| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
initdb는PostgreSQL의 데이터베이스 클러스터를 새롭게 작성합니다. 데이터베이스 클러스터란, 1개의 서버 인스턴스로 관리되는 데이터베이스의 집합입니다.
데이터베이스 클러스터의 작성에는, 데이터베이스의 데이터를 보존하는 디렉토리의 작성, 공유 카탈로그 테이블(특정의 데이터베이스는 아니고, 클러스터 전체에 소속하는 테이블)의 생성, 그리고template1와 postgres데이터베이스의 작성이라고 하는 작업이 포함됩니다. 나중에 새로운 데이터베이스를 작성할 때는 template1데이터베이스의 모든 내용이 카피됩니다. (그러므로 template1에 설치한 모든 것이 각 데이터베이스를 생성한 후에 자동적으로 카피됩니다. ) postgres데이터베이스는 사용자, 유틸리티, 써드 파티제 애플리케이션에 의한 기본의 데이터베이스의 사용을 의미합니다.
비록 initdb가 지정된 데이터 디렉토리를 작성하려고 시도할지라도, 그 디렉토리의 상위 디렉토리가 root의 소유이면 권한을 갖지 못합니다. 이 설치를 초기화 하고 root로서 빈 데이터 디렉토리를 생성하고 chown를 사용해 디렉토리의 소유권한을 데이터베이스의 사용자 계정에 이전해야 합니다. chown를 사용해 데이터베이스 사용자가 되고 initdb를 실행합니다.
initdb는 서버 프로세스의 소유자에 의해 실행되야 합니다. initdb에 의해 작성되는 파일이나 디렉토리에 서버가 접근 할 필요가 있기 때문입니다. 서버는 root로서 실행할 수 없기 때문에 root로initdb를 실행 해서는 안됩니다. (실제로는, 실행하려고 해도 거부됩니다).
initdb는, 데이터베이스 클러스터 기본값의 로케일과 캐릭터 세트 encoding 방식을 초기화합니다. 조합순서(LC_COLLATE)나 캐릭터 세트 클래스(LC_CTYPE, 예를 들면, 대문자, 소문자, 숫자)는모든 데이터베이스로 고정되어 변경할 수 없습니다. 또 C나POSIX이외의 조합순서에서는 성능상의 불이익도 있습니다. 그 외의 로케일 카테고리는 서버가 시작된 후에도 변경할 수가 있습니다. 모든 서버의 로케일 값(lc_*)은 SHOW ALL 통해 표시 할 수 있습니다. 그러므로 initdb를 실행하기에는 올바른 선택을 하도록 주의가 필요합니다. 자세한 사항은Section 21.1에서 찾아 볼 수 있습니다.
캐릭터 세트 encoding 방식은, 각 데이터베이스의 작성시에 개별적으로 설정할 수가 있습니다. initdb는 template1데이터베이스의 encoding 방식을 결정해, 이것이 향후 다른 모든 데이터베이스의 기본값으로서 사용됩니다. 기본 encode 방식을 변경하려면 --encoding옵션을 사용합니다. 자세한 것은Section 21.2에서 찾을 수 있습니다.
이 옵션은pg_hba.conf에서 로컬 유저용으로 사용되는 인증 방법을 지정합니다. 시스템의 모든 로컬 사용자가 신뢰할 수 있는 것은 아닌 경우는,trust를 사용하지 마십시오. trust는 설치를 쉽게 하기 위한 기본값입니다.
이 옵션은, 데이터베이스 클러스터를 저장해야 할 디렉토리를 지정합니다. 이것이 initdb에 의해 요구 되는 정보입니다. 하지만 PGDATA 환경 변수를 설정해 두면, 이 옵션으로 지정하는 수고를 줄일 수 있습니다. 이 방법은 후에 같은 변수를 사용해 데이터 베이스 서버(postgres)가 데이터베이스 디렉토리를 참조할 수 있으므로, 효율적입니다.
템플릿 데이터베이스의 encoding 방식을 선택합니다. 특히 덧쓰기되지 않는 이상 이것이 향후 작성되는 모든 데이터베이스 기본의 encoding 방식이 됩니다. 기본값은 로케일이나 만약 그것이 수행되지 않을 때 SQL_ASCII에 의해 정해집니다. PostgreSQL서버에 의해 지원되는 캐릭터 세트에 대해서는 Section 21.2.1으로 설명합니다.
데이터베이스 클러스터에 대한 로케일의 기본값을 설정합니다. 이 옵션을 지정하지 않는 경우는 initdb를 실행하고 있는 환경의 로케일이 계승됩니다. 로케일 지원에 대해서는Section 21.1으로 설명합니다.
--locale와 비슷하지만, 지정한 카테고리의 로케일만을 설정합니다.
데이터베이스의 슈퍼 유저의 사용자 이름을 선택합니다. initdb를 실행하고 효과있는 사용자의 이름이 기본값입니다. 슈퍼 유저의 이름은 너무 중요하지는 않지만, 비록 operating system의 사용자의 이름과 다를지라도 관습적으로 사용되고 있는postgres를 사용하는 것을 추천합니다.
initdb에 데이터베이스의 슈퍼 유저 권한을 주기 위한 패스워드 입력의 prompt를 표시시킵니다. 패스워드 인증을 실시할 생각이 없는 경우는 중요하지 않습니다. 이 옵션을 지정해도, 패스워드의 설정을 실시할 때 까지 패스워드 인증을 사용할 수 없습니다.
initdb는 데이터베이스 슈퍼 유저의 패스워드를 이 파일로부터 읽어냅니다. 이 파일의 최초의 행이 패스워드로서 해석됩니다.
이 밖에도, 일반적으로 덜 사용되는 아래와 같은 매개 변수도 사용할 수 있습니다.
bootstrap backend의 디버그 정보와 일반의 이용자에게는 불필요한 그 외의 정보를 출력합니다. bootstrap backend는initdb가 카탈로그 테이블을 작성할 때에 사용하는 프로그램입니다. 이 옵션은 결과물을 대량으로 출력합니다.
initdb는 데이터베이스 클러스터를 초기화하기 위해 입력파일을 찾아 위치를 지정합니다. 이것은 통상적으로 필요 없습니다. 필요할 경우 그것의 위치를 명확하게 지정하면 됩니다.
기본적으로 initdb 실행중에 에러가 발생할 때, 데이터베이스 클러스터를 완성할 수 있는 예방법으로 그 작업을 마칠 수 없다는 것을 발견하기 전에 작성된 모든 파일을 삭제합니다. 이 옵션을 지정하면 이러한 파일이 삭제하지 않고 남겨지므로, 디버깅 시에는 매우 편리합니다.
데이터베이스 클러스터를 보존하는 디렉토리를 지정합니다. -D옵션을 사용해 덧쓰기할 수가 있습니다.
또 이 유틸리티는 다른 대부분의PostgreSQL유틸리티와 같이,libpq로 지원되는 환경 변수를 사용합니다(Section 29.12를 참조해 주세요).