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

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

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

현재 인식 된 매개 변수 키워드는에 나열되어 있습니다.섹션 33.1.2.

전달 된 배열은 모든 기본 매개 변수를 사용하기 위해 비어 있거나 하나 이상의 매개 변수 설정을 포함 할 수 있습니다. 길이가 일치해야합니다. 처리가 첫 번째로 중지됩니다NULL입력키워드배열. 또한값비와 관련된 입력NULL 키워드Entry isNULL또는 빈 문자열, 해당 항목이 무시되고 다음 배열 항목 쌍으로 처리됩니다.

언제expand_dbname는 0이 아니며 첫 번째 값dbname키워드가 확인되어토토 결과 문자열. 그렇다면“확장”문자열에서 추출한 개별 연결 매개 변수로. 값은 동일한 부호를 포함하는 경우 데이터베이스 이름이 아닌 토토 결과 문자열로 간주됩니다 (=) 또는 URI 체계 지정자로 시작합니다. (토토 결과 문자열 형식에 대한 자세한 내용은섹션 33.1.1.) 첫 번째 발생dbname이런 식으로 처리됩니다. 모든 후속dbname매개 변수는 일반 데이터베이스 이름으로 처리됩니다.

일반적으로 매개 변수 배열은 처음부터 끝까지 처리됩니다. 키워드가 반복되면 마지막 값 (그렇지 않습니다NULL또는 빈)가 사용됩니다. 이 규칙은 특히 토토 결과 문자열에서 발견 된 핵심 단어가에 나타나는 것과 충돌 할 때 적용됩니다.키워드배열. 따라서 프로그래머는 토토 결과 문자열에서 가져온 값에 의해 배열 항목이 재정의 할 수 있는지 또는 재정의 할 수 있는지 결정할 수 있습니다. 확장 전에 나타나는 배열 항목dbnameConnection String의 필드에 의해 입력을 무효화 할 수 있으며, 그 결과 그 필드는 이후에 나타나는 배열 항목에 의해 무시됩니다.dbname(그러나 그 항목이 비어 있지 않은 값을 공급하는 경우에만).

모든 배열 항목과 확장 된 토토 결과 문자열을 처리 한 후에는 UNSET를 유지하는 연결 매개 변수는 기본값으로 채워집니다. UNSET 매개 변수의 해당 환경 변수 인 경우 (참조PostgreSQL : 문서 : 10 : 33.14. 환경 와이즈 토토)가 설정되어 있고 그 값이 사용됩니다. 환경 변수가 설정되지 않으면 매개 변수의 내장 기본값이 사용됩니다.

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

pgconn *pqconnectdb (const char *conninfo);

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

전달 된 문자열은 모든 기본 매개 변수를 사용하기 위해 비어 있거나 Whitespace로 분리 된 하나 이상의 매개 변수 설정을 포함하거나 A를 포함 할 수 있습니다uri. 보다섹션 33.1.1자세한 내용.

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

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포함=서명 또는 유효한 연결uri접두사, A로 간주됩니다.Conninfo통과 된 것과 정확히 같은 방식으로 문자열pqconnectdb, 나머지 매개 변수는 지정된대로 적용됩니다.PQCONNECTDBPARAMS.

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

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

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

블로킹하지 않은 방식으로 데이터베이스 서버에 토토 결과합니다.

PGCONN *PQCONNECTSTARTPARAMS (const char *const *키워드,
                             const char * const * 값,
                             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.

아니PQConnectStartParamsNORPQConnectStartNORpqconnectpoll여러 제한 사항이 충족되는 한 차단됩니다.

블로킹되지 않은 토토 결과 요청을 시작하려면 전화PQConnectStart또는PQConnectStartParams. 결과가 null이면libpq새로운 것을 할당 할 수 없었습니다pgconn구조. 그렇지 않으면 유효한pgconn포인터가 반환되었습니다 (아직 데이터베이스에 대한 유효한 연결을 나타내지는 않지만). 다음 호출pqstatus (conn). 결과가 인 경우Connection_Bad, 일반적으로 유효하지 않은 토토 결과 매개 변수로 인해 토토 결과 시도가 이미 실패했습니다.

ifPQConnectStart또는PQConnectStartParams성공, 다음 단계는 투표하는 것입니다libpq토토 결과 순서를 진행할 수 있도록. 사용pqsocket (conn)데이터베이스 토토 결과 기본 소켓의 설명자를 얻으려면. (주의 : 소켓이 동일하게 남아 있다고 가정하지 마십시오pqconnectpoll전화.) 루프 : ifpqconnectpoll (conn)마지막 반품pgres_polling_reading, 소켓이 읽을 준비가 될 때까지 기다리십시오 (select (), poll ()또는 유사한 시스템 기능). 그런 다음 호출pqconnectpoll (conn)다시. 반대로, ifpqconnectpoll (conn)마지막 반품pgres_polling_writing, 소켓이 쓸 준비가 될 때까지 기다렸다가 전화pqconnectpoll (conn)다시. 첫 번째 반복에서, 즉 아직 전화하지 않은 경우pqconnectpoll, 마지막으로 반환 된 것처럼 행동pgres_polling_writing. 이 루프를 계속할 때까지PQConnectPoll (Conn)반환pgres_polling_failed, 토토 결과 절차가 실패했음을 나타내거나pgres_polling_ok, 토토 결과이 성공적으로 이루어 졌음을 나타냅니다.

연결하는 동안 언제든지 연결 상태를 호출하여 확인할 수 있습니다PQSTATUS. 이 호출이 반환되는 경우Connection_Bad, 연결 절차가 실패했습니다. 통화가 반환되는 경우Connection_ok, 연결이 준비되었습니다. 이 두 상태는의 반환 값에서 똑같이 감지 할 수 있습니다.pqconnectpoll, 위에서 설명한. 다른 상태는 또한 비동기 연결 절차 중에 발생할 수 있습니다. 이는 연결 절차의 현재 단계를 나타내며 예를 들어 사용자에게 피드백을 제공하는 데 유용 할 수 있습니다. 이 상태는 다음과 같습니다.

이러한 상수는 (호환성을 유지하기 위해)이 상수가 유지되지만 응용 프로그램은 특정 순서 또는 전혀 또는 상태가 항상 문서화 된 값 중 하나 인 상태에 의존해서는 안됩니다. 응용 프로그램은 다음과 같은 일을 할 수 있습니다.

스위치 (pqstatus (conn))

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

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

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

PQConnectStart또는PQConnectStartParams널이 아닌 포인터를 반환하면 전화해야합니다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 *pqconninfo (pgconn *conn);

연결 옵션 배열을 반환합니다. 이것은 가능한 모든 것을 결정하는 데 사용할 수 있습니다PQCONNECTDB옵션 및 서버에 연결하는 데 사용 된 값. 반환 값은 배열을 가리 킵니다pqconninfooption구조.키워드포인터. 위의 모든 노트pqconndefaults또한 결과에 적용PQCONNINFO.

제공된 토토 결과 문자열에서 구문 분석 옵션을 반환합니다.

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

토토 결과 문자열을 구문 분석하고 결과 옵션을 배열로 반환합니다. 또는 반환NULL토토 결과 문자열에 문제가있는 경우. 이 기능은를 추출하는 데 사용될 수 있습니다.pqconnectdb제공된 토토 결과 문자열의 옵션. 반환 값은 배열을 가리 킵니다pqconninfooption구조.키워드포인터.

모든 법적 옵션이 결과 배열에 존재하지만pqconninfooption토토 결과 문자열에 존재하지 않는 옵션의 경우val설정NULL; 기본값은 삽입되지 않습니다.

iferrmsgNULL,*errmsgnull성공에, 그렇지 않으면Malloc'D 오류 문자열 문제를 설명합니다. (또한 가능합니다*errmsgNULL그리고 반환 할 함수NULL; 이것은 메모리 외 상태를 나타냅니다.)

옵션 배열을 처리 한 후 옵션을 전달하여PQCONNINFOFREE. 이 작업이 완료되지 않으면 각 호출마다 일부 메모리가 유출됩니다PQCONNINFOPARSE. 반대로 오류가 발생하면errmsgNULL,를 사용하여 오류 문자열을 제거하십시오PQFREEMEM.

서버 토토 결과을 닫습니다. 또한에 사용 된 메모리를 해방합니다.pgconn개체.

void pqfinish (pgconn *conn);

서버 토토 결과 시도가 실패하더라도 (PQSTATUS), 응용 프로그램은 전화해야합니다pqfinishpgconn개체. 그만큼pgconn포인터는 다시 사용해서는 안됩니다pqfinish호출.

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

void pqreset (pgconn *conn);

이 기능은 서버에 대한 연결을 닫고 이전에 사용한 모든 매개 변수를 사용하여 새로운 연결을 설정하려고 시도합니다. 작업 연결이 손실되면 오류 복구에 유용 할 수 있습니다.

블로킹하지 않은 방식으로 통신 채널을 서버로 재설정하십시오.

int pqresetstart (pgconn *conn);

postgrespollingstatustype pqresetpoll (pgconn *conn);

이러한 기능은 서버에 대한 연결을 닫고 이전에 사용한 동일한 매개 변수를 사용하여 새 연결을 설정하려고 시도합니다. 작업 연결이 손실되면 오류 복구에 유용 할 수 있습니다. 그들은 다릅니다pqreset(위) 비 블로킹 방식으로 작용한다는 점에서. 이러한 기능은와 동일한 제한을 겪습니다.PQConnectStartParams, PQConnectStart및pqconnectpoll.

연결 재설정을 시작하려면 CallPQRESETSTART. 0을 반환하면 재설정이 실패했습니다. 1을 반환하면를 사용하여 재설정을 폴링합니다pqresetpoll|PQConnectPoll.

pqpingparams서버의 상태를보고합니다. 토토 결과 매개 변수를 동일한 토토 결과 매개 변수와 동일하게 허용합니다.PQCONNECTDBPARAMS, 위에서 설명합니다. 서버 상태를 얻기 위해 올바른 사용자 이름, 암호 또는 데이터베이스 이름 값을 제공 할 필요는 없습니다. 그러나 잘못된 값이 제공되면 서버는 실패한 연결 시도를 기록합니다.

pgping pqpingparams (const char * const * 키워드,
                    const char * const * 값,
                    int expand_dbname);

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

pqping서버의 상태를보고합니다. 토토 결과 매개 변수를 동일한 토토 결과 매개 변수와 동일하게 허용합니다.PQCONNECTDB, 위에서 설명합니다. 서버 상태를 얻기 위해 올바른 사용자 이름, 암호 또는 데이터베이스 이름 값을 제공 할 필요는 없습니다. 그러나 잘못된 값이 제공되면 서버는 실패한 연결 시도를 기록합니다.

pgping pqping (const char *conninfo);

반환 값은와 동일합니다pqpingparams.