데이터베이스 서버에 새로운 연결을 만듭니다.

PGconn *PQconnectdbParams(const char * const *keywords,
                          const char * const *값,
                          int 확장_db이름);

이 함수는 두 매개변수에서 가져온 매개변수를 스포츠 토토 베트맨하여 새 데이터베이스 연결을 엽니다.NULL-종료된 어레이. 첫 번째,키워드은 문자열 배열로 정의되며 각 문자열은 키워드입니다. 두 번째,값, 각 키워드의 값을 제공합니다. 달리PQsetdb로그인아래에서 매개변수 세트는 함수 서명을 변경하지 않고 확장될 수 있으므로 이 함수(또는 비차단 아날로그)를 사용합니다.PQconnectStartParams그리고PQconnectPoll)는 새로운 애플리케이션 프로그래밍에 선호됩니다.

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

전달된 배열은 모든 기본 매개변수를 스포츠 토토 베트맨하기 위해 비어 있거나 하나 이상의 매개변수 설정을 포함할 수 있습니다. 길이가 일치해야 합니다. 처리가 처음부터 중지됩니다.NULL항목키워드배열. 또한 만약에값비-와 연관된 항목NULL 키워드항목은NULL또는 빈 문자열인 경우 해당 항목은 무시되고 다음 배열 항목 쌍으로 처리가 계속됩니다.

언제expand_dbname0이 아닌 경우 첫 번째 값db이름키워드가 다음과 같은지 확인합니다.연결 문자열. 그렇다면 그렇군요“확장”문자열에서 추출된 개별 연결 매개변수로. 값에 등호()가 포함된 경우 데이터베이스 이름이 아닌 연결 문자열로 간주됩니다.=) 또는 URI 체계 지정자로 시작됩니다. (연결 문자열 형식에 대한 자세한 내용은 다음에 나와 있습니다.섹션 32.1.1.) 첫 번째 발생만db이름이런 방식으로 처리됩니다. 모든 후속db이름매개변수는 일반 데이터베이스 이름으로 처리됩니다.

일반적으로 매개변수 배열은 처음부터 끝까지 처리됩니다. 키워드가 반복되면 마지막 값(즉,NULL또는 비어 있음)이 사용됩니다. 이 규칙은 특히 연결 문자열에서 발견된 키워드가에 나타나는 키워드와 충돌할 때 적용됩니다.키워드배열. 따라서 프로그래머는 배열 항목을 연결 문자열에서 가져온 값으로 재정의하거나 재정의할 수 있는지 여부를 결정할 수 있습니다. 확장 앞에 나타나는 배열 항목db이름항목은 연결 문자열의 필드로 재정의될 수 있으며, 해당 필드는 다음에 나타나는 배열 항목으로 재정의됩니다.DB이름(그러나 해당 항목이 비어 있지 않은 값을 제공하는 경우에만 해당).

모든 배열 항목과 확장된 연결 문자열을 처리한 후 설정되지 않은 상태로 남아 있는 모든 연결 매개변수는 기본값으로 채워집니다. 설정되지 않은 매개변수의 해당 환경 변수(참조PostgreSQL : 문서 : 17 : 32.15. 환경 배트맨 토토)가 설정되면 해당 값이 스포츠 토토 베트맨됩니다. 환경 변수도 설정되지 않은 경우 매개변수에 내장된 기본값이 스포츠 토토 베트맨됩니다.

데이터베이스 서버에 새로운 연결을 만듭니다.

PGconn *PQconnectdb(const char *conninfo);

이 함수는 문자열에서 가져온 매개변수를 스포츠 토토 베트맨하여 새 데이터베이스 연결을 엽니다.콘인포.

전달된 문자열은 모든 기본 매개변수를 사용하기 위해 비어 있을 수 있습니다. 또는 공백으로 구분된 하나 이상의 매개변수 설정을 포함할 수 있습니다. 또는 다음을 포함할 수 있습니다.URI. 참조섹션 32.1.1자세한 내용은.

데이터베이스 서버에 새로운 연결을 만듭니다.

PGconn *PQsetdbLogin(const char *pghost,
                     const char *pgport,
                     const char *pgoptions,
                     const char *pgtty,
                     const char *db이름,
                     const char *로그인,
                     const char *pwd);

이것은 다음의 전신입니다.PQconnectdb고정된 매개변수 세트를 스포츠 토토 베트맨합니다. 누락된 매개변수가 항상 기본값을 스포츠 토토 베트맨한다는 점을 제외하면 동일한 기능을 갖습니다. 쓰다NULL또는 기본값으로 설정될 고정 매개변수 중 하나에 대한 빈 문자열입니다.

만약에db이름포함=서명하거나 유효한 연결이 있음URI접두사, 다음과 같이 간주됩니다.콘인포문자열은 전달된 것과 똑같은 방식으로PQconnectdb, 나머지 매개변수는 지정된 대로 적용됩니다.PQconnectdbParams.

pgtty은 더 이상 스포츠 토토 베트맨되지 않으며 전달된 모든 값은 무시됩니다.

데이터베이스 서버에 새로운 연결을 만듭니다.

PGconn *PQsetdb(char *pghost,
                char *pgport,
                char *pgoptions,
                문자 *pgtty,
                char *dbName);

이것은 호출하는 매크로입니다PQsetdb로그인에 대한 널 포인터 포함로그인그리고비밀번호매개변수. 아주 오래된 프로그램과의 호환성을 위해 제공됩니다.

비차단 방식으로 데이터베이스 서버에 연결하십시오.

PGconn *PQconnectStartParams(const char * const *키워드,
                             const char * const *값,
                             int 확장_db이름);

PGconn *PQconnectStart(const char *conninfo);

PostgresPollingStatusType PQconnectPoll(PGconn *conn);

이 세 가지 기능은 데이터베이스 서버에 대한 연결을 여는 데 사용되며 그렇게 하는 동안 원격 I/O에서 애플리케이션의 실행 스레드가 차단되지 않습니다. 이 접근 방식의 요점은 I/O가 완료될 때까지 기다리는 시간이 내부가 아닌 애플리케이션의 메인 루프에서 발생할 수 있다는 것입니다.PQconnectdbParams또는PQconnectdb따라서 애플리케이션은 다른 활동과 동시에 이 작업을 관리할 수 있습니다.

함께PQconnectStartParams, 데이터베이스 연결은에서 가져온 매개변수를 스포츠 토토 베트맨하여 이루어집니다.키워드그리고값배열 및 제어expand_dbname, 위에서 설명한 대로PQconnectdbParams.

함께PQconnectStart, 문자열에서 가져온 매개변수를 스포츠 토토 베트맨하여 데이터베이스 연결이 이루어집니다.콘인포위에 설명된 대로PQconnectdb.

둘 다 아님PQconnectStartParams아니요PQconnectStart아니요PQconnectPoll다양한 제한 사항이 충족되는 한 차단됩니다.

비차단 연결 요청을 시작하려면 다음을 호출하세요.PQconnectStart또는PQconnectStartParams. 결과가 null이면, 다음은libpq새로운 할당을 할 수 없습니다PGconn구조. 그렇지 않으면 유효한PGconn포인터가 반환됩니다(아직 데이터베이스에 대한 유효한 연결을 나타내지는 않지만). 다음 통화PQ상태(conn). 결과가 다음과 같다면CONNECTION_BAD, 연결 시도가 이미 실패했습니다. 일반적으로 잘못된 연결 매개변수로 인해 발생합니다.

만약PQconnectStart또는PQconnectStartParams성공, 다음 단계는 설문 조사입니다.libpq그래서 연결 순서를 진행할 수 있습니다. 스포츠 토토 베트맨PQsocket(콘)데이터베이스 연결의 기반이 되는 소켓의 설명자를 가져옵니다. (주의: 소켓이 동일하게 유지된다고 가정하지 마십시오.PQconnectPoll호출.) 다음과 같이 반복하세요: IfPQconnectPoll(conn)마지막 반환PGRES_POLLING_READING, 소켓이 읽을 준비가 될 때까지 기다립니다(다음으로 표시됨).선택(), 설문조사()또는 유사한 시스템 기능). 참고하세요PQsocketPoll설정을 추상화하여 상용구를 줄이는 데 도움이 될 수 있습니다.선택(2)또는설문조사(2)귀하의 시스템에서 스포츠 토토 베트맨할 수 있는 경우. 그럼 전화하세요PQconnectPoll(conn)다시. 반대로 만약에PQconnectPoll(conn)마지막 반환PGRES_POLLING_WRITING, 소켓이 쓸 준비가 될 때까지 기다린 후 호출PQconnectPoll(conn)다시. 첫 번째 반복에서, 즉 아직 전화하지 않은 경우PQconnectPoll, 마지막으로 반환된 것처럼 동작PGRES_POLLING_WRITING. 다음까지 이 루프를 계속하세요.PQconnectPoll(conn)반환PGRES_POLLING_FAILED, 연결 절차가 실패했음을 나타냄, 또는PGRES_POLLING_OK, 연결이 성공적으로 이루어졌음을 나타냅니다.

연결 중 언제든지 호출을 통해 연결 상태를 확인할 수 있습니다.PQ상태. 이 호출이 반환되는 경우CONNECTION_BAD, 연결 절차가 실패했습니다. 전화가 돌아오면CONNECTION_OK이면 연결이 준비된 것입니다. 이 두 상태는 모두 반환 값에서 동일하게 감지할 수 있습니다.PQconnectPoll, 위에 설명되어 있습니다. 비동기 연결 절차 중에(및 도중에만) 다른 상태가 발생할 수도 있습니다. 이는 연결 절차의 현재 단계를 나타내며 예를 들어 스포츠 토토 베트맨자에게 피드백을 제공하는 데 유용할 수 있습니다. 상태는 다음과 같습니다.

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

스위치(PQstatus(conn))

        사례 CONNECTION_STARTED:
            Feedback = "연결 중...";
            부서지다;

        사례 CONNECTION_MADE:
            Feedback = "서버에 연결되었습니다...";
            부서지다;
.
.
.
        기본값:
            Feedback = "연결 중...";

그connect_timeout스포츠 토토 베트맨 시 연결 매개변수가 무시됩니다.PQconnectPoll; 과도한 시간이 경과했는지 여부를 결정하는 것은 애플리케이션의 책임입니다. 그렇지 않으면,PQconnectStart다음에 aPQconnectPoll루프는 다음과 같습니다.PQconnectdb.

언제든지 주의하세요PQconnectStart또는PQconnectStartParams널이 아닌 포인터를 반환합니다. 호출해야 합니다.PQfinish작업이 끝나면 구조 및 관련 메모리 블록을 폐기하기 위해. 연결 시도가 실패하거나 중단된 경우에도 이 작업을 수행해야 합니다.

다음으로 검색된 연결의 기본 소켓 설명자를 폴링PQsocket. 이 함수의 주요 용도는 다음 문서에 설명된 연결 순서를 반복하는 것입니다.PQconnectStartParams.

typedef pg_int64 pg_usec_time_t;

int PQsocketPoll(int sock, int forRead, int forWrite,
                 pg_usec_time_t end_time);

이 함수는 파일 설명자 폴링을 수행하며 선택적으로 시간 초과가 포함됩니다. 만약에forRead이 0이 아닌 경우 소켓을 읽을 준비가 되면 함수가 종료됩니다. 만일forWrite이 0이 아닌 경우, 소켓이 쓰기 준비가 되면 함수가 종료됩니다.

시간 초과는 다음에 의해 지정됩니다.종료_시간, Unix epoch 이후 마이크로초 단위로 표시되는 대기를 중지하는 시간입니다(즉,time_t회 100만). 다음의 경우 시간 초과는 무한합니다.종료_시간is-1. end_time이 다음과 같은 경우 시간 초과가 즉시 발생합니다(차단 없음).0(또는 실제로는 지금 이전 어느 때라도). 시간 초과 값은 원하는 마이크로초 수를 결과에 추가하여 편리하게 계산할 수 있습니다.PQgetCurrentTimeUSec. 기본 시스템 호출의 정밀도는 마이크로초 미만일 수 있으므로 실제 지연이 부정확할 수 있습니다.

함수는 다음보다 큰 값을 반환합니다.0지정된 조건이 충족되면0시간 초과가 발생한 경우 또는-1오류가 발생한 경우. 오류는 다음을 확인하여 검색할 수 있습니다.errno(3)값. 두 경우 모두forRead그리고forWrite0이면 함수는 즉시 시간 초과 표시를 반환합니다.

PQsocketPoll다음 중 하나를 사용하여 구현됩니다.설문조사(2)또는선택(2), 플랫폼에 따라 다름. 참조폴린그리고폴아웃에서설문조사(2)또는readfds그리고writefds에서선택(2), 자세한 정보는.

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

PQconninfoOption *PQconndefaults(void);

typedef 구조체

    char *키워드;   /* 옵션의 키워드 */
    char *envvar;    /* 대체 환경 변수 이름 */
    char *컴파일됨;  /* 기본값으로 컴파일된 폴백 */
    char *발;       /* 옵션의 현재 값, 또는 NULL */
    char *레이블;     /* 연결 대화 상자의 필드 레이블 */
    char *dispchar;  /* 이 필드를 표시하는 방법을 나타냅니다.
                          연결 대화 상자에서. 값은 다음과 같습니다.
                          "" 입력된 값을 그대로 표시
                          "*" 비밀번호 필드 - 값 숨기기
                          "D" 디버그 옵션 - 기본적으로 표시되지 않음 */
    int dispsize;  /* 대화상자의 필드 크기(문자) */
 PQconninfoOption;

연결 옵션 배열을 반환합니다. 이는 가능한 모든 것을 결정하는 데 사용될 수 있습니다.PQconnectdb옵션 및 현재 기본값. 반환 값은의 배열을 가리킵니다.PQconninfo옵션null이 있는 항목으로 끝나는 구조키워드포인터. 메모리를 할당할 수 없으면 널 포인터가 반환됩니다. 현재 기본값(발필드)는 환경 변수 및 기타 컨텍스트에 따라 달라집니다. 누락되거나 유효하지 않은 서비스 파일은 자동으로 무시됩니다. 호출자는 연결 옵션 데이터를 읽기 전용으로 처리해야 합니다.

옵션 배열을 처리한 후 다음으로 전달하여 해제하십시오.PQconninfoFree. 그렇지 않으면 호출할 때마다 소량의 메모리가 누출됩니다.PQconndefaults.

실시간 연결에 사용되는 연결 옵션을 반환합니다.

PQconninfo옵션 *PQconninfo(PGconn *conn);

연결 옵션 배열을 반환합니다. 이는 가능한 모든 것을 결정하는 데 사용될 수 있습니다.PQconnectdb옵션 및 서버에 연결하는 데 사용된 값. 반환 값은의 배열을 가리킵니다.PQconninfo옵션null이 있는 항목으로 끝나는 구조키워드포인터. 위의 모든 참고사항은PQconndefaults다음 결과에도 적용PQconninfo.

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

PQconninfoOption *PQconninfoParse(const char *conninfo, char **errmsg);

연결 문자열을 구문 분석하고 결과 옵션을 배열로 반환합니다. 또는 반품NULL연결 문자열에 문제가 있는 경우. 이 함수는를 추출하는 데 사용할 수 있습니다.PQconnectdb39890_39975PQconninfo옵션null이 있는 항목으로 끝나는 구조키워드포인터.

모든 적법한 옵션이 결과 배열에 표시되지만PQconninfo옵션연결 문자열에 없는 옵션의 경우발다음으로 설정됨NULL; 기본값은 삽입되지 않습니다.

만약errmsg아닙니다NULL그러면*errmsg다음으로 설정됨NULL성공 시, 그렇지 않으면 amalloc40655_40722*errmsg다음으로 설정됨NULL및 반환할 함수NULL; 이는 메모리 부족 상태를 나타냅니다.)

옵션 배열을 처리한 후 다음으로 전달하여 해제하십시오.PQconninfoFree. 그렇지 않으면 호출할 때마다 일부 메모리가 누수됩니다.PQconninfoParse. 반대로 오류가 발생하면errmsg아닙니다NULL, 다음을 사용하여 오류 문자열을 해제해야 합니다.PQfreemem.

서버 연결을 종료합니다. 또한에서 사용하는 메모리를 해제합니다.PGconn객체.

void PQfinish(PGconn *conn);

서버 연결 시도가 실패하더라도 (다음으로 표시됨)PQ상태), 애플리케이션은 호출해야 합니다.PQfinish다음에서 사용하는 메모리를 해제합니다.PGconn객체.PGconn포인터는 이후에 다시 스포츠 토토 베트맨되어서는 안 됩니다.PQfinish호출되었습니다.

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

void PQreset(PGconn *conn);

이 함수는 서버에 대한 연결을 닫고 이전에 사용된 것과 동일한 매개변수를 모두 사용하여 새 연결 설정을 시도합니다. 이는 작동 중인 연결이 끊어진 경우 오류 복구에 유용할 수 있습니다.

비차단 방식으로 서버와의 통신 채널을 재설정합니다.

int PQresetStart(PGconn *conn);

PostgresPollingStatusType PQresetPoll(PGconn *conn);

이 함수는 서버에 대한 연결을 닫고 이전에 사용된 것과 동일한 매개변수를 모두 사용하여 새 연결 설정을 시도합니다. 이는 작동 중인 연결이 끊어진 경우 오류 복구에 유용할 수 있습니다. 그들은 다음과 다릅니다.PQreset(위)는 비차단 방식으로 작동한다는 점입니다. 이러한 함수에는 다음과 같은 제한이 적용됩니다.PQconnectStartParams, PQconnectStart그리고PQconnectPoll.

연결 재설정을 시작하려면 다음을 호출하세요.PQresetStart. 0을 반환하면 재설정이 실패한 것입니다. 1이 반환되면 다음을 사용하여 재설정을 폴링합니다.PQresetPoll다음을 사용하여 연결을 생성하는 것과 정확히 같은 방식으로PQconnectPoll.

PQpingParams서버의 상태를 보고합니다. 다음과 동일한 연결 매개변수를 허용합니다.PQconnectdbParams, 위에 설명되어 있습니다. 서버 상태를 얻기 위해 올바른 스포츠 토토 베트맨자 이름, 비밀번호 또는 데이터베이스 이름 값을 제공할 필요는 없습니다. 그러나 잘못된 값이 제공되면 서버는 실패한 연결 시도를 기록합니다.

PGPing PQpingParams(const char * const *키워드,
                    const char * const *값,
                    int 확장_db이름);

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

PQ핑서버의 상태를 보고합니다. 다음과 동일한 연결 매개변수를 허용합니다.PQconnectdb, 위에 설명되어 있습니다. 서버 상태를 얻기 위해 올바른 스포츠 토토 베트맨자 이름, 비밀번호 또는 데이터베이스 이름 값을 제공할 필요는 없습니다. 그러나 잘못된 값이 제공되면 서버는 실패한 연결 시도를 기록합니다.

PGPing PQping(const char *conninfo);

반환 값은 다음과 동일합니다.PQpingParams.

PQsetSSLKeyPassHook_OpenSSL애플리케이션을 재정의할 수 있습니다.libpq's암호화된 클라이언트 인증서 키 파일의 기본 처리스포츠 토토 베트맨 중ssl비밀번호또는 대화형 메시지.

void PQsetSSLKeyPassHook_OpenSSL(PQsslKeyPassHook_OpenSSL_type 후크);

응용프로그램은 서명이 있는 콜백 함수에 대한 포인터를 전달합니다:

int callback_fn(char *buf, int 크기, PGconn *conn);

어떤libpq그런 다음 전화하겠습니다대신기본값PQdefaultSSLKeyPassHook_OpenSSL처리자. 콜백은 키의 비밀번호를 결정하고 이를 결과 버퍼에 복사해야 합니다.buf크기크기. 문자열은bufNull로 종료되어야 합니다. 콜백은 다음에 저장된 비밀번호의 길이를 반환해야 합니다.buf널 종결자를 제외합니다. 실패 시 콜백이 설정되어야 합니다.buf[0] = '\0'그리고 0을 반환합니다. 참조PQdefaultSSLKeyPassHook_OpenSSLinlibpq의 소스 코드 예시입니다.

스포츠 토토 베트맨자가 명시적인 키 위치를 지정한 경우 해당 경로는 다음과 같습니다.conn-sslkey콜백이 호출될 때. 기본 키 경로를 사용하는 경우에는 비어 있습니다. 엔진 지정자인 키의 경우, 다음을 사용할지 여부는 엔진 구현에 달려 있습니다.오픈SSL비밀번호 콜백을 사용하거나 자체 처리를 정의하세요.

앱 콜백은 처리되지 않은 사례를 위임하도록 선택할 수 있습니다.PQdefaultSSLKeyPassHook_OpenSSL또는 먼저 호출한 후 0이 반환되면 다른 것을 시도하거나 완전히 재정의하세요.

콜백해서는 안 됩니다예외가 있는 일반적인 흐름 제어를 탈출합니다.longjmp(...)등 정상적으로 반환되어야 합니다.

PQgetSSLKeyPassHook_OpenSSL현재 클라이언트 인증서 키 비밀번호 후크를 반환합니다. 또는NULL아무것도 설정되지 않은 경우.

PQsslKeyPassHook_OpenSSL_type PQgetSSLKeyPassHook_OpenSSL(void);