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

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

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

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

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

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

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

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

모든 배열 항목과 확장된 와이즈 토토 문자열을 처리한 후 설정되지 않은 상태로 남아 있는 모든 와이즈 토토 매개변수는 기본값으로 채워집니다. 설정되지 않은 매개변수의 해당 환경 변수(참조PostgreSQL : 문서 : 9.5 : 환경 롤 토토)이 설정되면 해당 값이 사용됩니다. 환경 변수도 설정되지 않은 경우 매개변수에 내장된 기본값이 사용됩니다.

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

PGconn *PQconnectdb(const char *conninfo);

This function opens a new database connection using the parameters taken from the string콘인포.

전달된 문자열은 모든 기본 매개변수를 사용하기 위해 비어 있을 수 있습니다. 또는 공백으로 구분된 하나 이상의 매개변수 설정을 포함할 수 있습니다. 또는 다음을 포함할 수 있습니다.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다양한 제한 사항이 충족되는 한 차단됩니다.

• 그호스트주소그리고호스트매개변수는 이름 및 역방향 이름 쿼리가 수행되지 않도록 적절하게 사용됩니다. 다음 매개변수에 대한 문서를 참조하세요.섹션 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와이즈 토토 문자열에 문제가 있는 경우. 이 함수는를 추출하는 데 사용할 수 있습니다.PQconnectdb29980_30065PQconninfo옵션null이 있는 항목으로 끝나는 구조키워드포인터.

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

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