31.1. 데이터베이스 윈 토토 제어 기능

데이터베이스 서버에 새로운 윈 토토을합니다.

pgconn *pqconnectdbparams (const char ** 키워드, const char ** 값, int expand_dbname);

이 기능은 The를 사용하여 새 데이터베이스 윈 토토을 엽니 다 두 가지에서 가져온 매개 변수NULL-종결 된 배열. 첫 번째,키워드, 문자열 배열로 정의됩니다. 각각은 핵심 단어입니다. 두 번째,값, 각 키 단어의 값을 제공합니다. 같지 않은pqsetdblogin아래, 매개 변수 세트는 변경하지 않고 확장 될 수 있습니다 기능 서명 이므로이 기능 (또는 그 기능을 사용하십시오 비 차단 아날로그PQConnectStartParamsandPQConnectPoll)는 새로 선호됩니다 응용 프로그램 프로그래밍.

언제expand_dbname는 0이 아닙니다. 그만큼dbname키워드 값은입니다 A로 인정받을 수 있습니다Conninfo문자열. 아래를 참조하십시오 세부.

전달 된 배열은 모든 기본값을 사용하기 위해 비어있을 수 있습니다. 매개 변수 또는 하나 이상의 매개 변수 설정을 포함 할 수 있습니다. 길이가 일치해야합니다. 처리는 중지됩니다 마지막 비NULL요소키워드배열.

현재 인식 된 매개 변수 키 단어는 다음과 같습니다.

매개 변수가 지정되지 않은 경우 해당 환경 변수 (참조섹션 31.13)가 확인되었습니다. 만약 환경 변수도 설정되지 않으며 표시됩니다 내장 기본값이 사용됩니다.

ifexpand_dbname는 0이 아닙니다 그리고dbname포함=사인, A로 간주됩니다.Conninfo정확히 같은 방식으로 문자열 통과 된 경우PQCONNECTDB(아래 참조). 이전에 처리 된 키워드는의 핵심 단어로 무시됩니다ConninfoStri윈 토토.

일반적으로 키워드는 시작부터 처리됩니다. 이 배열은 색인 순서입니다. 이것의 효과는 그것입니다 키워드가 반복되면 마지막 처리 된 값은 유지. 따라서 신중한 배치를 통해dbname키워드, 가능합니다 a에 의해 재정의 할 수있는 것을 결정하려면Conninfo문자열, 그렇지 않은 것.

데이터베이스 서버에 새로운 윈 토토을합니다.

pgconn *pqconnectdb (const char *conninfo);

이 기능은 The를 사용하여 새 데이터베이스 연결을 엽니 다 문자열에서 가져온 매개 변수Conninfo.

전달 된 문자열은 모든 기본값을 사용하기 위해 비어있을 수 있습니다. 매개 변수 또는 하나 이상의 매개 변수를 포함 할 수 있습니다 중학교로 분리 된 설정. 각 매개 변수 설정입니다 형식으로키워드 = value. 동일한 부호 주변의 공간은 선택 사항입니다. 글을 쓰기 위해 빈 값 또는 공백이 포함 된 값은 단일 따옴표, 예 :키워드 = 'a 값'. 값 내의 단일 따옴표 및 백 슬래시 백 슬래시로 탈출해야합니다.\ '및\\.

현재 인식 된 매개 변수 키워드는입니다 위와 동일.

데이터베이스 서버에 새로운 윈 토토을합니다.

pgconn *pqsetdblogin (const char *pghost,
                     const char *pgport,
                     const char *pgoptions,
                     const char *pgtty,
                     const char *dbname,
                     const char *로그인,
                     const char *pwd);

이것은의 전임자입니다.PQCONNECTDB고정 된 세트가 있습니다 매개 변수. 그 기능을 제외하고는 동일한 기능이 있습니다 누락 된 매개 변수는 항상 기본값을 사용합니다. 쓰다NULL또는 빈 문자열 고정 된 매개 변수 중 하나 기본값.

dbname포함=사인, A로 간주됩니다.Conninfo정확히 같은 방식으로 문자열 통과 된 경우PQCONNECTDB및 나머지 매개 변수 그런 다음 위와 같이 적용됩니다.

데이터베이스 서버에 새로운 윈 토토을합니다.

pgconn *pqsetdb (char *pghost,
                char *pgport,
                char *pgoptions,
                char *pgtty,
                char *dbname);

이것은 호출하는 매크로입니다pqsetdblogin로그인및PWD매개 변수. 그것은 제공됩니다 아주 오래된 프로그램과의 역 호환성.

a 비 차단 방식.

PGCONN *PQCONNECTSTARTPARAMS (Const Char ** 키워드,
                             const char ** 값,
                             int expand_dbname);

pgconn *pqconnectstart (const char *conninfo);

postgrespollingstatustype pqconnectpoll (pgconn *conn);

이 세 기능은 응용 프로그램의 스레드가되도록 데이터베이스 서버 그렇게하는 동안 원격 I/O에서 실행이 차단되지 않습니다. 그만큼 이 접근법의 요점은 I/O가 대기하는 것입니다. 오히려 애플리케이션의 기본 루프에서 완료가 발생할 수 있습니다 내부 아래에서PQCONNECTDBPARAMS또는PQCONNECTDB, 따라서 응용 프로그램이 가능합니다 이 작업을 다른 작업과 병렬로 관리하십시오 활동.

withPQConnectStartParams, 데이터베이스 연결은 취한 매개 변수를 사용하여 이루어집니다 에서키워드및값배열 및 제어expand_dbname, 위에서 설명한대로pqconnectdbparams.

withPQConnectStart, 데이터베이스 연결은 가져온 매개 변수를 사용하여 작성됩니다 문자열Conninfo설명대로 위의PQCONNECTDB.

아니PQConnectStartParamsNORPQConnectStartNORpqconnectpolla 제한 수준이 충족됩니다 :

• thehostaddrand호스트매개 변수는 적절하게 사용됩니다 해당 이름과 반대 이름 쿼리가 만들어진. 아래 에서이 매개 변수의 문서를 참조하십시오PQCONNECTDBPARAMS위 자세한 내용은.

• 전화하면pqtrace, 추적하는 스트림 객체가 차단하지 않습니다.

• 소켓이 적절한 지 확인하십시오 전화 전 상태PQCONNECTPOLL43838_43873

참고 : 사용PQConnectStartParams와 유사합니다PQConnectStart표시 아래에.

비 차단 윈 토토 요청을 시작하려면 전화conn = pqConnectStart ( "Connection_info_string"). 만약에connlibpq할당 할 수 없었습니다 새로운pgconn구조. 그렇지 않으면 유효한pgconn포인터가 반환되었습니다 (아직 유효한 것을 나타내지는 않지만 데이터베이스 연결). 에서 돌아온시PQConnectStart, Call상태 = pqstatus (conn). 만약에상태equalsConnection_Bad, PQConnectStart실패했습니다.

ifPQConnectStart성공, 다음 단계는 투표하는 것입니다libpq연결 순서. 사용pqsocket (conn)설명자를 얻으려면 데이터베이스 연결의 기본 소켓 고리 따라서 : ifpqconnectpoll (conn)마지막 반품pgres_polli윈 토토_readi윈 토토, 소켓까지 기다리십시오 읽을 준비가되었습니다 (select (), poll ()또는 유사한 시스템 기능). 그 다음에 부르다pqconnectpoll (conn)다시. 반대로, ifpqconnectpoll (conn)마지막 반품pgres_polli윈 토토_writi윈 토토, 기다릴 때까지 기다리십시오 소켓이 쓸 준비가되었고 전화pqconnectpoll (conn)다시. 당신이 있다면 아직 전화 할 것PQCONNECTPOLL, 즉, 호출 직후PQConnectStart는 마치 마치 마치 마치 행동합니다 반품pgres_polli윈 토토_writi윈 토토. 이 루프를 계속할 때까지PQConnectPoll (Conn)반환pgres_polli윈 토토_failed, 윈 토토 절차가 실패했거나pgres_polli윈 토토_ok, 윈 토토을 나타냅니다 성공적으로 만들어졌습니다.

언제든지 연결하는 동안 언제든지 연결을 호출하여 확인할 수 있습니다PQSTATUS. 이 호출이 반환되는 경우Connection_Bad, 그런 다음 연결 절차 실패했다. 통화가 반환되는 경우Connection_ok, 연결은입니다 준비가 된. 이 두 상태는 모두에서 똑같이 감지 할 수 있습니다 반환 값PQConnectPoll, 위에서 설명합니다. 다른 상태는 또한 (그리고 중에 만 발생할 수 있습니다 비동기 연결 절차. 이것들은 연결 절차의 현재 단계 예를 들어 사용자에게 피드백을 제공하는 데 유용합니다. 이것들 상태는 :

이 상수는 여전히 남아 있지만 (in 호환성을 유지하기 위해), 응용 프로그램이어야합니다 특정 순서로 발생하지 않거나 전혀, 또는 상태가 항상 이들 중 하나입니다. 문서화 된 값. 응용 프로그램은 같은 일을 할 수 있습니다 이것:

스위치 (pqstatus (conn))

        Case Connection_Started :
            피드백 = "연결 ...";
            부서지다;

        Case Connection_Made :
            피드백 = "서버에 연결되어 ...";
            부서지다;
.
.
.
        기본:
            피드백 = "연결 ...";

theConnect_Timeout연결 를 사용할 때 매개 변수는 무시됩니다PQCONNECTPOLL; 응용 프로그램입니다 과도한 양의 양을 결정해야 할 책임 시간이 경과했습니다. 그렇지 않으면,PQConnectStart뒤 따르는pqconnectpoll루프는에 해당합니다.PQCONNECTDB.

ifPQConnectStart널을 반환합니다 포인터, 전화해야pqfinish당신이 그것을 끝내면, 구조와 관련된 구조를 폐기하기 위해 메모리 블록. 윈 토토하더라도 수행해야합니다 시도는 실패하거나 포기됩니다.

기본 연결 옵션을 반환합니다.

pqconninfooption *pqconndefaults (void);

typedef struct

    char *키워드;   / * 옵션 키워드 */
    char *envvar;    / * 폴백 환경 변수 이름 */
    char *편집;  / * 기본값으로 컴파일 된 폴백 */
    char *val;       / * 옵션의 현재 값 또는 null */
    숯 *레이블;     / * 연결 대화 상자에서 필드에 대한 레이블 */
    char *dispchar;  /*이 필드를 표시하는 방법을 나타냅니다
                          연결 대화 상자에서. 값은 다음과 같습니다.
                          ""디스플레이가 그대로 입력되었습니다
                          "*"비밀번호 필드 - 값 숨기기
                          "D"디버그 옵션 - 기본적으로 표시하지 마십시오 */
    int dispsize;  / * 대화 상자의 문자의 필드 크기 */
 pqconninfooption;

연결 옵션 배열을 반환합니다. 이것은 사용될 수 있습니다 가능한 모든 결정PQCONNECTDB옵션 및 현재 기본값. 반환 값은 배열을 가리 킵니다pqconninfooption구조, 널이있는 항목으로 끝납니다키워드포인터. 널 포인터는입니다 메모리를 할당 할 수없는 경우 반환되었습니다. 주목하십시오 현재 기본값 값 (val필드)는 환경 변수 및 기타에 따라 다릅니다 문맥. 발신자는 연결 옵션 데이터를 처리해야합니다 읽기 전용.

옵션 배열을 처리 한 후 전달하여 자유롭게 해방하십시오PQCONNINFOFREE. 이 경우 완료되지 않으면, 소량의 메모리가 각각에 유출됩니다. 전화pqconndefaults.

제공된 연결 옵션을 반환합니다 연결 문자열.

pqconninfooption *pqconninfoparse (const char *conninfo, char ** errmsg);

연결 문자열을 구문 분석하고 결과를 반환합니다 배열로서의 옵션; 또는 반환null연결 문자열. 이 기능은를 추출하는 데 사용될 수 있습니다.PQCONNECTDB연결 문자열 제공. 반환 값은 배열pqconninfooption구조.키워드포인터.

문자열은 결과 배열에 값이 설정됩니다. 아니요 기본값이 삽입됩니다.

iferrmsgNULL,*errmsg로 설정되었습니다NULL성공에 대한 에이Malloc'd 오류 문자열 문제를 설명합니다. (또한 가능합니다*errmsg로 설정하려면NULL그리고 반환 할 함수NULL; 이것은 메모리가 아닌 것을 나타냅니다 상태.)

옵션 배열을 처리 한 후 전달하여 자유롭게 해방하십시오PQCONNINFOFREE. 이 경우 완료되지 않고, 각 호출마다 일부 메모리가 유출됩니다PQCONNINFOPARSE. 거꾸로, 오류가 발생하면errmsgIS 아니다NULL, 오류를 제거하십시오 사용PQFREEMEM.

서버에 대한 연결을 닫습니다. 또한 메모리를 해방시킵니다 에 의해 사용pgconn개체.

void pqfinish (pgconn *conn);

서버 윈 토토 시도가 실패하더라도 주목하십시오 (에 표시된대로PQSTATUS), 신청서는 전화해야pqfinishpgconn개체. 그만큼pgconn포인터를 다시 사용해서는 안됩니다 후에pqfinish라고 불리는.

통신 채널을 서버로 재설정합니다.

void pqreset (pgconn *conn);

이 함수는 서버에 대한 연결을 닫습니다 그리고 같은 새로운 연결을 다시 설정하려고 이전에 사용한 동일한 매개 변수를 모두 사용하는 서버. 이것 작업 연결이 있으면 오류 복구에 유용 할 수 있습니다. 손실되었습니다.

통신 채널을 서버로 재설정하십시오 비 차단 방식.

int pqresetstart (pgconn *conn);

postgrespollingstatustype pqresetpoll (pgconn *conn);

이 기능은 서버에 대한 연결을 닫습니다 그리고 같은 새로운 연결을 다시 설정하려고 이전에 사용한 동일한 매개 변수를 모두 사용하는 서버. 이것 작업 연결이있는 경우 오류 복구에 유용 할 수 있습니다. 잃어버린. 그들은 다릅니다pqreset(위) a 비 차단 방식. 이러한 기능은 동일하게 고통받습니다 제한PQConnectStartParams, PQConnectStart및PQCONNECTPOLL.

윈 토토 재설정을 시작하려면 CallPQRESETSTART. 0을 반환하면 재설정 실패했습니다. 1을 반환하면를 사용하여 재설정을 폴링합니다PQRESETPOLL정확히 를 사용하여 연결을 생성하는 것과 마찬가지로pqconnectpoll.

pqpi윈 토토params보고서 서버의 상태. 연결 매개 변수를 허용합니다 와 동일합니다PQCONNECTDBPARAMS, 위에서 설명합니다. 그것은 그러나 올바른 사용자 이름을 공급할 필요는 없지만 서버를 얻기위한 비밀번호 또는 데이터베이스 이름 값 상태.

pgping pqpi윈 토토params (const char ** 키워드, const char ** 값, int expand_dbname);

함수는 다음 값 중 하나를 반환합니다.

pqpi윈 토토상태를보고합니다 서버의. 연결 매개 변수를 동일하게 허용합니다PQCONNECTDB, 위에서 설명했습니다. 그러나 공급할 필요는 없습니다 올바른 사용자 이름, 암호 또는 데이터베이스 이름 값으로 서버 상태를 얻으십시오.

pgping pqpi윈 토토 (const char *conninfo);

반환 값은와 동일합니다pqpi윈 토토params.