ALTER AUDIT POLICY

기능

Audit policy 객체에 감사 대상을 추가하거나 삭제한다.

구문

<alter audit policy statement> ::= 
    ALTER AUDIT POLICY policy_name
    { <add_audit_option> | <drop_audit_option> }
    ;

<add_audit_option> ::=
    ADD { <privilege_audit_clause> |  <action_audit_clause> | <privilege_audit_clause> <action_audit_clause> }

<drop_audit_option> ::=
    DROP { <privilege_audit_clause> |  <action_audit_clause> | <privilege_audit_clause> <action_audit_clause> }


<privilege_audit_clause> ::=
    PRIVILEGES <database_privilege> [, ...]

<action_audit_clause> ::=
    ACTIONS { <object_action_audit> | <system_action_audit> } [, ...]

<object_action_audit> ::=
      ALL ON [schema_name.]object_name
    | <object_action> ON [schema_name.]object_name

<system_action_audit> ::=
      ALL
    | <system_action>

사용 범위 및 접근 권한

<alter audit policy statement> 구문을 수행하려면 사용자에게 AUDIT SYSTEM ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

policy_name

변경할 audit policy 객체의 이름이다.

<add_audit_option>

Audit policy에 감사대상을 추가한다.

<drop_audit_option>

Audit policy 감사대상에서 삭제한다.

<privilege_audit_clause>

자세한 내용은 CREATE AUDIT POLICY 를 참조한다.

<action_audit_clause>

자세한 내용은 CREATE AUDIT POLICY 를 참조한다.

설명

이미 활성화된 audit policy를 변경할 수 있지만 기존 session에는 영향을 주지 않고 새로 생성되는 session에만 영향을 미친다.

CREATE AUDIT POLICY p1
       ACTIONS ALL ON u1.t1,
               SELECT ON u1.t1;

ALTER AUDIT POLICY p1 DROP
      ACTIONS ALL ON u1.t1;

사용 예

다음은 audit policy에 새로운 audit option을 추가하는 예이다.

ALTER AUDIT POLICY policy_dml
      ADD ACTIONS SELECT ON u1.t1;

다음은 audit policy에서 audit option을 삭제하는 예이다.

ALTER AUDIT POLICY policy_dml
      DROP ACTIONS SELECT ON u1.t1;

호환성

SQL 표준에는 audit policy가 없다.

참조

관련 내용은 다음을 참조한다.

• Audit policy 객체 관리

  • CREATE AUDIT POLICY

  • DROP AUDIT POLICY

  • ALTER AUDIT POLICY

• Audit policy 활성화/ 비활성화

  • AUDIT POLICY

  • NOAUDIT POLICY

• Audit trail 조회: AUDIT_TRAIL

• Audit trail 삭제: ALTER DATABASE CLEAR AUDIT TRAIL

ALTER CLUSTER GROUP name ADD MEMBER

기능

Cluster group에 cluster member를 추가한다.

구문

<alter cluster group add member statement> ::=
    ALTER CLUSTER GROUP group_name ADD
        <cluster member definition> [, ...]
    ;

<cluster member definition> ::=
    CLUSTER MEMBER member_name <connection attribute>

<connection attribute> ::
    HOST 'address' PORT port_no

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter cluster group add member statement> 구문을 수행하려면 사용자에게 ADMINISTRATION ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

group_name

Cluster group의 이름이다.

<cluster member definition>

Cluster group에 포함될 cluster member를 정의한다.
Cluster group은 최대 32 개의 cluster member를 포함할 수 있다.

member_name

Cluster member의 이름이다.
Cluster member의 이름은 해당 member의 database를 생성할 때 정의한 member의 이름과 동일해야 한다.
동일한 cluster group, cluster member 이름이 존재하지 않아야 한다.
이름의 길이가 128 바이트보다 작아야 한다.
Cluster member의 start-up 단계가 OPEN이어야 한다.

<connection attribute>

Cluster member간 통신을 위한 연결 정보를 정의한다.
<connection attribute>는 해당 member의 database를 생성할 때 정의한 HOST, PORT와 동일해야 한다.
HOST와 PORT 조합은 cluster system 내에서 유일해야 한다.

• HOST 'address'는 ip v4 형식을 사용한다.

• PORT port_no는 1024 ~ 49151 범위의 값이어야 한다.

설명

<alter cluster group add member statement> 구문은 table들의 shard를 재배치하지 않는다.
추가된 cluster member에 shard를 재배치하려면 다음 구문을 수행해야 한다.

• ALTER DATABASE REBALANCE

• ALTER TABLE name REBALANCE

사용 예

다음은 cluster group에 두 개의 cluster member를 추가하는 예이다.

gSQL>
ALTER CLUSTER GROUP g1 ADD
    CLUSTER MEMBER g1n3 HOST '192.168.0.13' PORT 10130,
    CLUSTER MEMBER g1n4 HOST '192.168.0.14' PORT 10140
;

Cluster Group altered.

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• CREATE CLUSTER GROUP

• DROP CLUSTER GROUP

• ALTER DATABASE REBALANCE

• ALTER TABLE name REBALANCE

ALTER CLUSTER GROUP name OFFLINE MEMBER

기능

Cluster group의 cluster member를 offline 상태로 변경한다.

구문

<alter cluster group offline member statement> ::=
    ALTER CLUSTER GROUP group_name OFFLINE
        <cluster member definition>
    ;

<cluster member definition> ::=
    CLUSTER MEMBER member_name
    ;

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter cluster group offline member statement> 구문을 수행하려면 사용자에게 ADMINISTRATION ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

group_name

Cluster group의 이름이다.

<cluster member definition>

Cluster group에 포함될 cluster member를 정의한다.
Cluster group은 최대 32개의 cluster member를 포함할 수 있다.

member_name

Cluster member의 이름이다.
Cluster member의 이름은 해당 member의 database를 생성할 때 정의한 member의 이름과 동일해야 한다.
동일한 cluster group, cluster member 이름이 존재하지 않아야 한다.
이름의 길이가 128 바이트보다 작아야 한다.
Cluster member의 start-up 단계가 OPEN이어야 한다.

설명

<alter cluster group offline member statement> 구문은 table들의 shard를 재배치하지 않는다.

사용 예

다음은 특정 cluster member를 offline 상태로 변경하는 예이다.

gSQL>

ALTER CLUSTER GROUP g1 OFFLINE
    CLUSTER MEMBER g1n3
;
Cluster Group altered.

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• CREATE CLUSTER GROUP

• DROP CLUSTER GROUP

• ALTER DATABASE REBALANCE

• ALTER TABLE name REBALANCE

ALTER CLUSTER LOCATION

기능

Cluster location 정보를 수정한다.

구문

<alter cluster location statement> ::=
    ALTER CLUSTER LOCATION member_name 
    <cluster connection attribute>
    ;

<cluster connection attribute> ::
       HOST 'address' PORT port_no

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter cluster location statement> 구문을 수행하려면 사용자에게 ADMINISTRATION ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

member_name

Cluster member의 이름이다.
등록된 cluster location 정보에 동일한 cluster member 이름이 존재해야 한다.
이름의 길이가 128 바이트보다 작아야 한다.

<cluster connection attribute>

Cluster member 간 통신을 위한 연결 정보를 정의한다.
HOST와 PORT 조합은 cluster system 내에서 유일해야 한다.

• HOST 'address'는 ip v4 형식으로 사용한다.

• PORT port_no는 1024 ~ 49151 범위의 값이어야 한다.

설명

만약 cluster location의 접속 정보가 변경될 경우에는 cluster member를 제거하거나 재생성할 필요없이 ALTER CLUSTER LOCATION을 이용하여 접속 정보를 변경할 수 있다.

사용 예

gSQL> 
ALTER CLUSTER LOCATION g1n2
    HOST '192.168.0.12' PORT 10120,
;

Created

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• CREATE CLUSTER LOCATION

• DROP CLUSTER LOCATION

ALTER DATABASE ADD LOGFILE

기능

데이터베이스에 로그파일 그룹 또는 로그파일 멤버를 추가한다.

구문

<alter database add logfile statement> ::=
      <add logfile member statement> 
    | <add logfile group statement>
    ;

<add logfile member statement> ::=
    ALTER DATABASE ADD LOGFILE MEMBER <add logfile clause> [, ...] TO 
        <group clause>

<add logfile group statement> ::=
    ALTER DATABASE ADD LOGFILE <group clause> ( 'logfile_name' ) 
        <size clause> [ REUSE ]

<group clause> ::=
    GROUP integer

<add logfile clause> ::=
    'logfile_name' [ REUSE ]

<size clause> ::=
    integer [ M | G ]

사용 범위 및 접근 권한

<alter database add logfile statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<alter database add logfile statement>

데이터베이스는 MOUNT 상태여야 한다.

<add logfile member statement>

기존의 로그파일 그룹에 로그 멤버를 추가한다.

• <add logfile clause>

  • 'logfile_name'은 로그파일 그룹에 추가할 로그파일 멤버의 파일이름이다.

  • 파일이 존재하지 않으면 새로운 파일을 생성한다.

  • 'logfile_name'의 길이는 1024 바이트보다 작아야 한다.

• <group clause>

  • 데이터베이스에 추가할 로그파일 그룹의 식별자를 지정한다.

  • integer는 존재하는 로그파일 그룹의 식별자여야 한다.

  • integer에 해당하는 식별자가 존재하지 않을 경우에는 에러가 발생한다.

<add logfile group statement>

새로운 로그파일 그룹을 추가한다.

• CURRENT 로그파일 그룹의 다음 그룹으로 추가된다.

• <group clause>

  • 데이터베이스에 추가할 로그파일 그룹의 식별자를 지정한다.

  • integer는 존재하지 않는 로그파일 그룹 식별자여야 한다.

  • integer에 해당하는 식별자가 존재할 경우 에러가 발생한다.

• <size clause>

  • 파일의 크기는 최소 10 MB ~ 최대 10 GB까지 지정할 수 있다.

  • 파일의 크기는 로그 버퍼 (redo log buffer)의 크기와 지연 로그 버퍼 (pending log buffer) 크기의 합보다 커야 한다.

• 만약 logfile_name이 이미 존재하고 REUSE 옵션을 사용한 경우, 로그 파일 그룹 내의 다른 멤버와 크기가 동일하다면 기존 로그파일을 재사용한다.

설명

새로운 로그파일 그룹과 로그 멤버가 추가되는 경우 controlfile에 저장되므로 향후 controlfile 손상에 대비해 controlfile을 백업하는 것을 권장한다.

사용 예

다음은 기존 로그파일인 GROUP 3에 두 개의 로그파일 멤버를 추가하는 예이다.

ALTER DATABASE ADD LOGFILE MEMBER 'logfile1.log', 'logfile2.log' TO GROUP 3;

다음은 로그파일 크기가 100 M이고 로그파일 이름이 'logfile1.log'인 새로운 로그파일 GROUP 4를 데이터베이스에 추가하는 예이다.

ALTER DATABASE ADD LOGFILE GROUP 4 ( 'logfile1.log' ) SIZE 100M;

호환성

SQL 표준에서는 ALTER DATABASE 구문을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER DATABASE ADD LOGFILE

• ALTER DATABASE DROP LOGFILE

• ALTER DATABASE RENAME LOGFILE

ALTER DATABASE ARCHIVELOG

기능

데이터베이스의 온라인 로그 파일 archive 설정을 변경한다.

구문

<alter database archivelog statement> ::=
    ALTER DATABASE { ARCHIVELOG | NOARCHIVELOG }
    ;

사용 범위 및 접근 권한

<alter database archivelog statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<alter database archivelog statement>

• 데이터베이스가 MOUNT 상태여야 한다.

• ARCHIVELOG

  • 온라인 로그파일을 archive 한다.

• NOARCHIVELOG

  • 온라인 로그파일을 archive 하지 않는다.

설명

Database를 백업하고 백업을 이용해 복구 (media recovery)하려면 시스템이 ARCHIVELOG 모드로 운용되어야 한다.

사용 예

다음은 데이터베이스를 archive 모드로 설정하는 예이다.

ALTER DATABASE ARCHIVELOG;

호환성

SQL 표준에서는 ALTER DATABASE 구문을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER DATABASE BACKUP

• ALTER TABLESPACE name BACKUP

ALTER DATABASE BACKUP

기능

데이터베이스 전체 백업 (full backup)을 수행하기 위해 백업 상태를 'ACTIVE' 또는 'INACTIVE'로 설정한다. 그리고 데이터베이스 증분 백업 (incremental backup)과 제어 파일 (control file) 백업을 수행한다.

구문

<alter database backup statement> ::=
      <database begin backup statement>
    | <database end backup statement>
    | <database incremental backup statement>
    | <database controlfile backup statement>
    ;

<database begin backup statement> ::=
    ALTER DATABASE BEGIN BACKUP [ AT <domain name> ]
    ;

<database end backup statement> ::=
    ALTER DATABASE END BACKUP [ AT <domain name> ]
    ;

<database incremental backup statement> ::=
    ALTER DATABASE BACKUP INCREMENTAL
        <incremental backup option> [ AT <domain name> ]    ;

<incremental backup option> ::=
      LEVEL integer [ CUMULATIVE | DIFFERENTIAL ]

<database controlfile backup statement> ::=
    ALTER DATABASE BACKUP CONTROLFILE TO 'target_name'
        [ AT <domain name> ]    ;

사용 범위 및 접근 권한

<alter database backup statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<database begin backup clause>

데이터베이스를 전체 백업이 가능한 상태로 설정한다.

• 데이터베이스에서 생성되어 사용 중인 ONLINE 상태의 모든 테이블스페이스를 전체 백업이 가능한 상태로 설정한다.

• 데이터베이스는 OPEN 상태여야 하고 ARCHIVELOG 모드로 운영되어야 한다.

• BEGIN BACKUP이 시작된 이후에는 다음과 같이 데이터 파일에 쓰기를 요구하는 연산들은 수행할 수 없다.

  • SHUTDOWN NORMAL

  • OFFLINE/ DROP TABLESPACE

  • ADD/ DROP DATAFILE

• 전체 백업의 상태가 ACTIVE인 상태에서 인스턴스가 비정상 종료될 경우, 다시 시작할 때 미디어 복구를 요구할 수도 있다.

<database end backup clause>

데이터베이스를 전체 백업 불가능한 상태로 설정한다.

• 데이터베이스에서 생성되어 사용 중인 ONLINE 상태의 모든 테이블스페이스를 백업 불가능한 상태로 설정한다.

• 데이터베이스는 OPEN 상태여야 하고, ARCHIVELOG 모드로 운영되어야 한다.

<database incremental backup statement>

• 데이터베이스 증분 백업을 수행한다.

• 데이터베이스는 OPEN 상태여야 하고, ARCHIVELOG로 운영되어야 한다.

<incremental backup option>

• 'integer'는 0 ~ 4 까지 지정할 수 있다.

• LEVEL 0은 CUMULATIVE나 DIFFERENTIAL을 지정할 수 없다.

• CUMULATIVE | DIFFERENTIAL

  • CUMULATIVE

    • 'integer'가 n이면 가장 최근에 LEVEL 0 ~ LEVEL n-1까지 백업한 이후 변경된 모든 페이지들을 백업한다.

  • DIFFERENTIAL

    • 'integer'가 n이면 가장 최근에 LEVEL 0 ~ LEVEL n까지 백업한 이후 변경된 모든 페이지들을 백업한다.

  • 생략하면 DIFFERENTIAL이 기본으로 지정된다.

<database controlfile backup statement>

• 제어 파일 (controlfile)을 백업한다.

  • 'target_name'의 이름은 1024 바이트보다 작아야 한다.

  • 'target_name'이 이미 존재하는 경우 연산에 실패한다.

• 데이터베이스는 OPEN 상태여야 하고, ARCHIVELOG로 운영되고 있어야 한다.

<domain name>

• 구문을 수행할 멤버나 그룹의 이름이다.

• 지정하지 않은 경우에는 모든 그룹에 수행된다.

설명

Database의 datafile과 controlfile을 백업한다. BEGIN BACKUP을 수행한 후 OS의 파일 복사로 datafile들을 복사하고 나서 END BACKUP을 수행하여 database를 전체 백업한다. 한편, 증분 백업 파일은 하나의 구문으로 BACKUP_DIR_1 property에 설정된 경로에 생성한다.

사용 예

다음은 전체 백업 상태를 ACTIVE로 설정하는 예이다.

ALTER DATABASE BEGIN BACkUP;

다음은 전체 백업 상태를 INACTIVE로 설정하는 예이다.

ALTER DATABASE END BACkUP;

다음은 DIFFERENTIAL을 사용하여 LEVEL 1의 증분 백업을 만드는 예이다.

ALTER DATABASE BACKUP INCREMENTAL LEVEL 1 DIFFERENTIAL;

다음은 controlfile에 대해 'controlfile.bak' 백업 파일을 만드는 예이다. 절대 경로가 포함되지 않으면 LOG_DIR property에 설정된 경로에 백업 파일을 생성한다.

ALTER DATABASE BACKUP CONTROLFILE TO 'controlfile.bak';

호환성

SQL 표준에서는 ALTER DATABASE 구문을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLESPACE name BACKUP

• ALTER DATABASE RECOVER

ALTER DATABASE CLEAR AUDIT TRAIL

기능

Audit policy 적용으로 인해 누적된 audit record를 삭제 (purge)한다.

구문

<clear audit trail statement> ::= 
    ALTER DATABASE CLEAR AUDIT TRAIL
;

사용 범위 및 접근 권한

<clear audit trail statement> 구문을 수행하려면 사용자에게 AUDIT SYSTEM ON DATABASE 권한이 있어야 한다.

설명

Audit policy를 활성화하면 시간이 지남에 따라 audit trail이 계속 커진다. 
Audit trail을 구성하는 테이블들은 MEM_AUX_TBS 테이블스페이스에 저장되는데 audit trail이 계속 커지지 않도록 해야 한다.

Audit Trail 저장

필요에 따라 audit trail 을 저장하려면 다음과 같은 절차에 따라 저장한 후에 audit trail을 삭제해야 한다.

• 최초로 수행할 때

CREATE TABLE backup_audit_trail AS SELECT * FROM AUDIT_TRAIL;
COMMIT;

• 반복해서 수행할 때

INSERT INTO backup_audit_trail SELECT * FROM AUDIT_TRAIL;
COMMIT;

• Audit trail을 삭제할 때

ALTER DATABASE CLEAR AUDIT TRAIL;

사용 예

다음 구문을 사용하여 audit trail을 삭제 (purge)한다.

ALTER DATABASE CLEAR AUDIT TRAIL;

호환성

SQL 표준에는 audit policy가 없다.

참조

관련 내용은 다음을 참조한다.

• Audit policy 객체 관리

  • CREATE AUDIT POLICY

  • DROP AUDIT POLICY

  • ALTER AUDIT POLICY

• Audit policy 활성화/ 비활성화

  • AUDIT POLICY

  • NOAUDIT POLICY

• Audit trail 조회: AUDIT_TRAIL

• Audit trail 삭제:ALTER DATABASE CLEAR AUDIT TRAIL

ALTER DATABASE CLEAR PASSWORD HISTORY

기능

Profile 적용에 따라 누적된 사용자의 비밀번호 변경 이력을 삭제한다.

구문

<clear password history statement> ::= 
    ALTER DATABASE CLEAR PASSWORD HISTORY
    ;

사용 범위 및 접근 권한

<clear password history statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

설명

User에 profile을 적용할 때 PASSWORD_REUSE_MAX, PASSWORD_REUSE_TIME의 정책에 따라 사용자의 비밀번호 변경이력이 누적된다.

<clear password history statement> 구문은 누적된 사용자 비밀번호 변경 이력을 삭제한다.

사용 예

다음은 <clear password history statement> 구문을 수행하는 예이다.

gSQL> ALTER DATABASE CLEAR PASSWORD HISTORY;

Database altered.

gSQL> COMMIT;

Commit complete.

호환성

SQL 표준에서는 ALTER DATABASE 구문을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• CREATE PROFILE

• CREATE USER

ALTER DATABASE DELETE BACKUP

기능

증분 백업 (incremental backup)의 백업 정보와 백업 파일을 삭제한다. Database의 모든 증분 백업을 삭제하거나, 더 이상 쓸모 없는 백업 (obsolete backup)을 선택해서 삭제할 수 있다.

구문

<alter database delete backup statement> ::=
    ALTER DATABASE DELETE <delete backup list option> 
        BACKUP LIST [ <including backup file option> ]
    ;

<delete backup list option> ::=
      OBSOLETE
    | ALL

<including backup file option> ::=
    INCLUDING BACKUP FILES

사용 범위 및 접근 권한

<alter database delete backup statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<alter database delete backup statement>

데이터베이스가 MOUNT 또는 OPEN 상태여야 한다.

<delete backup list option>

기존 증분 백업들 중에서 삭제할 대상을 선정한다.

• OBSOLETE: 가장 최근의 데이터베이스 'LEVEL 0' 백업 이전에 백업한 데이터베이스 또는 테이블스페이스 백업본들을 삭제 대상으로 선정한다.

• ALL: 전체 증분 백업들을 삭제 대상으로 선정한다.

<including backup file option>

• 생략하면 백업 정보만 제어 파일에서 삭제한다.

• 백업 정보뿐만 아니라 백업 파일들도 함께 삭제한다.

설명

OBSOLETE 증분 백업 삭제는 가장 최근의 LEVEL 0 데이터베이스 백업 이전의 증분 백업을 삭제한다. 즉, LEVEL 0이 아닌 증분 백업을 수행할 때는 이전에 수행한 증분 백업을 포함하는 증분 백업이 있더라도 삭제하지 않는다. 왜냐하면 증분 백업을 이용한 불완전 복구를 수행할 때 사용될 수 있기 때문이다.

사용 예

다음은 기존 모든 증분 백업들의 백업정보와 백업파일들을 삭제하는 예이다.

ALTER DATABASE DELETE ALL BACKUP LIST INCLUING BACKUP FILES;

호환성

SQL 표준에서는 ALTER DATABASE 구문을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLESPACE name BACKUP

• ALTER DATABASE RECOVER

ALTER DATABASE DROP INACTIVE CLUSTER MEMBERS

기능

모든 inactive cluster member들을 제거한다.

구문

<alter database drop inactive members statement> ::=
    ALTER DATABASE DROP INACTIVE CLUSTER MEMBERS
    ;

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter database drop inactive cluster members statement> 구문을 수행하려면 사용자에게 ADMINISTRATION ON DATABASE 권한이 있어야 한다.

설명

모든 inactive cluster member들을 제거한다.

Cluster member의 inactive 상태는 cluster system과 연결되어 있지 않은 상태로서 다음과 같은 상황에서 발생한다.

• 운영 중인 cluster system에서 해당 cluster member에 장애가 발생한 경우

• 해당 cluster member를 구동하지 않고 cluster system의 start-up을 시도한 경우

단, cluster member를 제거할 때 table의 shard가 유실되는 경우에는 inactive cluster member를 제거할 수 없다.

<alter database drop inactive members statement> 구문은 모든 inactive cluster member들이 더 이상 cluster system에 포함될 수 없는 경우에 사용하는 것이 바람직하다.

사용 예

다음은 <alter database drop inactive members statement> 구문을 수행하는 예이다.

gSQL> ALTER DATABASE DROP INACTIVE CLUSTER MEMBERS;

Database altered.

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 ALTER SYSTEM JOIN DATABASE 를 참조한다.

ALTER DATABASE DROP LOGFILE

기능

데이터베이스에 존재하는 로그파일 그룹이나 멤버를 제거한다.

구문

<alter database drop logfile statement> ::=
      <drop logfile group statement>
    | <drop logfile member statement>
    ;

<drop logfile group statement> ::=
    ALTER DATABASE DROP LOGFILE <group clause>

<group clause> ::=
    GROUP integer

<drop logfile member statement> ::=
    ALTER DATABASE DROP LOGFILE MEMBER <logfile_list>

<logfile_list> ::=
      'logfile_name'
    | <logfile_list> , 'logfile_name'

사용 범위 및 접근 권한

<alter database drop logfile statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<alter database drop logfile statement>

데이터베이스는 MOUNT 상태여야 한다.
제거하려는 로그파일이 CURRENT 또는 ACTIVE 상태일 때는 에러가 발생한다.
제거한 후에 최소 네 개의 로그파일 그룹이 남아 있어야 한다.

<drop logfile group statement>

기존의 로그파일 그룹을 제거한다.

• <group clause>

  • 제거할 로그파일 그룹을 지정한다.

  • integer는 존재하는 로그파일의 식별자여야 한다.

  • integer가 존재하지 않을 경우 에러가 발생한다.

<drop logfile member statement>

기존의 로그파일 멤버들을 제거한다.

• <logfile_list>

  • 제거할 로그파일 멤버의 목록이다.

  • 'logfile_name'은 존재하는 이름이어야 한다.

  • 'logfile_name'이 존재하지 않을 경우 에러가 발생한다.

설명

각 구문별 사용 규칙을 참조한다.

사용 예

다음은 기존 로그파일인 GROUP 3을 제거하는 예이다.

ALTER DATABASE DROP LOGFILE GROUP 3;

다음은 기존 로그파일인 GROUP 3에서 'logfile1.log'와 'logfile2.log'를 제거하는 예이다.

ALTER DATABASE DROP LOGFILE MEMBER 'logfile1.log', 'logfile2.log';

호환성

SQL 표준에서는 ALTER DATABASE 구문을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER DATABASE ADD LOGFILE

• ALTER DATABASE RENAME LOGFILE

ALTER DATABASE MOVE SHARD

기능

특정 cluster group의 모든 table들의 shard를 다른 cluster group으로 재배치한다.

구문

<alter database move shard statement> ::=
    ALTER DATABASE MOVE SHARD FROM CLUSTER GROUP src_cluster_group
        TO CLUSTER GROUP dest_cluster_group [ ONLINE | OFFLINE ];

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter database move shard statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

src_cluster_group

테이블의 shard를 이동할 cluster group이다.

dest_cluster_group

테이블의 shard를 이동시킬 target cluster group이다.

[ ONLINE | OFFLINE ]

테이블의 shard를 재배치할 때 DML을 허용할지 여부를 결정한다.

• ONLINE

  • INSERT, UPDATE, DELETE를 허용한다.

• OFFLINE

  • INSERT, UPDATE, DELETE를 허용하지 않는다.

• 생략할 경우, 기본값은 ONLINE 이다.

설명

다음과 같은 구문을 사용하여 cluster member와 cluster group을 추가할 때 table들의 shard는 재배치하지 않는다.

• CREATE CLUSTER GROUP

• ALTER CLUSTER GROUP name ADD MEMBER

Cluster group과 cluster member를 추가할 때 재배치되지 않은 모든 테이블들의 shard를 재배치하려면 <alter database rebalance statement> 구문을 수행한다.

Shard를 재배치하지 않은 테이블들에 대해 <alter database move shard statement> 구문을 수행하는 것은 다음과 같은 의미이다.

ALTER TABLE t1 MOVE SHARD FROM CLUSTER GROUP src_group TO CLUSTER GROUP dest_group;
COMMIT;
ALTER TABLE t2 MOVE SHARD FROM CLUSTER GROUP src_group TO CLUSTER GROUP dest_group;
COMMIT;
ALTER TABLE t3 MOVE SHARD FROM CLUSTER GROUP src_group TO CLUSTER GROUP dest_group;
COMMIT;
...
...
ALTER TABLE t_n MOVE SHARD FROM CLUSTER GROUP src_group TO CLUSTER GROUP dest_group;
COMMIT;

특정 테이블의 shard 재배치에 실패하더라도 <alter database move shard statement> 구문은 계속 진행되고 shard 재배치에 성공한 테이블을 rollback 하지 않는다.

따라서 에러에 대해 적절한 조치를 취한 후 <alter database move shard statement> 구문을 다시 수행하면 이미 shard 재배치에 성공한 테이블들은 재배치 대상에 포함되지 않으며, 재배치가 필요한 테이블들의 shard만 재배치한다.

사용 예

다음은 <alter database move shard statement> 구문을 수행하는 예이다.

gSQL> ALTER DATABASE MOVE SHARD FROM CLUSTER GROUP G1 TO CLUSTER GROUP G2;

Database altered.

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLE name MOVE SHARD

• CREATE CLUSTER GROUP

• ALTER CLUSTER GROUP name ADD MEMBER

ALTER DATABASE OFFLINE INACTIVE CLUSTER MEMBERS

기능

모든 inactive cluster member들을 offline 상태로 변경한다. 즉, 해당 cluster member들에 대한 shard map을 offline 상태로 변경한다.

구문

<alter database offline inactive cluster members statement> ::=
    ALTER DATABASE OFFLINE INACTIVE CLUSTER MEMBERS
    ;

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter database offline inactive cluster members statement> 구문을 수행하려면 사용자에게 ADMINISTRATION ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

모든 inactive cluster member들을 offline 상태로 변경한다.

Cluster member의 inactive 상태는 cluster system과 연결되어 있지 않은 상태로서 다음과 같은 상황에서 발생한다.

• 운영 중인 cluster system에서 해당 cluster member에 장애가 발생한 경우

• 해당 cluster member를 구동하지 않고 cluster system의 start-up을 시도한 경우

설명

<alter database offline inactive members statement> 구문은 모든 inactive cluster member 들이 더 이상 cluster system에 포함될 수 없는 경우에 사용하는 것이 바람직하다.

Inactive cluster member가 cluster system에 참여할 수 있으면 ALTER SYSTEM JOIN DATABASE 구문을 수행하여 cluster system에 포함시킨다.

Offline 상태로 변경된 cluster member는 join 후에 다음 구문을 사용하여 online 상태로 다시 변경할 수 있다

• ALTER DATABASE REBALANCE

• ALTER TABLE name REBALANCE

사용 예

gSQL> ALTER DATABASE OFFLINE INACTIVE CLUSTER MEMBERS;

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER SYSTEM JOIN DATABASE

• ALTER DATABASE REBALANCE

• ALTER TABLE name REBALANCE

ALTER DATABASE REBALANCE

기능

모든 table들의 shard를 재배치한다.

구문

<alter database rebalance statement> ::=
    ALTER DATABASE REBALANCE [ ONLINE | OFFLINE ];

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter database rebalance statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

[ ONLINE | OFFLINE ]

테이블의 shard를 재배치할 때 DML을 허용할지 여부를 결정한다.

• ONLINE

  • INSERT, UPDATE, DELETE를 허용한다.

• OFFLINE

  • INSERT, UPDATE, DELETE를 허용하지 않는다.

• 생략할 경우, 기본값은 ONLINE 이다.

설명

다음과 같은 구문을 사용하여 cluster member, cluster group을 추가할 때 table들의 shard를 재배치하지 않는다.

• CREATE CLUSTER GROUP

• ALTER CLUSTER GROUP name ADD MEMBER

추가된 cluster group과 cluster member에 재배치하지 않은 모든 테이블들의 shard를 재배치하기 위해 <alter database rebalance statement> 구문을 수행한다.

Shard를 재배치하지 않은 테이블들에 대해 <alter database rebalance statement> 구문을 수행하는 것은 다음과 같은 의미이다.

ALTER TABLE t1 REBALANCE;
COMMIT;
ALTER TABLE t2 REBALANCE;
COMMIT;
ALTER TABLE t3 REBALANCE;
COMMIT;
...
...
ALTER TABLE t_n REBALANCE;
COMMIT;

특정 테이블의 shard 재배치에 실패하더라도 <alter database rebalance statement> 구문은 계속 진행되며 shard 재배치에 성공한 테이블을 rollback 하지 않는다.

따라서 에러에 대해 적절한 조치를 취한 후 <alter database rebalance statement> 구문을 재수행할 경우 이미 shard 재배치에 성공한 테이블들은 재배치 대상에 포함되지 않으며, 재배치가 필요한 테이블들의 shard만 재배치한다.

사용 예

다음은 <alter database rebalance statement> 구문을 수행하는 예이다.

gSQL> ALTER DATABASE REBALANCE;

Database altered.

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 ALTER TABLE name REBALANCE를 참조한다.

ALTER DATABASE REBALANCE EXCLUDE CLUSTER GROUP

기능

특정 cluster group에 shard가 포함되지 않도록 모든 테이블의 shard를 재배치한다.

구문

<alter database rebalance exclude cluster group statement> ::=
    ALTER DATABASE REBALANCE EXCLUDE CLUSTER GROUP cluster_group_name [ ONLINE | OFFLINE ];

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter database rebalance exclude cluster group statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

cluster_group_name

테이블들의 shard를 포함하지 않는 cluster group의 이름이다.
지정한 cluster group이 유일한 cluster group인 경우 구문을 수행할 수 없다.

[ ONLINE | OFFLINE ]

테이블의 shard를 재배치할 때 DML을 허용할지 여부를 결정한다.

• ONLINE

  • INSERT, UPDATE, DELETE를 허용한다.

• OFFLINE

  • INSERT, UPDATE, DELETE를 허용하지 않는다.

• 생략할 경우, 기본값은 ONLINE 이다.

설명

DROP CLUSTER GROUP 구문을 사용하여 cluster group을 제거하려면 해당 cluster group에 shard가 존재하지 않아야 한다.

해당 cluster group이 shard를 포함하지 않도록 하기 위해 <alter database rebalance exclude cluster group statement> 구문을 수행한다. 해당 cluster group의 shard를 포함한 테이블들에 대해 <alter database rebalance exclude cluster group statement> 구문을 수행하는 것은 다음과 같은 의미이다.

ALTER TABLE t1 REBALANCE EXCLUDE CLUSTER GROUP g3;
COMMIT;
ALTER TABLE t2 REBALANCE EXCLUDE CLUSTER GROUP g3;
COMMIT;
ALTER TABLE t3 REBALANCE EXCLUDE CLUSTER GROUP g3;
COMMIT;
...
...
ALTER TABLE t_n REBALANCE EXCLUDE CLUSTER GROUP g3;
COMMIT;

저장 공간 부족 등으로 인해 <alter database rebalance exclude cluster group statement> 구문이 실패한 경우, shard 배제에 성공한 테이블은 rollback 하지 않는다.

따라서 에러에 대해 적절한 조치를 취한 후 <alter database rebalance exclude cluster group statement> 구문을 다시 수행하면 이미 shard 배제에 성공한 테이블들은 재배치 대상에 포함되지 않으며, 재배치가 필요한 테이블들의 shard만 배제하고 재배치한다.

사용 예

다음은 <alter database rebalance exclude cluster group statement> 구문을 수행하는 예이다.

gSQL> ALTER DATABASE REBALANCE EXCLUDE CLUSTER GROUP g3;

Database altered.

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• DROP CLUSTER GROUP

• ALTER TABLE name REBALANCE EXCLUDE CLUSTER GROUP cluster_group_list

ALTER DATABASE RENAME LOGFILE

기능

데이터베이스에서 로그파일의 이름을 수정한다.

구문

<alter database rename logfile statement> ::=
    ALTER DATABASE RENAME LOGFILE <logfile_list> TO <logfile_list>
    ;

<logfile_list> ::=
      'logfile_name'
    | <logfile_list> , 'logfile_name'

사용 범위 및 접근 권한

<alter database rename logfile statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<alter database rename logfile statement>

• 데이터베이스는 MOUNT 상태여야 한다.

• FROM <logfile_list>

  • 데이터베이스에서 수정할 로그파일들의 이름 목록이다.

• TO <logfile_list>

  • 데이터베이스에서 수정될 로그파일들의 이름 목록이다.

  • <logfile_list>는 존재하는 파일이어야 한다.

  • 파일이 존재하지 않을 경우 에러가 발생한다.

설명

각 구문별 사용 규칙을 참조한다.

사용 예

다음은 기존 로그파일 'logfile.log'를 'newlogfile.log'로 변경하는 예이다.

ALTER DATABASE RENAME LOGFILE 'logfile.log' TO 'newlogfile.log';

호환성

SQL 표준에서는 ALTER DATABASE 구문을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER DATABASE ADD LOGFILE

• ALTER DATABASE DROP LOGFILE

ALTER DATABASE RECOVER

기능

온라인/ archive log file을 사용하여 데이터베이스 내의 전체 데이터파일 (datafile) 또는 일부 데이터파일을 복구한다.

구문

<alter database recover statement> ::=
      <complete database recover statement>
    | <datafile recover statement>
    | <complete tablespace recover statement>
    | <incomplete database recover statement>
    ;

<complete database recover statement> ::=
    ALTER DATABASE RECOVER

<datafile recover statement> ::=
    ALTER DATABASE RECOVER DATAFILE <datafile recovery clause>

<datafile recovery clause> ::=
    <datafile recovery object> [, ...]

<datafile recovery object> ::=
    'datafile_name' [<recovery using backup option>] [recovery corruption option>]

<recovery using backup option> ::=
    USING BACKUP 'backup_datafile_name'

<recovery corruption option> ::=
    CORRUPTION

<complete tablespace recover statement> ::=
    ALTER DATABASE RECOVER TABLESPACE tablespace_name

<incomplete database recover statement> ::=
      <batch incomplete recovery statement>
    | <interactive incomplete recovery statement>
    ;

<batch incomplete recovery statement> ::=
    ALTER DATABASE RECOVER <until clause> [<using backup controlfile option>]
    
<until clause> ::=
      UNTIL CHANGE integer

<using backup controlfile option> ::=
    USING BACKUP CONTROLFILE

<interactive incomplete recovery statement> ::=
    ALTER DATABASE <incomplete recovery option> [<using backup controlfile option>]

<incomplete recovery option> ::=
      BEGIN INCOMPLETE RECOVERY
    | END INCOMPLETE RECOVERY
    | RECOVER 'logfile name'
    | RECOVER AUTOMATICALLY
    | RECOVER SUGGESTION
    ;

사용 범위 및 접근 권한

<alter database recover statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<complete database recover statement>

온라인 및 archive log file을 이용하여 데이터베이스의 데이터 파일들을 최신 상태로 복구한다.

• ONLINE 상태의 모든 테이블스페이스를 복구한다.

• 데이터베이스는 MOUNT 상태여야하고, ARCHIVELOG 모드여야 한다.

• 필요한 archive log file이 존재하지 않으면 실패한다.

<datafile recover statement>

Immediate option으로 offline 된 tablespace의 datafile, backup된 datafile 또는 backup 중 장애로 인해 archive logfile을 이용한 복구가 필요한 tablespace의 datafile들을 최신상태로 복구한다.

• Datafile은 MOUNT phase 또는 OPEN phase에서 복구할 수 있다.

• OPEN phase에서의 복구는 OFFLINE 상태의 tablespace의 datafile만 가능하고, MOUNT phase에서의 복구는 ONLINE/ OFFLINE 상태의 datafile 모두 가능하다.

• 필요한 archive logfile이 존재하지 않으면 복구에 실패한다.

• <datafile recovery clause>

  • 복구할 한 개 이상의 datafile object list를 기술한다.

• <datafile recovery object>

  • 복구할 datafile 이름과 복구 옵션을 설정한다.

• <recovery using backup option>

  • 복구할 datafile의 backup datafile 이름을 설정한다.

• <recovery corruption option>

  • 복구할 datafile에서 corrupt 된 page만 복구할지 여부를 설정한다.

<complete tablespace recover statement>

테이블스페이스의 데이터 파일들을 최신 상태로 복구한다.

• 테이블스페이스를 복구하려면 데이터베이스가 MOUNT 또는 OPEN 상태여야 한다.

• OPEN 상태에서의 복구는 OFFLINE 상태의 테이블스페이스만 가능하고, MOUNT 상태에서의 복구는 ONLINE/ OFFLINE 상태의 테이블스페이스 모두에 가능하다.

• 필요한 archive log file이 존재하지 않으면 복구에 실패한다.

• 다음과 같은 경우에는 테이블스페이스 복구 연산이 필요하다.

  • IMMEDIATE로 OFFLINE 된 테이블스페이스

  • 백업된 데이터 파일을 이용해야 하는 경우

  • 전체 백업 중 장애가 발생한 경우

<incomplete database recover statement>

<batch incomplete database recover statement>

온라인 및 archive log file을 이용하여 데이터베이스의 데이터 파일들을 최신상태가 아닌 특정 시점까지 일괄 복구한다.

• ONLINE 상태의 모든 테이블스페이스를 복구한다.

• 데이터베이스는 MOUNT 상태여야하고, ARCHIVELOG 모드여야 한다.

• 불완전 복구될 시점 이후의 데이터가 존재하는 데이터 파일을 이용하면 실패한다.

• 불완전 복구가 완료되면 반드시 RESETLOGS로 데이터베이스를 OPEN 해야 한다.

• <until clause>

  • 불완전 복구될 특정 시점이다.

  • UNTIL CHANGE: 로그 단위로 불완전 복구 시점을 지정한다.

• <using backup controlfile>

  • Deprecated.

<interactive incomplete database recover statement>

온라인 및 archive log file을 이용하여 데이터베이스의 데이터 파일들을 최신상태가 아닌 특정 시점까지 사용자와 대화식으로 복구한다.

• ONLINE 상태의 모든 테이블스페이스를 복구한다.

• 데이터베이스는 MOUNT 상태여야하고, ARCHIVELOG 모드여야 한다.

• 불완전 복구될 시점 이후의 데이터가 존재하는 데이터파일을 이용하면 실패한다.

• 불완전 복구가 완료되면 반드시 RESETLOGS로 데이터베이스를 OPEN 해야 한다.

• <incomplete recovery option>

  • 로그 파일 단위로 대화식 불완전 복구를 수행하기 위한 옵션이다.

  • BEGIN INCOMPLETE RECOVERY: 불완전 복구를 시작한다.

  • END INCOMPLETE RECOVERY: 불완전 복구를 종료한다.

  • RECOVER 'logfile name': 복구를 수행할 로그 파일을 사용자가 직접 설정한다.

  • RECOVER AUTOMATICALLY: 복구 가능한 모든 archive log file을 복구한다.

  • RECOVER SUGGESTION: 시스템이 추천한 복구를 위해 필요한 archive log file을 복구한다.

• <using backup controlfile>

  • Deprecated

설명

데이터베이스 불완전 복구는 복구 완료 시점을 한 번에 찾아내기 어려우므로 여러 번 수행하여 원하는 복구 시점을 찾아야 한다. 그런데 불완전 복구가 완료된 후 RESETLOGS 옵션으로 데이터베이스를 기동하면 새로운 데이터베이스가 되기 때문에 archive log file과 온라인 redo log file에 대한 복사본을 만든 후에 불완전 복구를 여러 번 수행해야 한다.

사용 예

다음은 전체 데이터베이스를 완전 복구하는 예이다.

ALTER DATABASE RECOVER;

다음은 데이터 파일을 복구하는 예이다.

ALTER DATABASE RECOVER DATAFILE 'test.dbf';

다음은 테이블스페이스를 복구하는 예이다.

ALTER DATABASE RECOVER TABLESPACE test_tbs;

다음은 LSN이 11123인 지점까지 전체 데이터베이스를 불완전 복구하는 예이다.

ALTER DATABASE RECOVER UNTIL CHANGE 11123;

다음은 복구 가능한 archive log file까지만 복구하는 대화식 불완전 복구의 예이다.

ALTER DATABASE BEGIN INCOMPLETE RECOVERY;
ALTER DATABASE RECOVER AUTOMATICALLY;
ALTER DATABASE END INCOMPLETE RECOVERY;

호환성

SQL 표준에서는 ALTER DATABASE 구문을 정의하지 않고 있다

참조

관련 내용은 다음을 참조한다.

• ALTER DATABASE BACKUP

• ALTER TABLESPACE name BACKUP

• ALTER SYSTEM {MOUNT | OPEN} DATABASE

ALTER DATABASE REGISTER

기능

복구 불가능한 세그먼트를 데이터베이스에 등록한다.

구문

<alter database register statement> ::=
    ALTER DATABASE REGISTER IRRECOVERALBE SEGMENT 
        <segment physical identifier list>
    ;

<segment physical identifier list> ::=
      integer
    | <segment physical identifier list> , integer

사용 범위 및 접근 권한

<alter database register statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<alter database register statement>

복구 불가능한 세그먼트를 데이터베이스에 등록한다. 해당 구문은 백업이 존재하지 않고 데이터베이스를 복구할 수 없는 경우, 세그먼트를 더 이상 사용하지 않는다는 가정하에 사용될 수 있다.

• 데이터베이스가 MOUNT 상태여야 한다.

• 등록된 세그먼트 식별자 목록은 재시작할 때 초기화된다.

• 서버 재시작에 성공하면 등록된 세그먼트들이 'UNUSABLE' 상태가 되는데 해당 세그먼트들은 반드시 삭제해야 한다.

<segment physical identifier list>

복구 불가능한 세그먼트의 식별자 목록이다.
• Integer: 8 바이트 정수형의 세그먼트 식별자

설명

서버를 비정상 종료하고 재시작할 때 데이터베이스를 복구하는데, 이 때 이전 서비스 단계에서 디스크에 반영되지 못한 페이지들을 복구하기 위해서 REDO 로그들을 이용해 페이지를 다시 수행한다.

REDO 연산을 수행하는 중에 예상하지 못한 실패가 발생한 경우, 이를 무시하고 복구하기 위해 사용될 수 있다.

사용 예

다음은 4028679323648을 식별자로 갖는 세그먼트 복구를 포기하는 예이다.

ALTER DATABASE REGISTER IRRECOVERABLE SEGMENT 4028679323648;

호환성

SQL 표준에서는 ALTER DATABASE 구문을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLESPACE name BACKUP

• ALTER DATABASE RECOVER

ALTER DATABASE RESET LOCAL CLUSTER MEMBER

기능

Local cluster member에서 tablespace 객체를 제외한 부분을 database 생성 시점으로 초기화한다.

구문

<alter database reset local cluster member statement> ::=
    ALTER DATABASE RESET LOCAL CLUSTER MEMBER
    ;

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

Start-up 과정 중 LOCAL OPEN 단계에서 수행할 수 있다.

<alter database reset local cluster member statement> 구문을 수행하려면 사용자에게 ADMINISTRATION ON DATABASE 권한이 있어야 한다.

설명

Local cluster member에서 tablespace 객체를 제외한 부분을 database 생성 시점으로 초기화한다.
Tablespace 객체를 제외하고 사용자가 생성한 모든 객체를 제거한다.

<alter database reset local cluster member statement> 구문은 inactive cluster member를 초기화하고,
새로운 cluster member를 cluster system에 참여시키기 위해 사용한다.
Cluster system과 연결이 끊긴 inactive cluster member 들은 다음과 같이 처리할 수 있다.

• Cluster system에 다시 참여할 수 있는 경우 JOIN 구문을 이용하여 참여시킨다.

  • ALTER SYSTEM JOIN DATABASE

• Cluster system에 다시 참여할 수 없는 경우, DROP 구문을 이용하여 cluster system에서 제외한다.

  • ALTER DATABASE DROP INACTIVE CLUSTER MEMBERS

이 때, cluster system에서 제외된 cluster member에 해당하는 장비는 다음 두 가지 방법으로 재사용할 수 있다.

• 방법 1: Local cluster member의 database를 다시 생성한다.

• 방법 2: <alter database reset local cluster member statement> 구문을 이용해 local cluster member를 초기화한다.

방법 2는 방법 1보다 tablespace를 재생성하는 비용을 줄일 수 있다.

사용 예

다음은 cluster system에서 제외된 local cluster member를 LOCAL OPEN 단계까지 구동한 후, <alter database reset local cluster member statement> 구문을 이용해 초기화하는 예이다.

gSQL> \startup nomount

Startup success


gSQL> ALTER SYSTEM MOUNT DATABASE;

System altered.


gSQL> ALTER SYSTEM OPEN LOCAL DATABASE;

System altered.

gSQL> ALTER DATABASE RESET LOCAL CLUSTER MEMBER;

Database altered.

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER SYSTEM JOIN DATABASE

• ALTER DATABASE DROP INACTIVE CLUSTER MEMBERS

ALTER DATABASE RESTORE

기능

증분 백업을 이용하여 데이터베이스나 테이블스페이스 내의 데이터 파일들을 복원한다.

구문

<alter database restore statement> ::=
      <database restore statement>
    | <tablespace restore statement>
    | <controlfile restore statement>
    ;

<database restore statement> ::=
    ALTER DATABASE RESTORE [ <until clause> ]

<until clause> ::=
    UNTIL CHANGE integer

<tablespace restore statement> ::=
    ALTER DATABASE RESTORE TABLESPACE tablespace_name

<controlfile restore statement> ::=
    ALTER DATABASE RESTORE CONTROLFILE FROM 'file_name'

사용 범위 및 접근 권한

alter database restore statement> 구문을 수행하려면 사용자에게 ALTER DATABASE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<database restore statement>

증분 백업을 사용하여 데이터베이스 내의 데이터 파일들을 복원한다. 
데이터베이스가 MOUNT 상태여야 한다.

<tablespace restore statement>

증분 백업을 사용하여 테이블스페이스 내의 데이터 파일들을 복원한다.

• 데이터베이스가 MOUNT 또는 OPEN 상태여야 한다.

• OPEN 상태에서는 OFFLINE 상태의 테이블스페이스만 복원할 수 있고, MOUNT 상태에서는 ONLINE/ OFFLINE 상태의 테이블스페이스 모두 복원할 수 있다.

<controlfile restore statement>

'file_name'을 사용하여 제어파일을 복원한다.

• 데이터베이스가 NOMOUNT 상태여야 한다.

• 'file_name'은 절대 경로를 권장하지만, 만약 상대 경로를 기술한 경우에는 <GOLDILOCKS_HOME>/wal/'file_name'을 이용한다.

설명

전체 백업을 이용한 데이터 파일 복원은 OS 복사 명령으로 백업된 파일을 직접 데이터 파일 경로에 복사하는 방법이다. 증분 백업을 이용한 데이터 파일 복원은 삭제된 데이터 파일이나 이전 데이터 파일들만 복원한다.

사용 예

다음은 증분 백업을 사용하여 데이터베이스를 복원하는 예이다.

ALTER DATABASE RESTORE;

다음은 증분 백업을 사용하여 테이블스페이스를 복원하는 예이다.

ALTER DATABASE RESTORE TABLESPACE test_tbs;

다음은 LSN이 11123 보다 작은 증분 백업만 사용하여 데이터베이스를 복원하는 예이다.

ALTER DATABASE RESTORE UNTIL CHANGE 11123;

다음은 controlfile.bak을 사용하여 제어파일을 복원하는 예이다.

ALTER DATABASE RESTORE CONTROLFILE FROM 'controlfile.bak'

호환성

SQL 표준에서는 ALTER DATABASE 구문을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER DATABASE BACKUP

• ALTER TABLESPACE name BACKUP

• ALTER DATABASE RECOVER

ALTER INDEX

기능

인덱스 정의를 변경한다.

구문

<alter index statement> ::=
      <alter index physical attribute statement>
    | <rename index statement>
    | <aging index statement>
    ;

사용 범위 및 접근 권한

<alter index statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 인덱스의 소유자

• 인덱스가 속한 테이블의 소유자

• 인덱스가 속한 테이블에 대해 CONTROL TABLE ON TABLE

• 인덱스가 속한 스키마에 대해 (ALTER INDEX 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY INDEX ON DATABASE

구문 규칙 및 파라미터

<alter index physical attribute statement>

인덱스의 물리적 속성을 변경한다.
자세한 내용은 ALTER INDEX name STORAGE 구문을 참조한다.

<rename index statement>

인덱스 이름을 변경한다.
자세한 내용은 ALTER INDEX name RENAME TO 구문을 참조한다.

<aging statement>

인덱스의 빈 페이지를 삭제한다.
자세한 내용은 ALTER INDEX name AGING 구문을 참조한다.

설명

각 세부 구문의 설명을 참조한다.

사용 예

각 세부 구문의 사용 예를 참조한다.

호환성

SQL 표준은 인덱스에 대한 개념을 다루지 않고 있다.

ALTER INDEX name AGING

기능

인덱스의 빈 페이지를 삭제한다.

구문

<aging index statement> ::=
    ALTER INDEX index_name AGING
    ;

사용 범위 및 접근 권한

<aging index statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 인덱스의 소유자

• 인덱스가 속한 테이블의 소유자

• 인덱스가 속한 테이블에 대해 CONTROL TABLE ON TABLE

• 인덱스가 속한 스키마에 대해 (ALTER INDEX 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY INDEX ON DATABASE

구문 규칙 및 파라미터

index_name

대상 인덱스의 이름이다.

설명

해당 구문은 인덱스 페이지들 중에 모든 키가 삭제된 페이지들을 세그먼트로 반납한다. Aging은 논리적 삭제와 물리적 삭제의 2단계로 진행된다. 논리적 삭제는 인덱스에서 페이지를 지칭하는 연결을 끊는 작업이며 페이지의 마지막 키를 삭제할 당시의 SCN이 시스템의 agable SCN보다 작을 때 수행된다. 이후 물리적 삭제가 이루어지는데 논리적으로 삭제할 때의 SCN이 시스템의 agable SCN보다 작을 때 수행된다.

사용 예

다음은 인덱스를 aging하는 예이다.

gSQL> select index_name, empty_blocks from user_indexes where index_name = 'T1X';

INDEX_NAME EMPTY_BLOCKS
---------- ------------
T1X                   2

1 row selected.

gSQL> alter index t1x aging;

Index altered.

gSQL> select index_name, empty_blocks from user_indexes where index_name = 'T1X';

INDEX_NAME EMPTY_BLOCKS
---------- ------------
T1X                   0

1 row selected.

호환성

SQL 표준은 인덱스에 대한 개념을 다루지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• CREATE INDEX

• ALTER INDEX

• DROP INDEX

ALTER INDEX name STORAGE

기능

인덱스의 물리적 속성을 변경한다.

구문

<alter index physical attribute statement> ::=
    ALTER INDEX index_name
    | <physical attribute clause>
    | [ STORAGE ( <segment attr clause> [...] ) ]
    ;

<physical attribute clause> ::=
      PCTFREE integer
    | INITRANS integer
    | MAXTRANS integer

<segment attr clause> ::=
      INITIAL <size_clause>
    | NEXT <size_clause>
    | MINSIZE <size_clause>
    | MAXSIZE <size_clause>

<size clause> ::=
      integer [ K | M | G | T ]

사용 범위 및 접근 권한

<alter index physical attribute statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 인덱스의 소유자

• 인덱스가 속한 테이블의 소유자

• 인덱스가 속한 테이블에 대해 CONTROL TABLE ON TABLE

• 인덱스가 속한 스키마에 대해 (ALTER INDEX 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY INDEX ON DATABASE

구문 규칙 및 파라미터

index_name

대상 인덱스의 이름이다.

<physical attribute clause>

인덱스의 물리적 속성 정보를 정의한다.

• PCTFREE integer

  • 정의

    • 페이지 내에 key 삽입으로 인한 페이지 분할 빈도를 조절하기 위해 예약된 공간이다.

    • 인덱스 bottom-up 빌드 시에만 적용된다.

  • 0 에서 99 까지의 값을 사용할 수 있다.

  • 생략할 경우, 기본값은 DEFAULT_INDEX_PCTFREE property에 설정된 값을 사용한다.

• INITRANS integer

  • 정의

    • 페이지에 동시 접근할 수 있는 초기 트랜잭션의 개수이다.

    • 인덱스에 접근하는 사용자의 수가 적을 경우에는 INITRANS를 낮게 설정하고, 동시에 접근하는 사용자가 많을 경우에는 INITRANS를 높게 설정한다.

    • 필요한 경우 설정된 MAXTRANS까지 자동으로 늘어난다.

  • 1 부터 32 까지의 값을 사용할 수 있다.

  • 생략할 경우, 기본값은 4 이다.

• MAXTRANS integer

  • 정의

    • 페이지에 동시 접근할 수 있는 트랜잭션의 최대 개수이다.

  • 1 부터 32 까지의 값을 사용할 수 있다.

  • 생략할 경우, 기본값은 8 이다.

<segment attr clause>

인덱스가 저장될 공간에 대한 정보를 기술한다.

• INITIAL integer

  • 정의

    • 인덱스를 생성할 때 초기에 할당할 물리적 공간의 크기를 기술한다.

    • 이 크기는 테이블이 속하는 TABLESPACE의 EXTENT 크기에 align 되어 사용된다. (예: EXT 크기가 8192 bytes일 경우 'INITIAL 100'은 실제 8192 bytes로 동작한다.)

    • 이 크기 (TABLESPACE의 EXTENT 크기에 align 된 크기)는 MINEXTENTS의 크기와 같거나 커야 하며, MAXEXTENTS의 크기와 같거나 작아야 한다.

    • 인덱스 bottom-up 빌드 시에만 적용된다.

  • 최소값은 1이고 최대값은 시스템 환경에 따라 다르다.

  • 생략할 경우, 기본값은 테이블이 속한 TABLESPACE의 EXTENT 하나 크기이다.

• NEXT integer

  • 정의

    • 인덱스의 물리적 공간을 추가할 경우 할당할 물리적 공간의 크기를 기술한다.

    • 이 크기는 테이블이 속하는 TABLESPACE의 EXTENT 크기에 align 되어 사용된다. (예: EXT 크기가 8192 bytes일 경우 'NEXT 100'은 실제 8192 bytes로 동작한다.)

    • NEXT는 현재 인덱스가 사용할 수 있는 남은 공간의 크기 (MAXEXTENTS의 크기에서 현재 사용하고 있는 공간의 크기를 뺀 크기)에 따라 아래와 같이 동작한다.

    - 남은 공간의 크기가 0인 경우 더 이상 공간을 확장하지 못한다.

    - 남은 공간의 크기가 0보다 크고 NEXT보다 작은 경우 남은 공간의 크기만큼 할당한다.

    - 남은 공간의 크기가 NEXT 보다 클 경우 NEXT의 크기만큼 할당한다.

  • 최소값은 1이고 최대값은 시스템 환경에 따라 다르다.

  • 생략할 경우, 기본값은 인덱스가 속한 TABLESPACE의 EXTENT 하나 크기이다.

• MINSIZE integer

  • 정의

    • 인덱스에서 유지해야할 최소 공간의 크기이다.

    • 이 값은 MAXSIZE의 값과 같거나 작아야 한다.

  • 이 크기는 인덱스가 속하는 TABLESPACE의 EXTENT 크기에 align 되어 사용된다.

  • 최소값은 1이고 최대값은 시스템 환경에 따라 다르다.

  • EXTENT 두 개 크기보다 작을 경우 EXTENT 두 개 크기로 결정된다.

  • 생략할 경우, 기본값은 EXTENT 두 개 크기이다.

• MAXSIZE integer

  • 정의

    • 인덱스에서 할당받을 수 있는 최대 공간의 크기이다.

    • 이 값은 MINSIZE의 값과 같거나 커야 한다.

  • 이 크기는 인덱스가 속하는 TABLESPACE의 EXTENT 크기에 align 되어 사용된다.

  • 최소값은 1이고 최대값은 시스템 환경에 따라 다르다.

  • 생략할 경우, 기본값은 EXTENT 크기 * 2147483647 (INT32의 최대 양의 정수)이다.

<size clause>

파일의 바이트 크기를 명시한다. (단위를 기술하지 않을 경우 bytes이다.)

• K: Kilobytes

• M: Megabytes

• G: Gigabytes

• T: Terabytes

설명

각 구문별 사용 규칙을 참조한다.

사용 예

다음은 인덱스의 물리적 속성을 변경하는 예이다.

gSQL> ALTER INDEX idx_t1_id PCTFREE 10 INITRANS 4 MAXTRANS 8;

Index altered.

호환성

SQL 표준은 인덱스에 대한 개념을 다루지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• CREATE INDEX

• ALTER INDEX

• DROP INDEX

ALTER INDEX name RENAME TO

기능

인덱스의 이름을 변경한다.

구문

<rename index statement> ::=
    ALTER INDEX index_name
        RENAME TO new_index_name
    ;

사용 범위 및 접근 권한

<rename index statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 인덱스의 소유자

• 인덱스가 속한 테이블의 소유자

• 인덱스가 속한 테이블에 대해 CONTROL TABLE ON TABLE

• 인덱스가 속한 스키마에 대해 (ALTER INDEX 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY INDEX ON DATABASE

구문 규칙 및 파라미터

index_name

대상 인덱스의 이름이다.
스키마 이름을 기술할 수 없으며, 기존 인덱스와 동일한 스키마 이름을 갖는다.

new_index_name

새로운 인덱스의 이름이며 스키마 내에서 유일한 인덱스 이름이어야 한다.

설명

각 구문별 사용 규칙을 참조한다.

사용 예

다음은 인덱스의 이름을 변경하는 예이다.

gSQL> ALTER INDEX t1_idx1 RENAME TO idx_t1_id;

Index altered.

호환성

SQL 표준은 인덱스에 대한 개념을 다루지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• CREATE INDEX

• ALTER INDEX

• DROP INDEX

ALTER PROFILE

기능

비밀번호 관리 방법을 변경한다.

구문

<alter profile statement> ::= 
    ALTER PROFILE profile_name LIMIT 
    { <password_parameters>, ...}
    ; 

<password parameters> ::= 
      FAILED_LOGIN_ATTEMPTS { integer | UNLIMITED | DEFAULT }
    | PASSWORD_LOCK_TIME  { password_parameter_number_interval | UNLIMITED | DEFAULT }
    | PASSWORD_LIFE_TIME  { password_parameter_number_interval | UNLIMITED | DEFAULT }
    | PASSWORD_GRACE_TIME { password_parameter_number_interval | UNLIMITED | DEFAULT }
    | PASSWORD_REUSE_MAX  { integer | UNLIMITED | DEFAULT }
    | PASSWORD_REUSE_TIME { password_parameter_number_interval | UNLIMITED | DEFAULT }
    | PASSWORD_VERIFY_FUNCTION { <verify_policy> | NULL | DEFAULT }

<verify_policy> ::= 
      KISA_VERIFY_FUNCTION
    | ORA12C_VERIFY_FUNCTION
    | ORA12C_STRONG_VERIFY_FUNCTION
    | VERIFY_FUNCTION_11G 
    | VERIFY_FUNCTION

<password_parameter_number_interval> ::=
   integer 
 | integer / integer

사용 범위 및 접근 권한

<alter profile statement> 구문을 수행하려면 사용자에게 ALTER PROFILE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

profile_name

변경할 profile의 이름이다.

FAILED_LOGIN_ATTEMPTS

로그인 연속 실패 허용 횟수를 설정한다.
자세한 내용은 CREATE PROFILE 구문을 참조한다.

PASSWORD_LOCK_TIME

로그인에 연속적으로 실패한 후에 계정이 잠기는 기간 (day)을 설정한다.
자세한 내용은 CREATE PROFILE 구문을 참조한다.

PASSWORD_LIFE_TIME

비밀번호의 유효 기간 (day)을 설정한다.
자세한 내용은 CREATE PROFILE 구문을 참조한다.

PASSWORD_GRACE_TIME

PASSWORD_LIFE_TIME 이후에 로그인 할 때 비밀번호 만료를 유예하는 기간을 설정한다.
자세한 내용은 CREATE PROFILE 구문을 참조한다.

PASSWORD_REUSE_MAX

이전 비밀번호를 재사용하려 할 때 재사용할 수 없는 최근 비밀번호 개수를 명시한다.
자세한 내용은 CREATE PROFILE 구문을 참조한다.

PASSWORD_REUSE_TIME

이전 비밀번호를 재사용하기 위해 필요한 경과 기간을 명시한다.
자세한 내용은 CREATE PROFILE 구문을 참조한다.

PASSWORD_VERIFY_FUNCTION

비밀번호 복잡도 검증 방법을 설정한다.
자세한 내용은 CREATE PROFILE 구문을 참조한다.

사용 예

다음은 계정 잠금을 제어하기 위해 profile을 변경하는 예이다.

gSQL> ALTER PROFILE prof1 LIMIT
        FAILED_LOGIN_ATTEMPTS 3
        PASSWORD_LOCK_TIME 3;

Profile altered.

gSQL> COMMIT;

Commit complete.

다음은 비밀번호 만료를 제어하기 위해 profile을 변경하는 예이다

gSQL> ALTER PROFILE prof1 LIMIT
        PASSWORD_LIFE_TIME 90 
        PASSWORD_GRACE_TIME 7;

Profile altered.

gSQL> COMMIT;

Commit complete.

다음은 비밀번호 재사용 여부를 제어하기 위해 profile을 변경하는 예이다.

gSQL> ALTER PROFILE prof1 LIMIT
        PASSWORD_REUSE_MAX  DEFAULT
        PASSWORD_REUSE_TIME DEFAULT;

Profile altered.

gSQL> COMMIT;

Commit complete.

다음은 비밀번호 복잡도 검사를 제어하기 위해 profile을 변경하는 예이다.

gSQL> ALTER PROFILE prof1 LIMIT
        PASSWORD_VERIFY_FUNCTION KISA_VERIFY_FUNCTION;

Profile altered.

gSQL> COMMIT;

Commit complete.

호환성

SQL 표준은 profile에 대한 개념을 다루지 않고 있다.

참조

관련 내용은 DROP PROFILE을 참조한다.

ALTER SEQUENCE

기능

시퀀스를 변경한다.

구문

<alter sequence generator statement> ::=
    ALTER SEQUENCE sequence_name <alter sequence generator options>
    ;

<alter sequence generator options> ::=
    <alter sequence generator option> [, ...]

<alter sequence generator option> ::=
      <alter sequence generator restart option>
    | <basic sequence generator option>

<alter sequence generator restart option> ::=
    RESTART [ WITH integer ]

<basic sequence generator option> ::=
      <sequence generator increment by option>
    | <sequence generator maxvalue option>
    | <sequence generator minvalue option>
    | <sequence generator cycle option>
    | <sequence generator cache option>


<sequence generator increment by option> ::=
    INCREMENT BY integer

<sequence generator maxvalue option> ::=
      MAXVALUE integer
    | (NO MAXVALUE | NOMAXVALUE)

<sequence generator minvalue option> ::=
      MINVALUE integer
    | (NO MINVALUE | NOMINVALUE)

<sequence generator cycle option> ::=
      CYCLE 
    | (NO CYCLE | NOCYCLE)

<sequence generator cache option> ::=
      CACHE integer
    | (NO CACHE | NOCACHE)

사용 범위 및 접근 권한

<alter sequence generator statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 해당 시퀀스의 소유자

• 시퀀스가 속한 스키마에 대해 (ALTER SEQUENCE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY SEQUENCE ON DATABASE

구문 규칙 및 파라미터

sequence_name

변경할 시퀀스의 이름이다.
schema_name.sequence_name과 같이 시퀀스가 속할 스키마를 정의할 수 있으며, schema_name을 생략할 경우, 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

<alter sequence generator restart option>

시퀀스의 다음 값 (NEXT VALUE)을 설정한다.
단, CREATE SEQUENCE 구문에서 정의한 START WITH의 값은 변경하지 않는다.

• RESTART

  • 값을 명시하지 않을 경우, <sequence generator definition>에서 정의한 START WITH의 값이 시퀀스의 다음 값으로 설정된다.

• RESTART WITH integer

  • integer 값을 시퀀스의 다음 값으로 설정한다.

  • integer 값은 MINVALUE와 MAXVALUE 사이의 값이어야 한다.

<alter sequence generator restart option> 절을 명시하지 않은 경우, 시퀀스의 현재값을 기준으로 시퀀스의 속성을 변경한다.

<sequence generator increment by option>

시퀀스 번호의 간격을 변경한다.
다음과 같은 제약과 특징을 갖는다.

• 양수 또는 음수를 사용할 수 있으며, 0은 사용할 수 없다.

• 간격의 절대값은 MINVALUE와 MAXVALUE의 차이보다 작아야 한다.

• 양수일 경우 오름차순 시퀀스가 되고 음수일 경우 내림차순 시퀀스가 된다.

<sequence generator maxvalue option>

시퀀스로 생성할 수 있는 최대값을 변경한다.
단, MAXVALUE의 값이 시퀀스의 현재값보다 작지 않아야 한다.

• MAXVALUE integer

  • 최대값의 범위는 64bit 정수의 최소값 (−9,223,372,036,854,775,808)에서 64bit 정수의 최대값(+9,223,372,036,854,775,807) 까지이다.

  • START WITH의 값과 같거나 크고, MINVALUE 값보다 커야 한다.

• NO MAXVALUE | NOMAXVALUE

  • 최대값을 다음과 같이 변경한다.

    • 오름차순 시퀀스일 경우, 64 bit 정수의 최대값 (+9,223,372,036,854,775,807)이 된다.

    • 내림차순 시퀀스일 경우, -1이 된다.

    • NO MAXVALUE (SQL 표준)와 NOMAXVALUE는 동일한 의미의 예약어이므로 어떤 것을 사용해도 무방하다.

<sequence generator minvalue option>

시퀀스로 생성할 수 있는 최소값을 변경한다.
단, MINVALUE의 값이 시퀀스의 현재값보다 크지 않아야 한다.

• MINVALUE integer

  • 최소값의 범위는 64 bit 정수의 최소값 (−9,223,372,036,854,775,808)에서 64 bit 정수의 최대값(+9,223,372,036,854,775,807) 까지이다.

  • START WITH의 값과 같거나 작고, MAXVALUE 값보다 작아야 한다.

• NO MINVALUE | NOMINVALUE

  • 최소값을 다음과 같이 변경한다.

    • 오름차순 시퀀스일 경우, 1이 된다.

    • 내림차순 시퀀스일 경우, 64 bit 정수의 최소값 (−9,223,372,036,854,775,808)이 된다.

  • NO MINVALUE (SQL 표준)와 NOMINVALUE는 동일한 의미의 예약어이므로 어떤 것을 사용해도 무방하다.

<sequence generator cycle option>

시퀀스의 값이 최대값 또는 최소값이 되었을 때, 계속 값을 생성할지 여부를 변경한다.

• CYCLE

  • 오름차순 시퀀스가 최대값이 되었을 때, 최소값부터 다시 생성한다.

  • 내림차순 시퀀스가 최소값이 되었을 때, 최대값부터 다시 생성한다.

• NO CYCLE | NOCYCLE

  • 최대값 또는 최소값이 되었을 때, 시퀀스 값을 생성할 수 없다.

  • NO CYCLE (SQL 표준)과 NOCYCLE은 동일한 의미의 예약어이므로 어떤 것을 사용해도 무방하다.

<sequence generator cache option>

시퀀스에 신속하게 접근하기 위해 메모리상에 미리 적재할 시퀀스 값의 개수를 정의한다.
Database를 재구동할 때, 메모리상에 적재한 시퀀스 값은 유실되고 적재한 이후의 값부터 시작된다.

• CACHE integer

  • CACHE 값은 2와 같거나 커야하고

  • CYCLE이 존재할 경우 CACHE 값이 CYCLE의 길이보다 크지 않아야 한다.

    • CYCLE의 길이: CEIL(MAXVALUE - MINVALUE) / ABS(INCREMENT)

• NO CACHE | NOCACHE

  • 메모리 상에 시퀀스값을 미리 적재하지 않는다.

설명

CREATE SEQUENCE 구문에서 정의한 시퀀스 속성 중 START WITH는 변경할 수 없다.
START WITH 속성을 변경하려면 DROP SEQUENCE 구문을 수행한 후에 CREATE SEQUENCE 구문을 사용하여 다시 생성해야 한다.

사용 예

다음은 RESTART 옵션으로 시퀀스 값을 재시작하고 이를 사용하여 ID 값을 새로 부여하는 예이다.

gSQL> SELECT id, name FROM t1 ORDER BY 1;

 ID NAME  
--- ------
 10 leekmo
 42 mkkim 
 51 jhkim 
172 ehpark

4 rows selected.


gSQL> ALTER SEQUENCE seq1 RESTART;

Sequence altered.


gSQL> UPDATE t1 SET id = seq1.NEXTVAL;

4 rows updated.


gSQL> SELECT id, name FROM t1 ORDER BY 1;

ID NAME  
-- ------
 1 leekmo
 2 mkkim 
 3 jhkim 
 4 ehpark

4 rows selected.

호환성

SQL 표준에서는 CACHE/ NO CACHE 절을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• CREATE SEQUENCE

• DROP SEQUENCE

ALTER SESSION CLEANUP GLOBAL TEMPORARY SEGMENT POOL;

기능

세션에서 재사용하기 위해 catching 된 모든 공간들을 해당 tablespace로 반환한다.

구문

<alter session cleanup global temporary segment pool statement> ::=
    ALTER SESSION CLEANUP GLOBAL TEMPORARY SEGMENT POOL
    ;

설명

수행된 세션에서 segment cache의 segment들만 cleanup한다.

사용 예

다음은 세션 segment cache를 cleanup하는 예이다.

gSQL> ALTER SESSION CLEANUP GLOBAL TEMPORARY SEGMENT POOL;

Session altered.

호환성

SQL 표준에서는 global temporary table, global temporary index의 segment cache 개념을 정의하지 않고 있다.

참조

관련 내용은 Global Temporary Table 을 참조한다.

ALTER SESSION SET property_name

기능

세션의 프로퍼티 값을 설정한다.

구문

<alter session set statement> ::=
    ALTER SESSION SET <property name> { = <property value> | TO DEFAULT }
    ;

구문 규칙 및 파라미터

<property name>

설정할 프로퍼티 이름이다.
자세한 내용은 Database Administration 매뉴얼의 Server Property 장을 참조한다.

<property value>

설정할 프로퍼티 값이다.

TO DEFAULT

세션 프로퍼티 값을 시스템 프로퍼티 값으로 설정한다.

설명

각 property에 대한 자세한 설명은 Database Administration 매뉴얼의 Server Property 장을 참조한다.

사용 예

다음은 HINT_ERROR 속성을 설정하여 hint 구문에 오류가 있을 경우 에러가 발생하는 예이다.

gSQL> ALTER SESSION SET HINT_ERROR = ON;

Session altered.

gSQL> SELECT /*+ INDEX( t1, invalid_index ) */ name FROM t1 WHERE id = 1;

ERR-42000(16058): not applicable hint : 
SELECT /*+ INDEX( t1, invalid_index ) */ name FROM t1 WHERE id = 1
           *
ERROR at line 1:

다음은 세션 프로퍼티 값을 시스템 프로퍼티의 값으로 설정하는 예이다.

gSQL> ALTER SESSION SET HINT_ERROR TO DEFAULT;

Session altered.

호환성

SQL 표준에서는 세션 프로퍼티 개념을 정의하지 않고 있다.

참조

관련 내용은 ALTER SESSION SET property_name을 참조한다.

ALTER SYSTEM CHECKPOINT

기능

CHECKPOINT를 수행한다.

구문

<alter system checkpoint statement> ::=
    ALTER SYSTEM CHECKPOINT
    [ AT <domain name> ]
    ;

사용 범위 및 접근 권한

<alter system checkpoint statement> 구문을 수행하려면 사용자에게 ALTER SYSTEM ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<alter system checkpoint statement>

CHECKPOINT는 commit된 트랜잭션들이 변경한 모든 데이터가 디스크에 기록되는 것을 보장하는 연산이다.

• 데이터베이스가 OPEN 상태여야 한다.

• 데이터베이스가 TDS 모드여야 한다.

• 전체 백업이 진행중일 때는 변경된 페이지가 데이터 파일에 기록되지 않고, REDO 로그와 제어파일만 디스크에 기록된다. 만약 이러한 상태에서 서버가 비정상 종료되는 경우에는 미디어 복구를 수행해야 한다.

<domain name>

구문을 수행할 멤버나 그룹의 이름이다.
지정하지 않은 경우에는 모든 그룹에 수행된다.

설명

체크포인트 (checkpoint) 연산은 commit 된 트랜잭션들이 변경한 모든 내용을 디스크에 기록함으로써 시스템 장애시 신속한 복구를 가능하게 한다.

사용 예

다음은 CHECKPOINT를 수행하는 예이다.

ALTER SYSTEM CHECKPOINT;

호환성

SQL 표준에서는 CHECKPOINT 개념을 정의하지 않고 있다.

ALTER SYSTEM CLEANUP PLAN

기능

모든 SQL plan을 정리한다.

구문

<alter system cleanup plan statement> ::=
    ALTER SYSTEM CLEANUP PLAN
    [ AT <domain name> ]
    ;

사용 범위 및 접근 권한

<alter system cleanup plan statement> 구문을 수행하려면 사용자에게 ALTER SYSTEM ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<alter system cleanup plan statement>

해당 구문 규칙이나 파라미터가 존재하지 않는다.

<domain name>

구문을 수행할 멤버나 그룹의 이름이다.
지정하지 않은 경우에는 모든 그룹에 수행된다.

설명

캐시되어 있는 모든 SQL plan을 정리한다. 
단, V$SQL_CACHE.REF_COUNT가 0보다 큰 plan (prepare된 statement에서 참조하는 plan)들은 정리 대상에서 제외한다.

사용 예

다음은 CLEANUP PLAN을 수행하는 예이다.

ALTER SYSTEM CLEANUP PLAN;

호환성

SQL 표준에서는 CLEANUP PLAN의 개념을 정의하지 않고 있다.

ALTER SYSTEM IRRECOVERABLE CLUSTER MEMBER

기능

복구 불가능한 클러스터 멤버를 지정한다.

구문

<alter system irrecoverable cluster member statement> ::=
    ALTER SYSTEM IRRECOVERABLE CLUSTER MEMBER <domain name>
    ;

사용 범위 및 접근 권한

<alter system irrecoverable cluster member statement> 구문을 수행하려면 사용자에게 ALTER SYSTEM ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<alter system irrecoverable cluster member statement>

해당 구문 규칙이나 파라미터가 존재하지 않는다.

<domain name>

복구 불가능한 멤버 이름이다.
그룹 내의 모든 멤버들을 복구 불가한 멤버로 지정할 수 없다.

설명

복구 불가능한 멤버로 인해 클러스터 재시작에 실패하는 경우 해당 멤버를 제외하고 시스템을 재시작하기 위해 사용한다. 시스템 재시작에 성공한 후에는 반드시 ALTER DATABASE DROP INACTIVE CLUSTER MEMBERS 구문을 이용해 해당 멤버를 삭제해야 한다.

사용 예

다음은 IRRECOVERABLE CLUSTER MEMBER를 수행하는 예이다.

gSQL> ALTER SYSTEM IRRECOVERABLE CLUSTER MEMBER g1n1;

호환성

SQL 표준에서는 IRRECOVERABLE CLUSTER MEMBER의 개념을 정의하지 않고 있다.

ALTER SYSTEM JOIN DATABASE

기능

비활성화된 특정 cluster member를 cluster system에 다시 포함시킨다.

구문

<alter system join database statement> ::=
    ALTER SYSTEM JOIN DATABASE 
    ;

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter system join database statement> 구문을 수행하려면 사용자에게 ADMINISTRATION ON DATABASE 권한이 있어야 한다.

설명

Cluster member의 inactive 상태는 cluster system과 연결되어 있지 않은 상태로서 다음과 같은 상황에서 발생한다.

• 운영 중인 cluster system에서 해당 cluster member에 장애가 발생한 경우

• Cluster system에 포함된 cluster member를 구동하지 않고 cluster system start-up을 시도한 경우

특정 cluster member가 inactive인 상태에서 해당 member를 다음과 같은 절차를 거쳐 cluster system에 포함시킬 수 있다.

• 구동되지 않은 cluster member를 local open 단계로 구동한다.

$ gsql sys gliese --as sysdba --dsn=G3N2
gSQL> \startup

• <alter system join database statement> 구문을 사용하여 cluster system에 포함시킨다.

$ gsql sys gliese --as sysdba --dsn=G3N2
gSQL> ALTER SYSTEM JOIN DATABASE;

<alter system join database statement> 구문은 local open으로 구동된 inactive cluster member를 shutdown 하지 않고 cluster system에 참여시키려고 할 때 사용한다.

Inactive cluster member가 다시 cluster system에 참여하려면 cluster system과 inactive cluster member의 database 상태가 동일해야 한다.

Cluster system에서 database를 변경하는 트랜잭션이 완료된 후에는 inactive cluster member가 cluster system에 다시 참여할 수 없다.

다수의 inactive cluster member가 존재하는 경우, cluster system을 정상적으로 운영하기 위해 다음과 같은 순서로 inactive cluster member를 정리해야 한다.

1. Cluster system에 참여할 수 있는 inactive cluster member를 JOIN 한다.

gSQL> ALTER SYSTEM JOIN DATABASE;

2. Cluster system에 참여할 수 없는 inactive cluster member들을 DROP 한다.

gSQL> ALTER DATABASE DROP INACTIVE CLUSTER MEMBERS;

<alter database drop inactive cluster member statement> 구문을 수행하면 모든 inactive cluster member가 cluster system에서 제거되므로, DROP 하기 전에 참여 가능한 모든 inactive cluster member를 cluster system에 포함시켜야 한다.

사용 예

gSQL> ALTER SYSTEM JOIN DATABASE;

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 ALTER DATABASE DROP INACTIVE CLUSTER MEMBERS를 참조한다.

ALTER SYSTEM {MOUNT | OPEN} DATABASE

기능

데이터베이스를 시스템에 마운트하거나 서비스 가능한 상태로 변경한다.

구문

<alter system database statement> ::=
    ALTER SYSTEM <alter system database clause>
    ;

<alter system database clause> ::= 
      MOUNT DATABASE
    | OPEN [ <database_scope> ] DATABASE [ <open_database_option> ]

<open_database_option> ::=
      READ WRITE [ NORESETLOGS | RESETLOGS ]
    | READ ONLY

<database_scope> ::=
      LOCAL
    | GLOBAL

사용 범위 및 접근 권한

<alter system database statement> 구문을 수행하려면 사용자에게 ADMINISTRATION ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<alter system database clause>

• MOUNT DATATABASE

  • 데이터베이스를 시스템에 마운트한다.

• OPEN DATABASE

  • 데이터베이스를 서비스 가능한 상태로 변경한다.

<open database option>

• READ ONLY/ READ WRITE

  • 읽기 쓰기 모드를 지정하여 데이터베이스를 구동한다.

  • 생략된 경우에는 READ WRITE로 구동된다.

• RESETLOGS/ NORESETLOGS

  • 데이터베이스를 복구한 이후에 온라인 redo log를 유지할지 선택한다.

  • NORESETLOGS는 기존 redo log를 유지하는 반면에 RESETLOGS는 이를 초기화한다.

  • 데이터베이스를 불완전 복구한 경우, 반드시 RESETLOGS를 지정해야 한다.

  • 생략된 경우에는 NORESETLOGS가 기본으로 지정된다.

<database_scope>

• LOCAL

  • LOCAL 영역 서버를 OPEN 단계로 구동한다.

• GLOBAL

  • GLOBAL 영역, 즉 전체 서버를 OPEN 단계로 구동한다.

• Cluster 환경에서 생략된 경우 GLOBAL로 구동 된다.

사용 예

다음은 읽기 전용으로 데이터베이스를 구동하는 예이다.

ALTER SYSTEM OPEN DATABASE READ ONLY;

다음은 읽기/ 쓰기 모드로 구동하고, online redo log를 초기화하는 예이다.

ALTER SYSTEM OPEN DATABASE READ WRITE RESETLOGS;

호환성

SQL 표준에서는 데이터베이스의 MOUNT 또는 OPEN에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 ALTER DATABASE RECOVER를 참조한다.

ALTER SYSTEM [KILL | DISCONNECT] SESSION

기능

세션을 종료한다.

구문

<alter system end session statement> ::=
      ALTER SYSTEM DISCONNECT SESSION [<member_position>,] <session_id>,
          <serial#> [<disconnect_option>] [AT <domain_name>]
    |  ALTER SYSTEM KILL SESSION [<member_position>,] 
           <session_id>, <serial#>  [AT <domain_name>]    ;

<disconnect_option> ::=
      POST_TRANSACTION
    | IMMEDIATE

사용 범위 및 접근 권한

<alter system end session statement> 구문을 수행하려면 사용자에게 ALTER SYSTEM ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<member_position>

Cluster 환경에서 disconnect/ kill 대상이 되는 세션의 member position 이다.

<session_id>

세션의 ID 이다.

<serial#>

세션의 SERIAL NUMBER이다.

<disconnect_option>

• POST_TRANSACTION: 트랜잭션 완료 후 세션을 종료한다.

• IMMEDIATE: 트랜잭션 완료를 기다리지 않고 바로 세션을 종료한다.

<disconnect_option>이 사용되지 않으면 IMMEDIATE로 작동한다.

<domain name>

구문을 수행할 멤버나 그룹의 이름이다.
지정하지 않은 경우에는 모든 그룹에 수행된다.

설명

DISCONNECT SESSION은 POST_TRANSACTION과 IMMEDIATE 옵션을 지정할 수 있으며, POST_TRANSACTION은 현재 실행되는 트랜잭션이 있을 경우 트랜잭션이 끝난 후에 세션을 종료한다. IMMEDIATE는 현재 수행 중인 트랜잭션을 바로 정리한 후에 세션을 종료한다.

KILL SESSION은 해당 세션의 프로세스는 존재하지 않지만 시스템에 남아있는 비정상 세션을 종료한다.

사용 예

gSQL> SELECT USER_NAME, SESSION_ID, SERIAL_NO, SESSION_STATUS, PROGRAM_NAME FROM V$SESSION WHERE USER_NAME = 'TEST';

USER_NAME SESSION_ID SERIAL_NO SESSION_STATUS PROGRAM_NAME
--------- ---------- --------- -------------- ------------
TEST              62        49 CONNECTED      gsql        
TEST              65       109 CONNECTED      gsqlnet     
TEST              66       130 CONNECTED      gsql        

3 rows selected.

gSQL> ALTER SYSTEM DISCONNECT SESSION 65, 109;

System altered.

호환성

SQL 표준에서는 정의하지 않고 있다.

ALTER SYSTEM RECONNECT GLOBAL CONNECTION

기능

GLOBAL CONNECTION 형태로 접속한 세션에 재접속할지 여부를 설정한다.

구문

<alter system reconnect global connection statement> ::=
    ALTER SYSTEM RECONNECT GLOBAL CONNECTION
    ;

사용 범위 및 접근 권한

<alter system reconnect global connection statement> 구문을 수행하려면 사용자에게 ALTER SYSTEM ON DATABASE 권한이 있어야 한다.

설명

GLOBAL CONNECTION 클라이언트의 재접속 여부는 최초 접속할 때 서버로부터 얻은 system 객체의 SCN과 현재 서버의 system 객체의 SCN을 비교하여 결정한다. 해당 구문은 system 객체의 SCN을 상승시켜 클라이언트의 재접속을 유도한다.

해당 구문을 수행한 즉시 클라이언트가 재접속하는 것은 아니다. 클라이언트가 서버에 명령어를 실행할 때 SCN 비교를 통해서 재접속하며 만약 클라이언트에서 모든 멤버로의 연결이 유효하다면 재접속을 시도하지 않는다.

사용 예

다음은 해당 구문을 수행하는 예이다.

gSQL> ALTER SYSTEM RECONNECT GLOBAL CONNECTION;

System altered.

호환성

SQL 표준에서는 GLOBAL CONNECTION의 개념을 정의하지 않고 있다.

ALTER SYSTEM RESET property_name

기능

프로퍼티 파일에서 프로퍼티 값을 삭제한다.

구문

<alter system reset statement> ::=
    ALTER SYSTEM { RESET | UNSET } <property name>
        [ SCOPE = { FILE | SPFILE } ]
        [ AT <domain name>]
    ;

사용 범위 및 접근 권한

<alter system reset statement> 구문을 수행하려면 사용자에게 ALTER SYSTEM ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

{ RESET | UNSET }

RESET과 UNSET은 동일한 의미의 예약어이므로 어떤 것을 사용해도 무방하다.

<property name>

삭제할 프로퍼티의 이름이다.
자세한 내용은 Database Administration 매뉴얼의 Server Property 장을 참조한다.

[ SCOPE = { FILE | SPFILE } ]

프로퍼티 파일에서 삭제하는 것이므로 SCOPE=FILE/SPFILE만 사용할 수 있다.

• SCOPE = FILE

  • FILE과 SPFILE은 동일한 의미의 예약어이므로 어떤 것을 사용해도 무방하다.

  • 프로퍼티를 FILE에서 삭제하고, 현재 상태에는 적용하지 않는다.

  • Database를 재구동할 때 변경 사항을 적용한다.

SCOPE 절을 명시하지 않을 경우, 기본값은 SCOPE = FILE 이다.

<domain name>

구문을 수행할 멤버나 그룹의 이름이다.
지정하지 않은 경우에는 모든 그룹에 수행된다.

설명

SCOPE=FILE/SPFILE을 사용하여 프로퍼티를 변경했을 경우, 갱신된 값이 프로퍼티 파일에 저장되고 데이터베이스를 재시작할 때 반영된다.

RESET 할 경우, 프로퍼티 파일에 저장된 해당 갱신값을 파일에서 제거하고 데이터베이스를 재시작할 때 default 값을 사용하도록 한다.

사용 예

다음은 SCOPE=FILE을 사용하여 프로퍼티를 변경하는 예이다.

gSQL> ALTER SYSTEM SET PROCESS_MAX_COUNT=128 SCOPE=FILE;

System altered.

gSQL> alter system set DEFAULT_INDEX_LOGGING=YES scope=FILE;

System altered.

다음은 위에서 변경한 프로퍼티를 삭제하는 예이다.

gSQL> ALTER SYSTEM RESET PROCESS_MAX_COUNT SCOPE=FILE;

System altered.

gSQL> ALTER SYSTEM RESET PROCESS_MAX_COUNT SCOPE=SPFILE;

System altered.

gSQL> ALTER SYSTEM RESET PROCESS_MAX_COUNT;

System altered.

gSQL> ALTER SYSTEM RESET DEFAULT_INDEX_LOGGING;

System altered.

gSQL> ALTER SYSTEM UNSET DEFAULT_INDEX_LOGGING;

System altered.

호환성

SQL 표준에서는 시스템 프로퍼티 개념을 정의하지 않고 있다.

참조

관련 내용은 ALTER SYSTEM SET property_name을 참조한다.

ALTER SYSTEM SET property_name

기능

시스템의 프로퍼티 값을 설정한다.

구문

<alter system set statement> ::=
    ALTER SYSTEM SET <property name> { = <property value> | TO DEFAULT }
        [ DEFERRED ]
        [ SCOPE = [ MEMORY | { FILE | SPFILE } | BOTH ] ]
    [AT <domain name>]
    ;

사용 범위 및 접근 권한

<alter system set statement> 구문을 수행하려면 사용자에게 ALTER SYSTEM ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<property name>

설정할 프로퍼티의 이름이다.
자세한 내용은 Database Administration 매뉴얼의 Server Property 장을 참조한다.

<property value>

설정할 프로퍼티의 값이다.

TO DEFAULT

시스템 프로퍼티 값을 시스템을 구동할 당시의 최초값으로 설정한다.

[ DEFERRED ]

변경된 프로퍼티를 적용할 시점을 정의한다.

• DEFERRED

  • 현재 SESSION에는 영향을 주지 않고, 새로 생성되는 SESSION에 적용된다.

  • 프로퍼티의 SYS_MODIFIABLE 속성값이 IMMEDIATE/ DEFERRED일 때 적용 가능하며, 반드시 명시해야 한다.

  • 프로퍼티의 SYS_MODIFIABLE 속성값이 FALSE인 경우 사용할 수 없다.

프로퍼티의 SYS_MODIFIABLE 속성값이 IMMEDIATE일 경우, DEFERRED를 명시하지 않으면 모든 SESSION에 바로 적용된다.

[ SCOPE = [ MEMORY | { FILE | SPFILE } | BOTH ] ]

시스템 프로퍼티 변경에 영향을 받는 범위를 정의한다.

• SCOPE = MEMORY

  • 변경 사항이 현재 상태에만 적용되며, database를 다시 구동할 경우 해당 값은 없어진다.

• SCOPE = FILE

  • FILE과 SPFILE은 동일한 의미의 예약어이므로 어떤 것을 사용해도 무방하다.

  • 변경 사항을 FILE에 저장하고 현재 상태에는 적용하지 않는다.

  • Database를 다시 구동할 때 변경을 적용한다.

• SCOPE = BOTH

  • 변경 사항을 FILE에 저장하고 현재 상태에도 적용한다.

SCOPE 절을 명시하지 않을 경우, 기본값은 SCOPE = MEMORY 이다.
프로퍼티의 SYS_MODIFIABLE 속성값이 FALSE인 경우에는 반드시 SCOPE=FILE/SPFILE이라고 명시해야 한다.

<domain name>

구문을 수행할 멤버나 그룹의 이름이다.
지정하지 않은 경우에는 모든 그룹에 수행된다.

설명

관련 내용은 Database Administration 매뉴얼의 Server Property 장을 참조한다.

사용 예

다음은 SYS_MODIFIABLE 속성이 DEFERRED인 프로퍼티를 변경하는 예이다.

gSQL> ALTER SYSTEM SET HINT_ERROR = ON;

ERR-22000(13019): Invalid property modify mode.(HINT_ERROR)

gSQL> ALTER SYSTEM SET HINT_ERROR = ON DEFERRED;

System altered.

다음은 SYS_MODIFIABLE 속성이 FALSE인 프로퍼티를 변경하는 예이다.

gSQL> ALTER SYSTEM SET PROCESS_MAX_COUNT=128;

ERR-22000(13018): Specified property cannot be modified with this SCOPE option.(PROCESS_MAX_COUNT)

gSQL> ALTER SYSTEM SET PROCESS_MAX_COUNT=128 SCOPE=FILE;

System altered.

다음은 변경된 속성을 session 접속 당시의 default 값으로 변경하는 예이다.

gSQL> ALTER SYSTEM SET TRANSACTION_COMMIT_WRITE_MODE=0;

System altered.

gSQL> ALTER SYSTEM SET TRANSACTION_COMMIT_WRITE_MODE TO DEFAULT;

System altered.

gSQL> ALTER SYSTEM SET TRANSACTION_COMMIT_WRITE_MODE TO DEFAULT DEFERRED;

System altered.

호환성

SQL 표준에서는 시스템의 프로퍼티 개념을 정의하지 않고 있다.

참조

관련 내용은 ALTER SYSTEM RESET property_name을 참조한다.

ALTER SYSTEM SWITCH LOGFILE

기능

데이터베이스 내에 있는 CURRENT 상태의 로그파일을 ACTIVE 상태로 변경한다.

구문

<alter system switch logfile statement> ::=
    ALTER SYSTEM SWITCH LOGFILE
    [ AT <domain name> ]
    ;

사용 범위 및 접근 권한

<alter system switch logfile statement> 구문을 수행하려면 사용자에게 ALTER SYSTEM ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<alter system switch logfile statement>

데이터베이스가 MOUNT 또는 OPEN 상태여야 한다.

<domain name>

구문을 수행할 멤버나 그룹의 이름이다.
지정하지 않은 경우에는 모든 그룹에 수행된다.

설명

기본적으로 CURRENT 상태의 로그파일이 다 채워지면 자동으로 로그 스위치가 발생한다. 해당 구문은 특수한 상황에서 강제로 로그 스위치하고자 할 때 사용된다.

사용 예

ALTER SYSTEM SWITCH LOGFILE;

호환성

SQL 표준에서는 LOGFILE에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 ALTER SYSTEM {MOUNT | OPEN} DATABASE를 참조한다.

ALTER TABLE

기능

테이블 정의를 변경한다.

구문

<alter table statement> ::=
      <alter table physical attribute statement>
    | <rename table statement>
    | <add column definition>
    | <drop column definition>
    | <alter column definition>
    | <rename column statement>
    | <add table constraint definition>
    | <drop table constraint definition>
    | <alter table constraint definition>
    | <rename table constraint statement>
    | <add table supplemental log statement>
    | <drop table supplemental log statement>
    | <rebalance statement>
    | <move shard statement>
    | <split shard statement>
    | <rename shard statement>
    | <read { only | write } statement>
    ;

사용 범위 및 접근 권한

<alter table statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

<alter table physical attribute statement>

테이블의 물리적 속성을 변경한다.
자세한 내용은 ALTER TABLE name STORAGE 구문을 참조한다.

<rename table statement>

테이블 이름을 변경한다.
자세한 내용은 ALTER TABLE name RENAME TO 구문을 참조한다.

<add column definition>

테이블에 column을 추가한다.
자세한 내용은 ALTER TABLE name ADD COLUMN 구문을 참조한다.

<drop column definition>

테이블에서 column을 삭제한다.
자세한 내용은 ALTER TABLE name SET UNUSED COLUMN 구문을 참조한다.

<alter column definition>

테이블 column의 정의를 변경한다.
자세한 내용은 ALTER TABLE name ALTER COLUMN 구문을 참조한다.

<rename column statement>

테이블 column의 이름을 변경한다.
자세한 내용은 ALTER TABLE name RENAME COLUMN 구문을 참조한다.

<add table constraint definition>

테이블에 제약 조건을 추가한다.
자세한 내용은 ALTER TABLE name ADD CONSTRAINT 구문을 참조한다.

<drop table constraint definition>

테이블 제약 조건을 삭제한다.
자세한 내용은 ALTER TABLE name DROP CONSTRAINT 구문을 참조한다.

<alter table constraint definition>

테이블의 제약 조건을 변경한다.
자세한 내용은 ALTER TABLE name ALTER CONSTRAINT 구문을 참조한다.

<rename table constraint statement>

테이블 제약 조건의 이름을 변경한다.
자세한 내용은 ALTER TABLE name RENAME CONSTRAINT 구문을 참조한다.

<add table supplemental log statement>

테이블의 데이터가 변경되면 redo log에 부가 정보를 추가하도록 설정한다.
자세한 내용은 ALTER TABLE name ADD SUPPLEMENTAL LOG 구문을 참조한다.

<drop table supplemental log statement>

테이블의 데이터가 변경되면 redo log에 부가 정보를 추가하지 않도록 설정한다.
자세한 내용은 ALTER TABLE name DROP SUPPLEMENTAL LOG 구문을 참조한다.

<rebalance statement>

Cluster 환경에서 테이블의 shard를 재배치하거나 정합성이 깨진 shard를 동기화하여 정합성을 복구한다.
자세한 내용은 ALTER TABLE REBALANCE 구문을 참조한다.

<move shard statement>

Cluster 환경에서 테이블의 특정 shard를 특정 cluster group에 재배치한다.
자세한 내용은 ALTER TABLE MOVE SHARD 구문을 참조한다.

<split shard statement>

Cluster 환경에서 테이블의 특정 shard를 분산하여 특정 cluster group에 재배치한다.
자세한 내용은 ALTER TABLE SPLIT SHARD 구문을 참조한다.

<rename shard statement>

Cluster 환경에서 테이블의 특정 shard 이름을 변경한다.
자세한 내용은 ALTER TABLE name RENAME SHARD 구문을 참조한다.

<read { only | write } statement>

테이블에 READ ( only | write }을 설정한다.
자세한 내용은 ALTER TABLE name READ { ONLY | WRITE } 구문을 참조한다.

설명

각 세부 구문의 설명을 참조한다.

사용 예

각 세부 구문의 사용 예를 참조한다.

호환성

SQL 표준에서는 다음과 같은 구문을 정의하지 않고 있다.

• <alter table physical attribute statement>

• <rename table statement>

• <rename column statement>

• <rename table constraint statement>

• <add table supplemental log statement>

• <drop table supplemental log statement>

• <rebalance statement>

• <move shard statement>

• <split shard statement>

• <rename shard statement>

• <read { only | write } statement>

ALTER TABLE name ADD COLUMN

기능

테이블에 column을 추가한다.

구문

<add column definition> ::=
      ALTER TABLE table_name ADD [ COLUMN ] <column definition>
    | ALTER TABLE table_name ADD [ COLUMN ] ( <column definition> [, ...] )
    ;

사용 범위 및 접근 권한

<add column definition> 구문을 수행하려면 사용자가 다음 조건들을 만족해야 한다.

• 테이블을 변경하려면 다음 권한 중 하나가 있어야 한다.

  • 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

  • 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

  • ALTER ANY TABLE ON DATABASE

• Column을 추가할 때 제약 조건을 함께 명시했다면, 다음과 같이 제약 조건을 생성할 수 있는 조건을 만족해야 한다.

  • 제약 조건이 생성될 스키마에 대해 다음 권한 중 하나가 있어야 한다.

    • 해당 스키마에 대해 (ADD CONSTRAINT 또는 CONTROL SCHEMA) ON SCHEMA

    • ALTER ANY TABLE ON DATABASE

  • 생성할 제약 조건이 key 제약 조건일 경우, 인덱스가 생성될 테이블스페이스에 대해 다음 권한 중 하나가 있어야 한다.

    • 해당 테이블스페이스에 대해 CREATE OBJECT ON TABLESPACE

    • USAGE TABLESPACE ON DATABASE

• 해당 테이블의 소유자는 추가된 column에 대해 다음과 같은 권한을 갖는다.

  • 추가된 모든 column에 대한 권한

    • SELECT(columns) ON TABLE WITH GRANT OPTION

    • INSERT(columns) ON TABLE WITH GRANT OPTION

    • UPDATE(columns) ON TABLE WITH GRANT OPTION

    • REFERENCES(columns) ON TABLE WITH GRANT OPTION

  • 함께 생성한 제약 조건에 대한 권한

    • 제약 조건의 소유자

    • 제약 조건과 함께 생성된 인덱스의 소유자

구문 규칙 및 파라미터

table_name

변경할 테이블의 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

ADD [ COLUMN ]

COLUMN 예약어는 생략할 수 있다.

<column definition>

추가할 column을 정의한다.
자세한 내용은 CREATE TABLE 구문의 <column definition> 절을 참조한다.
테이블 내에 동일한 column 이름이 존재하지 않아야 한다.

Column을 정의할 때 DEFAULT 절을 명시할 경우, 모든 row의 기본값을 추가되는 column에 저장한다.
Column을 정의할 때 <identity column specification> 절을 명시한 경우, 모든 row 각각의 자동 생성값을 추가되는 column에 저장한다.
Column을 정의할 때 NOT NULL 제약 조건을 함께 명시한 경우, 테이블을 비우거나 DEFALUT 절 또는 <identity column specification> 절을 함께 기술해야 한다.

( <column definition> [, ...] )

다수의 column을 추가한다.
괄호 내부에 다수의 <column definition>을 나열한다.

설명

추가되는 column은 기존 column들의 뒤에 위치한다.
DEFAULT 절이나 <identity column specification>을 명시한 경우, 수행시간은 테이블에 존재하는 row의 개수에 비례하여 증가한다.

사용 예

다음은 하나의 column을 추가하는 예이다.

gSQL> ALTER TABLE region ADD COLUMN r_new_comment VARCHAR(152);

Table altered.

다음은 다수의 column을 추가하는 예이다.

gSQL> ALTER TABLE partsupp ADD COLUMN ( 
   ps_retailprice NUMERIC(12,2), 
   ps_acctbal NUMERIC(12,2), ps_mktsegment  CHAR(10) );

Table altered.

다음은 identity column과 DEFAULT 절을 갖는 column을 추가하는 예이다.

gSQL> ALTER TABLE region ADD COLUMN ( 
    r_regionkey INTEGER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
    r_comment   VARCHAR(152) DEFAULT 'N/A' );

Table altered.

gSQL> SELECT r_regionkey, r_name, r_comment FROM region;

R_REGIONKEY R_NAME                    R_COMMENT
----------- ------------------------- ---------
          1 AFRICA                    N/A      
          2 AMERICA                   N/A      
          3 ASIA                      N/A      
          4 EUROPE                    N/A      
          5 MIDDLE EAST               N/A      

5 rows selected.

다음은 지연가능한 제약 조건을 가지는 column을 추가하는 예이다.

gSQL> ALTER TABLE t1 ADD COLUMN ( id INTEGER CONSTRAINT t1_uk UNIQUE DEFERRABLE );

Table altered.

gSQL> COMMIT;

Commit complete.

호환성

SQL 표준에서는 다수의 column definition 추가에 대해 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLE

• ALTER TABLE name SET UNUSED COLUMN

• ALTER TABLE name ALTER COLUMN

• ALTER TABLE name RENAME COLUMN

ALTER TABLE name SET UNUSED COLUMN

기능

테이블 column을 제거한다.

구문

<drop column definition> ::=
    ALTER TABLE table_name <drop column clause>
    ;

<drop column clause> ::=
      SET UNUSED [ COLUMN ] <column_name_list> [ <drop behavior> ]

<column name list> ::=
      column_name
    | ( column_name [, ...] )

<drop behavior> ::=
      RESTRICT
    | CASCADE
    | CASCADE CONSTRAINTS

사용 범위 및 접근 권한

<drop column definition> 구문을 수행하려면 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

변경할 테이블의 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

SET UNUSED [ COLUMN ]

해당 column들을 사용하지 않도록 설정한다.

column_name_list

한 개 이상의 삭제될 column 이름이다.

• 예: ALTER TABLE t1 SET UNUSED COLUMN c1

• 예: ALTER TABLE t1 SET UNUSED COLUMN (c1, c2)

column_name

삭제할 column의 이름이다.
해당 column을 이용하는 제약 조건과 인덱스도 함께 삭제한다.

drop behavior

생략할 경우, 기본값은 RESTRICT 이다.
현재는 RESTRICT/ CASCADE가 동일하게 작동한다.

설명

SET UNUSED COLUMN은 data를 물리적으로 제거하지 않으므로 row의 개수에 관계없이 일정한 성능을 보장한다.

사용 예

다음은 해당 column을 사용하지 않도록 설정하는 예이다.

gSQL> ALTER TABLE t1 SET UNUSED COLUMN ( addr );

Table altered.

호환성

SQL 표준에서는 다음과 같은 절들을 정의하지 않고 있다.

• SET UNUSED

• CASCADE CONSTRAINTS

• 다수의 column 나열

참조

관련 내용은 다음을 참조한다.

• ALTER TABLE

• ALTER TABLE name ADD COLUMN

• ALTER TABLE name ALTER COLUMN

• ALTER TABLE name RENAME COLUMN

ALTER TABLE name ALTER COLUMN

기능

Column의 정의를 변경한다.

구문

<alter column definition> ::=
    ALTER TABLE table_name 
        ALTER [ COLUMN ] column_name <alter column action>

<alter column action> ::=

      <set column default clause>
    | <drop column default clause>
    | <set column not null clause>
    | <drop column not null clause>
    | <alter column data type clause>
    | <alter identity column specification>
    | <drop identity property clause>    
    ;

<set column default clause> ::=
    SET DEFAULT <default option>

<drop column default clause> ::=
    DROP DEFAULT

<set column not null clause> ::=
    SET [ CONSTRAINT constraint_name ] NOT NULL [ <constraint characteristics> ]


<constraint characteristics> ::=
      [ NOT ] DEFERRABLE [ <constraint check time> ]
    | <constraint check time> [ [ NOT ] DEFERRABLE ]

<constraint check time> ::=
      INITIALLY DEFERRED 
    | INITIALLY IMMEDIATE

<drop column not null clause> ::=
    DROP NOT NULL

<alter column data type clause> ::=
    SET DATA TYPE <data type> 

<alter identity column specification> ::=
     <set identity column generation clause> [ <alter identity column option> ... ]
   | <alter identity column option> ...

<set identity column generation clause> ::=
   SET GENERATED { ALWAYS | BY DEFAULT }

<alter identity column option> ::=
     <alter sequence generator restart option>
   | [ SET ] <basic sequence generator option>

<alter sequence generator restart option> ::=
    RESTART [ WITH integer ]

<basic sequence generator option> ::=
      <sequence generator increment by option>
    | <sequence generator maxvalue option>
    | <sequence generator minvalue option>
    | <sequence generator cycle option>
    | <sequence generator cache option>

<drop identity property clause> ::=
    DROP IDENTITY

사용 범위 및 접근 권한

<alter column definition> 구문을 수행하려면 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

변경할 테이블 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

ALTER [ COLUMN ]

COLUMN 예약어는 생략할 수 있다.

column_name

변경할 column의 이름이다.

<set column default clause>

Column의 기본값을 설정한다.
identity column이 아니어야 한다.

이후에 수행되는 INSERT 구문 등에서 DEFAULT 절을 사용할 경우 설정된 기본값이 사용된다.

DEFAULT expression의 데이터 타입은 column의 데이터 타입과 호환 가능해야 한다.
타입이 호환되지 않거나 공간이 부족한 경우 INSERT, UPDATE 구문에서 DEFAULT를 사용할 때 에러가 발생한다.

자세한 설명은 CREATE TABLE 구문의 <default clause> 절을 참조한다.

<drop column default clause>

Column의 기본값을 제거한다.
identity column이 아니어야 한다.
기본값을 제거하면 INSERT 구문 등에서 DEFAULT 절을 사용할 때 NULL 값으로 설정된다.

<set column not null clause>

• SET [CONSTRAINT constraint_name] NOT NULL [ <constraint characteristics> ]

  • Column에 NOT NULL 제약 조건을 설정한다.

  • Column의 값으로 NULL 값을 허용하지 않는다.

  • 해당 column에 NULL 값이 존재하지 않아야 한다.

• [CONSTRAINT constraint_name]을 생략할 경우 자동으로 제약 조건 이름을 부여한다.

• <constraint characteristics>를 생략할 경우, NOT DEFERRABLE INITIALLY IMMEDIATE 속성을 갖는다.

• identity column은 DEFERRABLE 속성을 가질 수 없다.

지연 가능한 제약 조건에 대한 자세한 내용은 SET CONSTRAINTS 구문의 설명을 참조한다.

<drop column not null clause>

• DROP NOT NULL

  • Column의 NOT NULL 제약 조건을 제거한다.

<alter column data type clause>

• SET DATA TYPE <data type>

  • Column의 데이터 타입을 변경한다.

동일한 계열간에 타입을 변경할 수 있는데 이 때 다음 조건을 만족해야 한다.

char length unit을 변경할 경우 다음과 같은 조건을 만족해야 한다.

FLOAT(p)에 대한 ddc (decimal digit count) 값은 다음과 같다.

참고로 모든 numeric type은 동일한 구조로 관리되며, 각 numeric type은 다음과 같은 NUMBER(p,s) 표현식과 동일하다.

Native 숫자형은 C 언어의 숫자형 타입과 동일한 데이터 타입이며 서로 다른 타입으로 변환할 수 없다.

<alter identity column specification>

Column의 identity 속성을 변경한다.
Column은 identity column 이어야 한다.

• SET GENERATED [ ALWAYS | BY DEFAULT ]

  • identity column의 생성 방식을 변경한다.

  • 자세한 내용은 CREATE TABLE 구문의 <identity column specification>을 참조한다.

• <alter sequence generator restart option>

  • identity column의 다음 값 (NEXT VALUE)을 변경한다.

  • 자세한 내용은 ALTER SEQUENCE 구문의 <alter sequence generator restart option> 절을 참조한다.

• <basic sequence generator option>

  • identity column의 속성을 변경한다.

  • SQL 표준에서는 SET <basic sequence generator option>의 형태로 기술하도록 정의하고 있으나 생략 가능하다.

  • 자세한 내용은 ALTER SEQUENCE 구문을 참조한다.

<drop identity property clause>

Column의 identity 속성을 제거한다.
Column은 identity column 이어야 한다.

설명

SET NOT NULL 절의 null 검사 수행시간은 테이블의 row 개수에 비례한다.

다음과 같은 column은 NULL 값을 허용하지 않는다. 즉, DROP NOT NULL 절을 수행하더라도 다음 조건 중 하나를 만족할 경우 NULL 값을 허용하지 않는다.

• NOT NULL 제약 조건이 있는 column

• Column이 primary key 제약 조건에 포함되는 경우

• Column이 identity column인 경우

SET DEFAULT 절을 이용한 기본값 변경과 <alter identity column specification> 절을 이용한 identity 속성의 변경은 이후에 수행되는 INSERT 또는 UPDATE 구문에 적용된다.

사용 예

다음은 column에 DEFAULT 속성을 설정하는 예이다.

gSQL> ALTER TABLE region ALTER COLUMN r_comment SET DEFAULT 'N/A';

Table altered.

다음은 column의 DEFAULT 속성을 제거하는 예이다.

gSQL> ALTER TABLE region ALTER COLUMN r_comment DROP DEFAULT;

Table altered.

다음은 column에 NOT NULL 제약 조건을 설정하는 예이다.

gSQL> ALTER TABLE region ALTER COLUMN r_regionkey SET NOT NULL;

Table altered.

다음은 column의 NOT NULL 제약 조건을 제거하는 예이다.

gSQL> ALTER TABLE region ALTER COLUMN r_regionkey DROP NOT NULL;

Table altered.

다음은 column의 data type 크기를 확장하는 예이다.

gSQL> ALTER TABLE region ALTER COLUMN r_comment SET DATA TYPE VARCHAR(512);

Table altered.

다음은 identity column의 다음 값을 다시 시작하는 예이다.

gSQL> ALTER TABLE region ALTER COLUMN r_regionkey RESTART;

Table altered.

다음은 column의 identity 속성을 제거하는 예이다.

gSQL> ALTER TABLE region ALTER COLUMN r_regionkey DROP IDENTITY;

Table altered.

호환성

참조

관련 내용은 다음을 참조한다.

• ALTER TABLE

• ALTER TABLE name ADD COLUMN

• ALTER TABLE name SET UNUSED COLUMN

• ALTER TABLE name RENAME COLUMN

ALTER TABLE name RENAME COLUMN

기능

테이블 column의 이름을 변경한다.

구문

<rename column statement> ::=
    ALTER TABLE table_name 
        RENAME COLUMN old_column_name TO new_column_name
    ;

사용 범위 및 접근 권한

<rename column statement> 구문을 수행하려면 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

변경할 테이블 이름이다.
schema_name.table_name과 같이 테이블이 속한 스키마를 정의할 수 있으며, schema_name을 생략할 경우 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

old_column_name

변경할 column의 기존 이름이다.

new_column_name

변경할 column의 새로운 이름이다.
테이블 내에 동일한 column 이름이 존재하지 않아야 한다.

설명

Column 이름이 변경되더라도 이전에 해당 column을 기준으로 생성된 index, constraint 등의 객체를 변경할 필요는 없다.

사용 예

다음은 두 개의 column 이름인 col_1과 col_2를 서로 바꾸는 예이다.

gSQL> ALTER TABLE t1 RENAME COLUMN col_1 TO col_temp;

Table altered.

gSQL> ALTER TABLE t1 RENAME COLUMN col_2 TO col_1;

Table altered.

gSQL> ALTER TABLE t1 RENAME COLUMN col_temp TO col_2;

Table altered.

gSQL> COMMIT;

Commit complete.

호환성

SQL 표준에서는 <rename column statement> 구문을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLE

• ALTER TABLE name ADD COLUMN

• ALTER TABLE name SET UNUSED COLUMN

• ALTER TABLE name ALTER COLUMN

ALTER TABLE name ADD CONSTRAINT

기능

테이블 제약 조건을 추가한다.

구문

<add table constraint definition> ::=
    ALTER TABLE table_name 
        ADD <table constraint definition>
    ;

사용 범위 및 접근 권한

<add table constraint definition> 구문을 수행하려면 사용자가 다음 조건들을 만족해야 한다.

• 제약 조건을 생성할 테이블에 대해 다음 권한 중 하나가 있어야 한다.

  • 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

  • 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

  • ALTER ANY TABLE ON DATABASE

• 제약 조건이 생성될 스키마에 대해 다음 권한 중 하나가 있어야 한다.

  • 해당 스키마에 대해 (ADD CONSTRAINT 또는 CONTROL SCHEMA) ON SCHEMA

  • ALTER ANY TABLE ON DATABASE

• 생성할 제약 조건이 key 제약 조건일 경우, 인덱스가 생성될 테이블스페이스에 대해 다음 권한 중 하나가 있어야 한다.

  • 해당 테이블스페이스에 대해 CREATE OBJECT ON TABLESPACE

  • USAGE TABLESPACE ON DATABASE

• 생성한 제약 조건의 소유자는 다음과 같이 결정된다.

  • 제약 조건이 속한 스키마의 소유자

  • 제약 조건이 속한 스키마가 PUBLIC 일 경우, 구문을 수행한 사용자

구문 규칙 및 파라미터

table_name

변경할 테이블의 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우, 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

<table constraint definition>

추가할 제약 조건을 정의한다.
NOT NULL 제약 조건은 ALTER TABLE .. ADD CONSTRAINT 구문으로 추가할 수 없으며, 다음 예와 같이 ALTER TABLE name ALTER COLUMN 구문을 이용해 정의할 수 있다.

ALTER TABLE t1 ALTER COLUMN c1 SET NOT NULL;

자세한 내용은 CREATE TABLE 구문의 <table constraint definition> 절을 참조한다.

설명

Primary key, unique key와 같은 key 제약을 추가할 때 이를 위한 index가 자동으로 생성된다.

사용 예

다음은 테이블에 primary key 제약 조건을 추가하는 예이다.

gSQL> ALTER TABLE t1 ADD PRIMARY KEY ( id );

Table altered.

다음은 테이블에 primary key 제약 조건을 추가할 때 제약 조건 이름을 명시하는 예이다.

gSQL> ALTER TABLE t1 ADD CONSTRAINT t1_pk PRIMARY KEY ( id );

Table altered.

다음은 지연 가능한 제약 조건을 추가하는 예이다.

gSQL> ALTER TABLE t1 ADD CONSTRAINT t1_uk UNIQUE ( id ) DEFERRABLE INITIALLY DEFERRED;

Table altered.

gSQL> COMMIT;

Commit complete.

호환성

참조

관련 내용은 다음을 참조한다.

• CREATE TABLE

• CREATE INDEX

• ALTER TABLE

• ALTER TABLE name DROP CONSTRAINT

ALTER TABLE name DROP CONSTRAINT

기능

테이블 제약 조건을 제거한다.

구문

<drop table constraint definition> ::=
    ALTER TABLE table_name 
        DROP <constraint object>
        [ <drop behavior> ]
    ;

<constraint object> ::=
      CONSTRAINT constraint_name
    | PRIMARY KEY 
    | UNIQUE ( column_name [, ...] ) 

<drop behavior> ::=
      RESTRICT
    | CASCADE
    | CASCADE CONSTRAINTS

사용 범위 및 접근 권한

<drop table constraint definition> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 제약 조건의 소유자

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

변경할 테이블의 이름이다.
schema_name.table_name과 같이 테이블이 속한 스키마를 정의할 수 있으며, schema_name을 생략할 경우, 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

CONSTRAINT constraint_name

제거할 제약 조건의 이름이다.

PRIMARY KEY

테이블의 primary key 제약 조건이다.

UNIQUE( column_name [, ...] )

Column들에 대한 unique 제약 조건이다.

<drop behavior>

생략할 경우, 기본값은 RESTRICT 이다.
현재는 RESTRICT/ CASCADE가 동일하게 작동한다.

설명

제약 조건의 이름을 사용하지 않고 NOT NULL 제약 조건을 제거하려고 할 경우 ALTER TABLE name ALTER COLUMN 구문의 <drop column not null clause> 절을 이용한다.

사용 예

다음은 테이블의 primary key 제약 조건을 제거하는 예이다.

gSQL> ALTER TABLE t1 DROP PRIMARY KEY;

Table altered.

다음은 제약 조건 이름을 명시하여 테이블의 제약 조건을 제거하는 예이다.

gSQL> ALTER TABLE t1 DROP CONSTRAINT t1_pk;

Table altered.

호환성

SQL 표준에서는 다음과 같은 절을 정의하지 않고 있다.

• DROP PRIMARY KEY

• DROP UNIQUE ( column_name [, ...] )

• CASCADE CONSTRAINTS

참조

관련 내용은 다음을 참조한다.

• ALTER TABLE

• ALTER TABLE name ADD CONSTRAINT

• DROP INDEX

ALTER TABLE name ALTER CONSTRAINT

기능

테이블 제약 조건의 특성을 변경한다.

구문

<alter table constraint definition> ::=
    ALTER TABLE table_name 
        ALTER <constraint object> <constraint characteristics>
    ;

<constraint object> ::=
      CONSTRAINT constraint_name
    | PRIMARY KEY 
    | UNIQUE ( column_name [, ...] ) 

<constraint characteristics> ::=
      [ NOT ] DEFERRABLE [ <constraint check time> ] 
    | <constraint check time> [ [ NOT ] DEFERRABLE ] 

<constraint check time> ::=
      INITIALLY DEFERRED 
    | INITIALLY IMMEDIATE

사용 범위 및 접근 권한

<alter table constraint definition> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

변경할 테이블의 이름이다.
schema_name.table_name과 같이 테이블이 속한 스키마를 정의할 수 있으며, schema_name을 생략할 경우, 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

<constraint object>

변경할 제약 조건은 다음과 같이 지정할 수 있다.

• CONSTRAINT constraint_name

  • 변경할 제약 조건의 이름이다.

• PRIMARY KEY

  • 테이블의 PRIMARY KEY 제약 조건이다.

• UNIQUE( column [,...] )

  • Column 목록에 부합되는 UNIQUE 제약 조건이다.

DEFERRABLE | NOT DEFERRABLE

제약 조건의 지연 가능 여부를 변경한다.

• DEFERRABLE

  • 제약 조건을 지연가능하도록 변경한다.

• NOT DEFERRABLE

  • 제약 조건을 지연가능하지 않도록 변경한다.

INITIALLY IMMEDIATE | INITIALLY DEFERRED

제약 조건의 검사시점 초기값을 변경한다.

• INITIALLY IMMEDIATE

  • DML을 수행할 때 제약 조건을 검사한다.

• INITIALLY DEFERRED

  • COMMIT을 수행할 때 제약 조건을 검사한다.

NOT DEFERRABLE로 정의된 제약 조건은 INITIALLY DEFERRED로 변경할 수 없다.

설명

지연가능한 제약 조건에 대한 자세한 내용은 SET CONSTRAINTS 구문을 참조한다.

사용 예

다음은 t1_uk 제약 조건을 지연가능하게 하고 검사시점을 DEFERRED로 설정하는 예이다.

gSQL> ALTER TABLE t1 ALTER CONSTRAINT t1_uk DEFERRABLE INITIALLY DEFERRED;

Table altered.

gSQL> COMMIT;

Commit complete.

호환성

SQL 표준에서는 다음과 같은 절을 정의하지 않고 있다.

• ALTER PRIMARY KEY 절

• ALTER UNIQUE(column [,...]) 절

ALTER TABLE name RENAME CONSTRAINT

기능

테이블 제약 조건의 이름을 변경한다.

구문

<rename table constraint statement> ::=
    ALTER TABLE table_name 
        RENAME <constraint object> TO new_constraint_name
    ;

<constraint object> ::=
      CONSTRAINT constraint_name
    | PRIMARY KEY 
    | UNIQUE ( column_name [, ...] )

사용 범위 및 접근 권한

<rename table constraint statement> 구문을 수행하려면 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

변경할 테이블의 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우, 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

<constraint object>

변경할 제약 조건의 기존 이름은 다음과 같이 지정할 수 있다.

• CONSTRAINT constraint_name

  • 변경할 제약 조건의 이름이다.

• PRIMARY KEY

  • 테이블의 PRIMARY KEY 제약 조건이다.

• UNIQUE( column [,...] )

  • Column 목록에 부합되는 UNIQUE 제약 조건이다.

new_column_name

변경할 제약 조건의 새로운 이름이다.

설명

Primary key, unique key와 같이 key 제약 조건으로 자동 생성된 index의 이름은 변경되지 않는다. Index 이름은 ALTER INDEX name RENAME TO 구문을 사용하여 변경해야 한다.

사용 예

다음은 테이블의 primary key 제약 조건 이름을 변경하는 예이다.

gSQL> ALTER TABLE t1 RENAME PRIMARY KEY TO pk_t1;

Table altered.

다음은 제약 조건 이름을 명시하여 테이블의 제약 조건 이름을 변경하는 예이다.

gSQL> ALTER TABLE t1 RENAME CONSTRAINT pk_t1 TO t1_pk;

Table altered.

호환성

SQL 표준에서는 <rename table constraint statement> 구문을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLE

• ALTER TABLE name ADD CONSTRAINT

• ALTER TABLE name DROP CONSTRAINT

• ALTER TABLE name ALTER CONSTRAINT

ALTER TABLE name ADD GLOBAL SECONDARY INDEX

기능

테이블에 global secondary index를 생성한다.

구문

<alter table add global secondary index definition> ::=
    ALTER TABLE table_name 
        ADD GLOBAL SECONDARY INDEX
        [ <index attributes> [...] ] [ TABLESPACE tablespace_name ]
    ;

<index attributes> ::=
      <physical attribute clause>
    | STORAGE ( <segment attr clause> [...] )
    | <logging clause> 
    | <parallel clause> 

<physical attribute clause> ::=
      PCTFREE integer
    | INITRANS integer
    | MAXTRANS integer

<segment attr clause> ::=
      INITIAL <size_clause>
    | NEXT <size_clause>
    | MINSIZE <size_clause>
    | MAXSIZE <size_clause>

<size clause> ::=
      integer [ K | M | G | T ]

<logging clause> ::=
      LOGGING
    | NOLOGGING

<parallel clause> ::=
      NOPARALLEL
    | PARALLEL [ integer ]

사용 범위 및 접근 권한

<alter table add global secondary index definition> 구문은 cluster system에서 정의할 수 있으며 사용자는 다음 조건들을 만족해야 한다.

• 인덱스를 생성할 테이블에 대해 다음 권한 중 하나가 있어야 한다.

  • 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

  • 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

  • ALTER ANY TABLE ON DATABASE

• 인덱스가 생성될 테이블스페이스에 대해 다음 권한 중 하나가 있어야 한다.

  • 해당 테이블스페이스에 대해 CREATE OBJECT ON TABLESPACE

  • USAGE TABLESPACE ON DATABASE

구문 규칙 및 파라미터

table_name

인덱스를 생성할 테이블 이름이다.
schema_name.table_name과 같이 테이블이 속한 스키마를 정의할 수 있으며, schema_name을 생략할 경우, 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

<physical attribute clause>

인덱스의 물리적 속성 정보를 정의한다.

• PCTFREE integer

  • 정의

    • 페이지 내 key 삽입으로 인한 페이지 분할 빈도를 조절하기 위해 예약된 공간이다.

    • 인덱스 bottom-up 빌드 시에만 적용된다.

  • 0에서 99까지의 값을 사용할 수 있다.

  • 생략할 경우, 기본값은 DEFAULT_INDEX_PCTFREE property에 설정된 값을 사용한다.

• INITRANS integer

  • 정의

    • 페이지에 동시 접근할 수 있는 초기 트랜잭션의 개수이다.

    • 인덱스에 접근하는 사용자의 수가 적을 경우에는 INITRANS를 낮게 설정하고, 동시에 접근하는 사용자가 많을 경우에는 INITRANS를 높게 설정한다.

    • 필요한 경우 설정된 MAXTRANS까지 자동으로 늘어난다.

  • 1 부터 32 까지의 값을 사용할 수 있다.

  • 생략할 경우, 기본값은 4 이다.

• MAXTRANS integer

  • 정의

    • 페이지에 동시 접근할 수 있는 트랜잭션의 최대 개수이다.

  • 1 부터 32 까지의 값을 사용할 수 있다.

  • 생략할 경우, 기본값은 8 이다.

<segment attr clause>

인덱스가 저장될 공간에 대한 정보를 기술한다.

• INITIAL integer

  • 정의

    • 인덱스를 생성할 때 초기에 할당할 물리적 공간의 크기를 기술한다.

    • 이 크기는 테이블이 속하는 TABLESPACE의 EXTENT 크기에 align 되어 사용된다. (예: EXT 크기가 8192 bytes일 경우 'INITIAL 100'은 실제 8192 bytes로 작동한다.)

    • 이 크기 (TABLESPACE의 EXTENT 크기에 align 된 크기)는 MINEXTENTS의 크기와 같거나 커야 하며, MAXEXTENTS의 크기와 같거나 작아야 한다.

  • 최소값은 1이고 최대값은 시스템 환경에 따라 다르다.

  • 생략할 경우, 기본값은 테이블이 속한 TABLESPACE의 EXTENT 하나 크기이다.

• NEXT integer

  • 정의

    • 인덱스의 물리적 공간을 추가할 경우 할당할 물리적 공간의 크기를 기술한다.

    • 이 크기는 테이블이 속하는 TABLESPACE의 EXTENT 크기에 align 되어 사용된다. (예: EXT크기가 8192 bytes일 경우 'NEXT 100'은 실제 8192 bytes로 작동한다.)

    • NEXT는 현재 인덱스가 사용할 수 있는 남은 공간의 크기 (MAXEXTENTS의 크기에서 현재 사용하고 있는 공간의 크기를 뺀 크기)에 따라 다음과 같이 작동한다.

    - 남은 공간의 크기가 0인 경우 더 이상 공간을 확장하지 못한다.

    - 남은 공간의 크기가 0보다 크고 NEXT보다 작은 경우 남은 공간의 크기만큼 할당한다.

    - 남은 공간의 크기가 NEXT 보다 클 경우 NEXT의 크기만큼 할당한다.

  • 최소값은 1이고 최대값은 시스템 환경에 따라 다르다.

  • 생략할 경우, 기본값은 인덱스가 속한 TABLESPACE의 EXTENT 하나 크기이다.

• MINSIZE integer

  • 정의

    • 인덱스에서 유지해야 할 최소 공간의 크기이다.

    • 이 값은 MAXSIZE의 값과 같거나 작아야 한다.

  • 이 크기는 인덱스가 속하는 TABLESPACE의 EXTENT 크기에 align 되어 사용된다.

  • 최소값은 1이고 최대값은 시스템 환경에 따라 다르다.

  • EXTENT 두 개 크기보다 작을 경우 EXTENT 두 개 크기로 결정된다.

  • 생략할 경우, 기본값은 EXTENT 두 개 크기이다.

• MAXSIZE integer

  • 정의

    • 인덱스에서 할당받을 수 있는 최대 공간의 크기이다.

    • 이 값은 MINSIZE의 값과 같거나 커야 한다.

  • 이 크기는 인덱스가 속하는 TABLESPACE의 EXTENT 크기에 align 되어 사용된다.

  • 최소값은 1이고 최대값은 시스템 환경에 따라 다르다.

  • 생략할 경우, 기본값은 EXTENT 크기 * 2147483647 (INT32의 최대 양의 정수)이다.

<size clause>

파일의 바이트 크기를 명시한다. (단위를 기술하지 않을 경우 bytes이다.)

• K: Kilobytes

• M: Megabytes

• G: Gigabytes

• T: Terabytes

LOGGING | NOLOGGING

인덱스의 리두 로깅 여부를 명시한다.
명시하지 않을 경우, 기본값은 NOLOGGING 이다.

NOPARALLEL | PARALLEL [ integer ]

인덱스 구축과정에 사용될 thread의 개수를 지정한다.

• NOPARALLEL

  • 병렬로 인덱스를 구축하지 않는다.

• PARALLEL [integer]

  • 병렬로 인덱스를 구축한다.

  • integer가 생략되거나 0으로 지정된 경우에는 프로퍼티 (INDEX_BUILD_PARALLEL_FACTOR)를 따른다.

  • integer는 0부터 사용할 수 있으며 최대값은 16이다.

  • 만약 프로퍼티의 값이 0인 경우에는 최적값을 시스템이 결정한다.

• 명시하지 않을 경우, 기본값은 PARALLEL이다.

TABLESPACE tablespace_name

인덱스가 저장될 tablespace의 이름을 지정한다.

• tablespace_name을 지정할 경우

  • LOGGING 인덱스의 tablespace_name은 data tablespace여야 하며

  • NOLOGGING 인덱스의 tablespace_name은 temporary tablespace 또는 nologging tablespace여야 한다.

• TABLESPACE 절을 생략할 경우,

  • USER의 INDEX TABLESPACE tablespace_name을 지정한 경우

    • 정의한 테이블스페이스를 사용한다.

  • USER의 INDEX TABLESPACE가 NULL인 경우

    • LOGGING 인덱스는 사용자의 기본 데이터 테이블스페이스를 사용하고,

    • NOLOGGING 인덱스는 사용자의 기본 임시 테이블스페이스를 사용한다.

설명

Non-deterministic 질의에는 global secondary index가 반드시 필요하다. LOGGING 인덱스와 NOLOGGING 인덱스에는 다음과 같은 trade-off가 있다.

• LOGGING 인덱스

  • 장점: 시스템을 구동할 때 로그를 이용해 인덱스가 자동으로 복구되므로 별도의 구축과정이 없다.

  • 단점: 관련 row를 변경할 때 인덱스 변경 내용을 로그로 기록하여 디스크 IO를 유발한다.

• NOLOGGING 인덱스

  • 장점: 관련 row를 변경할 때 인덱스 변경 내용에 대해 디스크 IO가 발생하지 않는다.

  • 단점: 시스템을 구동할 때 인덱스에 대한 로그 정보가 없어 자동으로 인덱스를 재구축한다.

사용 예

다음은 테이블 T1에 global secondary index를 추가하는 예이다.

gSQL> ALTER TABLE T1 ADD GLOBAL SECONDARY INDEX;

Table altered.

gSQL> COMMIT;

Commit complete.

다음은 logging option으로 테이블 T1의 tablespace USER_DATA_TBS에 global secondary index를 생성하는 예이다.

gSQL> ALTER TABLE T1 ADD GLOBAL SECONDARY INDEX LOGGING TABLESPACE USER_DATA_TBS;

Table altered.

gSQL> COMMIT;

Commit complete.

다음은 nologging option으로 테이블 T1의 tablespace USER_TEMP_TBS에 global secondary index를 생성하는 예이다.

gSQL> ALTER TABLE T1 ADD GLOBAL SECONDARY INDEX NOLOGGING TABLESPACE USER_TEMP_TBS;

Table altered.

gSQL> COMMIT;

Commit complete.

호환성

SQL 표준에서는 global secondary index에 대한 개념을 다루지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLE name DROP GLOBAL SECONDARY INDEX

• ALTER TABLE name ALTER GLOBAL SECONDARY INDEX

• CREATE TABLE

ALTER TABLE name DROP GLOBAL SECONDARY INDEX

기능

테이블에서 global secondary index를 제거한다.

구문

<alter table drop global secondary index definition> ::=
    ALTER TABLE table_name 
        DROP GLOBAL SECONDARY INDEX
    ;

사용 범위 및 접근 권한

<alter table drop global secondary index definition> 구문은 cluster system에서 정의할 수 있으며 사용자는 다음 조건들을 만족해야 한다.

• 인덱스를 제거할 테이블에 대해 다음 권한 중 하나가 있어야 한다.

  • 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

  • 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

  • ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

인덱스를 제거할 테이블 이름이다.

설명

Non-deterministic 질의를 하려면 global secondary index가 반드시 필요하다.

사용 예

테이블 T1에서 global secondary index를 제거한다.

gSQL> ALTER TABLE T1 DROP GLOBAL SECONDARY INDEX;

Table altered.

gSQL> COMMIT;

Commit complete.

호환성

SQL 표준에서는 global secondary index에 대한 개념을 다루지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLE name ADD GLOBAL SECONDARY INDEX

• ALTER TABLE name ALTER GLOBAL SECONDARY INDEX

ALTER TABLE name ALTER GLOBAL SECONDARY INDEX

기능

테이블에서 global secondary index의 물리적 속성을 변경한다.

구문

<alter table alter global secondary index storage statement> ::=
    ALTER TABLE table_name ALTER GLOBAL SECONDARY INDEX
      <physical attribute clause>
    | [ STORAGE ( <segment attr clause> [...] ) ]
    ;

<physical attribute clause> ::=
      PCTFREE integer
    | INITRANS integer
    | MAXTRANS integer

<segment attr clause> ::=
      INITIAL <size_clause>
    | NEXT <size_clause>
    | MINSIZE <size_clause>
    | MAXSIZE <size_clause>

<size clause> ::=
      integer [ K | M | G | T ]

사용 범위 및 접근 권한

<alter table alter global secondary index storage statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

인덱스를 생성할 테이블 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

<physical attribute clause>

인덱스의 물리적 속성 정보를 정의한다.

• PCTFREE integer

  • 정의

    • 페이지 내 key 삽입으로 인한 페이지 분할 빈도를 조절하기 위해 예약된 공간이다.

    • 인덱스 bottom-up 빌드 시에만 적용된다.

  • 0 에서 99 까지의 값을 사용할 수 있다.

  • 생략할 경우, 기본값은 DEFAULT_INDEX_PCTFREE property에 설정된 값을 사용한다.

• INITRANS integer

  • 정의

    • 페이지에 동시 접근할 수 있는 초기 트랜잭션의 개수이다.

    • 인덱스에 접근하는 사용자의 수가 적을 경우에는 INITRANS를 낮게 설정하고, 동시에 접근하는 사용자가 많을 경우에는 INITRANS를 높게 설정한다.

    • 필요한 경우 설정된 MAXTRANS까지 자동으로 늘어난다.

  • 1 부터 32 까지의 값을 사용할 수 있다.

  • 생략할 경우, 기본값은 4 이다.

• MAXTRANS integer

  • 정의

    • 페이지에 동시 접근할 수 있는 트랜잭션의 최대 개수이다.

  • 1 부터 32 까지의 값을 사용할 수 있다.

  • 생략할 경우, 기본값은 8 이다.

<segment attr clause>

인덱스가 저장될 공간에 대한 정보를 기술한다.

• INITIAL integer

  • 정의

    • 인덱스를 생성할 때 초기에 할당할 물리적 공간의 크기를 기술한다.

    • 이 크기는 테이블이 속하는 TABLESPACE의 EXTENT 크기에 align 되어 사용된다. (예: EXT 크기가 8192 bytes일 경우 'INITIAL 100'은 실제 8192 bytes로 작동한다.)

    • 이 크기 (TABLESPACE의 EXTENT 크기에 align 된 크기)는 MINEXTENTS의 크기와 같거나 커야 하며, MAXEXTENTS의 크기와 같거나 작아야 한다.

  • 최소값은 1이고 최대값은 시스템 환경에 따라 다르다.

  • 생략할 경우, 기본값은 테이블이 속한 TABLESPACE의 EXTENT 하나 크기이다.

• NEXT integer

  • 정의

    • 인덱스의 물리적 공간을 추가할 경우 할당할 물리적 공간의 크기를 기술한다.

    • 이 크기는 테이블이 속하는 TABLESPACE의 EXTENT 크기에 align 되어 사용된다. (예: EXT크기가 8192 bytes일 경우 'NEXT 100'은 실제 8192 bytes로 작동한다.)

    • NEXT는 현재 인덱스가 사용할 수 있는 남은 공간의 크기 (MAXEXTENTS의 크기에서 현재 사용하고 있는 공간의 크기를 뺀 크기)에 따라 다음과 같이 작동한다.

    - 남은 공간의 크기가 0인 경우 더 이상 공간을 확장하지 못한다.

    - 남은 공간의 크기가 0보다 크고 NEXT보다 작은 경우 남은 공간의 크기만큼 할당한다.

    - 남은 공간의 크기가 NEXT 보다 클 경우 NEXT의 크기만큼 할당한다.

  • 최소값은 1이고 최대값은 시스템 환경에 따라 다르다.

  • 생략할 경우, 기본값은 인덱스가 속한 TABLESPACE의 EXTENT 하나 크기이다.

• MINSIZE integer

  • 정의

    • 인덱스에서 유지해야할 최소 공간의 크기이다.

    • 이 값은 MAXSIZE의 값과 같거나 작아야 한다.

  • 이 크기는 인덱스가 속하는 TABLESPACE의 EXTENT 크기에 align 되어 사용된다.

  • 최소값은 1이고 최대값은 시스템 환경에 따라 다르다.

  • EXTENT 두 개 크기보다 작을 경우 EXTENT 두 개 크기로 결정된다.

  • 생략할 경우, 기본값은 EXTENT 두개 크기이다.

• MAXSIZE integer

  • 정의

    • 인덱스에서 할당받을 수 있는 최대 공간의 크기이다.

    • 이 값은 MINSIZE의 값과 같거나 커야 한다.

  • 이 크기는 인덱스가 속하는 TABLESPACE의 EXTENT 크기에 align 되어 사용된다.

  • 최소값은 1이고 최대값은 시스템 환경에 따라 다르다.

  • 생략할 경우, 기본값은 EXTENT 크기 * 2147483647 (INT32의 최대 양의 정수)이다.

<size clause>

파일의 바이트 크기를 명시한다. (단위를 기술하지 않을 경우 bytes이다.)

• K: Kilobytes

• M: Megabytes

• G: Gigabytes

• T: Terabytes

설명

Non-deterministic 질의를 하려면 global secondary index가 반드시 필요하다.

사용 예

테이블 T1의 global secondary index가 사용할 최대 크기를 100 Mbyte로 변경한다.

gSQL> ALTER TABLE T1 ALTER GLOBAL SECONDARY INDEX STORAGE( MAXSIZE 100M );

Table altered.

gSQL> COMMIT;

Commit complete.

테이블 T1의 global secondary index가 사용할 INITRANS, MAXTRANS 값을 2와 4로 변경한다.

gSQL> ALTER TABLE T1 ALTER GLOBAL SECONDARY INDEX INITRANS 2 MAXTRANS 4;

Table altered.

gSQL> COMMIT;

Commit complete.

호환성

SQL 표준에서는 global secondary index에 대한 개념을 다루지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLE name ADD GLOBAL SECONDARY INDEX

• ALTER TABLE name DROP GLOBAL SECONDARY INDEX

ALTER TABLE name MOVE SHARD

기능

테이블의 특정 shard 또는 특정 cluster group의 전체 shard를 특정 cluster group에 재배치한다.

구문

<alter table move shard statement> ::=
    ALTER TABLE table_name MOVE SHARD
        { shard_name_list | FROM CLUSTER GROUP src_cluster_group }
        TO CLUSTER GROUP dest_cluster_group [ ONLINE | OFFLINE ]
    ;

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter table move shard statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

테이블 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.
해당 테이블이 cluster group specific인 경우에만 구문을 수행할 수 있다.

shard_name_list

재배치할 shard name 목록이다.
해당 테이블에 존재하지 않는 shard인 경우 구문을 수행할 수 없다.

src_cluster_group

재배치할 특정 cluster group의 이름이다.

dest_cluster_group

테이블의 shard를 배치할 target cluster group의 이름이다.
해당 테이블의 shard가 지정한 cluster group에 이미 존재할 경우 구문을 수행할 수 없다.

[ ONLINE | OFFLINE ]

테이블의 shard를 재배치할 때 DML을 허용할지 여부를 결정한다.

• ONLINE

  • INSERT, UPDATE, DELETE를 허용한다.

• OFFLINE

  • INSERT, UPDATE, DELETE를 허용하지 않는다.

• 생략할 경우, 기본값은 ONLINE 이다.

설명

테이블의 특정 shard를 특정 cluster group에서 다른 cluster group으로 재배치한다.

특정 cluster group을 제거하려면 테이블의 shard를 재배치한 후에 DROP CLUSTER GROUP 구문을 수행해야 한다.

모든 테이블의 shard를 특정 cluster group에서 다른 cluster group으로 이동시키는 경우, ALTER DATABASE MOVE SHARD FROM CLUSTER GROUP TO CLUSTER GROUP 구문을 수행한다.

사용 예

다음은 <alter table move shard statement> 구문을 수행하는 예이다.

gSQL> ALTER TABLE t1 MOVE SHARD shard1, shard2 TO CLUSTER GROUP g3;

Table altered.

gSQL> ALTER TABLE t1 MOVE SHARD FROM CLUSTER GROUP g1 TO CLUSTER GROUP g3;

Table altered.

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 ALTER DATABASE MOVE SHARD를 참조한다.

ALTER TABLE name REBALANCE

기능

테이블의 shard를 재배치한다.

구문

<alter table rebalance statement> ::=
    ALTER TABLE table_name REBALANCE [ ONLINE | OFFLINE ]
    ;

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter table rebalance statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

테이블의 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우, 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

[ ONLINE | OFFLINE ]

테이블의 shard를 재배치할 때 DML을 허용할지 여부를 결정한다

• ONLINE

  • INSERT, UPDATE, DELETE를 허용한다.

• OFFLINE

  • INSERT, UPDATE, DELETE를 허용하지 않는다.

• 생략할 경우, 기본값은 ONLINE 이다.

설명

다음과 같은 구문을 통해 cluster member, cluster group을 추가할 때 table들의 shard는 재배치하지 않는다.

• CREATE CLUSTER GROUP

• ALTER CLUSTER GROUP name ADD MEMBER

추가된 cluster group과 cluster member의 테이블 shard를 재배치하려면 <alter table rebalance statement> 구문을 수행한다. 테이블의 shard가 이미 재배치된 경우, 별도의 재배치 작업 없이 실행에 성공한다.

모든 테이블들의 shard를 재배치하려면 ALTER DATABASE REBALANCE 구문을 수행한다.

사용 예

다음은 <alter table rebalance statement> 구문을 수행하는 예이다.

gSQL> ALTER TABLE t1 REBALANCE;

Table altered.

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

ALTER TABLE name REBALANCE EXCLUDE CLUSTER GROUP cluster_group_list

기능

특정 cluster group에 shard를 포함하지 않도록 테이블의 shard를 재배치한다.

구문

<alter table rebalance exclude cluster group statement> ::=
    ALTER TABLE table_name REBALANCE 
        EXCLUDE CLUSTER GROUP cluster_group_list [ ONLINE | OFFLINE ]
    ;

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter table rebalance exclude cluster group statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

테이블의 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우, 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.
해당 테이블이 cluster-wide인 경우에만 구문을 수행할 수 있다.

cluster_group_list

테이블의 shard를 포함하지 않는 cluster group의 list이다.
재배치에서 제외될 cluster group이 cluster 전체 group인 경우 구문을 수행할 수 없다.

[ ONLINE | OFFLINE ]

테이블의 shard를 재배치할 때 DML을 허용할지 여부를 결정한다.

• ONLINE

  • INSERT, UPDATE, DELETE를 허용한다.

• OFFLINE

  • INSERT, UPDATE, DELETE를 허용하지 않는다.

• 생략할 경우, 기본값은 ONLINE 이다.

설명

특정 cluster group을 배제하고 테이블의 shard를 재배치한다.
해당 cluster group에 테이블의 shard가 존재하지 않을 경우, 별도의 재배치 작업없이 성공한다.
테이블의 shard가 위치한 cluster group을 기준으로 shard를 재배치한다.

특정 cluster group을 제거하려면 테이블의 shard를 재배치한 후 DROP CLUSTER GROUP 구문을 수행해야 한다.
모든 테이블들에서 cluster group을 배제하고 shard를 재배치하고자 할 경우, ALTER DATABASE REBALANCE EXCLUDE CLUSTER GROUP을 수행한다.

사용 예

다음은 <alter table rebalance exclude cluster group statement> 구문을 수행하는 예이다.

gSQL> ALTER TABLE t1 REBALANCE EXCLUDE CLUSTER GROUP g3;

Table altered.

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

ALTER TABLE name SPLIT SHARD

기능

Cluster 환경에서 테이블의 특정 shard를 split하여 재배치한다.

구문

<alter table split shard statement> ::=
    ALTER TABLE table_name SPLIT SHARD source_shard_name
        INTO ( <split shard placement> [, ...] )
    ;

<split shard placement> ::=
    <split shard bound def> AT CLUSTER GROUP dest_group_name

<split shard bound def> ::=
    <split list shard def>
  | <split range shard def>

<split list shard def> :=
    SHARD dest_shard_name VALUES IN ( <split list value clause> )

<split list value clause> :=
    <split list value> [, ...]

<split list value> :=
    constant
  | NULL

<split range shard def> :=
    SHARD dest_shard_name VALUES LESS THAN ( <split range value clause> )

<split range value clause> :=
    <split range value> [, ...]

<split range value> :=
    constant

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter table split shard statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

테이블 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우, 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.
해당 테이블이 cluster group specific이고 list shard 또는 range shard인 경우에만 구문을 수행할 수 있다.

source_shard_name

Split할 원본 shard 이름이다.
해당 테이블에 shard가 존재하지 않을 경우 구문을 수행할 수 없다.

<split shard placement>

원본 shard를 split하여 재배치할 대상 shard를 정의한다.

<split shard bound def>

Split 될 대상 shard의 bound를 정의한다.

다음 두 가지 bound def 중 하나로 정의할 수 있다.

• <split list shard def>

• <split range shard def>

<split list shard def>

List shard를 위한 split shard bound를 정의한다.

• dest_shard_name

  • 대상 shard 이름이다.

• <split list value clause>

  • <split list value>는 상수값이어야 한다.

  • <split list value>는 NULL 값을 사용할 수 없다.

  • <split list value>는 DEFAULT를 사용할 수 없다.

  • S1 : ( 1, 11, 21, 31, NULL ) SPLIT SHARD S1 INTO ( <split list value clause> .. )

    • (O) SHARD S11 VALUES IN ( 1 )

    • (O) SHARD S11 VALUES IN ( 1, NULL )

    • (O) SHARD S11 VALUES IN ( 1, 11, 21, 31 )

    • (X) SHARD S11 VALUES IN ( 2 )

    • (X) SHARD S11 VALUES IN ( DEFAULT )

    • (X) SHARD S11 VALUES IN ( 1, 11, 21, 31, NULL )

<split range shard def>

Range shard를 위한 split shard bound를 정의한다.

• <split range value clause>

  • <split list value>는 상수값이어야 한다.

  • <split list value>는 NULL 값을 사용할 수 없다.

  • <split list value>는 MAXVALUE를 사용할 수 없다.

  • S1 : ( 100, 100 ), S2 : ( 50, 50 ) SPLIT SHARD S1 INTO ( <split range value clause> .. )

    • (O) SHARD S11 VALUES IN ( 50, 100 )

    • (O) SHARD S11 VALUES IN ( 100, 50 )

    • (O) SHARD S11 VALUES IN ( 60, 60 )

    • (X) SHARD S11 VALUES IN ( 50, NULL )

    • (X) SHARD S11 VALUES IN ( 50, 50 )

    • (X) SHARD S11 VALUES IN ( 100, 100 )

    • (X) SHARD S11 VALUES IN ( 100, 110 )

    • (X) SHARD S11 VALUES IN ( MAXVALUE, 100 )

dest_group_name

Split 된 shard가 배치될 cluster group의 이름이다.

설명

특정 테이블의 특정 shard를 분산하여 임의의 cluster group에 배치한다.
특정 shard에 해당하는 레코드가 많거나 특정 group member에 부하가 편중될 때 shard를 분산하여 레코드와 부하를 분산하기 위해 사용된다.

사용 예

다음은 <alter table split shard statement> 구문을 수행하는 예이다.

gSQL> ALTER TABLE t1 SPLIT SHARD shard1 INTO ( SHARD shard11 VALUES IN ( 11 ) AT CLUSTER GROUP G2 );

Table altered.

gSQL> ALTER TABLE t1 SPLIT SHARD shard1 INTO ( SHARD shard11 VALUES LESS THAN ( 11 ) AT CLUSTER GROUP G2 );


Table altered.

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLE name REBALANCE

• ALTER TABLE name REBALANCE EXCLUDE CLUSTER GROUP cluster_group_list

• ALTER TABLE name MOVE SHARD

ALTER TABLE name RENAME SHARD

기능

Cluster 환경에서 테이블의 특정 shard의 이름을 변경한다.

구문

<alter table rename shard statement> ::=
    ALTER TABLE table_name 
        RENAME SHARD shard_name TO new_shard_name
    ;

사용 범위 및 접근 권한

Cluster system에서 수행할 수 있다.

<alter table rename shard statement> 구문을 수행하려면 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

변경할 테이블의 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우, 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

shard_name

변경할 shard의 기존 이름이다.
Shard가 해당 테이블에 존재하지 않을 경우 구문을 수행할 수 없다.

new_shard_name

변경할 shard의 새 이름이다.
테이블 내에 동일한 shard 이름이 존재하지 않아야 한다.

설명

Hash, range, list 테이블의 특정 shard의 이름을 변경한다. Cloned 테이블에 대해서는 해당 구문을 수행할 수 없다.

사용 예

다음은 <alter table rename shard statement> 구문을 수행하는 예이다.

gSQL> ALTER TABLE t_range RENAME SHARD r_01 TO r_new_01;

Table altered.

gSQL> ALTER TABLE t_list RENAME SHARD l_01 TO l_new_01;

Table altered.

gSQL> ALTER TABLE t_hash RENAME SHARD shard_000000 TO h_new_00;

Table altered.

gSQL> COMMIT;

Commit complete.

호환성

SQL 표준에서는 cluster에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLE

• ALTER TABLE name MOVE SHARD

• ALTER TABLE name SPLIT SHARD

• ALTER TABLE name REBALANCE

ALTER TABLE name READ { ONLY | WRITE }

기능

테이블에 READ { ONLY | WRITE }을 설정한다.

구문

<alter table read { only | write } statement> :==
     ALTER TABLE table_name
         READ { ONLY | WRITE }
     ;

사용 범위 및 접근 권한

<alter table read { only | write } statement> 구문을 수행하려면 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

테이블 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우, 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

설명

테이블 속성을 READ { ONLY | WRITE } 으로 지정한다.

READ ONLY로 지정하면 SELECT .. FOR UPDATE 구문, 테이블의 데이터가 변경되는 DML 또는 DDL 구문들을 사용할 수 없다. 반면, 테이블의 데이터가 변경이 되지 않는 DDL 구문은 허용한다.

사용 예

다음은 <alter table read { only | write } statement> 구문을 수행하는 예이다.

gSQL> ALTER TABLE t1 READ ONLY;

Table altered.

gSQL> ALTER TABLE t1 READ WRITE;

Table altered.

호환성

SQL 표준에서는 <alter table read { only | write } statement> 구문을 정의하지 있지 않다.

참조

관련 내용은 ALTER TABLE을 참조한다.

ALTER TABLE name RENAME TO

기능

테이블의 이름을 변경한다.

구문

<rename table statement> ::=
    ALTER TABLE table_name 
        RENAME TO new_table_name
    ;

사용 범위 및 접근 권한

<rename table statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

테이블의 기존 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

new_table_name

테이블의 새 이름이다.
스키마 내에 동일한 테이블 이름이 존재하지 않아야 한다.

설명

테이블 이름이 변경되더라도 이를 참조하는 index constraint 등의 객체는 변경할 필요없다.

사용 예

다음은 두 테이블 t1, t2의 이름을 서로 바꾸는 예이다.

gSQL> ALTER TABLE t1 RENAME TO t_temp;

Table altered.

gSQL> ALTER TABLE t2 RENAME TO t1;

Table altered.

gSQL> ALTER TABLE t_temp RENAME TO t2;

Table altered.

gSQL> COMMIT;

Commit complete.

호환성

SQL 표준에서는 <rename table statement> 구문을 정의하지 않고 있다.

참조

관련 내용은 ALTER TABLE을 참조한다.

ALTER TABLE name STORAGE

기능

테이블의 물리적 속성을 변경한다.

구문

<alter table physical attribute statement> ::=
    ALTER TABLE table_name 
      [ <physical attribute clause> ]
    | [ STORAGE ( <segment attr clause> [...] ) ]
    ;

<physical attribute clause> ::=
      PCTFREE integer
    | PCTUSED integer
    | INITRANS integer
    | MAXTRANS integer

<segment attr clause> ::=
    NEXT <size_clause>
    | MINSIZE <size_clause>
    | MAXSIZE <size_clause>

<size clause> ::=
      integer [ K | M | G | T ]

사용 범위 및 접근 권한

<alter table physical attribute statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

변경할 테이블 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우, 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

<physical attribute clause>

테이블을 구성하는 page의 물리적 속성을 변경한다.
이미 할당된 page에는 적용되지 않으며 새로 할당받는 page에 적용된다.
자세한 설명은 CREATE TABLE 구문의 <table physical attribute clause> 절을 참조한다.

<segment attr clause>

세그먼트를 구성하는 extent의 물리적 속성을 변경한다. 
이미 할당된 extent에는 적용되지 않으며, 새로 할당받는 extent에 적용된다.

• MAXSIZE integer

  • 할당될 수 있는 세그먼트 공간의 크기를 변경한다.

  • 이미 할당되어 있는 공간보다 작은 크기를 지정하면, MAXSIZE가 현재 할당되어 있는 크기로 변경된다.

설명

각 구문별 사용 규칙을 참조한다.

사용 예

다음은 테이블의 물리적 속성을 변경하는 예이다.

gSQL> ALTER TABLE t1 PCTFREE 10 PCTUSED 40 STORAGE ( NEXT 10M  MAXSIZE  100M );

Table altered.

호환성

SQL 표준에서는 테이블의 물리적 속성에 대하여 정의하지 않고 있다.

참조

관련 내용은 ALTER TABLE을 참조한다.

ALTER TABLE name ADD SUPPLEMENTAL LOG

기능

테이블의 데이터가 변경될 때 테이블에 primary key가 있으면 redo log에 primary key 값을 추가하도록 설정한다.

구문

<add table supplemental log statement> ::=
    ALTER TABLE table_name 
        ADD SUPPLEMENTAL LOG DATA ( PRIMARY KEY ) COLUMNS
    ;

사용 범위 및 접근 권한

<add table supplemental log statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

변경할 테이블의 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

테이블에 primary key가 존재하지 않더라도 구문을 수행할 수 있다.

설명

해당 TABLE에 UPDATE/ DELETE를 수행할 때 SUPPLEMENTAL LOG를 추가로 기록하도록 한다. 기록된 SUPPLEMENTAL LOG는 CDC와 같은 tool 또는 로그를 분석할 때 사용된다.

모든 TABLE의 SUPPLEMENTAL LOG를 기록하려면 SUPPLEMENTAL_LOG_DATA_PRIMARY_KEY = YES 로 설정한다.

사용 예

다음은 테이블의 data를 변경할 때 redo log에 primary key 값을 추가하도록 설정하는 예이다.

gSQL> ALTER TABLE t1 ADD SUPPLEMENTAL LOG DATA ( PRIMARY KEY ) COLUMNS;

Table altered.

호환성

SQL 표준에서는 <add table supplemental log statement>를 다루지 않는다.

참조

관련 내용은 ALTER TABLE name DROP SUPPLEMENTAL LOG를 참조한다.

ALTER TABLE name DROP SUPPLEMENTAL LOG

기능

테이블의 데이터가 변경될 때 redo log에 primary key 정보를 남기지 않도록 설정한다.

구문

<add table supplemental log statement> ::=
    ALTER TABLE table_name 
        DROP SUPPLEMENTAL LOG DATA ( PRIMARY KEY ) COLUMNS
    ;

사용 범위 및 접근 권한

<drop table supplemental log statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 해당 테이블에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• 테이블이 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

table_name

변경할 테이블의 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.
ALTER TABLE name ADD SUPPLEMENTAL LOG 구문을 사용해 설정된 상태여야 한다.

설명

각 구문별 사용 규칙을 참조한다.

사용 예

다음은 테이블의 데이터가 변경되었을 때 redo log에 primary key 정보를 남기지 않도록 설정하는 예이다.

gSQL> ALTER TABLE t1 DROP SUPPLEMENTAL LOG DATA ( PRIMARY KEY ) COLUMNS;

Table altered.

호환성

SQL 표준에서는 <drop table supplemental log statement>를 다루지 않는다.

ALTER TABLESPACE

기능

테이블스페이스의 정의를 변경한다.

구문

<alter tablespace statement> ::=
      <rename tablespace statement>
    | <backup tablespace statement>
    | <on/offline tablespace statement>
    | <add file statement>
    | <drop file statement>
    | <rename datafile statement>
    ;

사용 범위 및 접근 권한

<alter tablespace statement> 구문을 수행하려면 사용자에게 database에 대한 ALTER TABLESPACE 권한이 있어야 한다.

구문 규칙 및 파라미터

<rename tablespace statement>

테이블스페이스의 이름을 변경한다.
자세한 내용은 ALTER TABLESPACE name RENAME TO 구문을 참조한다.

<backup tablespace statement>

테이블스페이스를 백업한다.
자세한 내용은 ALTER TABLESPACE name BACKUP 구문을 참조한다.

<on-offline tablespace statement>

테이블스페이스의 모든 파일을 online 또는 offline으로 변경한다.
자세한 내용은 ALTER TABLESPACE name [ONLINE|OFFLINE] 구문을 참조한다.

<add file statement>

테이블스페이스에 파일을 추가한다.
자세한 내용은 ALTER TABLESPACE name ADD [DATAFILE|MEMORY] 구문을 참조한다.

<drop file statement>

테이블스페이스의 파일을 제거한다.
자세한 내용은 ALTER TABLESPACE name DROP [DATAFILE|MEMORY] 구문을 참조한다.

<rename datafile statement>

데이터 테이블스페이스의 데이터 파일 이름을 변경한다.
자세한 내용은 ALTER TABLESPACE name RENAME DATAFILE 구문을 참조한다.

설명

ALTER TABLESPACE 구문은 다른 Data Definition Language (DDL)과 달리 ROLLBACK 할 수 없고 구문을 수행한 transaction이 자동으로 COMMIT 된다.

사용 예

각 세부 구문의 사용 예를 참조한다.

호환성

SQL 표준에서는 테이블스페이스 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• CREATE TABLESPACE

• DROP TABLESPACE

ALTER TABLESPACE name RENAME TO

기능

테이블스페이스의 이름을 변경한다.

구문

<rename tablespace statement> ::=
    ALTER TABLESPACE tablespace_name RENAME TO <new_tablespace_name>
    ;

사용 범위 및 접근 권한

<rename space statement> 구문을 수행하려면 사용자에게 ALTER TABLESPACE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

tablespace_name

기존 테이블스페이스의 이름이다.

• Built-in 테이블스페이스의 이름은 변경할 수 없다.

• OFFLINE 테이블스페이스의 이름은 변경할 수 없다.

new_tablespace_name

새로운 테이블스페이스의 이름이다.

설명

Tablespace 이름이 변경되더라도 기존에 이미 해당 tablespace에 생성된 table, index 등은 변경할 필요없다.

사용 예

다음은 테이블스페이스의 이름을 변경하는 예이다.

gSQL> ALTER TABLESPACE space1 RENAME TO space2;

Tablespace altered.

호환성

SQL 표준에서는 테이블스페이스 개념을 정의하지 않고 있다.

참조

관련 내용은 ALTER TABLESPACE를 참조한다.

ALTER TABLESPACE name BACKUP

기능

테이블스페이스를 backup 하기 위해 backup이 가능한 상태와 불가능한 상태로 전환한다.

구문

<backup tablespace statement> ::=
      <tablespace begin backup statement>
    | <tablespace end backup statement>
    | <tablespace incremental backup statement>    
    ;

<tablespace begin backup statement> ::=
    ALTER TABLESPACE tablespace_name BEGIN BACKUP [AT <domain_name>]
    ;

<tablespace end backup statement> ::=
    ALTER TABLESPACE tablespace_name END BACKUP [AT <domain_name>]
    ;

<tablesapce incremental backup statement> ::=
    ALTER TABLESPACE tablespace_name 
        BACKUP INCREMENTAL <incremental backup option> [AT <domain_name>]    ;

<incremental backup option> ::=
      LEVEL integer [ CUMULATIVE | DIFFERENTIAL ]

사용 범위 및 접근 권한

<backup space statement> 구문을 수행하려면 사용자에게 ALTER TABLESPACE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<tablespace begin backup statement>

테이블스페이스를 백업 가능한 상태로 설정한다.

• 생성되어 사용 중인 테이블스페이스를 백업 가능한 상태로 설정한다.

• OFFLINE/ temporary 테이블스페이스의 backup 상태는 전환할 수 없다.

tablespace_name

Backup 상태를 전환할 테이블스페이스의 이름이다.

<tablespace end backup statement>

테이블스페이스를 백업이 불가능한 상태로 설정한다.

<tablesapce incremental backup statement>

테이블스페이스의 증분 백업을 수행한다.
데이터베이스가 OPEN 상태이고, ARCHIVELOG로 운영되어야 한다.

<incremental backup option>

• 'integer'는 0 ~ 4 까지 지정할 수 있다.

• 'LEVEL 0'는 CUMULATIVE나 DIFFERENTIAL을 지정할 수 없다.

• CUMULATIVE | DIFFERENTIAL

  • CUMULATIVE

    • 'integer'가 n이면 가장 최근에 'LEVEL 0' ~ 'LEVEL n-1'까지 백업한 이후 변경된 모든 페이지들을 백업한다.

  • DIFFERENTIAL

    • 'integer'가 n이면 가장 최근에 'LEVEL 0' ~ 'LEVEL n'까지 백업한 이후 변경된 모든 페이지들을 백업한다.

  • 생략되면 DIFFERENTIAL이 기본으로 지정된다.

<domain_name>

구문을 수행할 멤버나 그룹의 이름이다.
지정하지 않은 경우에는 모든 그룹에 수행된다.

설명

테이블스페이스에 생성된 datafile을 백업한다. 테이블스페이스 전체를 백업하려면 BEGIN BACKUP을 수행한 후 OS의 파일 복사로 datafile들을 복사하고 나서 END BACKUP을 수행한다. 한편, 증분 백업 파일은 하나의 구문으로 BACKUP_DIR_1 property에 설정된 경로에 생성한다.

사용 예

다음은 DICTIONARY_TBS 테이블스페이스의 전체 백업 상태를 'ACTIVE'로 설정하는 예이다.

ALTER TABLESPACE DICTIONARY_TBS BEGIN BACKUP;

다음은 DICTIONARY_TBS 테이블스페이스의 전체 백업 상태를 'INACTIVE'로 설정하는 예이다.

ALTER TABLESPACE DICTIONARY_TBS END BACKUP;

다음은 DICTIONARY_TBS 테이블스페이스의 LEVEL 0 증분 백업을 만드는 예이다.

ALTER TABLESPACE DICTIONARY_TBS BACKUP INCREMENTAL LEVEL 0;

호환성

SQL 표준에서는 테이블스페이스 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLESPACE

• ALTER TABLESPACE name [ONLINE|OFFLINE]

ALTER TABLESPACE name [ONLINE|OFFLINE]

기능

테이블스페이스 상태를 변경한다.

구문

<on/off tablespace statement> ::=
    ALTER TABLESPACE tablespace_name { ONLINE | OFFLINE [ NORMAL | IMMEIDATE ] }
    [ AT <domain name> ]
    ;

사용 범위 및 접근 권한

<on/off tablespace statement> 구문을 수행하려면 사용자에게 ALTER TABLESPACE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

ONLINE

OFFLINE 상태의 테이블스페이스를 ONLINE으로 변경한다.

OFFLINE NORMAL

ONLINE 상태의 테이블스페이스를 OFFLINE으로 변경한다.

OFFLINE으로 변경된 테이블스페이스는 일관된 (consistent) 상태이기 때문에 ONLINE 상태로 변경할 때 미디어 복구할 필요없다.

OFFLINE IMMEDIATE

ONLINE 상태의 테이블스페이스를 OFFLINE으로 변경한다.

OFFLINE으로 변경된 테이블스페이스는 비일관적인 (inconsistent) 상태이기 때문에, ONLINE 상태로 변경할 때 미디어 복구해야 한다.

<domain name>

구문을 수행할 멤버나 그룹의 이름이다.
지정하지 않은 경우에는 모든 그룹에 수행된다.

설명

각 구문별 사용 규칙을 참조한다.

사용 예

다음은 테이블스페이스를 OFFLINE으로 설정하는 예이다.

gSQL> ALTER TABLESPACE space1 OFFLINE;

Tablespace altered.

다음은 MOUNT 단계에서 테이블스페이스에 OFFLINE NORMAL을 수행하여 실패하는 예이다.

gSQL> ALTER TABLESPACE space1 OFFLINE;

ERR-42000(16290): OFFLINE NORMAL is only allowed if the database is in OPEN phase : 
ALTER TABLESPACE space1 OFFLINE
                 *
ERROR at line 1:

gSQL> ALTER TABLESPACE space1 OFFLINE NORMAL;

ERR-42000(16290): OFFLINE NORMAL is only allowed if the database is in OPEN phase : 
ALTER TABLESPACE space1 OFFLINE NORMAL
                 *
ERROR at line 1:

호환성

SQL 표준에서는 테이블스페이스 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLESPACE

• ALTER TABLESPACE name BACKUP

ALTER TABLESPACE name ADD [DATAFILE|MEMORY]

기능

테이블스페이스의 공간을 확장한다.

구문

<add space statement> ::=
    ALTER TABLESPACE tablespace_name ADD <space specification>
        [AT <domain name>]
    ;

<space specification> ::=
      MEMORY <memory clause> [, ...]
    | DATAFILE <add datafile clause> [, ...]

<size clause> ::=
    integer [ K | M | G | T ]

<memory clause> 
     'memory_name' { SIZE <size clause> }

<add datafile clause> ::=
     'filename' 
        { SIZE <size clause> | REUSE | SIZE <size clause> REUSE }

사용 범위 및 접근 권한

<add space statement> 구문을 수행하려면 사용자에게 ALTER TABLESPACE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

tablespace_name

변경할 테이블스페이스의 이름이다.

<file specification>

테이블스페이스의 유형에 따라 다음과 같은 구문을 사용해야 한다.

• 메모리 데이터 테이블스페이스

  • DATAFILE <add datafile clause>

• 메모리 임시 테이블스페이스

  • MEMORY <memory clause>

<add datafile clause>

추가할 메모리 데이터 파일을 정의한다.

• 'filename'

  • 데이터를 저장 관리할 파일의 이름이다.

  • 메모리 데이터에 대한 체크포인트 이미지를 저장할 공간이다.

  • filename은 새로운 파일이거나 이미 존재하는 파일일 수 있다.

  • filename의 길이는 1024 바이트보다 작아야 한다.

• SIZE <size clause>

  • 새로운 파일일 경우 SIZE 절을 이용해 초기 크기를 지정한다.

  • 파일이 이미 존재할 경우 에러가 발생한다.

  • 파일의 크기는 최소 1 M ~ 최대 30 G 까지 지정할 수 있다.

• REUSE

  • 이미 존재하는 파일일 경우 REUSE 절을 이용한다.

  • 파일이 존재하지 않을 경우 새로운 파일을 생성한다.

  • 새로 생성되는 파일의 사이즈는

    • 데이터 테이블스페이스의 경우 MEMORY_DATA_TABLESPACE_SIZE 프로퍼티에 의해 결정되고

    • 임시 테이블스페이스의 경우 MEMORY_TEMP_TABLESPACE_SIZE 프로퍼티에 의해 결정된다.

• SIZE <size clause> REUSE

  • SIZE 절과 REUSE 절을 모두 명시할 경우 filename의 존재 여부에 따라 다음과 같이 작동한다.

    • 새로운 filename일 경우 SIZE 절을 이용해 초기 파일 크기를 지정한다.

    • 이미 존재하는 filename일 경우 기존 파일을 이용하여 SIZE 절의 값으로 크기를 조정한다.

<memory clause>

• <size clause>

  • 추가할 메모리를 정의한다.

자세한 내용은 CREATE MEMORY TEMPORARY TABLESPACE 구문의 <memory clause>를 참조한다.

<domain name>

구문을 수행할 멤버나 그룹의 이름이다.
지정하지 않은 경우에는 모든 그룹에 수행된다.

설명

각 구문별 사용 규칙을 참조한다.

사용 예

다음은 테이블스페이스에 data file을 추가하는 예이다.

gSQL> ALTER TABLESPACE space1 ADD DATAFILE 'test_file_a2.dbf' SIZE 10M REUSE;

Tablespace altered.

호환성

SQL 표준에서는 테이블스페이스 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• CREATE MEMORY DATA TABLESPACE

• CREATE MEMORY TEMPORARY TABLESPACE

• ALTER TABLESPACE

ALTER TABLESPACE name DROP [DATAFILE|MEMORY]

기능

테이블스페이스의 공간을 축소한다.

구문

<drop space statement> ::=
    ALTER TABLESPACE tablespace_name DROP <file specification>
    [ AT <domain name> ]
    ;

<file specification> ::=
      DATAFILE 'filename' 
    | MEMORY 'memory_name'

사용 범위 및 접근 권한

<drop space statement> 구문을 수행하려면 사용자에게 ALTER TABLESPACE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

tablespace_name

변경할 테이블스페이스의 이름이다.

<file specification>

테이블스페이스의 유형에 따라 다음과 같은 구문을 사용해야 한다.

• 메모리 데이터 테이블스페이스

  • DATAFILE 'filename'

• 메모리 임시 테이블스페이스

  • MEMORY 'memory_name'

<domain name>

구문을 수행하는 멤버 및 그룹의 이름이다.
지정하지 않은 경우에는 모든 그룹에 수행된다.

설명

각 구문별 사용 규칙을 참조한다.

사용 예

다음은 테이블스페이스의 파일을 제거하는 예이다.

gSQL> ALTER TABLESPACE space1 DROP DATAFILE 'test_file_f2.dbf';

Tablespace altered.

호환성

SQL 표준에서는 테이블스페이스 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLESPACE

• ALTER TABLESPACE name ADD [DATAFILE|MEMORY]

• ALTER TABLESPACE name RENAME DATAFILE

ALTER TABLESPACE name RENAME DATAFILE

기능

테이블스페이스를 구성하는 데이터 파일의 이름을 변경한다.

구문

<rename datafile statement> ::=
    ALTER TABLESPACE tablespace_name RENAME DATAFILE <filename_list> TO <filename_list>
    ;

    <filename_list> ::= 
        'filename' [ AT <domain name> ] [, ...]

사용 범위 및 접근 권한

<rename datafile statement> 구문을 수행하려면 사용자에게 ALTER TABLESPACE ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

tablespace_name

변경할 테이블스페이스의 이름이다.

'filename'

메모리 임시 테이블스페이스는 'memory_name'을 의미하며, 그 외의 테이블스페이스 종류는 'filename'을 의미한다.

<domain name>

구문을 수행할 멤버나 그룹의 이름이다.
지정하지 않은 경우에는 모든 그룹에 수행된다.

설명

테이블스페이스 상태에 따라 연산 가능 여부가 결정된다.

• OFFLINE: MOUNT 단계나 OPEN 단계에서 수행 가능하다.

• ONLINE: MOUNT 단계에서만 수행 가능하다.

사용 예

다음은 'test.dbf'를 'test1.dbf'로 변경하는 예이다.

gSQL> ALTER TABLESPACE TEST_TBS RENAME DATAFILE 'test.dbf' TO 'test1.dbf';

Tablespace altered.

호환성

SQL 표준에서는 테이블스페이스 개념을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• ALTER TABLESPACE

• ALTER TABLESPACE name ADD [DATAFILE|MEMORY]

• ALTER TABLESPACE name DROP [DATAFILE|MEMORY]

ALTER USER

기능

데이터베이스 사용자 정의를 변경한다.

구문

<alter user statement> ::=
      ALTER USER user_identifier <alter user action>
    | ALTER USER PUBLIC <alter schema path>
    ;

<alter user action> ::=
      <alter password>
    | <alter profile>
    | <password expire>
    | <account lock>
    | <alter default tablespace>
    | <alter temporary tablespace>
    | <alter index tablespace>
    | <alter schema path>

<alter password> ::=
    IDENTIFIED BY new_password [ REPLACE old_password ]

<alter profile> ::=
    PROFILE { profile_name | DEFAULT | NULL }

<password expire> ::=
    PASSWORD EXPIRE

<account lock> ::=
    ACCOUNT { LOCK | UNLOCK }

<alter default tablespace> ::=
    DEFAULT TABLESPACE tablespace_name

<alter temporary tablespace> ::=
    TEMPORARY TABLESPACE tablespace_name

<alter index tablespace> ::=
    INDEX TABLESPACE { tablespace_name | NULL }

<alter schema path> ::=
    SCHEMA PATH ( { schema_name | CURRENT PATH } [, ...] )

사용 범위 및 접근 권한

<alter user statement> 구문을 수행하려면 사용자에게 ALTER USER ON DATABASE 권한이 있어야 한다.
단, <alter password>는 사용자가 user_identifier와 동일할 경우에 권한 없이 수행할 수 있다.

구문 규칙 및 파라미터

user_identifier

변경할 사용자의 이름이다.

<alter password>

사용자의 password를 변경한다.

• IDENTIFIED BY new_password

  • 새로운 password로 암호화되어 저장된다.

  • Password의 길이는 128 byte보다 작아야 한다.

  • Password는 대소문자를 구별한다.

• REPLACE old_password

  • ALTER USER ON DATABASE 권한이 있을 경우에는 생략 가능하다.

  • ALTER USER ON DATABASE 권한이 없을 경우에는 생략할 수 없다.

    • 사용자와 user_identifier가 동일해야 한다.

<alter profile>

비밀번호 관리 정책 profile을 변경한다.

• PROFILE profile_name

  • 사용자가 생성한 profile_name을 할당한다.

• PROFILE DEFAULT

  • 기본 profile인 "DEFAULT"를 할당한다.

• PROFILE NULL

  • Profile을 할당하지 않는다.

<password expire>

사용자의 비밀번호를 만료시킨다.

<account lock>

• ACCOUNT LOCK

  • 사용자 계정을 잠근다.

• ACCOUNT UNLOCK

  • 계정 잠금을 해제한다.

<alter default tablespace>

사용자의 기본 tablespace를 변경한다.
tablespace_name은 data tablespace여야 한다.

<alter temporary tablespace>

사용자의 temporary tablespace를 변경한다.
tablespace_name은 temporary tablespace여야 한다.

<alter index tablespace>

사용자의 index tablespace를 변경한다.

• INDEX TABLESPACE tablespace_name을 지정한다.

  • Data tablespace를 지정한 경우, LOGGING 인덱스여야 한다.

  • Temporary tablespace를 지정한 경우, NOLOGGING 인덱스여야 한다.

• INDEX TABLESPACE NULL

  • Index tablespace를 지정하지 않는다.

<alter schema path>

사용자의 스키마 접근 경로를 변경한다.
사용자의 SQL 구문에 schema가 명시되지 않았을 경우 스키마 접근 경로는 객체의 naming resolution을 위한 스키마 순서에 따라 결정된다.

스키마 이름이 기존에 스키마 접근 경로에 나열된 스키마 이름과 동일할 경우에는 추가적으로 반영되지 않는다.

다음은 ALTER USER u1 SCHEMA PATH ( u1, s2, public ); 구문을 수행했을 때 schema에 존재하는 객체의 예이다.

다음과 같이 u1 사용자가 수행하는 schema가 명시되지 않은 객체의 이름은 SCHEMA PATH에 의해 다음과 같이 해석된다.

• CREATE 구문

  • CREATE TABLE t1 ( c1 INTEGER );

    • 에러: CREATE TABLE u1.t1 ( c1 INTEGER );

  • CREATE TABLE t2 ( c1 INTEGER );

    • 수행: CREATE TABLE u1.t2 ( c1 INTEGER );

• SELECT 구문

  • SELECT * FROM t1;

    • 수행: SELECT * FROM u1.t1;

  • SELECT * FROM t2;

    • 수행: SELECT * FROM s2.t2;

  • SELECT * FROM t3;

    • 수행: SELECT * FROM public.t3;

CURRENT PATH

현재 사용자의 schema path이다.

다음 예와 같이 CURRENT PATH를 이용해 기존의 schema path를 유지하면서 새로운 schema path를 추가할 수 있다.

• u1의 현재 schema path

  • (u1, public)

• 구문 수행

  • ALTER USER u1 SCHEMA PATH ( s1, CURRENT PATH, s2 );

• u1의 schema path는 다음과 같이 변경된다.

  • (s1, u1, public, s2)

ALTER USER PUBLIC <alter schema path>

PUBLIC 계정의 schema path를 변경한다.
PUBLIC 계정의 schema path는 모든 사용자의 schema path에 포함된다.

PUBLIC 계정에 최초로 부여된 schema path는 다음과 같다.

• DICTIONARY_SCHEMA

• INFORMATION_SCHEMA

• DEFINITION_SCHEMA

• PERFORMANCE_VIEW_SCHEMA

• FIXED_TABLE_SCHEMA

설명

각 구문별 사용 규칙을 참조한다.

사용 예

다음은 사용자의 password를 변경하는 예이다.

gSQL> ALTER USER u1 IDENTIFIED BY new_password;

User altered.

다음의 사용자에게 profile을 할당하는 예이다.

gSQL> ALTER USER u1 PROFILE prof1;

User altered.

gSQL> COMMIT;

Commit complete.

다음은 사용자의 profile을 제거하는 예이다.

gSQL> ALTER USER u1 PROFILE NULL;

User altered.

gSQL> COMMIT;

Commit complete.

다음은 사용자의 비밀번호를 만료시키는 예이다.

gSQL> ALTER USER u1 PASSWORD EXPIRE;

User altered.

gSQL> COMMIT;

Commit complete.

다음은 사용자의 계정잠금을 해제하는 예이다.

gSQL> ALTER USER u1 ACCOUNT UNLOCK;

User altered.

gSQL> COMMIT;

Commit complete.

다음은 사용자의 DEFAULT TABLESPACE를 변경하는 예이다.

gSQL> ALTER USER u1 DEFAULT TABLESPACE mem_data_tbs;

User altered.

다음은 사용자의 TEMPORARY TABLESPACE를 변경하는 예이다.

gSQL> ALTER USER u1 TEMPORARY TABLESPACE mem_temp_tbs;

User altered.

다음은 사용자의 INDEX TABLESPACE를 변경하는 예이다.

gSQL> ALTER USER u1 INDEX TABLESPACE mem_temp_tbs;

User altered.

다음은 사용자의 schema path를 변경하는 예이다.

gSQL> ALTER USER u1 SCHEMA PATH ( s1, CURRENT PATH );

User altered.

호환성

SQL 표준에서 user의 개념은 다루고 있지만 user의 생성, 변경 및 삭제와 관련된 SQL 구문은 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• CREATE USER

• DROP USER

ALTER VIEW

기능

View 정의를 변경한다.

구문

<alter view statement> ::=
    ALTER VIEW view_name <alter view action>
    ;

<alter view action> ::=
    COMPILE

사용 범위 및 접근 권한

<alter view statement> 구문을 수행하려면 사용자에게 다음 권한 중 하나가 있어야 한다.

• 해당 view에 대해 (ALTER 또는 CONTROL TABLE) ON TABLE

• View가 속한 스키마에 대해 (ALTER TABLE 또는 CONTROL SCHEMA) ON SCHEMA

• ALTER ANY TABLE ON DATABASE

구문 규칙 및 파라미터

view_name

변경할 view의 이름이다.
schema_name.view_name과 같이 view가 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

COMPILE

View를 다시 컴파일한다.
View column에 부여한 COMMENT는 초기화된다.

설명

View가 참조하는 테이블이나 view가 변경되거나 삭제되면 해당 view도 영향을 받는다.

이런 정보는 INFORMATION_SCHEMA.VIEWS를 통해 조회할 수 있다.

• IS_COMPILED column

  • TRUE: View가 정상적으로 생성되었다.

  • FALSE: 에러가 존재하는 상태에서 FORCE 옵션으로 view가 생성되었다.

• IS_AFFECTED column

  • TRUE : View가 참조하는 테이블 또는 view가 변경되었다.

  • FALSE: View가 생성되고 COMPILE 된 후에 view가 참조하는 테이블이나 view가 변경되지 않았다.

사용 예

다음은 view가 참조하는 table 변경에 영향을 받은 view를 COMPILE 하는 예이다.

gSQL> SELECT TABLE_NAME, IS_AFFECTED 
        FROM INFORMATION_SCHEMA.VIEWS 
       WHERE TABLE_SCHEMA = 'PUBLIC'
         AND TABLE_NAME = 'V1';

TABLE_NAME IS_AFFECTED
---------- -----------
V1         TRUE       

1 row selected.


gSQL> ALTER VIEW v1 COMPILE;

View altered.

COMMIT;

Commit complete.

gSQL> SELECT TABLE_NAME, IS_AFFECTED 
        FROM INFORMATION_SCHEMA.VIEWS 
       WHERE TABLE_SCHEMA = 'PUBLIC'
         AND TABLE_NAME = 'V1';

TABLE_NAME IS_AFFECTED
---------- -----------
V1         FALSE      

1 row selected.

호환성

SQL 표준에서는 <alter view statement> 구문을 정의하지 않고 있다.

참조

관련 내용은 다음을 참조한다.

• CREATE VIEW

• DROP VIEW

ANALYZE SYSTEM

기능

시스템의 통계 정보를 제어한다.

구문

<analyze system statement> ::=
    ANALYZE SYSTEM [ <analyze action> ]
    ;

<analyze action> ::=
      COMPUTE STATISTICS
    | DELETE STATISTICS

사용 범위 및 접근 권한

<analyze system statement> 구문을 수행하려면 사용자에게 ANALYZE ANY ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

<analyze action>

생략할 경우 기본값은 COMPUTE STATISTICS 이다.

COMPUTE STATISTICS

시스템과 관련된 다음과 같은 통계 정보를 구축한다.

• CPU_OPS (Operations Per Second)

  • CPU가 초당 처리할 수 있는 operation의 개수이다.

• NETWORK_IOPS (IO operations Per Second)

  • Cluster인 경우에 유효하다.

  • 초당 처리할 수 있는 network IO 횟수이다.

DELETE STATISTICS

시스템 통계 정보를 삭제한다.

설명

구축한 시스템 통계 정보는 질의 처리를 위한 최적화 과정의 비용을 계산하기 위해 사용한다.

사용 예

다음은 <analyze system statement> 구문을 사용하여 시스템 통계 정보를 구축하는 예이다.

gSQL> ANALYZE SYSTEM COMPUTE STATISTICS;

analyzed.

다음은 구축된 시스템 통계 정보를 조회하는 예이다.

gSQL> 
SELECT * FROM DBA_STAT_SYSTEM;

 CPU_OPS NETWORK_IOPS NETWORK_BUFSIZE LAST_ANALYZED             
-------- ------------ --------------- --------------------------
53000412         2914           65536 2017-03-30 16:49:42.200000

1 row selected.

호환성

SQL 표준에서는 통계 정보에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 ANALYZE TABLE을 참조한다.

ANALYZE TABLE

기능

테이블의 통계 정보를 제어한다.

구문

<analyze table statement> ::=
    ANALYZE TABLE table_name
    [ <parallel clause> ]
    [ <analyze action> ]
    ;

<parallel clause> ::=
      NOPARALLEL
    | PARALLEL [thread_count]

<analyze action> ::=
      COMPUTE STATISTICS [ <for_clause> ]
    | ESTIMATE STATISTICS <sample_clause> [ <for_clause> ]
    | DELETE STATISTICS

<sample_clause>
      SAMPLE row_count ROWS
    | SAMPLE percentage PERCENT

<for_clause>
      FOR ALL COLUMNS
    | FOR ALL INDEXED COLUMNS
    | FOR COLUMNS column_name [, ...]
    | FOR ALL INDEXES
    | FOR INDEXES index_name [, ...]

사용 범위 및 접근 권한

<analyze table statement> 구문을 수행하려면 사용자에게 ANALYZE ANY ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

table_name

테이블 이름이다.
schema_name.table_name과 같이 테이블이 소속한 스키마를 정의할 수 있는데 schema_name을 생략할 경우 구문을 수행하는 사용자의 기본 스키마 이름이 사용된다.

<parallel clause>

분석 과정에서 사용할 thread 개수를 지정한다.
명시하지 않을 경우, 기본값은 PARALLEL 이다.

• NOPARALLEL

  • 병렬로 분석하지 않는다.

• PARALLEL [thread_count]

  • 병렬로 분석한다.

  • thread_count 값은 0 부터 사용할 수 있으며 최대값은 64 이다.

  • thread_count 값이 0이거나 생략된 경우 시스템의 CPU 개수에 의해 결정된다.

<analyze action>

생략할 경우 기본값은 COMPUTE STATISTICS 이다.

COMPUTE STATISTICS

전수 검사를 통해 테이블과 관련된 다음과 같은 통계 정보를 구축한다.

• Table 통계정보

  • Row count

• 각 column의 통계 정보

  • 서로 다른 값의 개수

  • NULL 값의 개수

  • 값의 평균 길이

  • 최소값

  • 최대값

• Index 통계정보

  • 서로 다른 key의 개수

Column의 data type에 따라 구축하는 통계 정보는 다음과 같다.

ESTIMATE STATISTICS <sample_clause>

지정한 <sample_clause>만큼의 샘플을 사용하여 column과 index의 통계 정보를 구축한다.

• SAMPLE row_count ROWS

  • 지정한 row 개수만큼 샘플을 사용한다.

  • row_count는 0보다 큰 양의 정수이다.

• SAMPLE percentage PERCENT

  • 지정한 비율만큼 샘플을 사용한다.

  • Percentage는 1 ~ 99 범위의 양의 정수이다.

샘플링 row의 개수가 MIN_SAMPLE_ROW_COUNT 프로퍼티 값보다 작을 경우 프로퍼티 값을 따른다.

<for_clause>

생략할 경우, 통계정보 구축이 가능한 모든 column과 모든 인덱스의 통계 정보를 구축한다.

FOR ALL COLUMNS

통계 정보 구축이 가능한 모든 column의 통계 정보를 구축한다. 
인덱스 통계 정보는 구축하지 않는다.

FOR ALL INDEXED COLUMNS

인덱스에 포함된 모든 column의 통계 정보를 구축한다. 
그 외 column의 통계 정보는 구축하지 않는다. 
인덱스 통계 정보는 구축하지 않는다.

FOR COLUMNS column_name [, ...]

나열한 column의 통계 정보를 구축한다. 
기술하지 않은 column의 통계 정보는 구축하지 않는다. 
인덱스 통계 정보는 구축하지 않는다.

FOR ALL INDEXES

모든 인덱스의 통계 정보를 구축한다. 
Column 통계 정보는 구축하지 않는다.

FOR INDEXES index_name [, ...]

나열한 인덱스의 통계 정보를 구축한다. 
기술하지 않은 인덱스의 통계 정보는 구축하지 않는다. 
Column 통계 정보는 구축하지 않는다.

DELETE STATISTICS

테이블의 통계 정보를 제거한다.

설명

테이블 통계 정보는 질의 최적화의 정확도에 영향을 미치는 매우 중요한 정보이다.

통계 정보 구축시간은 테이블의 데이터 양에 비례하므로, 데이터 양이 많을 경우 샘플링을 사용하여 통계 정보를 구축하거나 질의에 영향을 미치는 주요 정보에 대해서만 통계 정보를 구축하는 것이 바람직하다.

• 다음은 샘플링을 사용하여 통계 정보를 구축하는 예이다.

ANALYZE TABLE lineitem ESTIMATE STATISTICS SAMPLE 10 PERCENT;

• 다음은 주요 column과 인덱스에 대해서만 통계 정보를 구축하는 예이다.

ANALYZE TABLE lineitem COMPUTE STATISTICS FOR ALL INDEXED COLUMNS;
ANALYZE TABLE lineitem COMPUTE STATISTICS FOR ALL INDEXES;

사용 예

다음은 전수 검사를 통해 통계 정보를 구축하는 예이다.

gSQL> ANALYZE TABLE orders;

Table analyzed.

다음은 구축된 테이블 통계 정보를 조회하는 예이다.

gSQL>
SELECT 
       TABLE_NAME
     , NUM_ROWS
  FROM
       DICTIONARY_SCHEMA.USER_TABLES
 WHERE
       TABLE_SCHEMA = 'PUBLIC'
   AND TABLE_NAME   = 'ORDERS'
;

TABLE_NAME NUM_ROWS
---------- --------
ORDERS      1500000

1 row selected.


gSQL>
SELECT 
       TABLE_NAME
     , COLUMN_NAME
     , NUM_DISTINCT
     , NUM_NULLS
     , LOW_VALUE
     , HIGH_VALUE
  FROM
       DICTIONARY_SCHEMA.USER_TAB_COLUMNS
 WHERE
       TABLE_SCHEMA = 'PUBLIC'
   AND TABLE_NAME   = 'ORDERS'
;

TABLE_NAME COLUMN_NAME     NUM_DISTINCT NUM_NULLS LOW_VALUE           HIGH_VALUE         
---------- --------------- ------------ --------- ------------------- -------------------
ORDERS     O_ORDERKEY           1500000         0 1                   6000000            
ORDERS     O_CUSTKEY              99996         0 1                   149999             
ORDERS     O_ORDERSTATUS              3         0 F                   P                  
ORDERS     O_TOTALPRICE         1464556         0 857.71              555285.16          
ORDERS     O_ORDERDATE             2406         0 1992-01-01 00:00:00 1998-08-02 00:00:00
ORDERS     O_ORDERPRIORITY            5         0 1-URGENT            5-LOW              
ORDERS     O_CLERK                 1000         0 Clerk#000000001     Clerk#000001000    
ORDERS     O_SHIPPRIORITY             1         0 0                   0                  
ORDERS     O_COMMENT            1482071         0 null                null               

9 rows selected.

gSQL>
SELECT 
       TABLE_NAME
     , INDEX_NAME
     , DISTINCT_KEYS
  FROM
       DICTIONARY_SCHEMA.USER_INDEXES
 WHERE
       TABLE_SCHEMA = 'PUBLIC'
   AND TABLE_NAME   = 'ORDERS'
;

TABLE_NAME INDEX_NAME        DISTINCT_KEYS
---------- ----------------- -------------
ORDERS     ORDERS_PK_INDEX         1500000
ORDERS     ORDERS_CUSTKEY_FK         99996

2 rows selected.

호환성

SQL 표준에서는 통계 정보에 대한 개념을 정의하지 않고 있다.

참조

관련 내용은 ANALYZE SYSTEM을 참조한다.

AUDIT POLICY

기능

Audit policy를 활성화한다.

구문

<audit policy statement> ::= 
    AUDIT POLICY policy_name
    [ <specified_user_option> ]
    [ <specified_success_option> ]
    ;

<specified_user_option> ::=
      BY user_name [, ...]
    | EXCEPT user_name [, ...]

<specified_success_option> ::=
      WHENEVER SUCCESSFUL
    | WHENEVER NOT SUCCESSFUL

사용 범위 및 접근 권한

<audit policy statement> 구문을 수행하려면 사용자에게 AUDIT SYSTEM ON DATABASE 권한이 있어야 한다.

구문 규칙 및 파라미터

policy_name

활성화할 audit policy 객체의 이름이다.
활성화 된 audit policy는 기존 session에 영향을 미치지 않으며 새로 생성되는 session에만 영향을 준다.

<specified_user_option>

감사를 수행할 사용자를 명시한다.   
생략할 경우 모든 사용자에 대해 감사를 수행한다.

동일한 audit policy에 대해 BY 절과 EXCEPT 절을 함께 사용할 수 없다.

• BY user_list: 감사를 수행할 사용자를 특정할 경우 BY 절을 사용한다.

• EXCEPT user_list: 특정 사용자를 배제하고 다른 사용자들을 감사할 경우 EXCEPT 절을 사용한다.

<specified_success_option>

• WHENEVER SUCCESSFUL

  • Action이 성공했을 때 audit record가 생성된다.

• WHENEVER NOT SUCCESSFUL

  • Action이 실패했을 때 audit record가 생성된다.

• 생략할 경우 성공할 경우와 실패할 경우 모두 audit record를 생성한다.

설명

Audit policy를 활성화하면 기존 session에는 영향을 미치지 않으며 새로 생성되는 session에 대해 감사를 시작한다.

Audit Record 조회

감사 조건에 부합할 경우 audit record를 생성하는데 다음과 같이 DICTIONARY_SCHEMA.AUDIT_TRAIL view를 통해 조회할 수 있다.

SELECT logon_user
     , event_timestamp
     , action_name
     , object_name 
     , sql_text
  FROM audit_trail
 WHERE policy_name = 'P1'
;

일반 사용자가 AUDIT_TRAIL을 조회하려면 SELECT 권한을 부여받아야 한다.

GRANT SELECT ON DICTIONARY_SCHEMA.AUDTI_TRAIL TO user_name;

Audit Policy 정보 조회

Audit policy 객체 정보는 DICTIONARY_SCHEMA.AUDIT_POLICY_OPTIONS view를 통해 조회할 수 있다.

SELECT policy_name
     , audit_option
     , object_schema
     , object_name
  FROM audit_policy_options
;

Audit policy 객체들의 활성화 정보는 DICTIONARY_SCHEMA.AUDIT_POLICY_ENABLED view를 통해 조회할 수 있다.

SELECT policy_name
     , enabled_opt
     , user_name
     , when_success
     , when_failure
  FROM audit_policy_enabled
;

BY 절과 EXCEPT 절 사용 시 유의사항

동일한 audit policy에 대해 다수의 AUDIT POLICY BY 절을 사용할 경우, user들의 집합을 활성화한다.
즉, 다음 두 예는 동일한 의미이다.

• 예제 1: u1, u2에 대해 p1 audit policy를 활성화한다.

AUDIT POLICY p1 BY u1;
AUDIT POLICY p1 BY u2;

• 예제 2: u1, u2에 대해 p1 audit policy를 활성화한다.

AUDIT POLICY p1 BY u1, u2;

동일한 audit policy에 대해 다수의 AUDIT POLICY EXCEPT 절을 사용할 경우, 마지막 AUDIT POLICY 구문만 유효하다.
즉, 다음 두 예는 다른 의미이다.

• 예제 1: 마지막 구문만 유효하며 u2를 배제하고 p1 audit policy를 활성화한다.

AUDIT POLICY p1 EXCEPT u1;
AUDIT POLICY p1 EXCEPT u2;

• 예제 2: u1과 u2를 배제하고 p1 audit policy를 활성화한다.

AUDIT POLICY p1 EXCEPT u1, u2;

같은 audit policy에 대해 BY와 EXCEPT를 함께 사용할 수 없다.

• BY 절로 audit policy가 활성화된 경우 이후에 BY 절만 사용할 수 있다.

AUDIT POLICY p1 BY u1;

• N/A

  • Error

AUDIT POLICY p1 EXCEPT u2;

• EXCEPT 절로 audit policy가 활성화 된 경우 이후에 EXCEPT 절만 사용할 수 있다.

AUDIT POLICY p1 EXCEPT u1;

• N/A

  • Error: by all users에 해당한다.

AUDIT POLICY p1;

BY로 활성화된 audit policy를 EXCEPT로 전환하거나 EXCEPT로 활성화된 audit policy를 BY로 전환하려면 먼저 활성화된 audit policy를 비활성화 한 후에 전환해야 한다.

다음 예와 같이 NOAUDIT POLICY 구문으로 비활성화한다.

• AUDIT POLICY p1 BY u1, u2;

  • NOAUDIT POLICY p1 BY u1, u2;

• AUDIT POLICY p1;

  • NOAUDIT POLICY p1;

• AUDIT POLICY p1 EXCEPT u1, u2;

  • NOAUDIT POLICY p1;

  • NOAUDIT POLICY 구문에는 EXCEPT option이 없다.

BY 절과 함께 사용하는 WHENEVER 절은 누적된다.

다음 두 예는 동일한 의미이다.

• 예제 1: 성공/ 실패와 관계없이 audit record를 생성한다.

AUDIT POLICY p1 BY u1 WHENEVER SUCCESSFUL;
AUDIT POLICY p1 BY u1 WHENEVER NOT SUCCESSFUL;

• 예제 2: 성공/ 실패와 관계없이 audit record를 생성한다.

AUDIT POLICY p1 BY u1;

WHENEVER 절이 EXCEPT 절과 함께 사용되면 마지막 WHENEVER 절만 유효하다.

다음 두 예는 서로 다른 의미이다.

• 예제 1: 실패할 경우 audit record를 생성한다.

AUDIT POLICY p1 EXCEPT u1 WHENEVER SUCCESSFUL;
AUDIT POLICY p1 EXCEPT u1 WHENEVER NOT SUCCESSFUL;

• 예제 2: 성공/ 실패와 관계없이 audit record를 생성한다.

AUDIT POLICY p1 EXCEPT u1;

사용 예

다음은 모든 사용자에 대해 audit policy를 활성화하는 예이다.

AUDIT POLICY table_pol;

다음 질의를 통해 활성화 정보를 확인할 수 있다.

SELECT policy_name
     , enabled_opt
     , user_name
  FROM audit_policy_enabled
 WHERE policy_name = 'TABLE_POL';

POLICY_NAME  ENABLED_OPT  USER_NAME
-----------  -----------  ---------
TABLE_POL    BY           ALL USERS

다음은 특정 사용자들을 한정하여 audit policy를 활성화하는 예이다.

AUDIT POLICY dml_pol BY u1, u2;

다음은 특정 사용자를 배제하여 audit policy를 활성화하는 예이다.

AUDIT POLICY read_seq_pol EXCEPT sys;

다음은 특정 사용자가 SQL 구문에 실패한 경우를 감사하는 예이다.

AUDIT POLICY delete_pol BY u1 WHENEVER NOT SUCCESSFUL;

호환성

SQL 표준에는 audit policy가 없다.

참조

관련 내용은 다음을 참조한다.

• Audit policy 객체 관리

  • CREATE AUDIT POLICY

  • DROP AUDIT POLICY

  • ALTER AUDIT POLICY

• Audit policy 활성화/ 비활성화

  • AUDIT POLICY

  • NOAUDIT POLICY

• Audit trail 조회: AUDIT_TRAIL

• Audit trail 제거: ALTER DATABASE CLEAR AUDIT TRAIL

CLOSE cursor_name

기능

커서를 닫는다.

구문

<close statement> ::=
    CLOSE cursor_name
    ;

구문 규칙 및 파라미터

cursor_name

커서가 open 되어 있어야 한다.
세션 내에서 DECLARE cursor_name 구문으로 선언된 커서이어야 한다.

설명

Cursor는 session 내에 존재하는 객체이고 서로 다른 session의 cursor에 영향을 주지 않는다.

사용 예

다음은 interactive SQL tool (gsql)을 사용하여 커서를 DECLARE, OPEN, FETCH, CLOSE 하는 예이다.

gSQL> DECLARE cur1 CURSOR FOR SELECT id, data FROM t1;

Cursor declared.

gSQL> OPEN cur1;

Cursor is open.

gSQL> \var v_id   INTEGER
gSQL> \var v_data VARCHAR(128)

gSQL> FETCH cur1 INTO :v_id, :v_data;

V_ID V_DATA
---- ------
   1 data_1

1 row fetched.


gSQL> FETCH cur1 INTO :v_id, :v_data;

V_ID V_DATA
---- ------
   2 data_2

1 row fetched.

gSQL> FETCH cur1 INTO :v_id, :v_data;

no rows fetched.

gSQL> CLOSE cur1;

Cursor closed.

호환성

참조

관련 내용은 다음을 참조한다.

• DECLARE cursor_name

• OPEN cursor_name

• FETCH cursor_name

COMMENT ON name IS

기능

객체에 대한 설명을 dictionary에 저장한다.

구문

<comment statement> ::=
    COMMENT ON <comment object> IS 'comment string'
    ;

<comment object> ::=
      CLUSTER GROUP group_name
    | CLUSTER MEMBER member_name
    | DATABASE
    | PROFILE profile_name
    | AUDIT POLICY policy_name
    | AUTHORIZATION user_name
    | TABLESPACE tablespace_name
    | SCHEMA schema_name
    | TABLE [schema_name].table_name
    | COLUMN [schema_name].table_name.column_name
    | INDEX [schema_name].index_name
    | SEQUENCE [schema_name].sequence_name
    | CONSTRAINT [schema_name].constraint_name
    | PROCEDURE [schema_name].procedure_name

사용 범위 및 접근 권한

<comment statement> 구문을 수행하려면 각 객체에 대하여 다음과 같이 권한을 변경해야 한다.

• CLUSTER GROUP

  • ALTER SYSTEM ON DATABASE

• CLUSTER MEMBER

  • ALTER SYSTEM ON DATABASE

• DATABASE

  • ALTER DATABASE ON DATABASE

• PROFILE

  • ALTER PROFILE ON DATABASE

• AUDIT POLICY

  • AUDIT SYSTEM ON DATABASE

• AUTHORIZATION (user)

  • ALTER USER ON DATABASE

• AUTHORIZATION (role)

  • ALTER ROLE ON DATABASE

• TABLESPACE

  • ALTER TABLESPACE ON DATABASE

• SCHEMA: 다음 권한 중 하나가 있어야 한다.

  • 스키마의 소유자

  • 스키마에 대해 CONTROL SCHEMA ON SCHEMA

  • ALTER SCHEMA ON DATABASE

• TABLE: 다음 권한 중 하나가 있어야 한다.

  • 테이블의 소유자

  • 테이블에 대해 CONTROL TABLE ON TABLE

  • 테이블이 속한 스키마에 대해 CONTROL SCHEMA ON SCHEMA

  • ALTER ANY TABLE ON DATABASE

• COLUMN: 다음 권한 중 하나가 있어야 한다.

  • Column이 속한 테이블의 소유자

  • Column이 속한 테이블에 대해 CONTROL TABLE ON TABLE

  • Column이 속한 테이블의 스키마에 대해 CONTROL SCHEMA ON SCHEMA

  • ALTER ANY TABLE ON DATABASE

• INDEX: 다음 권한 중 하나가 있어야 한다.

  • 인덱스의 소유자

  • 인덱스가 속한 스키마에 대해 CONTROL SCHEMA ON SCHEMA

  • ALTER ANY INDEX ON DATABASE

• SEQUENCE

  • 시퀀스의 소유자

  • 시퀀스가 속한 스키마에 대해 CONTROL SCHEMA ON SCHEMA

  • ALTER ANY SEQUENCE ON DATABASE

• CONSTRAINT

  • 제약 조건의 소유자

  • 제약 조건이 속한 스키마에 대해 CONTROL SCHEMA ON SCHEMA

  • ALTER ANY TABLE ON DATABASE

• PROCEDURE

  • Stored procedure/ function의 소유자

  • Stored procedure/ function이 속한 스키마에 대해 CONTROL SCHEMA ON SCHEMA

  • ALTER ANY PROCEDURE ON DATABASE

구문 규칙 및 파라미터

<comment object>

설명을 저장할 대상 객체로써 다음과 같은 database 객체에 대한 comment를 저장할 수 있다.

• Cluster object

  • CLUSTER GROUP

  • CLUSTER MEMBER

• Non-schema object

  • DATABASE

  • PROFILE

  • AUDIT POLICY

  • AUTHORIZATION (User or Role)

  • TABLESPACE

  • SCHEMA

• Schema object

  • TABLE 또는 VIEW

  • COLUMN

  • INDEX

  • SEQUENCE

  • CONSTRAINT

  • PROCEDURE 또는 FUNCTION

Schema object의 경우 schema_name을 기술하지 않으면 구문을 수행하는 사용자의 Schema Path에 의해 스키마 이름이 결정된다.

COMMENT ON TABLE test_table IS 'test comment'; 
→ COMMENT ON TABLE user_default_schema.test_table IS 'test comment';

'comment string'

저장할 comment 문장을 기술한다.
Comment를 삭제하려면 다음과 같이 empty string ('')을 사용한다.

COMMENT ON TABLE test_table IS '';

Comment string의 길이는 1024 bytes를 초과할 수 없다.

설명

다음 dictionary view의 COMMENTS column으로부터 객체 유형별 정보를 확인할 수 있다.

• Cluster objects

  • CLUSTER GROUP & CLUSTER MEMBER

    • DICTIONARY_SCHEMA.DBA_CLUSTER_COMMENTS view

• Non-schema objects

  • DATABASE

    • DICTIONARY_SCHEMA.ALL_NONSCHEMA_COMMENTS view

    • DICTIONARY_SCHEMA.DBA_NONSCHEMA_COMMENTS view

  • PROFILE

    • DICTIONARY_SCHEMA.DBA_NONSCHEMA_COMMENTS view

  • AUDIT POLICY

    • DICTIONARY_SCHEMA.AUDIT_POLICIES view

  • USER

    • DICTIONARY_SCHEMA.ALL_NONSCHEMA_COMMENTS view

    • DICTIONARY_SCHEMA.DBA_NONSCHEMA_COMMENTS view

  • TABLESPACE

    • DICTIONARY_SCHEMA.ALL_NONSCHEMA_COMMENTS view

    • DICTIONARY_SCHEMA.DBA_NONSCHEMA_COMMENTS view

  • SCHEMA

    • DICTIONARY_SCHEMA.ALL_NONSCHEMA_COMMENTS view

    • DICTIONARY_SCHEMA.DBA_NONSCHEMA_COMMENTS view

• SQL schema objects

  • TABLE

    • DICTIONARY_SCHEMA.USER_TAB_COMMENTS view

    • DICTIONARY_SCHEMA.ALL_TAB_COMMENTS view

    • DICTIONARY_SCHEMA.DBA_TAB_COMMENTS view

  • VIEW

    • DICTIONARY_SCHEMA.USER_TAB_COMMENTS view

    • DICTIONARY_SCHEMA.ALL_TAB_COMMENTS view

    • DICTIONARY_SCHEMA.DBA_TAB_COMMENTS view

  • COLUMN

    • DICTIONARY_SCHEMA.USER_COL_COMMENTS view

    • DICTIONARY_SCHEMA.ALL_COL_COMMENTS view

    • DICTIONARY_SCHEMA.DBA_COL_COMMENTS view

  • INDEX

    • DICTIONARY_SCHEMA.USER_INDEXES view

    • DICTIONARY_SCHEMA.ALL_INDEXES view

    • DICTIONARY_SCHEMA.DBA_INDEXES view

  • SEQUENCE

    • DICTIONARY_SCHEMA.USER_SEQUENCES view

    • DICTIONARY_SCHEMA.ALL_SEQUENCES view

    • DICTIONARY_SCHEMA.DBA_SEQUENCES view

  • CONSTRAINT

    • DICTIONARY_SCHEMA.USER_CONSTRAINTS view

    • DICTIONARY_SCHEMA.ALL_CONSTRAINTS view

    • DICTIONARY_SCHEMA.DBA_CONSTRAINTS view

  • PROCEDURE & FUNCTION

    • DICTIONARY_SCHEMA.USER_PROCEDURES view

    • DICTIONARY_SCHEMA.ALL_PROCEDURES view

    • DICTIONARY_SCHEMA.DBA_PROCEDURES view