| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 31. ECPG - C언어에 의한 매입SQL | Fast Forward | Next |
Section 31.4에서, 매입 SQL 프로그램으로 어떻게 SQL 명령문을 실행하는지에 대해서 설명했습니다. 이 명령문 중에는 고정값 밖에 사용하지 않거나, 사용자가 지정한 값을 명령문에 삽입하는 방법을 제공하지 않는 것, 쿼리가 돌려준 값을 프로그램으로 처리하는 방법을 제공하지 않는 것들이 있었습니다. 이런 종류의 명령문은 실제의 어플리케이션에서는 도움이 되지 않습니다. 본절에서는, 호스트 변수라는 단순한 기법을 사용한, C프로그램과 매입 SQL 명령문과의 사이에 데이터를 교환하는 방법을 상세하게 설명합니다. 매입 SQL 프로그램에서는, SQL명령문을 호스트 언어가 되는 C프로그램 코드에서 게스트 guests로 간주합니다. 따라서, C프로그램의 변수는 호스트 변수로 불립니다.
매입 SQL에 있어서 C프로그램과 SQL 명령문의 사이에서의 데이터의 교환은 특히 단순합니다. 값에 적절한 인용부호를 부여하는 것처럼, 여러가지 복잡한 처리를 수반하는, 프로그램에 데이터를 명령문에 붙이는 일 대신, 단지 SQL명령문에, 콜론으로 접두사를 붙인 C변수명을 쓸 뿐입니다. 이하에 예를 나타냅니다.
EXEC SQL INSERT INTO sometable VALUES (:v1, 'foo', :v2);
이 문장은, v1와 v2라고 하는 2개의 C변수를 참조하고, 또한, 보통의 SQL 문자열 리터럴도 사용합니다. 이것은, 사용할 수 있는 데이터의 종류는 1개 뿐이라는 제한이 없음을 나타내고 있습니다.
SQL 명령문 내에 C변수를 삽입하는 이 양식은, SQL 명령문으로 값을 표현하면 어디에서라도 작동합니다.
예를 들면, 쿼리 내의 매개변수로서 프로그램으로부터 데이터베이스에 데이터를 건네주거나, 혹은, 데이터베이스에서 데이터를 프로그램으로 보내기 위해서, 매입 SQL 프리프로세서를 관리할 수 있도록, 이러한 데이터를 포함하도록 의도된 C변수를 특수한 표가 붙은 섹션으로 선언할 필요가 있습니다.
이 섹션은 이하로 시작됩니다.
EXEC SQL BEGIN DECLARE SECTION;
그리고, 이하로 끝납니다.
EXEC SQL END DECLARE SECTION;
이 행의 사이는, 이하와 같은 일반적인 C변수 선언이 있어야 합니다.
int x = 4; char foo[16], bar[16];
보이는 대로, 변수에 초기값을 할당할 수 있습니다. 변수의 범위는 프로그램내의 섹션 선언 장소에 의해 정해집니다. 또, 이하와 같이 암묵적으로 선언 섹션을 생성하는 구문을 사용해 변수를 선언할 수도 있습니다.
EXEC SQL int i = 4;
프로그램에 원하는 만큼 복수의 선언 섹션을 갖게할 수 있습니다.
또, 선언은 보통 C변수로서 그대로 출력 파일에 출력됩니다. 그러므로, 이것들을 재차 선언할 필요는 없습니다. 통상, SQL 명령으로 사용할 의도가 없는 변수는 이 특별한 섹션의 밖에서 선언됩니다.
마찬가지로, 구조나 union의 정의도 DECLARE섹션의 안쪽에 나타낼 필요가 있습니다. 그렇지 않으면, 선행 프로세스에서 그 정의가 불명하기 때문에, 이 형태를 다룰 수 없습니다.
호스트 변수로서 배열, typedef, 구조, 포인터를 사용할 수가 있습니다. 게다가 ECPG에서만 존재하는 특별한 호스트 변수의 형태가 존재합니다.
호스트 변수의 예를 이하에 나타냅니다.
배열 선언에서 가장 자주 사용되는 것의 하나는, 이하와 같은 문자 배열의 할당입니다.
EXEC SQL BEGIN DECLARE SECTION;
char str[50];
EXEC SQL END DECLARE SECTION;
배열 길이는 개발자가 신경써야 하는 것에 주의해 주세요. 이 호스트 변수를 49 문자보다 긴 문자열을 돌려주는 쿼리의 대상 변수에 사용했을 경우, 버퍼 오버플로우가 발생합니다.
typedef키워드를 사용해, 새로운 형태를 기존의 형태에 할당할 수가 있습니다.
EXEC SQL BEGIN DECLARE SECTION;
typedef char mychartype[40];
typedef long serial_t;
EXEC SQL END DECLARE SECTION;
이하도 사용할 수 있음에 주의해 주세요.
EXEC SQL TYPE serial_t IS long;
이 선언이 선언 섹션의 일부일 필요는 없습니다.
자주 사용되는 형태의 포인터를 선언할 수가 있습니다. 그러나, 자동 할당없이 포인터를 대상 변수로 사용할 수 없는 점에 주의해 주세요. 자동 할당에 관한 정보는 Section 31.10을 참조해 주세요.
EXEC SQL BEGIN DECLARE SECTION;
int *intp;
char **charp;
EXEC SQL END DECLARE SECTION;
ECPG에는, SQL 서버의 데이터를 간단하게 취급하기 위한 특별한 형태가 포함되어 있습니다. 예를 들면, varchar, numeric, date, timestamp, interval형에 대한 지원이 구현되고 있습니다. Section 31.8에는, 이러한 형태를 취급하는 기본 함수가 있습니다. 예를 들어, 이것들을 사용하면, 시간 간격을 타임스템프에 가산하기 위해서, SQL 서버에 쿼리를 송신할 필요가 없어집니다.
특별한 VARCHAR형은 각 변수를 이름 첨부의 struct로 변환합니다.
VARCHAR var[180];
이러한 선언은, 이하와 같이 변환됩니다.
struct varchar_var { int len; char arr[180]; } var;
이 구조는, varchar형의 SQL 데이터와의 인터페이스에 적합합니다.
여기까지, 프로그램으로 생성한 데이터를 SQL 명령에 보낼 수 있게 되었습니다. 그러나, 어떻게 쿼리의 결과를 꺼내는 것일까요? 이 목적을 위해서, 매입 SQL에서는, SELECT와 FETCH를 파생한, 보통 명령의 특별한 변형을 제공합니다. 이러한 명령은 특별한 INTO구를 가져, 여기서 돌려받은 값을 어느 호스트 변수에 저장될 곳을 지정합니다.
이하에 샘플을 나타냅니다.
/* * 이하의 테이블을 전제로 하고 있습니다. * CREATE TABLE test1 (a int, b varchar(50)); */ EXEC SQL BEGIN DECLARE SECTION; int v1; VARCHAR v2; EXEC SQL END DECLARE SECTION; ... EXEC SQL SELECT a, b INTO :v1, :v2 FROM test;
INTO구가 선택 리스트와 FROM구의 사이에 나타납니다. 선택 리스트내의 요소의 수와 INTO직후의 리스트(타겟 리스트라고도 불립니다)의 요소의 수는 동일해야 합니다.
이하에 FETCH명령을 사용하는 예를 나타냅니다.
EXEC SQL BEGIN DECLARE SECTION;
int v1;
VARCHAR v2;
EXEC SQL END DECLARE SECTION;
...
EXEC SQL DECLARE foo CURSOR FOR SELECT a, b FROM test;
...
do {
...
EXEC SQL FETCH NEXT FROM foo INTO :v1, :v2;
...
} while (...);
여기에서는, INTO구가 모든 일반적인 구의 뒤에 나타나고 있습니다.
이러한 두가지 방법은 모두, 한 번에 1행만을 꺼낼 수가 있습니다. 복수의 행을 포함할 가능성이 있는 결과 집합을 처리해야 하는 경우는, 두 번째의 예처럼 커서를 사용할 필요가 있습니다.
위의 예에서는 NUJLL값을 취급하지 않습니다. 실제, 검색 예에서는, 만약 데이터베이스에서 NULL값이 나왔을 경우에 에러가 발생합니다. 데이터베이스에 NULL값을 건네거나, 또는, 데이터베이스로부터 NULL값을 꺼내기 위해서는, 제2의 호스트 변수 사양을 데이터를 저장하는 호스트 변수 각각 추가해야 합니다. 제2의 호스트 변수는 지시자로 불려져 데이터가 NULL인지 아닌지를 나타내는 플래그가 포함됩니다. NULL의 경우, 실제의 호스트 변수의 값은 무시됩니다. 이하에, NULL값의 취득을 올바르게 다루는 예를 나타냅니다.
EXEC SQL BEGIN DECLARE SECTION; VARCHAR val; int val_ind; EXEC SQL END DECLARE SECTION: ... EXEC SQL SELECT b INTO :val :val_ind FROM test1;
값이 NULL가 아니면, 지시자 변수 val_ind는 0이 됩니다. 값이 NULL라면, 부의 값이 됩니다.
지시자는 다른 기능을 가집니다. 지시자의 값이 정이라면, 값이 NULL가 아니지만, 호스트 변수에 저장될 때에 일부가 삭제된 것을 나타냅니다.