| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
postgres는,PostgreSQL의 데이터 베이스 서버입니다. 클라이언트 애플리케이션이 데이터베이스에 접속하기 위해서는, 가동중의postgres인스턴스에(네트워크 또는 로컬로) 접속할 필요가 있습니다. 그 후,postgres는 접속을 취급하기 위해서 분리된 서버 프로세스를 개시합니다.
1개의postgres인스턴스는 항상 1개의 데이터베이스 클러스터의 데이터를 관리합니다.. 데이터베이스 클러스터란, 공통의 파일 시스템 영역("데이터 영역")에 저장되고 있는 데이터베이스의 집합입니다. 1개의 시스템상에서, 동시에 1개 이상의 postmaster인스턴스를 실행하는 것은 가능하지만, 그것들은 다른 데이터 영역과 다른 접속 포트(아래와 같이 참조)를 사용할 필요한 만큼의 postgres가 데이터 영역의 장소를 모르면 안됩니다. 그 자리는 -D옵션 또는 PGDATA환경 변수에 의해 지정되어야 합니다. 기본값은 없습니다. 통상,-D 또는 PGDATA는, initdb에 의해 작성된 데이터 영역 디렉토리를 직접 지시합니다. 다른 가능한 파일 레이아웃은 Section 17.2(을)를 참조해 주세요.
기본값에서는 postgres는 foreground로 시작해 로그 메세지를 표준 에러 스트림에 출력합니다. 실질적으로 postgres애플리케이션은 아마 부팅시 배경 프로세서로서 기동될 것입니다.
또postgres는 싱글 유저 모드로 호출할 수도 있습니다. 이 모드는, 주로initdb에 의한 부트 스트랩 중에 사용됩니다. 이것을, 디버그나 재해로부터의 복구시에 사용할 수도 있습니다. (그러나, 실제로는 발생해야할 프로세스간 통신이나 락 처리가 발생하지 않으므로, 싱글 유저 모드가 서버의 디버그에 확실히 적합한 것이 아님을 주의해 주세요. ) 쉘로부터 싱글 유저 모드로 불려 갔을 경우, 사용자는 쿼리를 입력할 수 있습니다. 결과는 화면상에 표시됩니다만, 그 형식은 최종 사용자보다 개발자에게 더 유용합니다. 싱글 유저 모드에서는, 세션 유저는 유저 ID 1으로 설정되어 암묵적으로 슈퍼 유저의 능력이 이 유저에게 줄 수 있습니다. 이 유저는 실제로 존재하고 있지 않는 것을 ?고 있기 때문에 싱글 유저 모드는 시스템 카탈로그의 우발적인 손해의 등에서 수동으로 복구하기 위해서 사용할 수가 있습니다.
postgres에는, 아래와 같은 명령 라인 인수를 지정할 수 있습니다. 옵션에 관한 자세한 것은Chapter 17을 참조해 주세요. 또, 설정 파일에서 설정된 것에 의해 이것들을 입력하는 수고를 생략할 수가 있습니다. 일부의(안전한) 옵션은 그 세션에서만 적용되고 애플리케이션에 의존해 접속하고있는 클라이언트로부터 설정할 수도 있습니다. 예를 들어,PGOPTIONS환경 변수를 설정되면 libpq를 기본으로 한 클라이언트는 그 캐릭터 라인(string)을 서버에 건네줍니다. 건네받은 캐릭터 라인은postgres명령을 라인 옵션으로서 다루어집니다.
실행시에 assertion 체크를 실시해, 프로그램의 불편을 찾는데 디버그를 보조합니다. 이 옵션은,PostgreSQL의 컴파일시에 assertion가 유효하게 되었을 경우에게만, 사용 가능해집니다. 이 경우, 기본값으로 유효하게 됩니다.
서버 프로세스에 의해 사용하는 공유 버퍼의 수를 설정합니다. 이 매개변수의 기본값은 initdb에 의해 자동적으로 정해집니다. 더욱 많은 정보를 위해서 Section 17.4.1를 참조하십시오.
지정된 실행 매개변수를 설정합니다. PostgreSQL로 지원되는 구성 매개변수는Chapter 17으로 설명합니다. 실제로는, 대부분의 다른 명령을 라인 옵션은, 이러한 매개변수에의 할당을 간략화한 것입니다. -c는 복수의 매개변수를 설정하기 위해서 다중 시간으로 나타날 수 있습니다.
디버그 레벨을 설정합니다. 큰 값이 설정되어 있는 만큼, 보다 많은 디버그 정보가 서버의 로그에 출력됩니다. 값으로 해서 설정할 수 있는 범위는, 1에서 5까지입니다. 특정의 세션으로-d 0을 건네줄 수도 있습니다. 이 설정에 의해, 세션으로 전파되는 것으로부터 부모의postgres프로세스의 서버 로그 레벨이 이 세션에 전파 되지 않습니다.
파일 시스템상의 데이터 디렉토리의 장소나 구성 파일의 장소를 지정합니다. 자세한 것은Section 17.2을 참조해 주세요.
기본값의 일자 데이터 형식을"유럽식"으로 합니다. 이것에 의해, 일자의 입력시의 차례는DMY가 됩니다. 또, 일자의 출력시에도, 달의 전에 날의 출력 서식에서 표시되게 됩니다. 자세한 것은Section 8.5을 참조해 주세요.
퍼포먼스 향상을 위해서fsync호출을 무효로 합니다.
다만 이 경우, 시스템 크래쉬시에 데이터가 손상하는 위험성이 있습니다.
이 옵션의 지정은,fsync설정 매개변수를 무효로 하는 것으로 동일합니다.
이 옵션을 사용할 때는, 사전에 상세 정보가 쓰여진 문서를 읽어 주세요.
postgres가 클라이언트 애플리케이션으로부터 TCP/IP의 접속을 감시하는 IP호스트명 또는 IP주소를 지정합니다. 이 값에는 주소의 컴마로 나뉜 리스트나 모든 이용 가능한 인터페이스를 감시하는 것을 의미하는*로 될 수가 있습니다. 빈 값을 지정하면, IP주소를 전혀 감시하지 않는 것을 의미합니다. 이 경우, 서버에의 접속에는, Unix 도메인 소켓만이 사용됩니다. 기본값에서는 localhost만을 감시합니다. 이 옵션지정은listen_addresses설정 매개변수를 설정하는 것으로 동일합니다.
리모트 클라이언트로부터의 TCP/IP(인터넷 도메인) 경유의 접속을 가능케 합니다. 이 옵션을 설정하지 않는 경우에는, 로컬로부터의 접속만이 수락됩니다. 이 옵션은 postgresql.conf내의listen_addresses를 혹은 -h 를*로 설정하는 것으로 같은 의미를 가집니다.
이 옵션은 listen_addresses의 모든 기능을 실현할 수가 없기 때문에 폐지가 예정되어 있습니다. 통상은 직접listen_addresses를 설정하는 방법을 추천합니다.
postgres가 클라이언트 애플리케이션으로부터의 접속을 감시하는 Unix 도메인 소켓의 디렉토리를 지정합니다. 기본값에서는 통상/tmp가 되고 있지만, 이것은 구축시로 변경할 수 있습니다.
SSL를 사용해, 안전한 접속을 실시합니다. PostgreSQL는 이 옵션을 사용하기 위해서 SSL로 지원으로 컴파일이 되어져야 합니다. SSL의 사용에 관한 자세한 것은Section 16.7을 참조해 주세요.
이 서버가 받아들이는 클라이언트 접속수의 최대치를 설정합니다. 이 매개변수의 기본값은initdb에 의해 자동적으로 선택됩니다. 이 옵션의 지정은 max_connections설정 매개변수를 설정하는 것으로 같은 의미를 가집니다.
extra-options 로 지정된 명령 라인 옵션은 이postgres프로세스에 의해 시작된 모든 서버 프로세스에 인도해집니다. 이 옵션의 캐릭터 라인에 공백 문자가 포함되어 있는 경우에는 캐릭터 라인(string) 전체를 인용부호로 둘러쌀 필요가 있습니다.
이 옵션의 사용은 비추천입니다. 서버 프로세스의 모든 명령 라인 옵션은postgres명령을 라인으로 직접 지정할 수가 있습니다.
클라이언트 애플리케이션으로부터의 접속을 감시하는 postgres에 TCP/IP포트 또는 로컬 Unix 도메인 소켓 파일의 확장자(extension)를 지정합니다. PGPORT환경 변수,PGPORT가 설정되어 있지 않은 경우는 컴파일시로 설정된 값(통상 5432)이 기본값이 됩니다. 포트 이외를 지정했을 경우에는 명령을 라인 옵션 또는PGPORT를 사용해, 모든 클라이언트 애플리케이션이 같은 포트를 지정해야 합니다.
각 명령을의 종료시에 시간 정보나 다른 통계 정보를 표시합니다. 이것은 벤치마크나 버퍼수의 조정시의 사용에 적절합니다.
일시 디스크 파일로 재소트 처리를 실시하기 전에 내부적인 소트 처리나 해시 처리로 사용되는 메모리량을 지정합니다. Section 17.4.1의work_mem설정 매개변수의 설명을 참조해 주세요.
이름지어진 실행시 매개변수를 설정합니다. -c의 생략 형식입니다.
이 옵션은 서버의 내부 설정 변수 그 설명 및 탭 단락의COPY서식의 기본값을 덤프합니다. 이것은 관리 툴로부터의 사용을 주목적으로 해 설계되었습니다.
몇가지 다른 옵션은 상술되어지거나 디버그의 목적으로 사용되거나 심하게 손상된 데이터베이스의 복구를 지원하기 위해 사용됩니다. 제품 데이터베이스의 설치에는 그들이 사용하는 이유가 없어야 합니다. PostgreSQL 시스템 개발자에 의해 오직 사용되는것이 기술 되어 있습니다. 게다가 그 옵션의 어느 것이든 알림없이 릴리스가 미래에 사라지거나 변화할 수도 있습니다.
특정의 스캔과 결합 메소드의 사용을 금지합니다. s는 시퀀스 스캔,i는 인덱스 스캔을 무효로 합니다. n는 nested-loop 결합,m는 merge 결합,h는 해시 결합을 무효로 합니다.
시퀀셜 스캔과 nested-loop 결합은, 완전하게 무효로 할 수 없습니다. -fs옵션과-fn옵션은 만약 다른 선택사항이 있다면, 이러한 종류의 계획을 사용의 최적화를 낙담시키는 것입니다.
이것은 서버 프로세스가 이상종료(ABEND) 하는 문제를 디버그하기 위한 옵션입니다. 이러한 상태에서 보통의 전략은 모든 서버 프로세스를 종료한 후에 공유 메모리나 semaphore를 재초기화하도록 통지하는 것입니다. 종료하기 전에 오류가 있는 공유 상태를 가질 수 있었던 잘못된 서버 프로세스가 원인일지도 모릅니다. 이 옵션은 postgres가 공유 데이터 구조를 재초기화하지 않게 지정합니다. 지식이 있는 시스템 프로그래머이면, 그 후에 디버거를 사용해 공유 메모리나 semaphore 상태를 검증할 수가 있습니다.
시스템 테이블의 구조의 변경을 가능하게 합니다. 이것은initdb에 의해 사용됩니다.
시스템 테이블의 읽을 때에 시스템 인덱스를 무시합니다. (그러나, 시스템 테이블의 변경할 때 인덱스는 업데이트됩니다). 파손한 시스템 인덱스로부터 복구하는 경우에 유용합니다.
주요한 시스템 모듈에 관련하는 각각의 쿼리에 대해 시간에 관한 통계 정보를 표시합니다. 이 옵션은-s옵션과 함께 사용할 수 없습니다.
이것은 서버 프로세스가 이상종료(ABEND) 하는 문제를 디버그하기 위한 옵션입니다. 이러한 상태에서 보통의 전략은 모든 서버 프로세스를 종료한 후에 공유 메모리나 semaphore를 재초기화하도록 통지하는 것입니다. 종료하기 전에 오류가 있는 공유 상태를 가질 수 있었던 잘못된 서버 프로세스가 원인일지도 모릅니다. 이 옵션은,postgres가 SIGSTOP시그널을 송신해 다른 모든 서버 프로세스에 대해 종료시키는 것이 아니라 정지시키는 것을 지정합니다. 이것에 의해 시스템 프로그래머는 모든 서버 프로세스의 코어덤프를 수작업으로 수집할 수가 있습니다.
특정의 세션으로 사용되는 frontend/연구 최종 단계(backend) 프로토콜의 버젼 번호를 지정합니다. 이 옵션은 내부 사용만을 목적으로 한 것입니다.
신규 서버 프로세스가 기동했을 때에 상당한 시간의 지연이 발생합니다. 인증 절차는 이 다음에 행해집니다. 서버 프로세스에 디버거를 접속하는 가치을 제공하는 것이 목적입니다.
부모 postgres프로세스에 의해 시작되는 서브 프로세스에 의해 나타납니다. 그리고 사용하는 데이터베이스의 지정합니다. 이 옵션은 오직 내부적인 사용을 위한 것입니다.
이하의 옵션은 싱글 유저 모드 에 대해서만 적용됩니다.
싱글 유저 모드를 선택합니다. 이것은, 명령 라인으로 최초의 인수가 아니면 안됩니다.
액세스 하는 데이터베이스의 명칭을 지정합니다. 생략시는 기본값으로 사용자 이름이 됩니다.
모든 명령을 표시합니다.
delimiter 명령문으로서 개행문자(newline)의 사용을 무효로 합니다.
모든 서버 로그 출력물을 filename 에 보냅니다. 통상의 multiuser 모드에서는 이 옵션은 무시되어stderr가 모든 프로세스로 사용됩니다.
클라이언트로 사용되는 문자 encode 방식의 기본값입니다. (클라이언트는 개별적으로 오버라이드할 수가 있습니다. ) 또, 이 값은 설정 파일에서도 설정 가능합니다.
기본값의 데이터 디렉토리의 장소입니다.
DateStyle실행시 매개변수의 기본값입니다. (이 환경 변수의 사용은 폐지 예정입니다. )
기본 포트 번호입니다.(설정 파일내에서 설정하는 편이 선호되고 있습니다.)
서버의 타임 존입니다.
semget나shmget에 대해 언급하는 에러 메세지는 아마, 적절한 공유 메모리나 semaphore를 제공할 수 있도록 커널을 재구축 할 필요가 있는 것을 나타냅니다. 자세한 것은Section 16.4을 참조해 주세요. 다만,shared_buffers의 값을 작게 해PostgreSQL의 공유 메모리 소비량을 절감하는 max_connections의 값을 작게 해 semaphore 소비량을 절감한다고 하는 대책을 실시하는 것으로, 커널의 재구축을 유보할 수가 있습니다.
다른 서버가 이미 실행중인 것을 나타내는 에러 메세지에 대해서는, 예를 들면 이하의 명령을 사용해, 주의 깊게 검사하지 않으면 안됩니다.
$ ps ax | grep postgres
혹은
$ ps -ef | grep postgres
어느 쪽을 사용할까는 시스템에 따라서 다릅니다. 경합하는 서버가 가동하고 있지 않는 것이 확실하면, 메세지내에서 나타난 락 파일을 삭제해, 재차 시험해 주세요.
포트를 바인드 할 수 없었던 것을 나타내는 에러 메세지의 경우는 PostgreSQL이외의 프로세스가 이미 그 포트를 사용하고 있을 가능성이 생각됩니다. 또, postgres를 정지해 곧바로 같은 포트를 사용하는 설정으로 재기동했을 경우, 이 에러가 나오는 일이 있습니다. 이 경우, operating system가 포트를 폐쇄할 때까지 몇 초 기다리고 나서 재도전해 주세요. 마지막으로 operating system가 예약하고 있는 포트 번호를 지정했을 경우도, 이 에러가 발생하는 일이 있습니다. 예를 들면, Unix가 많은 버젼에서는 1024보다 작은 포트 번호는"신뢰할 수 있는(trusted)"로 간주해지고 있어 Unix의 슈퍼 유저 이외 액세스 할 수 없습니다.
주된 postgres서버를 종료시키기 위해서 SIGKILL를 사용하는 것은 가능한 한 피해 주세요 . 이것에 의해 postgres가 보관 유지하고 있는 system resource(공유 메모리나 semaphore)를 해방하기 전에 종료해 버리는 것을 방지할 수 있습니다. system resource가 해방되어 있지 않으면 새롭게postgres를 기동할 때에 문제가 일어날 가능성이 있습니다.
postgres서버를 통상에 종료시키기 위해서 그 시그널 SIGTERM, SIGINT, SIGQUIT를 사용할 수가 있습니다. 첫번째로 SIGTERM는 모든 클라이언트가 종료하는 것을 기다리고 나서 종료시킵니다. 두번째로 SIGINT는 강제적으로 모든 클라이언트와의 접속을 절단 합니다. SIGQUIT는 적절한 정지를 실시하지 말고, 즉시에 종료시킵니다. 이 경우, 다음번의 기동시에 복구 처리를 합니다. SIGHUP시그널에 의해 서버의 설정 파일을 리로드 할 것입니다. 또, SIGHUP를 개개의 서버 프로세스에 송신하는 일도 가능하지만, 통상은 의미가 없습니다.
pg_ctl 유틸리티 명령은 postgres서버의 기동과 정지(shut down)를 안전하고 간편하게하기 위한의 것입니다.
실행중의 쿼리를 중지하려면 그 명령을 실행하고 있는 프로세스에SIGINT시그널을 송신해 주세요.
postgres서버에서는 하위 서버 프로세스를 통상 대로에 종료시키기 위해 SIGTERM를 통상의 삭제를 실시하지 않고 종료시키려면SIGQUIT를 사용합니다. 이것들은 should not 사용자에 의해 사용되어야 합니다. 또, 서버에SIGKILL시그널을 송신하는 것은 바람직하지는 않습니다. 메인의postgres는 이것을 크래쉬로서 해석하므로, 크래쉬로부터의 표준적인 복구 수속의 일환으로서 강제적으로 공통의 parent process를 가지는 postgres프로세스를 모두 종료시킵니다.
--옵션은 FreeBSD나 OpenBSD에서는 잘 움직이지 않습니다. 대신에-c를 사용해 주세요. 이것은 대상의 operating system의 버그입니다. 만약 수정되지 않으면 장래의PostgreSQL릴리스로 회피책을 제공할 예정입니다.
싱글 유저 모드의 서버를 기동하려면 , 이하의 명령을 사용해 주세요.
postgres --single -D /usr/local/pgsql/data other-options my_database
데이터베이스 디렉토리의 정확한 패스를-D로 지정합니다. 패스를 지정하지 않을 때는 반드시PGDATA환경 변수를 설정해 두어 주세요. 또, 작업 대상으로 하는 데이터베이스의 이름도 지정해 주세요.
통상 싱글 유저 모드의 서버에서는 개행을 명령 입력의 마지막으로 간주합니다. psql에 있어서의 세미콜론과 같은 고도의 기능은 없습니다. 명령이 복수행에 걸치는 경우는 개행을 입력하기 전에 backslash를 입력하지 않으면 안됩니다(맨 마지막 줄을 제외하다).
다만, -j명령 라인 스위치를 사용했을 경우는 개행이 명령 입력의 마지막이라고는 보이지 않습니다. 서버는 표준 입력을 파일 종단 마크(EOF)까지 읽어내 거기까지의 입력을 1개의 명령 캐릭터 라인으로서 처리합니다. 이 경우, backslash와 개행의 편성은 특별 취급 되지 않습니다.
세션을 종료하려면 EOF(통상Control+D)를 입력합니다. -j를 사용하고 있는 경우, 종료하기 위해서EOF를 2번 연속해 입력할 필요가 있습니다.
싱글 사용자 모드의 서버에는 고도의 행 편집 기능이 준비되어 있지 않은 것에 주의해 주세요(예를 들면 명령 이력 기능은 없습니다).
기본값을 사용하는postgres를 배경으로 기동하려면, 이하를 입력해 주세요.
$ nohup postgres >logfile 2>&1 </dev/null &
포트를 지정한postgres를 기동하려면, 이하를 입력해 주세요.
$ postgres -p 1234
이 명령은 1234 포트를 통해서 통신을 실시하는postgres를 기동합니다. psql를 사용해 이 서버에 접속하려면, 이하와 같이 실행할 필요가 있습니다.
$ psql -p 1234
또는 PGPORT환경 변수를 설정할 필요가 있습니다.
$ export PGPORT=1234 $ psql
이름 첨부 실행시 매개변수를 이하의 어느쪽이든으로 설정할 수가 있습니다.
$ postgres -c work_mem=1234 $ postgres --work-mem=1234
어느 쪽의 형식에서도 postgresql.conf내에 기재되어 있을지도 모르는work_mem의 값을 오버라이드합니다. 명령 라인에서는 파라미터내의 언더 스코아(_)를 언더 스코아라고 해도 데쉬 기호(-)라고 해도 기재할 수 있는 것에 주의해 주세요. 아마 단기간의 실험이라고 하는 경우를 제외해, 명령 라인 스위치에 의존하는 것보다도 postgresql.conf내의 설정을 변경해 매개변수를 설정하는 편이 실용적입니다.