36.4. 호스트 배트맨 토토 사용

in섹션 36.3임베디드 SQL 프로그램에서 SQL 문을 실행하는 방법을 보았습니다. 이러한 진술 중 일부는 고정 값 만 사용했으며 사용자가 제공 한 값을 명령문에 삽입하거나 프로그램이 쿼리에서 반환 한 값을 처리하도록하는 방법을 제공하지 않았습니다.호스트 배트맨 토토. 임베디드 SQL 프로그램에서는 SQL 문을 고려합니다.게스트C 프로그램 코드에서호스트 언어. 따라서 C 프로그램의 배트맨 토토를라고합니다.호스트 배트맨 토토.

PostgreSQL 백엔드와 ECPG 응용 프로그램 간의 값을 교환하는 또 다른 방법은에 설명 된 SQL 디스크립터의 사용입니다.섹션 36.7.

36.4.1. 개요

C 프로그램과 SQL 문의 데이터 전달은 내장 된 SQL에서 특히 간단합니다. 프로그램에 데이터를 표시하는 대신 값을 올바르게 인용하는 것과 같은 다양한 합병증을 수반하는 문장에 데이터를 붙여 넣는 대신 C 변수의 이름을 콜론에 의해 접두사에 표시 한 SQL 문에 작성할 수 있습니다.

Exec SQL insert instable 값 (: v1, 'foo', : ​​v2);

이 문장은v1v2그리고 또한 일반 SQL 문자열 리터럴을 사용하여 한 종류의 데이터 또는 다른 데이터를 사용하는 것이 제한되지 않음을 설명합니다..

SQL 문에 C 변수를 삽입하는이 스타일은 SQL 문에서 값 표현식이 예상되는 곳 어디에서나 작동합니다.

36.4.2. 섹션 선언

예를 들어 쿼리의 매개 변수와 같은 프로그램에서 데이터를 데이터베이스로 전달하거나 데이터베이스에서 데이터를 프로그램으로 다시 전달하려면이 데이터를 포함하려는 C 변수는 특별히 표시된 섹션에서 선언해야하므로 임베드 된 SQL Preprocessor는 그들에 대한 인식이 이루어집니다..

이 섹션은 :부터 시작합니다.

Exec SQL 시작 선언 섹션;

:로 끝납니다.

Exec SQL End Declare 섹션;

해당 라인 사이에 :과 같은 일반 C 배트맨 토토 선언이 있어야합니다.

int x = 4;

보시다시피, 초기 값을 배트맨 토토에 선택적으로 할당 할 수 있습니다. 배트맨 토토의 범위는 프로그램 내에서 선언 섹션의 위치에 따라 결정됩니다.

Exec SQL int i = 4;

원하는만큼 프로그램에서 많은 선언 섹션을 가질 수 있습니다.

선언은 또한 일반 C 변수로 출력 파일에 반향되므로 다시 선언 할 필요가 없습니다. SQL 명령에 사용되지 않는 변수는이 특수 섹션 밖에서 정상적으로 선언 될 수 있습니다.

구조 또는 조합의 정의는 a 내부에 나열되어 있어야합니다.선언섹션. 그렇지 않으면 사전 처리기는 정의를 모르기 때문에 이러한 유형을 처리 할 수 ​​없습니다.

36.4.3. 쿼리 결과 검색

이제 프로그램에서 생성 된 데이터를 SQL 명령으로 전달할 수 있어야합니다. 그러나 쿼리 결과를 어떻게 검색합니까?selectfetch. 이 명령에는 특별한in검색된 값이 저장 될 호스트 배트맨 토토를 지정하는 조항.select단일 행만 반환하는 쿼리에 사용됩니다.fetch커서를 사용하여 여러 행을 반환하는 쿼리에 사용됩니다.

예는 다음과 같습니다.

/*

theinSELECT 목록과 사이에 조항이 나타납니다.From절. 선택 목록의 요소 수와 다음 목록in(대상 목록이라고도 함)는 동일해야합니다.

다음은 명령을 사용하는 예입니다fetch:

Exec SQL 시작 선언 섹션;

여기in조항은 모든 정상적인 조항 후에 나타납니다.

36.4.4. 유형 매핑

ECPG 애플리케이션이 PostgreSQL 서버와 C 응용 프로그램 간의 값을 교환 할 때, 예를 들어 서버에서 쿼리 결과를 검색하거나 입력 매개 변수로 SQL 문을 실행할 때와 같이 PostgreSQL 데이터 유형과 호스트 언어 유형 사이에서 값을 변환해야합니다 (C 언어 데이터 유형, 구체적). ECPG의 주요 요점 중 하나는 대부분의 경우이를 자동으로 처리한다는 것입니다.

이와 관련하여 두 가지 종류의 데이터 유형이 있습니다.Integer텍스트, 응용 프로그램에서 직접 읽고 쓸 수 있습니다. 와 같은 기타 PostgreSQL 데이터 유형타임 스탬프숫자특수 라이브러리 기능을 통해서만 액세스 할 수 있습니다. 보다섹션 36.4.4.2.

표 36.1어떤 PostgreSQL 데이터 유형이 C 데이터 유형에 해당하는지 보여줍니다. 주어진 PostgreSQL 데이터 유형의 값을 보내거나 받으려면 선언 섹션에서 해당 C 데이터 유형의 C 변수를 선언해야합니다..

표 36.1. PostgreSQL 데이터 유형과 C 변수 유형 간의 매핑

PostgreSQL 데이터 유형 호스트 배트맨 토토 유형
smallint 짧은
Integer int
bigint 긴 긴 int
소수점 소수점[A]
숫자 숫자[A]
Real float
이중 정밀 더블
SmallSerial 짧은
Serial int
bigserial 긴 긴 int
OID 서명되지 않은 int
문자 (n), varchar (n), 텍스트 char [n+1], Varchar [n+1]
이름 char [namedatalen]
타임 스탬프 타임 스탬프[A]
간격 간격[A]
날짜 날짜[A]
부울 bool[B]
BYTEA char *, Bytea [n]

[A]이 유형은 특수 라이브러리 기능을 통해서만 액세스 할 수 있습니다. 보다섹션 36.4.4.2.

[B]선언ecpglib.h기본이 아닌 경우


36.4.4.1. 캐릭터 문자열 처리

SQL 문자열 데이터 유형을 처리하려면Varchar텍스트, 호스트 배트맨 토토를 선언하는 두 가지 가능한 방법이 있습니다.

한 가지 방법은 사용 중char [], 배열char, 이것은 C에서 문자 데이터를 처리하는 가장 일반적인 방법입니다.

Exec SQL 시작 선언 섹션;

길이를 직접 돌봐야합니다. 이 호스트 배트맨 토토를 49 자 이상의 문자열을 반환하는 쿼리의 대상 변수로 사용하면 버퍼 오버플로가 발생합니다.

다른 방법은 사용 중입니다.VarcharECPG에서 제공하는 특수 유형 인 유형. 유형 배열에 대한 정의Varchar지명으로 변환struct모든 변수에 대해. 다음과 같은 선언 :

Varchar var [180];

Struct varchar_var int len; char arr [180];

회원ARR종료 0 바이트를 포함하여 문자열을 호스팅합니다. 따라서 문자열을 a 저장하려면Varchar호스트 배트맨 토토, 호스트 배트맨 토토는 제로 바이트 터미네이터를 포함한 길이로 선언해야합니다. 회원Len에 저장된 문자열의 길이를 유지합니다ARR종료 제로 바이트없이. 호스트 배트맨 토토가 쿼리의 입력으로 사용되는 경우, ifStrlen (ARR)Len다르고 짧은 것이 사용됩니다.

Varchar상류 또는 소문자로 작성할 수는 있지만 혼합 된 경우에는 없습니다.

charVarchar호스트 배트맨 토토는 다른 SQL 유형의 값을 보유 할 수 있으며,이 유형은 문자열 양식에 저장됩니다.

36.4.4.2. 특수 데이터 유형 액세스

ECPG에는 PostgreSQL 서버의 일부 특수 데이터 유형과 쉽게 상호 작용하는 데 도움이되는 몇 가지 특수 유형이 포함되어 있습니다. 특히에 대한 지원을 구현했습니다.숫자, 소수점, 날짜, 타임 스탬프간격유형. 이러한 데이터 유형은 원시적 호스트 배트맨 토토 유형에 유용하게 매핑 될 수 없습니다 (예 :int, 긴 긴 int또는char [])는 복잡한 내부 구조를 가지고 있기 때문입니다. 응용 프로그램은 특수 유형의 호스트 배트맨 토토를 선언하고 PGTypes 라이브러리에서 기능을 사용하여 액세스하여 이러한 유형을 처리합니다.섹션 36.6예를 들어 타임 스탬프에 간격을 추가하기 위해 SQL Server에 쿼리를 보낼 필요가 없도록 이러한 유형을 처리하는 기본 기능이 포함되어 있습니다.

다음 하위 섹션에서는 이러한 특수 데이터 유형을 설명합니다. PGTYPES 라이브러리 기능에 대한 자세한 내용은 참조하십시오.섹션 36.6.

36.4.4.2.1. 타임 스탬프, 날짜

처리 패턴은 다음과 같습니다타임 스탬프ECPG 호스트 응용 프로그램의 변수.

먼저, 프로그램에는에 대한 헤더 파일을 포함해야합니다.타임 스탬프유형 :

#include 

다음, 호스트 배트맨 토토를 유형으로 선언타임 스탬프선언 섹션 :

Exec SQL 시작 선언 섹션;

그리고 호스트 배트맨 토토에 값을 읽은 후 PgTypes 라이브러리 기능을 사용하여 처리하십시오. 다음 예에서타임 스탬프값은 텍스트 (ASCII) 양식으로 변환됩니다pgtypestimestamp_to_asc ()기능 :

exec sql now () :: timestamp in : ts;

이 예제는 다음과 같은 결과를 보여줍니다 :

TS = 2010-06-27 18 : 03 : 56.949343

또한 날짜 유형은 같은 방식으로 처리 할 수 ​​있습니다. 프로그램에는 포함해야합니다pgtypes_date.h, 호스트 배트맨 토토를 날짜 유형으로 선언하고 날짜 값을 텍스트 양식으로 변환pgtypesdate_to_asc ()함수. PGTYPES 라이브러리 기능에 대한 자세한 내용은 참조하십시오.섹션 36.6.

36.4.4.2.2. 간격

간격유형은 또한와 유사합니다.타임 스탬프날짜유형. 그러나 AN에 대한 메모리를 할당하는 것이 필요합니다간격명시 적으로 값을 입력하십시오. 다시 말해, 배트맨 토토의 메모리 공간은 스택 메모리가 아닌 힙 메모리에 할당되어야합니다.

여기 예제 프로그램이 있습니다 :

#include 
36.4.4.2.3. 숫자, 소수점

숫자소수점유형은와 유사합니다.간격유형 : 포인터 정의, 힙에 메모리 공간을 할당하며 PGTypes 라이브러리 기능을 사용하여 변수에 액세스해야합니다. PGTYPES 라이브러리 기능에 대한 자세한 내용은 참조하십시오.섹션 36.6.

기능이 특별히 제공되지 않습니다.소수점타입. 응용 프로그램은 a로 변환해야합니다.숫자추가 처리를 수행하기 위해 PGTYPES 라이브러리 기능을 사용하는 가변.

여기 예제 프로그램 처리숫자소수점배트맨 토토 유형.

#include 
36.4.4.2.4. 바이트

BYTEA유형은와 유사합니다.Varchar. 유형 배열에 대한 정의BYTEA는 모든 변수에 대해 명명 된 구조로 변환됩니다. 다음과 같은 선언 :

Bytea var [180];

Struct Bytea_var int len; char arr [180];

회원ARR이진 형식 데이터를 호스트합니다. 또한 처리 할 수 ​​있습니다'\ 0'데이터의 일부로Varchar. 데이터는/to hex 형식에서 변환되고 ecpglib에 의해 전송/수신됩니다.

note

BYTEA배트맨 토토는 만 사용할 수 있습니다bytea_output로 설정되었습니다hex.

36.4.4.3. 비 프리즘 유형의 호스트 배트맨 토토

호스트 배트맨 토토로서 배열, typedefs, structs 및 pointers를 사용할 수도 있습니다.

36.4.4.3.1. 배열

호스트 배트맨 토토로 배열에 대한 두 가지 사용 사례가 있습니다. 첫 번째는 텍스트 문자열을 저장하는 방법입니다.char []또는varchar [], 설명 된대로섹션 36.4.4.1. 두 번째 유스 케이스는 커서를 사용하지 않고 쿼리 결과에서 여러 행을 검색하는 것입니다.fetch명령. 그러나 배열 호스트 배트맨 토토를 사용하면 한 번에 여러 행을 수신 할 수 있습니다.

다음 예제 스캔pg_database시스템 테이블과 사용 가능한 데이터베이스의 모든 OID 및 이름을 표시합니다.

int

이 예제는 다음과 같은 결과를 보여줍니다. (정확한 값은 지역 상황에 따라 다릅니다.)

oid = 1, dbname = 템플릿 1
36.4.4.3.2. 구조

멤버 이름이 쿼리 결과의 열 이름과 일치하는 구조를 사용하여 여러 열을 한 번에 검색 할 수 있습니다. 구조는 단일 호스트 배트맨 토토에서 여러 열 값을 처리 할 수 ​​있습니다.

다음 예제는 사용 가능한 데이터베이스의 OID, 이름 및 크기를 검색합니다.pg_database시스템 테이블 및 사용pg_database_size ()함수. 이 예에서는 구조 배트맨 토토dbinfo_tselect결과는 여러 호스트 배트맨 토토를 넣지 않고 하나의 결과 행을 검색하는 데 사용됩니다fetch진술.

exec SQL 시작 선언 섹션;

이 예제는 다음과 같은 결과를 보여줍니다. (정확한 값은 지역 상황에 따라 다릅니다.)

oid = 1, datname = template1, size = 4324580

구조 호스트 배트맨 토토흡수필드만큼 구조만큼 많은 열. 추가 열은 다른 호스트 배트맨 토토에 지정될 수 있습니다.size구조 외부의 배트맨 토토 :

Exec SQL 시작 선언 섹션;
36.4.4.3.3. typedefs

사용typedef새로운 유형을 이미 기존 유형에 매핑하는 키워드.

exec SQL 시작 선언 섹션;

당신도 사용할 수 있습니다 :

exec sql type serial_t는 길다;

이 선언은 선언 섹션의 일부일 필요는 없습니다.

36.4.4.3.4. 포인터

가장 일반적인 유형으로 포인터를 선언 할 수 있습니다. 그러나 포인터를 자동 할당없이 쿼리의 대상 변수로 사용할 수는 없습니다.섹션 36.7자동 할당에 대한 자세한 내용은

exec SQL 시작 선언 섹션;

36.4.5. 비 프리밍 SQL 데이터 유형 처리

이 섹션에는 ECPG 애플리케이션에서 NONSCALAR 및 사용자 정의 SQL 레벨 데이터 유형을 처리하는 방법에 대한 정보가 포함되어 있습니다. 이는 이전 섹션에서 설명한 비 프라이드 유형의 호스트 배트맨 토토의 처리와는 다릅니다.

36.4.5.1. 배열

다차원 SQL 레벨 어레이는 ECPG에서 직접 지원되지 않습니다. 1 차원 SQL 레벨 어레이는 C 배열 호스트 배트맨 토토에 매핑 될 수 있고 그 반대도 마찬가지입니다.

쿼리에 액세스하는 경우요소별도로 배열의 배열은 ECPG에서 배열을 사용하지 않습니다. 그런 다음 요소 유형에 매핑 될 수있는 유형을 갖는 호스트 배트맨 토토를 사용해야합니다.Integer, 유형의 호스트 배트맨 토토int를 사용할 수 있습니다. 또한 요소 유형이 인 경우Varchar또는텍스트, 유형의 호스트 배트맨 토토char []또는varchar []사용할 수 있습니다.

여기 예입니다. 다음 표를 가정하십시오.

테이블 생성 t3 (

다음 예제 프로그램은 배열의 4 번째 요소를 검색하고이를 유형의 호스트 배트맨 토토에 저장합니다int:

Exec SQL 시작 선언 섹션;

이 예제는 다음과 같은 결과를 보여줍니다.

ii = 4

배열 유형 호스트 배트맨 토토에서 여러 배열 요소를 여러 요소에 매핑하려면 배열 열의 각 요소와 호스트 배트맨 토토 배열의 각 요소는 별도로 관리되어야합니다.

Exec SQL 시작 선언 섹션;

다시 참고

Exec SQL 시작 선언 섹션;

배열 유형 열을 배열 호스트 배트맨 토토에 직접 매핑 할 수 없기 때문에이 경우 올바르게 작동하지 않습니다.

다른 해결 방법은 외부 문자열 표현에 배열을 유형의 호스트 배트맨 토토에 저장하는 것입니다char []또는varchar []. 이 표현에 대한 자세한 내용은 참조하십시오.섹션 8.15.2. 이것은 배열이 호스트 프로그램의 배열로 자연스럽게 액세스 할 수 없음을 의미합니다 (텍스트 표현을 구문 분석하는 추가 처리없이).

36.4.5.2. 복합 유형

Composite 유형은 ECPG에서 직접 지원되지 않지만 쉬운 해결 방법이 가능합니다. 사용 가능한 해결 방법은 위의 배열에 대해 설명 된 것과 유사합니다. 각 속성에 별도로 액세스하거나 외부 문자열 표현을 사용하십시오.

다음 예제의 경우 다음 유형과 표를 가정합니다.

유형 Comp_t 생성 (Intval Integer, TextVal Varchar (32));

가장 분명한 해결책은 각 속성에 별도로 액세스하는 것입니다. 다음 프로그램은 유형의 각 속성을 선택하여 예제 테이블에서 데이터를 검색합니다comp_t별도로 :

exec SQL 시작 선언 섹션;

이 예를 향상시키기 위해 호스트 배트맨 토토는에 값을 저장합니다.fetch명령을 하나의 구조로 수집 할 수 있습니다. 구조 양식의 호스트 배트맨 토토에 대한 자세한 내용은 참조하십시오.섹션 36.4.4.3.2. 구조로 전환하려면 예를 다음과 같이 수정할 수 있습니다.intvalTextVal,comp_t구조 및 구조는에 지정되어 있습니다.fetch명령.

Exec SQL 시작 선언 섹션;

구조가 사용되지만fetch명령, 속성 이름select절은 하나씩 지정됩니다. 이것은 a를 사용하여 향상 될 수 있습니다.*복합 유형 값의 모든 속성을 요구합니다.

...

ECPG가 복합 유형 자체를 이해하지 못하더라도 복합 유형은 거의 완벽하게 구조에 매핑 될 수 있습니다..

마지막으로, 유형의 호스트 배트맨 토토에 외부 문자열 표현에 복합 유형 값을 저장할 수도 있습니다char []또는varchar []. 그러나 그렇게하면 호스트 프로그램에서 값의 필드에 액세스하는 것은 쉽지 않습니다.

36.4.5.3. 사용자 정의 기본 유형

새로운 사용자 정의 기본 유형은 ECPG에서 직접 지원되지 않습니다. 유형의 외부 문자열 표현 및 호스트 배트맨 토토를 사용할 수 있습니다char []또는varchar [], 그리고이 솔루션은 실제로 많은 유형에 적합하고 충분합니다.

데이터 유형을 사용하는 예는 다음과 같습니다.복잡한예제에서섹션 38.13. 해당 유형의 외부 문자열 표현은입니다.(%f,%f), 함수에 정의 된complex_in ()complex_out ()함수섹션 38.13. 다음 예제는 복잡한 유형 값을 삽입합니다(1,1)(3,3)열로ab, 그 후 테이블에서 선택하십시오.

exec SQL 시작 선언 섹션;

이 예제는 다음과 같은 결과를 보여줍니다 :

a = (1,1), b = (3,3)

다른 해결 방법은 ECPG에서 사용자 정의 유형을 직접 사용하는 것을 피하고 대신 사용자 정의 유형과 ECPG가 처리 할 수있는 기본 유형을 변환하는 함수 또는 캐스트를 만듭니다. 그러나 이러한 유형의 캐스트, 특히 암시 적 캐스트는 유형 시스템에 매우 신중하게 도입되어야합니다.

예를 들어

CREATE CREATION_COMPLEX (R DOUBLE, I DOUBLE)는 복합체를 반환합니다

이 정의 이후 다음

Exec SQL 시작 선언 섹션;

Exec SQL insert invest_complex 값 ( '(1,2)', '(3,4)';

36.4.6. 표시기

위의 예는 널 값을 처리하지 않습니다. 실제로 검색 예제는 데이터베이스에서 널 값을 가져 오면 오류가 발생합니다.표시기그리고 데이텀이 null인지 알려주는 플래그가 포함되어 있으며,이 경우 실제 호스트 배트맨 토토의 값은 무시됩니다. 다음은 널 값의 검색을 올바르게 처리하는 예입니다.

Exec SQL 시작 선언 섹션;

지표 배트맨 토토val_ind값이 null이 아닌 경우 0이되며 값이 널이면 음수가됩니다. (보다PostgreSQL : 문서 : 15 : 36.16. Oracle 호환성 와이즈 토토Oracle-specific 행동을 활성화하려면)

표시기에는 또 다른 기능이 있습니다. 표시기 값이 양수 인 경우 값이 NULL이 아니지만 호스트 배트맨 토토에 저장 될 때 잘 렸습니다..

인수 인 경우-r no_indicator사전 처리기에게 전달ECPG에서 작동합니다no-indicator모드. NO-Indicator 모드에서 표시기 변수가 지정되지 않으면 널 값이 비어있는 문자열로 문자열 유형에 대한 문자열 유형에 대한 신호 (입력 및 출력) 및 유형에 대한 최저 값 (예 :에 대한 정수 유형에 대한 신호를 나타냅니다.int_minforint).

정정 제출

문서에 올바르지 않은 내용이 있으면 일치하지 않습니다.이 양식문서 문제를보고하려면