| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 29. libpq - C 라이브러리 | Fast Forward | Next |
이하의 환경 변수를 사용하고, 호출되는 소스로 직접 값를 지정하지 않은 경우, 접속 파라미터의 디폴트 값를 선택할 수 있습니다.
이 값은 PQconnectdb, PQsetdbLogin및, PQsetdb 로 사용됩니다.
예를 들면, 간단한 클라이언트 어플리케이션에서는 데이터베이스 접속 정보를 직접 프로그램에 기술하지 않는 것이 편리합니다.
PGHOST는 데이터베이스 서버명을 설정합니다. slash로 시작되는 경우는 TCP/IP통신이 아닌 Unix 도메인 소켓 통신을 지정한 것이 됩니다. 이 때의 값은 소켓 파일이 저장되는 디렉토리명입니다(디폴트의 인스톨시 설정은 /tmp입니다).
PGHOSTADDR는 데이터베이스 서버의 IP주소 수치를 지정합니다.
PGHOST대신 설정하거나 PGHOST에 추가해, DNS 검색에 필요로 하는 오버헤드를 피할 수 있습니다.
이 상호작용에 대한 자세한 사항은 , 파라미터에 대한 문서, 위의PQconnectdb를 참조해 주십시요.
PGHOST나 PGHOSTADDR도 설정되어 있지 않은 경우, 디폴트의 동작은 로컬인 Unix 도메인 소켓에 접속하는 것입니다. 다만, Unix 도메인 소켓을 가지지 않는 머신에서는 libpq가 localhost의 접속을 시도합니다.
PGPORT는 PostgreSQL서버와 통신하기 위한 디폴트의 TCP 포트 번호나 Unix 도메인 소켓 파일의 확장자(extension)를 설정합니다.
PGPASSWORD는 서버가 패스워드 인증을 요구하는 경우에 사용되는 패스워드를 설정합니다. 이 환경 변수는 보안상의 이유(일부 operating system에서는 root가 아닌 유저가ps커맨드를 거쳐 환경 변수를 볼 수 있기 때문에)로 현재는 추천 되고 있지 않습니다. 대신에~/. pgpass를 사용하는 것을 검토해 주십시요. (Section 29.13를 참조해 주십시요. )
패스워드 파일의 이름을 지정합니다. 지정되지 않았다면, 디폴트의 ~/. pgpass 가 됩니다. (자세한 사항은 Section 29.13 을 참조해 주십시요).
PGSERVICE는 pg_service.conf내에서 검색되는 서비스명을 설정합니다. 이는 모든 파라미터 설정을 간단히 하는 방법을 제공합니다.
PGREALM는 PostgreSQL의 Kerberos realm이 로컬과 다른 경우, 그 realm을 설정합니다. PGREALM가 설정되면, libpq어플리케이션은 설정된 realm의 서버와 인증을 실시하고, 다른 티켓 파일을 사용하여, 로컬의 티켓 파일과 충돌하지 않게 합니다. 이 환경 변수는 서버가 Kerberos에 의한 인증을 선택했을 경우에만 사용됩니다.
PGSSLMODE는 서버와의 SSL접속 조정을 실시할지와 우선 순위를 결정합니다. 4개의 모드가 있습니다. disable는 암호화되지 않는 SSL접속만을 시도합니다. allow에서의 조정은 우선 SSL이 아닌 접속이 시도되어 실패했을 경우에SSL접속을 시도합니다. prefer(디폴트)에서의 조정은 우선SSL접속이 시도되어 실패했을 경우, 일반적인 SSL이 아닌 접속을 시도합니다. require에서는 SSL만이 시도됩니다. PostgreSQL가 SSL 서포트없이 컴파일 되고 있을 때 require를 사용하면 에러가 납니다. allow와 prefer옵션은 받아들일 수 있지만, 실제로는 libpq는 SSL접속을 시도하지 않습니다.
PGREQUIRESSL는 SSL를 거치는 접속이 필수인지를 지정합니다. "1"으로 지정하면, 서버가SSL접속을 받아들이지 않는 경우에, libpq는 접속을 거절합니다. (sslmode prefer 와 같습니다. ) 이 옵션은 sslmode설정을 위해 폐기되고, SSL 서포트로 PostgreSQL가 컴파일 되었을 경우에만 이용할 수 있습니다.
PGKRBSRVNAME는 인증으로 Kerberos 를 이용하는 경우, 사용되는 Kerberos 서비스명을 지정합니다.
PGCONNECT_TIMEOUT는 libpq가 PostgreSQL서버로의 접속 확립을 기다리는 최대 초 수를 지정합니다. 설정되지 않았거나 0으로 설정했을 경우, libpq는 무한정 대기합니다. 이 대기 시간은 2초 미만으로 설정하는 것은 추천되지 않습니다.
이하의 환경 변수를 사용하고, PostgreSQL세션 마다 디폴트 동작을 지정할 수 있습니다. (또한, 유저나 데이터베이스를 단위로 한 디폴트 동작의 설정 방법에 대해서는 ALTER USER 및 ALTER DATABASE 커맨드를 참조해 주십시요. )
PGDATESTYLE 는 날짜/시간의 디폴트 형식을 설정합니다. (SET datestyle TO ...과 동일합니다.)
PGCLIENTENCODING 는 디폴트 클라이언트의 캐릭터 세트 인코딩 방식을 지정합니다. (SET client_encoding TO ...과 동일합니다. )
PGGEQO는 유전적 쿼리 옵티마이저의 디폴트 모드를 설정합니다. (SET geqo TO ...과 동일합니다. )
이러한 환경 변수의 정확한 값에 대해서는 SET SQL커맨드를 참조해 주십시요.
이하의 환경 변수는 libpq의 내부 동작을 결정합니다. 이것들은 컴파일시의 디폴트에 겹쳐쓰여 집니다.