| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 29. libpq - C 라이브러리 | Fast Forward | Next |
이러한 함수를 사용하고, 기존의 데이터베이스 접속 오브젝트 상태를 조사할 수 있습니다.
Tip: libpq어플리케이션 프로그래머는 PGconn에 의한 추상화에 주위를 기울여야 합니다. PGconn의 내용은 이하에 드는 엑세서 함수를 사용해 꺼내 주십시요. 내부의 PGconn 필드는 향후 예고 없이 변경되기 때문에, libpq-int.h를 사용한 필드의 참조는 피해 주십시요.
이하의 함수는 접속으로 확립한 파라미터의 값을 반환합니다. 이러한 값은 PGconn 오브젝트의 존속 기간 중에는 고정되고 있습니다.
PQdb
접속한 데이터베이스명을 반환합니다.
char *PQdb(const PGconn *conn);
PQuser
접속한 유저명을 반환합니다.
char *PQuser(const PGconn *conn);
PQpass
접속한 패스워드를 반환합니다.
char *PQpass(const PGconn *conn);
PQhost
접속한 서버 호스트명을 반환합니다.
char *PQhost(const PGconn *conn);
PQport
접속한 포트를 반환합니다.
char *PQport(const PGconn *conn);
PQtty
접속의 디버그 TTY 를 반환합니다. (이것은 쓸모없게 된 것입니다. 왜냐하면 서버가 더이상 TTY설정을 참조하지 않기 때문입니다. 그러나 향후 호환성을 위해 함수는 남아 있습니다. )
char *PQtty(const PGconn *conn);
PQoptions
접속 요구시 건네진 커맨드 라인 옵션을 반환합니다.
char *PQoptions(const PGconn *conn);
이하의 함수는 PGconn에 대해서 조작을 실시하는 것으로 변경 가능한 상태 데이터를 반환합니다.
PQstatus
접속 상태를 반환합니다.
ConnStatusType PQstatus(const PGconn *conn);
이 상태는 많은 값 중에 하나가 될 수 있습니다.
그러나 CONNECTION_OK와 CONNECTION_BAD의 2개만이 비동기 접속 순서외로 볼 수 있습니다.
데이터베이스의 접속에 문제가 없으면, CONNECTION_OK상태가 됩니다.
접속에 실패한 경우 CONNECTION_BAD상태가 됩니다.
보통, OK상태는 PQfinish까지 유지되지만, 통신 실패로 앞당겨져CONNECTION_BAD가 되는 경우도 있습니다.
그 경우, 어플리케이션은PQreset를 호출해 복구을 시도할 수 있습니다.
그 외의 일어날 수 있는 상태 코드에 대해서는 PQconnectStart 와 PQconnectPoll의 항목을 참조해 주십시요.
PQtransactionStatus
서버의 현재의 트랜잭션 내부 상태를 반환합니다.
PGTransactionStatusType PQtransactionStatus(const PGconn *conn);
이 상태는 PQTRANS_IDLE (현재 대기중), PQTRANS_ACTIVE (커맨드 실행중), PQTRANS_INTRANS (유효한 트랜잭션 블록 내에서 대기중), PQTRANS_INERROR (무효인 트랜잭션 블록 내에서 대기중)가 될 수 있습니다. 접속에 문제가 있는 경우만PQTRANS_UNKNOWN가 보고됩니다. 서버로 쿼리가 전송됐지만, 아직 완료되지 않는 경우만PQTRANS_ACTIVE가 보고됩니다.
| Caution |
|
autocommit파라미터를 무효로 한PostgreSQL 7.3 서버를 사용하는 경우, |
PQparameterStatus
서버의 현재 파라미터 설정을 검색합니다.
const char *PQparameterStatus(const PGconn *conn, const char *paramName);
어느 파라미터 값은 접속 개시시에 서버에 의해 자동으로, 혹은 그 값이 변경되었을 때 항상 보고됩니다.
PQparameterStatus는 그러한 설정을 조사에 도움이 됩니다.
파라미터의 현재 값을 알면 그 값을, 모르는 경우는 NULL를 반환합니다.
현재 릴리스로 보고되는 파라미터에는 server_version, server_encoding, client_encoding, is_superuser, session_authorization, DateStyle, TimeZone, integer_datetimes, 및 standard_conforming_strings가 있습니다. (8.0 이전으로는 server_encoding, TimeZone, 및 integer_datetimes가, 8.1 이전으로는 standard_conforming_strings가 보고되지 않았습니다. ) server_version, server_encoding 및 integer_datetimes는 작동 후 변경하지 못합니다.는 것을 주의하십시요.
프로토콜 3.0보다 이전 서버는 파라미터 설정을 보고하지 않습니다.
그러나 libpq에는 server_version와 client_encoding의 값을 꺼내는 구조가 있습니다.
어플리케이션은 ad hoc코드로 이러한 값을 결정하는 것이 아니라, PQparameterStatus를 사용하는 것이 요구되고 있습니다.
(그러나 3.0 이전의 접속에서는 접속 시작 후에SET에 의한client_encoding의 변경은PQparameterStatus에 반영되지 않는 것을 주의하십시요. )
server_version에 대해서는 PQserverVersion도 참조해 주십시요.
이 함수는 보다 비교하기 쉬운 이 정보를 수치 형식으로 반환합니다.
standard_conforming_strings의 값이 없다고 보고되었을 경우, 어플리케이션은off라고 추측할 수 있습니다. 즉, backslash는 문자 리터럴 중 이스케이프 문자로서 취급합니다. 또한, 이 파라미터가 존재하면, 이스케이프 문자 구문(E'...'이 허락되었다는 것으로 받아들여집니다.
반환되는 포인터는 const라고 선언되고 있지만, 실제로는 PGconn구조와 관련된 변화하는 영역을 가르킵니다. 이 포인터가 쿼리를 통해 유효한 상태로 남을 것이라고 생각하지 말아 주십시요.
PQprotocolVersion
사용되는 프론트엔드/백엔드 프로토콜을 조사합니다.
int PQprotocolVersion(const PGconn *conn);
어떤 기능을 서포트 할 지를 결정하기 위해서, 이 함수를 사용하는 편이 좋을 것입니다. 현재, 취할 수 있는 값은 2(2.0 프로토콜), 3(3.0 프로토콜), 혹은 0(접속 불량)입니다. 이는 접속의 개시가 완료한 다음에 변경할 수 없습니다. 그러나 이론적으로는 접속의 재설정시로 변경 가능합니다. PostgreSQL 7.4이후에서의 통신할 때 보통 3.0 프로토콜이 사용됩니다. 7.4보다 전의 서버에서는 2.0 프로토콜만을 서포트합니다. (1.0 프로토콜은 폐지되어libpq에서는 서포트되고 있지 않습니다. )
PQserverVersion
백엔드 버전의 정수 표현을 반환합니다.
int PQserverVersion(const PGconn *conn);
이것을 사용해서 어플리케이션은 접속한 데이터베이스 서버 버전을 결정해도 상관하지 않습니다. 이 수치의 형식은 메이저, 마이너, 리버전 번호를 2자리수의 10 진수로 변환해, 연결시킨 것입니다. 예를 들면, 버전 8.1. 5에서는 80105를 반환하고, 버전 8.2에서는 80200을 반환합니다. (선두의 0은 나타나지 않습니다. ) 접속 불량의 경우는 0이 반환됩니다.
PQerrorMessage
접속의 조작에 대해, 가장 최근에 생성된 에러 메세지를 반환합니다.
char *PQerrorMessage(const PGconn *conn);
거의 모든libpq함수는 실패시에PQerrorMessage에 대한 메세지를 설정합니다.
libpq 협약에 따라 새로운 행을 포함한 비어있지 않은 PQerrorMessage 결과에 주의하십시요.
호출하는 쪽에서는 이 결과를 직접 해제해서는 안됩니다.
관련하는 PGconn핸들이PQfinish에게 건네졌을 때 이것은 해제됩니다.
PGconn구조의 조작을 통해 이 결과 문자열이 동일하다라고 가정 해서는 안됩니다.
PQsocket
서버와의 접속 소켓에 대한 파일 기술자 번호를 얻습니다. 유효한 기술자라면 값은 0 이상입니다. -1 의 경우는 서버와의 접속이 아직 열려 있지 않은 것을 나타냅니다. (이것은 일반적인 조작에서는 변경할 수 없습니다. 접속 설정 중이나 재설정 중으로 변경됩니다. )
int PQsocket(const PGconn *conn);
PQbackendPID
접속을 처리하는 백엔드 서버의 프로세스ID(PID)를 반환합니다.
int PQbackendPID(const PGconn *conn);
백엔드 PID 는 디버그 하는 경우나 NOTIFY메세지 (백엔드 프로세스룰 통보하는 PID 를 포함하고 있습니다)의 비교에 유용합니다. 이 PID는 데이터베이스 서버 호스트에서 실행되고 있는 프로세스에 속하며, 로컬 호스트측의 것이 아닙니다! 주의하십시요.
PQgetssl
접속으로 사용되고 있는 SSL 구조를 반환합니다. SSL 가 사용되지 않는 경우는 null을 반환합니다.
SSL *PQgetssl(const PGconn *conn);
이 구조는 암호화 레벨의 검증이나 서버 증명서의 체크 등에 도움이 됩니다. 이 구조에 대해서는 OpenSSL의 문서를 참조해 주십시요.
이 함수의 올바른 prototype를 얻으려면 , USE_SSL 를 정의할 필요가 있습니다. 이렇게 하면, OpenSSL의 ssl.h도 자동으로 포함됩니다.