설명

ALTER DATABASE 명령은 해당 데이터베이스 속성을 바꾼다.

첫번째 구문은 해당 데이터베이스 접속 관련 설정과 템플릿 데이터베이스로 사용할지를 설정하는데 사용된다. (아래에서 좀 더 자세히 다룬다.) 슈퍼유저와 해당 데이터베이스 소유주만 이 명령을 사용할 수 있다.

두번째 구문은 데이터베이스 이름을 바꾸는 구문이다. 슈퍼유저와 해당 데이터베이스 소유주만 사용할 수 있으며, 두 경우가 아닌 일반 사용자인 경우라면, 그 사용자에게 CREATEDB 권한이 있으면 사용할 수 있다. 현재 접속한 데이터베이스의 이름은 바꿀 수 없다. (다른 데이터베이스에 접속해서 이름을 바꿔야 한다.)

세번째 구문은 데이터베이스 소요주를 바꾸는 구문이다. 현재 접속한 사용자는 새 소유주로 지정할 사용자에 직간접적으로 소속되어 있어야 하며, 새 사용자는 CREATEDB 권한이 있어야 한다. (슈퍼유저는 이런 제약 조건에 상관 없이 작업할 수 있다.)

네번째 구문은 해당 데이터베이스의 기본 테이블스페이스를 바꾸는 구문이다. 데이터베이스 소유주나 슈퍼유저만 이 명령을 사용할 수 있고, 이 사용자는 새 테이블스페이스에 대한 create 권한이 있어야 한다. 이 명령은 물리적으로 옛 테이블스페이스 있던 개체들(테이블, 인덱스 등)을 새 테이블스페이스로 옮긴다. 새 테이블스페이스는 빈 상태여야하며, 이 작업을 할 시점에는 자기 자신 외 아무도 이 데이터베이스에 접속해 있으면 안된다. 이미 특정 테이블스페이스를 사용하도록 지정한 테이블과 인덱스는 이 작업에서 제외된다.

나머지 구문은 PostgreSQL 데이터베이스 서버 환경 설정 매개 변수 값을 기본 세션에 적용되도록 바꾸는 구문이다. 새로운 세션이 이 데이터베이스로 접속하면, 여기서 지정한 설정 값을 그 세션 기본값으로 사용한다. postgresql.conf에서 지정했거나, 서버 실행시 지정한 명령행 옵션으로 지정한 설정값을 무시하고, 이 값을 사용한다. 데이터베이스 소유주나 슈퍼유저만 이 명령을 사용할 수 이다. 몇몇 변수는 이 방법으로 지정할 수 없기도 하고, 슈퍼유저만 설정할 수 있기도 한다.

매개 변수

참고

세션이 사용할 서버 환경 설정 기본값 지정은 데이터베이스 단위로 지정할 수도 있지만, 롤에서 지정할 수도 있다; ALTER ROLE 참고. 두 지정이 서로 같은 변수인 경우는 롤에서 지정한 값을 사용한다.

예제

test 데이터베이스에서 인덱스를 사용한 탐색을 안하게:

ALTER DATABASE test SET enable_indexscan TO off;

호환성

ALTER DATABASE 구문은 PostgreSQL 확장 기능이다.

관련 항목