31.1. 데이터베이스 배트맨 토토 제어 기능

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

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

이 기능은 두 가지에서 가져온 매개 변수NULL-종료 배열. 첫 번째,키워드는 다음과 같이 정의됩니다 문자열의 배열, 각 배열은 핵심 단어입니다. 두 번째,값, 각 키 단어의 값을 제공합니다. 같지 않은pqsetdblogin아래, 기능을 변경하지 않고 매개 변수 세트를 확장 할 수 있습니다 서명 이므로이 기능 (또는 비 차단 아날로그 사용PQConnectStartParamsandpqconnectpoll)는 새로운 응용 프로그램에 선호됩니다 프로그램 작성.

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

언제expand_dbname는 0이 아니며dbname키워드 값이 허용됩니다 연결 문자열로 인식됩니다. 의 첫 번째 사건 만dbname이런 식으로 확장됩니다 후속dbname값은 처리됩니다 일반 데이터베이스 이름. 가능한 배트맨 토토 문자열에 대한 자세한 내용 형식은에 나타납니다.섹션 31.1.1.

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

매개 변수가 지정되지 않은 경우 해당 환경 변수 (참조PostgreSQL : 문서 : 9.3 : 환경 사설 토토)가 확인됩니다. 환경 변수가 설정되지 않은 경우 어느 쪽이든, 표시된 내장 기본값이 사용됩니다.

일반적으로 키워드는이 시작부터 처리됩니다. 인덱스 순서대로 배열. 이것의 효과는 핵심 단어 일 때입니다 반복되면, 마지막 처리 된 값이 유지됩니다. 그러므로, 신중한 배치를 통해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여러 번 차단됩니다 제한이 충족됩니다 :

• thehostaddrandhost매개 변수는 적절하게 사용하여 보장합니다 그 이름과 반대 이름 쿼리는 만들어지지 않습니다. 참조 이 매개 변수의 문서화섹션 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구조 NULL이있는 항목으로 끝납니다키워드포인터.

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

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

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

서버 배트맨 토토을 닫습니다. 또한 사용 된 메모리를 해방시킵니다 그만큼pgconn개체.

void pqfinish (pgconn *conn);

서버 배트맨 토토 시도가 실패하더라도 표시PQSTATUS), 응용 프로그램은 전화해야합니다pqfinishto 에서 사용하는 메모리를 무료pgconn개체. 그만큼pgconn포인터가되어서는 안됩니다 이후에 다시 사용pqfinish라고 불리는.

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

void pqreset (pgconn *conn);

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

블로킹을하지 않은 상태에서 통신 채널을 서버로 재설정합니다. 방법.

int pqresetstart (pgconn *conn);

postgrespollingstatustype pqresetpoll (pgconn *conn);

이 기능은 서버에 대한 연결을 닫고 동일한 서버에 대한 새로운 연결을 다시 설정하려고 시도합니다. 이전에 사용한 모든 동일한 매개 변수. 이것은 유용 할 수 있습니다 작업 연결이 손실되면 오류 복구. 그들은 다릅니다pqreset(위) a에서 행동한다는 점에서 비 차단 방식. 이러한 기능은 동일하게 고통받습니다 제한PQConnectStartParams, PQConnectStartandPQConnectPoll.

연결 재설정을 시작하려면 CallPQRESETSTART. 0을 반환하면 재설정이 있습니다 실패한. 1을 반환하면를 사용하여 재설정을 폴링합니다pqresetpoll정확히 같은 방식으로 를 사용하여 배트맨 토토을 만듭니다.PQConnectPoll.

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

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

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

pqping섬기는 사람. 배트맨 토토 매개 변수를 동일한 배트맨 토토 매개 변수와 동일하게 허용합니다.PQCONNECTDB, 위에서 설명합니다. 그것은 올바른 사용자 이름, 암호 또는 데이터베이스를 제공 할 필요가 없습니다. 서버 상태를 얻기위한 이름 값; 그러나 잘못된 경우 값이 제공되며 서버는 실패한 연결을 기록합니다. 시도.

pgping pqping (const char *conninfo);

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