| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
CREATE DATABASE
name
[ [ WITH ] [ OWNER [=]
dbowner
]
[ TEMPLATE [=]
template
]
[ ENCODING [=]
encoding
]
[ TABLESPACE [=]
tablespace
]
[ CONNECTION LIMIT [=]
connlimit
] ]
CREATE DATABASE는 새로운PostgreSQL데이터베이스를 생성합니다.
데이터베이스를 생성하려면, 슈퍼유저이거나 또는 CREATEDB라고 하는 특별한 권한을 갖아야 합니다. CREATE USER 를 참조해 주세요.
통상, 데이터베이스의 작성자가 새로운 데이터베이스의 소유자가 됩니다. 슈퍼유저는, OWNER구를 사용하여 다른 사용자가 소유한 데이터베이스를 생성할 수 있습니다. 슈퍼유저는, 특별한 권한이 없는 사용자가 소유하고 있는 데이터베이스를 생성할 수도 있습니다. CREATEDB권한을 가진 비슈퍼유저는, 그들이 소유하고 있는 데이터베이스만 생성할 수 있습니다.
디폴트에서는, 표준 시스템 데이터베이스 template1를 복제하여 새로운 데이터베이스가 생성됩니다. 다른 템플릿은, TEMPLATE name 을 작성함으로써 지정될 수 있습니다. 특히, TEMPLATE template0를 작성하여, PostgreSQL버전에 의해 미리 정의된 표준객체를 가지는 원래의 데이터베이스를 생성할 수 있습니다. 이것은, template1에 추가될 수 있는 설치-로컬 객체의 복사를 원하지 않는 경우에 유용합니다.
생성될 데이터베이스의 이름입니다.
새로운 데이터베이스를 소유하는 데이터베이스 사용자의 이름입니다. 디폴트(즉, 커멘드를 실행하는 사용자)를 사용하는 경우는 DEFAULT로 지정합니다.
새로운 데이터베이스를 생성하는 템플릿의 이름입니다. 디폴트 템플릿(template1)을 사용하는 경우는 DEFAULT로 지정합니다.
새로운 데이터베이스 내에 사용될 문자 세트 인코딩입니다. 문자열 상수(예를 들면, 'SQL_ASCII'), 또는 정수의 인코딩 번호, 또는 디폴트의 인코딩을 사용하는DEFAULT(즉, 템플릿 데이터베이스의 인코딩)을 지정합니다. PostgreSQL서버로 지원된 문자 세트에 대해서는 Section 21.2.1으로 설명합니다.
새로운 데이터베이스와 연관된 테이블스페이스명, 또는 템플릿 데이터베이스의 테이블스페이스를 사용하는 경우는,DEFAULT로 지정합니다. 이 테이블스페이스는, 이 데이터베이스내에서 생성되는 객체의 디폴트의 테이블스페이스가 됩니다. 자세한 정보는 CREATE TABLESPACE 을 참조해 주세요.
이 데이터베이스로 확립할 수 있는 동시 접속수입니다. -1(디폴트)(은)는 무제한을 의미합니다.
생략 가능한 매개변수는, 임의의 순서로 기술할 수 있습니다. 상기의 순서로 기술하지 않아도 됩니다.
CREATE DATABASE는 트랜잭션 블록의 내에서 실행할 수 없습니다. block.
"could not initialize database directory"라고 하는 행이 포함되는 에러는 대부분의 경우, 데이터 디렉토리의 권한 부족, 디스크 용량 부족 등 파일 시스템에 대한 문제에 관련하는 것입니다.
데이터베이스를 삭제하려면, DROP DATABASE 를 사용해 주세요.
createdb 프로그램은, 편의를 위해 제공된, 이 커멘드의 래퍼 프로그램 입니다.
template1이외의 데이터베이스의 이름을 템플릿으로 지정해 데이터베이스를 복사하는 것은 가능합니다만, 이것은( 아직) 일반적으로 사용하는"COPY DATABASE"기능으로서 의도되고 있는 것은 아닙니다. 주요 제한은, 복사 중인 경우에 다른 세션이 템플릿 데이터베이스에 접속할 수 없다는 것입니다. CREATE DATABASE는, 시작 했을 때에 다른 접속이 있으면 실패합니다. 템플릿 데이터베이스로의 새로운 접속은, CREATE DATABASE 이 완료할 때까지 락이 걸립니다. 자세한 것은Section 19.3을 참조해 주세요.
CONNECTION LIMIT는 엄밀한 제한이 아닙니다. 데이타베이스전용의 접속"슬롯"이 1개남아 있었을 때에 동시에 2개의 새로운 세션이 시작할 경우, 둘 다 실패할 가능성이 있습니다. 또한, 이 제한은 슈퍼 유저에 대해 강제적이지 않습니다.