| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 29. libpq - C 라이브러리 | Fast Forward | Next |
PostgreSQL는 LISTEN와 NOTIFY커맨드를 사용한, 비동기 통보를 지원합니다. 클라이언트 세션은 LISTEN커맨드를 사용해 특정한 통보 조건을 등록합니다. (통보 감시를 그만두려면UNLISTEN커맨드를 사용합니다. ) 임의의 세션으로 조건명에 의한NOTIFY커맨드가 실행되면, 특정 조건을 감시하는 모든 세션은 비동기에게 통보를 받습니다. 통보원으로부터 통보를 받는 쪽은 더 이상의 정보를 건네받지 않습니다. 따라서, 보통 통신해야 하는 실제 데이터는 데이터베이스 테이블을 개입시켜 전송됩니다. 일반적으로, 조건명은 관련하는 릴레이션명과 같은 것이지만, 반드시 관련하는 릴레이션이 필요하지는 않습니다.
libpq어플리케이션은 보통의 SQL에 의한 쿼리와 같이LISTEN와 UNLISTEN커맨드를 발행할 수 있습니다.
NOTIFY메세지의 도착은 계속되어PQnotifies를 호출하면 검출할 수 있습니다.
PQnotifies는 서버로부터 수신한 통보 메세지의 처리되지 않은 리스트로부터 다음의 통보를 리턴받습니다.
보류 중인 통보가 없으면 null 포인터를 반환합니다.
PQnotifies 가 통보를 돌려주면, 그 통보는 처리된 것으로 인식되고 통보 리스트에서 제거됩니다.
PGnotify *PQnotifies(PGconn *conn);
typedef struct pgNotify {
char *relname; /* notification condition name */
int be_pid; /* process ID of notifying server process */
char *extra; /* notification parameter */
} PGnotify;
-->
char *relname; /* 통보 조건명 */
int be_pid; /* 통보하는 서버 프로세스의 프로세스 ID */
char *extra; /* 통보 파라미터 */
} PGnotify;
PQnotifies로 반환된PGnotify오브젝트의 처리가 끝나면, PQfreemem를 사용해 확실히 해제해 주십시요.
PGnotify 포인터를 해제하는 것은 중요합니다.
relname와 extra필드는 다른 할당을 나타내고 있지 않습니다.
(현재, extra필드는 사용되지 않고, 항상 비여있는 문자열의 포인터가 됩니다. )
Example 29-2는 비동기 통보를 사용한 샘플 프로그램을 나타내고 있습니다.
PQnotifies()는 실제로 서버의 데이터를 읽어내는 것은 아닙니다.
이것은 단지, 다른libpq함수가 흡수했던 통보 메세지를 반환할 뿐입니다.
libpq 이전 릴리스에서는 통보 메세지를 적절한 시점에 확실히 받으려면 , 빈 쿼리라도 일정시간마다 보내고,
PQexec()를 실행할 때마다PQnotifies()를 체크할 수 밖에 없었습니다.
지금도 이 방법은 동작하지만, 처리 능력이 낭비 되므로 그만두어야 합니다.
실행해야 할 쿼리가 없을 때 통보 메세지를 체크하는 좋은 방법은 우선PQconsumeInput()를 호출하고 PQnotifies()를 체크하는 것입니다.
서버로부터의 데이터의 도착을select()로 기다릴 수 있어, 불필요한 동작으로CPU파워를 소비해 버리는 일이 없습니다
(select()를 사용하는 파일 기술자의 번호 취득에 대해서는 PQsocket()를 참조해 주십시요).
덧붙여 이것은 쿼리에PQsendQuery와 PQgetResult를 사용했을 때도, 친숙한PQexec를 사용했을 때도 동작합니다.
그러나 통보가 커맨드의 처리 중에 도착하는지 아닌지, PQgetResult나 PQexec의 실행 마다PQnotifies()를 조사하는 것을 잊지 않도록 해야합니다.