31.1. 데이터베이스 범퍼카 토토 제어 기능

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

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

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

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

언제expand_dbname는 0이 아닙니다.dbname키워드 값은 연결 문자열로 인식 될 수 있습니다. 의 첫 번째 사건 만dbname이런 식으로 확장됩니다.dbname값은 일반 데이터베이스 이름으로 처리됩니다. 가능한 범퍼카 토토 문자열 형식에 대한 자세한 내용은에 표시됩니다.섹션 31.1.1.

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

매개 변수가있는 경우NULL또는 emptry 문자열, 해당 환경 변수 (참조PostgreSQL : 문서 : 9.4 : 환경 범퍼카 토토)가 확인되었습니다. 환경 변수가 설정되지 않으면 표시된 내장 기본값이 사용됩니다.

일반적으로 키워드는이 배열의 시작부터 색인 순서대로 처리됩니다. 이것의 효과는 키워드가 반복 될 때 마지막 처리 된 값이 유지된다는 것입니다. 따라서 신중한 배치를 통해dbname키워드, a에 의해 무엇이 상정 될 수 있는지 판단 할 수 있습니다.Conninfo문자열, 그렇지 않은 것.

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

pgconn *pqconnectdb (const char *conninfo);

이 함수는 문자열에서 가져온 매개 변수를 사용하여 새 데이터베이스 범퍼카 토토을 엽니 다Conninfo.

전달 된 문자열은 모든 기본 매개 변수를 사용하기 위해 비어 있거나 Whitespace로 분리 된 하나 이상의 매개 변수 설정을 포함하거나 A를 포함 할 수 있습니다uri. 보다섹션 31.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, 데이터베이스 범퍼카 토토은에서 가져온 매개 변수를 사용하여 이루어집니다.키워드and값배열 및 제어expand_dbname, 위에서 설명한대로PQCONNECTDBPARAMS.

withPQConnectStart, 데이터베이스 범퍼카 토토은 문자열에서 가져온 매개 변수를 사용하여 만들어집니다Conninfo위에서 설명한대로PQCONNECTDB.

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

• the​​hostaddrandhost매개 변수는 이름과 반대 이름 쿼리가 만들어지지 않도록 적절하게 사용됩니다. 이 매개 변수의 문서를 참조하십시오섹션 31.1.2자세한 내용.

• 전화하면pqtrace, 추적하는 스트림 객체가 차단되지 않도록하십시오.

• 전화하기 전에 소켓이 적절한 상태인지 확인PQConnectPoll, 아래 설명 된대로.

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

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

ifPQConnectStart성공, 다음 단계는 여론 조사입니다libpq범퍼카 토토 순서를 진행할 수 있도록. 사용pqsocket (conn)데이터베이스 연결 기본 소켓의 설명자를 얻으려면. 따라서 루프 : ifpqconnectpoll (conn)마지막 반품pgres_polling_reading, 소켓이 읽을 준비가 될 때까지 기다리십시오 (select (), poll ()또는 유사한 시스템 기능). 그런 다음 호출pqconnectpoll (conn)다시. 반대로, ifpqconnectpoll (conn)마지막 반품pgres_polling_writing, 소켓이 쓸 준비가 될 때까지 기다렸다가 전화pqconnectpoll (conn)다시. 아직 전화하지 않은 경우pqconnectpoll, 즉 호출 직후PQConnectStart, 마지막으로 반환 된 것처럼 행동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.

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 *pqconninfo (pgconn *conn);

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

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

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

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

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

iferrmsgnull,*errmsg로 설정되었습니다NULL성공에 관한 것, 그렇지 않으면Malloc'd 오류 문자열 문제를 설명합니다. (또한 가능합니다*errmsg로 설정하려면null그리고 반환 할 함수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.