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

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

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

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

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

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

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

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

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

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

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포함=서명 또는 유효한 연결uriPrefix, 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여러 제한 사항이 충족되는 한 차단됩니다.

• thehostaddrand호스트매개 변수는 이름과 리버스 이름 쿼리가 만들어지지 않도록 적절하게 사용됩니다. 이 매개 변수의 문서를 참조하십시오섹션 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, PQConnectStartandPQConnectPoll.

연결 재설정을 시작하려면 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.