| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 29. libpq - C 라이브러리 | Fast Forward | Next |
본 절에서 설명하는 함수를 사용하여, 클라이언트 어플리케이션은 서버로 처리 중인 커맨드를 취소하는 요구를 실시할 수 있습니다.
PQgetCancel
특정한 데이터베이스 접속을 통해 발행된 커맨드를 취소하기 위해 필요한 정보를 가지는 데이터 구조를 생성합니다.
PGcancel *PQgetCancel(PGconn *conn);
PQgetCancel는 주어진PGconn접속 오브젝트의PGcancel
오브젝트를 생성합니다.
주어진conn가 NULL이나 잘못된 접속이었을 경우, NULL이 반환됩니다.
PGcancel오브젝트는 불투명한 구조로, 어플리케이션으로부터 직접 액세스 할 수 없는 것을 뜻합니다.
이것은PQcancel나 PQfreeCancel에 건네줄 수 밖에 없습니다.
PQfreeCancel
PQgetCancel로 생성된 데이터 구조를 해제합니다.
void PQfreeCancel(PGcancel *cancel);
PQfreeCancel는 사전에PQgetCancel로 생성된 데이터 오브젝트를 해제합니다.
PQcancel
서버에 현재의 커맨드의 폐기 처리를 요구합니다.
int PQcancel(PGcancel *cancel, char *errbuf, int errbufsize);
취소 요청이 수락되면 1을, 그렇지 않으면 0을 반환합니다. 실패했을 경우, errbuf에 그 원인을 나타내는 에러 메세지가 채워집니다. errbuf는 errbufsize크기의 문자 배열이 아니면 안됩니다. (추천 크기는 256바이트입니다. )
그러나 요청이 수락됐다고 해도, 그 요청의 효과가 나오는 것은 전혀 보증되지 않습니다. 만약 취소 요청이 유효하면, 현재의 커맨드는 머지않아 중단되어 에러가 결과적으로 돌아갑니다. 취소 조작에 실패했을 경우(즉 서버가 벌써 커맨드 처리를 종료하고 있었기 때문에), 눈에 보이는 결과는 아무것도 나오지 않게 됩니다.
errbuf가 시그널 핸들러 내의 로컬 변수이면, PQrequestCancel는 시그널 핸들러로부터 기동해도 문제 없습니다.
PQcancel의 실행중, PGcancel는 read만입니다.
따라서, PGconn오브젝트를 조작하는 thread와 다른 thread로부터 이 함수를 호출할 수도 있습니다.
PQrequestCancel
서버에 현재의 커맨드의 폐기 처리를 요구합니다.
int PQrequestCancel(PGconn *conn);
PQrequestCancel는 PQcancel의 변형이며 폐지된 것입니다.
이것은PGconn오브젝트를 직접 취급하고, 실패했을 경우 에러 메세지는 PGconn오브젝트 내에 저장됩니다.
(PQerrorMessage에 의해 꺼낼 수 있습니다. )
기능적으로는 동일하지만, PGconn의 에러 메세지가 겹쳐 써지는 것으로, 그 접속으로 현재 진행 중인 조작이 망가져 버리기 때문에,
이 방법은 복수 thread 프로그램이나 시그널 핸들러에서 문제가 일어납니다.