| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 31. ECPG - C언어에 의한 매입SQL | Fast Forward | Next |
본절에서는, 매입 SQL 프로그램에 대해, 예외 조건이나 경고를 어떻게 취급할 지에 대해서 설명합니다. 이를 위해, 함께 사용할 수 있는 복수의 기능이 있습니다.
에러나 경고를 받아들이는 간단한 수법의 하나는, 특정의 조건이 발생할 때에 특정의 동작을 실행하도록 설정하는 것입니다. 일반적으로는 이하와 같이 됩니다.
EXEC SQL WHENEVER condition action ;
condition 는 이하의 어느쪽이든을 취할 수 있습니다.
SQL문의 실행중에 에러가 발생할 때에, 지정한 동작이 불려 갑니다.
SQL문의 실행 중에 경고가 발생할 때에, 지정한 동작이 불려 갑니다.
SQL문이 0행을 받거나, 혹은 0행에 영향을 줄 때, 지정한 동작이 불려 갑니다 (이 조건은 에러가 아닙니다만, 이것을 특별히 취급하고 싶은 경우가 있습니다).
action 는 이하의 어느쪽이든을 취할 수가 있습니다.
이것은, 효과적으로 그 조건이 무시되는 것을 의미합니다. 이것이 기본값입니다.
지정한 라벨로 이동합니다 (C의 goto문을 사용합니다).
표준 에러에 메세지를 출력합니다. 이것은, 단순한 프로그램이나 프로토타입 작성시에 도움이 됩니다. 메세지의 자세한 것은 설정할 수 없습니다.
프로그램을 종료시키는 exit(1)를 호출합니다.
C의 break문을 실행합니다. 이것은 루프내, 혹은 switch문내에서만 사용해야 합니다.
저장한 인자로, 지정한 C함수를 호출합니다.
표준 SQL에서는 CONTINUE와 GOTO(와GO TO)만을 제공하고 있습니다.
간단한 프로그램으로 사용해 보고 싶은 예를 이하에 나타냅니다. 경고가 발생했을 경우에 간단한 메세지를 표시해, 에러가 발생했을 경우에 프로그램을 중단합니다.
EXEC SQL WHENEVER SQLWARNING SQLPRINT; EXEC SQL WHENEVER SQLERROR STOP;
EXEC SQL WHENEVER문은 C의 문장은 아니고, SQL 프리프로세서의 지시문입니다. 설정한 에러 혹은 경고 동작은, 최초의 EXEC SQL WHENEVER와 조건을 발생시킨 SQL문의 사이로, 동일 조건에 다른 동작이 설정되지 않는 이상 핸들러를 설정한 시점 이후에 있는, 모든 매입 SQL문에 적용됩니다. C프로그램의 제어 흐름은 관계하지 않습니다. 그러므로, 이하의 2개의 C프로그램의 발췌는 어느 쪽에서도 바라는 동작을 실시하지 않습니다.
/*
* WRONG
*/
int main(int argc, char *argv[])
{
...
if (verbose) {
EXEC SQL WHENEVER SQLWARNING SQLPRINT;
}
...
EXEC SQL SELECT ...;
...
}
/*
* WRONG
*/
int main(int argc, char *argv[])
{
...
set_error_handler();
...
EXEC SQL SELECT ...;
...
}
static void set_error_handler(void)
{
EXEC SQL WHENEVER SQLERROR STOP;
}
보다 강력하게 에러를 취급하기 위해서, 매입 SQL 인터페이스는 이하의 구조를 가지는 sqlca라는 이름의 글로벌 변수를 제공합니다.
struct
{
char sqlcaid[8];
long sqlabc;
long sqlcode;
struct
{
int sqlerrml;
char sqlerrmc[70];
} sqlerrm;
char sqlerrp[8];
long sqlerrd[6];
char sqlwarn[8];
char sqlstate[5];
} sqlca;
(멀티 쓰레드화 된 프로그램에서는, 각 쓰레드는 자동적으로 sqlca의 복사본를 독자적으로 가집니다. 이것은 표준 C의 errno글로벌 변수의 취급과 같은 동작을 합니다. )
sqlca는 경고와 에러의 양쪽 모두를 대상으로 하고 있습니다. 1개의 문장의 실행시에 복수의 경고나 에러가 발생했을 경우 sqlca는 마지막의 것과 관계된 정보만을 포함합니다.
직전의 SQL문으로 에러가 없으면, sqlca.sqlcode는 0에, sqlca.sqlstate는 "00000"이 됩니다. 경고나 에러가 발생했을 경우는, sqlca.sqlcode는 부의 값에, sqlca.sqlstate는 "00000"와 다르게 됩니다. 정의 sqlca.sqlcode는, 직전의 쿼리가 0행을 돌려주었다는 등의 무해인 조건을 나타냅니다. sqlca.sqlcode와 sqlca.sqlstate는 2개가 다른 에러 코드 스키마입니다. 다음에 상세하게 설명합니다.
직전의 SQL문이 성공하면, sqlca.sqlerrd[1]은 처리된 행의 OID가 저장됩니다. 또, 만약 그 명령으로 적절하면, sqlca.sqlerrd[2]는 처리된, 혹은 돌려주어진 행수가 저장됩니다.
에러 혹은 경고의 경우, sqlca.sqlerrm.sqlerrmc에는, 그 에러를 설명하는 문자열이 저장됩니다.
sqlca.sqlerrm.sqlerrml 필드에는 sqlca.sqlerrm.sqlerrmc에 저장된 에러 메세지 길이가 저장됩니다
(strlen()의 결과입니다. 아마 C프로그래머는 필요로 하지 않을 것입니다).
일부의 메세지는 고정 길이의 sqlerrmc배열에는 너무 긴 것에 주의해 주세요.
이 경우는 절약할 수 있습니다.
경고의 경우, sqlca.sqlwarn[2]는 W로 설정됩니다 (다른 모든 경우에서는, 이것은 W와 다르게 설정됩니다). sqlca.sqlwarn[1]이 W로 설정되었을 경우, 호스트 변수에 대입할 때에 값을 절약할 수 있고 있습니다. 다른 요소가 경고를 나타내도록 설정되었을 경우, sqlca.sqlwarn[0]은 W로 설정됩니다.
현재, sqlcaid, sqlcabc, sqlerrp, 및 sqlerrd와 sqlwarn의 상기 이외의 요소는 유용한 정보를 가지지 않습니다.
sqlca는 표준 SQL에서는 정의되고 있지 않습니다. 그러나, 복수의 다른 SQL 데이터베이스 시스템으로 구현되고 있습니다. 그 정의는 기본 부분은 비슷하지만, 이식성을 가지는 어플리케이션을 작성하는 경우는 구현의 차이를 주의해 조사하지 않으면 안됩니다.
sqlca.sqlstate와 sqlca.sqlcode는 에러 코드를 제공하는 다른 2개의 스키마입니다. 모두 표준 SQL로부터 파생된 것입니다만, SQLCODE는 SQL-92판에서는 쓸모없게 된 것으로 여겨진 이후의 판으로부터 삭제되었습니다. 따라서, 신규 어플리케이션에서는 SQLSTATE를 사용하는 것을 강하게 권합니다.
SQLSTATE는 5 요소의 문자 배열입니다. 이 5 문자는, 각종의 에러 조건, 경고 조건의 코드를 표현하는 숫자, 대문자로부터 구성됩니다. SQLSTATE는 계층을 가진 스키마입니다. 최초의 2 문자는 조건을 범화한 클래스를 나타내, 나머지 3 문자는 범화 클래스의 부클래스를 나타냅니다. 성공 상태는 00000이라고 하는 코드로 나타납니다. SQLSTATE코드의 대부분은 표준 SQL로 정의되고 있습니다. PostgreSQL서버는 본질적으로 SQLSTATE에러 코드를 지원하고 있습니다. 따라서, 모든 어플리케이션으로 이 에러 코드를 사용하는 것으로, 고도의 일관성을 달성할 수가 있습니다. 상세한 것에 대하여는 Appendix A을 참조해 주세요.
폐지된 에러 코드 스키마인 SQLCODE는 단순한 정수입니다. 0이라고 하는 값은 성공을 의미해, 정의 값은 추가 정보를 가진 성공을, 부의 값은 에러를 나타냅니다. 표준 SQL에서는, 직전의 명령이 0행을 돌려준다, 혹은 0행에 영향을 준 것을 나타내는 100이라고 하는 값까지의 정의 값만을 정의하고 있습니다. 부의 값은 규정되고 있지 않습니다. 따라서, 이 스키마에서는 낮은 이식성 밖에 달성하지 못하고, 또, 코드 체계도 계층을 가지고 있지 않습니다. 역사적으로, PostgreSQL의 매입 SQL 프로세서에는, 몇 개의 특수한 SQLCODE의 값을 전용에 할당할 수 있고 있었습니다. 이하에, 그 수치와 그 상징명의 일람을 나타냅니다. 이것들은 다른 SQL 구현에의 이식성이 없는 것을 잊지 말아 주세요. 어플리케이션의 SQLSTATEschema에의 이행을 간이화 하기 위해서, 대응하는 SQLSTATE도 가리키고 있습니다. 그러나, 2개의 스키마간의 관계는 1대 1은 아니고 1대 다입니다 (실제는 다대 다입니다). 그러므로, 경우 마다 Appendix A에 나타낸 글로벌인 각 SQLSTATE를 참조하지 않으면 안됩니다.
할당이 끝난 SQLCODE입니다.
가상 메모리 부족을 나타냅니다. (SQLSTATE YE001)
라이브러리가 파악하고 있지 않는 것을 프리프로세서가 생성한 것을 나타냅니다. 아마, 호환성이 없는 프리프로세서와 라이브러리의 버젼을 사용하고 있습니다. (SQLSTATE YE002)
명령의 상정보다 많은 호스트 변수가 지정된 것을 의미합니다. (SQLSTATE 07001혹은 07002)
명령의 상정보다 적은 호스트 변수가 지정된 것을 의미합니다. (SQLSTATE 07001혹은 07002)
문의가 복수행을 돌려주었지만, 문장에서는 1개의 결과의 저장의 준비밖에 하고 있지 않았던 것을 의미합니다 (예를 들면, 지정된 변수가 배열은 아니었다). (SQLSTATE 21000)
호스트 변수의 형태가 int입니다만, 데이터베이스내의 데이터형이 달라, 그 값을 int로서 해석할 수가 없었습니다.
라이브러리는 이 변환에 strtol()를 사용합니다.
(SQLSTATE 42804)
호스트 변수의 형태가 unsigned int입니다만, 데이터베이스내의 데이터형이 달라, 그 값을 unsigned int로서 해석할 수가 없었습니다.
라이브러리는 이 변환에 strtoul()를 사용합니다.
(SQLSTATE 42804)
호스트 변수의 형태가 float입니다만, 데이터베이스내의 데이터형이 달라, 그 값을 float로서 해석할 수가 없었습니다.
라이브러리는 이 변환에 strtod()를 사용합니다.
(SQLSTATE 42804)
이것은, 호스트 변수의 형태가 bool입니다만, 데이터베이스내의 데이터가 't'도 'f'도 아니었던 것을 의미합니다. (SQLSTATE 42804)
PostgreSQL서버에 송신된 문장이 비었습니다 (통상 매입 SQL 프로그램에서는 발생하지 않습니다. 그러므로, 이것은 내부 에러를 나타내고 있을지도 모릅니다). (SQLSTATE YE002)
NULL값이 돌려주어졌습니다만, NULL용의 지시자 변수가 주어지고 있지 않았습니다. (SQLSTATE 22002)
배열이 필요한 개소에 보통 변수가 사용되고 있었습니다. (SQLSTATE 42804)
배열값을 요구했는데 데이터베이스가 보통 변수를 돌려주었습니다. (SQLSTATE 42804)
존재하지 않는 접속에 프로그램이 접속하려고 했습니다.
존재하지만 열려 있지 않은 접속에 프로그램이 접속하려고 했습니다 (이것은 내부 에러입니다). (SQLSTATE YE002)
사용하려고 한 문장이 준비되어 있지 않았습니다. (SQLSTATE 26000)
지정한 기술어가 발견되지 않았습니다. 사용하려고 한 문장은 준비되어 있지 않았습니다. (SQLSTATE 33000)
기술어의 인덱스가 범위 밖이었습니다. (SQLSTATE 07009)
무효인 기술어 항목이 요구되었습니다 (이것은 내부 에러입니다). (SQLSTATE YE002)
동적인 문장의 실행시에 데이터베이스가 수치를 돌려주었습니다만, 호스트 변수가 수치가 아니었습니다. (SQLSTATE 07006)
동적인 문장의 실행시에 데이터베이스가 수치가 아닌 것을 돌려주었습니다만, 호스트 변수가 수치였습니다. (SQLSTATE 07006)
PostgreSQL서버로 어떠한 에러가 발생했습니다. 이 메세지는 PostgreSQL서버로부터의 에러 메세지를 포함합니다.
PostgreSQL서버가 트랜잭션의 머킷이나 롤백(rollback)를 시작하지 못하는 것을 통지했습니다. (SQLSTATE 08007)
데이터베이스에의 접속 시행에 실패했습니다.
직전의 명령이 0행을 돌려준, 0행에 영향을 준, 커서의 종단에 이르게 한, 무해인 조건을 나타냅니다. (SQLSTATE 02000)