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

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

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

이 함수는 다음을 사용하여 새 데이터베이스 배트맨 토토을 엽니다. 두 개에서 가져온 매개변수NULL-종료됨 배열. 첫 번째,키워드은 다음과 같이 정의됩니다. 문자열 배열로, 각 문자열은 키워드입니다. 두 번째,값, 각 키워드의 값을 제공합니다. 달리PQsetdb로그인아래, 기능을 변경하지 않고도 매개변수 세트를 확장할 수 있습니다. 서명이므로 이 함수(또는 비차단 유사 함수)를 사용하세요.PQconnectStartParams그리고PQconnectPoll14516_14565

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

언제expand_dbname0이 아닙니다.db이름키워드 값은 다음과 같습니다. 배트맨 토토 문자열로 인식됩니다. 첫 번째 발생만db이름이런 식으로 확장됩니다. 후속db이름값은 다음과 같이 처리됩니다. 일반 데이터베이스 이름. 가능한 배트맨 토토 문자열에 대한 자세한 내용 형식은 다음에 표시됩니다.섹션 31.1.1.

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

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

일반적으로 키워드는 이러한 단어의 시작 부분부터 처리됩니다. 인덱스 순서대로 배열. 이것의 효과는 키워드가 반복되면 마지막으로 처리된 값이 유지됩니다. 그러므로, 신중한 배치를 통해db이름키워드, a로 재정의할 수 있는 항목을 결정하는 것이 가능합니다.콘인포문자열이며 그렇지 않을 수도 있습니다.

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

PGconn *PQconnectdb(const char *conninfo);

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

모든 기본 매개변수를 사용하려면 전달된 문자열이 비어 있을 수 있습니다. 또는 로 구분된 하나 이상의 매개변수 설정을 포함할 수 있습니다. 공백 또는 다음을 포함할 수 있습니다.URI. 참조섹션 31.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.

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

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

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

비차단 모드에서 데이터베이스 서버에 배트맨 토토합니다. 방식.

PGconn *PQconnectStartParams(const char * const *keywords,
                             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수만큼 차단됩니다. 제한 사항이 충족되었습니다:

• 그hostaddr그리고호스트매개변수는 다음을 위해 적절하게 사용됩니다. 해당 이름 및 역이름 쿼리는 수행되지 않습니다. 참조 이러한 매개변수에 대한 문서는섹션 31.1.2용 세부사항.

• 부르신다면PQtrace, 다음을 확인하세요. 추적하는 스트림 개체는 차단되지 않습니다.

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

참고: 다음의 사용PQconnectStartParams유사함PQconnectStart표시됨 아래.

비차단 배트맨 토토 요청을 시작하려면 다음을 호출하세요.conn = PQconnectStart("connection_info_string"). 만일콘null이면libpq새로운 할당을 할 수 없습니다PGconn구조. 그렇지 않으면 유효한PGconn포인터가 반환됩니다(그렇지는 않지만 아직 데이터베이스에 대한 유효한 배트맨 토토을 나타냅니다). 돌아올 때 에서PQconnectStart, 전화상태 = PQ상태(conn). 만일상태같음CONNECTION_BAD, PQconnectStart실패했습니다.

만약PQconnectStart성공했습니다. 다음 단계는 여론 조사입니다.libpq그래서 배트맨 토토 순서를 진행할 수 있습니다. 사용PQsocket(콘)설명자를 얻으려면 데이터베이스 배트맨 토토의 기반이 되는 소켓입니다. 다음과 같이 반복하세요: IfPQconnectPoll(conn)마지막 반환PGRES_POLLING_READING, 소켓을 읽을 준비가 되었습니다(다음으로 표시됨).선택(), 설문조사(), 또는 유사한 시스템 기능). 그럼 전화하세요PQconnectPoll(conn)다시. 반대로 만약에PQconnectPoll(conn)마지막 반환PGRES_POLLING_WRITING, 소켓이 쓰기 준비가 된 후 호출PQconnectPoll(conn)다시. 아직 전화PQconnectPoll, 즉, 직후 호출PQconnectStart, 다음과 같이 행동합니다. 마지막으로 반환된 경우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널이 아닌 포인터를 반환합니다. 호출해야 합니다.PQfinish작업이 끝나면 순서대로 구조 및 관련 메모리 블록을 폐기합니다. 이 배트맨 토토 시도가 실패하거나 실패하더라도 수행되어야 합니다. 버려졌습니다.

기본 배트맨 토토 옵션을 반환합니다.

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있는 경우 배트맨 토토 문자열에 문제가 있습니다. 이 기능은 다음과 같은 용도로 사용할 수 있습니다. 추출하다PQconnectdb옵션 제공된 배트맨 토토 문자열. 반환 값은 배열을 가리킵니다. 의PQconninfo옵션구조, 이는 null이 있는 항목으로 끝납니다.키워드포인터.

모든 적법한 옵션이 결과 배열에 표시되지만PQconninfo옵션모든 옵션에 대해 배트맨 토토 문자열에 있는 내용은 다음과 같습니다.발다음으로 설정됨NULL; 기본값 값은 삽입되지 않습니다.

만약errmsg아닙니다NULL그러면*errmsg다음으로 설정됨NULL성공 시, 그렇지 않으면 amalloc30460_30527*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이름);

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

PQping상태를 보고합니다. 서버. 다음과 동일한 배트맨 토토 매개변수를 허용합니다.PQconnectdb, 위에 설명되어 있습니다. 그것은 올바른 사용자 이름, 비밀번호 또는 데이터베이스를 제공할 필요는 없습니다. 서버 상태를 얻기 위한 이름 값; 그러나 틀린 경우 값이 제공되면 서버는 배트맨 토토 실패를 기록합니다. 시도합니다.

PGPing PQping(const char *conninfo);

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