RDS for Db2용 데이터베이스에 대해 저장된 프로시저

다음 저장 프로시저는 Amazon RDS for Db2의 데이터베이스를 관리합니다. 이 프로시저를 실행하려면 마스터 사용자가 먼저 rdsadmin 데이터베이스에 연결되어야 합니다.

rdsadmin.create_database

데이터베이스를 생성합니다.

구문

db2 "call rdsadmin.create_database('database_name')"

파라미터

다음 파라미터는 필수입니다.

다음 파라미터는 선택적입니다.

사용 노트

Amazon RDS 콘솔 또는 AWS CLI를 사용하여 RDS for Db2 DB 인스턴스를 만들 때 데이터베이스 이름을 지정하지 않은 경우 rdsadmin.create_database를 호출하여 데이터베이스를 만들 수 있습니다 자세한 내용은 DB 인스턴스 생성 단원을 참조하십시오.

특별 고려 사항:

이러한 고려 사항에 대한 자세한 내용은 IBM Db2 설명서의 CREATE DATABASE 명령을 참조하세요.

rdsadmin.create_database를 호출하기 전에 rdsadmin 데이터베이스에 연결해야 합니다. 다음 예제에서 master_username 및 master_password를 RDS for Db2 DB 인스턴스의 정보로 대체합니다.

db2 connect to rdsadmin user master_username using master_password

데이터베이스 생성 상태 점검에 대한 자세한 내용은 rdsadmin.get_task_status 섹션을 참조하세요.

예시

다음 예제에서는 일본에 대한 database_code_set, database_territory, database_collation 파라미터의 올바른 조합을 사용하여 TESTJP라는 데이터베이스를 생성합니다.

db2 "call rdsadmin.create_database('TESTJP', 4096, 'IBM-437', 'JP', 'SYSTEM')"

rdsadmin.drop_database

데이터베이스를 삭제합니다.

구문

db2 "call rdsadmin.drop_database('database_name')"

파라미터

다음 파라미터는 필수입니다.

사용 노트

다음 조건이 충족되면 rdsadmin.drop_database만 직접 호출하여 데이터베이스를 삭제할 수 있습니다.

rdsadmin.drop_database를 호출하기 전에 rdsadmin 데이터베이스에 연결해야 합니다. 다음 예제에서 master_username 및 master_password를 RDS for Db2 DB 인스턴스의 정보로 대체합니다.

db2 connect to rdsadmin user master_username using master_password

데이터베이스 삭제 상태 점검에 대한 자세한 내용은 rdsadmin.get_task_status 섹션을 참조하세요.

저장 프로시저를 호출할 때 반환되는 오류 메시지는 저장된 프로시저의 오류 해결 섹션을 참조하세요.

예시

다음 예제에서는 TESTDB라는 데이터베이스를 삭제합니다.

db2 "call rdsadmin.drop_database('TESTDB')"

rdsadmin.update_db_param

데이터베이스 파라미터를 업데이트합니다.

구문

db2 "call rdsadmin.update_db_param(
    'database_name', 
    'parameter_to_modify', 
    'changed_value)"

파라미터

다음 파라미터는 필수 파라미터입니다.

사용 노트

데이터베이스 파라미터 업데이트 상태 점검에 대한 자세한 내용은 rdsadmin.get_task_status 섹션을 참조하세요.

저장 프로시저를 호출할 때 반환되는 오류 메시지는 저장된 프로시저의 오류 해결 섹션을 참조하세요.

예시

다음 예제에서는 TESTDB라는 데이터베이스의 archretrydelay 파라미터를 100으로 업데이트합니다.

db2 "call rdsadmin.update_db_param(
    'TESTDB', 
    'archretrydelay', 
    '100')"

다음 예제에서는 종속성 검사를 피하기 위해 TESTDB라는 데이터베이스에서 생성된 객체의 검증을 연기합니다.

db2 "call rdsadmin.update_db_param(
    'TESTDB', 
    'auto_reval', 
    'deferred_force')"

rdsadmin.set_configuration

데이터베이스의 특정 설정을 구성합니다.

구문

db2 "call rdsadmin.set_configuration(
    'name',  
    'value')"

파라미터

다음 파라미터는 필수 파라미터입니다.

사용 노트

다음 테이블에는 rdsadmin.set_configuration으로 제어할 수 있는 구성 설정이 나와 있습니다.

예시

다음 예제에서는 RESTORE_DATABASE_PARALLELISM 구성을 8로 설정합니다.

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_PARALLELISM', 
    '8')"

다음 예제에서는 RESTORE_DATABASE_NUM_BUFFERS 구성을 150으로 설정합니다.

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_NUM_BUFFERS', 
    '150')"

rdsadmin.show_configuration

저장 프로시저 rdsadmin.set_configuration을 사용하여 설정할 수 있는 현재 설정을 반환합니다.

구문

db2 "call rdsadmin.show_configuration(
    'name')"

파라미터

다음 파라미터는 선택 사항입니다.

사용 노트

구성 설정의 이름을 지정하지 않으면 rdsadmin.show_configuration이 저장 프로시저 rdsadmin.set_configuration을 사용하여 설정할 수 있는 모든 구성 설정에 대한 정보를 반환합니다.

예시

다음 예제는 현재 RESTORE_DATABASE_PARALLELISM 구성에 관한 정보를 반환합니다.

db2 "call rdsadmin.show_configuration(
    'RESTORE_DATABASE_PARALLELISM')"

rdsadmin.restore_database

데이터베이스를 복원합니다.

구문

db2 "call rdsadmin.restore_database(
    ?,
    'database_name', 
    's3_bucket_name', 
    's3_prefix', 
    restore_timestamp, 
    'backup_type')"

파라미터

다음 출력 파라미터는 필수입니다.

다음 입력 파라미터는 필수입니다.

사용 노트

저장된 프로시저를 직접적으로 호출하기 전에 다음 고려 사항을 검토하세요.

데이터베이스를 복원한 후 데이터베이스를 온라인 상태로 전환하고 추가 트랜잭션 로그를 적용하려면 rdsadmin.rollforward_database 섹션을 참조하세요.

데이터베이스 복원 상태 점검에 대한 자세한 내용은 rdsadmin.get_task_status 섹션을 참조하세요.

저장 프로시저를 호출할 때 반환되는 오류 메시지는 저장된 프로시저의 오류 해결 섹션을 참조하세요.

예시

다음 예제에서는 s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101이 있는 단일 파일 또는 여러 파일을 사용하여 오프라인 백업을 복원합니다.

db2 "call rdsadmin.restore_database(
    ?,
    'SAMPLE',
    'amzn-s3-demo-bucket',
    'backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101',
    20230615010101,
    'OFFLINE')"

rdsadmin.rollforward_database

rdsadmin.restore_database를 호출하여 데이터베이스를 복원한 후 데이터베이스를 온라인 상태로 만들고 추가 트랜잭션 로그를 적용합니다.

구문

db2 "call rdsadmin.rollforward_database(
    ?,
    'database_name',
    's3_bucket_name', 
    s3_prefix, 
    'rollfoward_to_option', 
    'complete_rollforward')"

파라미터

다음 출력 파라미터는 필수입니다.

다음 입력 파라미터는 필수입니다.

입력 다음 파라미터는 선택적입니다.

사용 노트

rdsadmin.restore_database를 호출한 후에는 rollforward_database를 호출하여 S3 버킷의 아카이브 로그를 적용해야 합니다. 이 저장 프로시저를 사용하여 rdsadmin.restore_database 호출 후 추가 트랜잭션 로그를 복원할 수도 있습니다.

complete_rollforward를 FALSE로 설정하면 데이터베이스가 ROLL-FORWARD PENDING 상태이고 오프라인 상태입니다. 데이터베이스를 온라인 상태로 만들려면 rdsadmin.complete_rollforward를 직접 호출해야 합니다.

데이터베이스의 롤포워드 상태 점검에 대한 자세한 내용은 rdsadmin.get_task_status 섹션을 참조하세요.

예시

다음 예제에서는 트랜잭션 로그가 있는 데이터베이스의 온라인 백업으로 롤포워드한 다음 데이터베이스를 온라인 상태로 만듭니다.

db2 "call rdsadmin.rollforward_database(
    ?,
    null,
    null,
    'END_OF_LOGS',
    'TRUE')"

다음 예제에서는 트랜잭션 로그가 없는 데이터베이스의 온라인 백업으로 롤포워드한 다음 데이터베이스를 온라인 상태로 만듭니다.

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'amzn-s3-demo-bucket',
    'logsfolder/,
    'END_OF_BACKUP',
    'TRUE')"

다음 예제에서는 트랜잭션 로그가 있는 데이터베이스의 온라인 백업으로 롤포워드한 다음 데이터베이스를 온라인 상태로 만들지 않습니다.

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    null,
    'onlinebackup/TESTDB',
    'END_OF_LOGS',
    'FALSE')"

다음 예제에서는 추가 트랜잭션 로그가 있는 데이터베이스의 온라인 백업으로 롤포워드한 다음 데이터베이스를 온라인 상태로 만들지 않습니다.

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'amzn-s3-demo-bucket',
    'logsfolder/S0000155.LOG',
    'END_OF_LOGS',
    'FALSE')"

rdsadmin.complete_rollforward

데이터베이스를 ROLL-FORWARD PENDING 상태에서 온라인 상태로 만듭니다.

구문

db2 "call rdsadmin.complete_rollforward(
    ?,
    'database_name')"

파라미터

다음 출력 파라미터는 필수입니다.

다음 입력 파라미터는 필수입니다.

사용 노트

complete_rollforward가 FALSE로 설정된 상태로 rdsadmin.rollforward_database를 호출한 경우 데이터베이스는 ROLL-FORWARD PENDING 상태이며 오프라인 상태입니다. 롤포워드 프로세스를 완료하고 데이터베이스를 온라인 상태로 전환하려면 rdsadmin.complete_rollforward를 호출하세요.

롤포워드 프로세스 완료 상태 점검에 대한 자세한 내용은 rdsadmin.get_task_status 섹션을 참조하세요.

예시

다음 예제에서는 TESTDB 데이터베이스를 온라인 상태로 전환합니다.

db2 "call rdsadmin.complete_rollfoward(
    ?,
    'TESTDB')"

rdsadmin.db2pd_command

RDS for Db2 데이터베이스 정보를 수집합니다.

구문

db2 "call rdsadmin.db2pd_command('db2pd_cmd')"

파라미터

다음 입력 파라미터는 필수입니다.

사용 노트

이 저장 프로시저는 RDS for Db2 데이터베이스를 모니터링하고 문제를 해결하는 데 도움이 되는 정보를 수집합니다.

저장 프로시저는 IBM db2pd 유틸리티를 사용하여 다양한 명령을 실행합니다. db2pd 유틸리티를 사용하려면 RDS for Db2 마스터 사용자에게는 없는 SYSADM 인증이 필요합니다. 하지만 Amazon RDS 저장 프로시저를 사용하면 마스터 사용자가 유틸리티를 사용하여 다양한 명령을 실행할 수 있습니다. 유틸리티에 대한 자세한 내용은 IBM Db2 설명서의 db2pd - Db2 데이터베이스 명령 모니터링 및 문제 해결을 참조하세요.

출력은 최대 2GB로 제한됩니다.

데이터베이스의 정보 수집 상태 점검에 대해 알아보려면 rdsadmin.get_task_status 섹션을 참조하세요.

예시

다음 예제는 RDS for Db2 DB 인스턴스의 가동 시간을 반환합니다.

db2 "call rdsadmin.db2pd_command('-')"

다음 예제는 TESTDB라는 데이터베이스의 가동 시간을 반환합니다.

db2 "call rdsadmin.db2pd_command('-db TESTDB -')"

다음 예제는 RDS for Db2 DB 인스턴스의 메모리 사용량을 반환합니다.

db2 "call rdsadmin.db2pd_command('-dbptnmem')"

다음 예제는 RDS for Db2 DB 인스턴스 및 TESTDB라는 데이터베이스의 메모리 집합을 반환합니다.

db2 "call rdsadmin.db2pd_command('-inst -db TESTDB -memsets')"

rdsadmin.force_application

RDS for Db2 데이터베이스의 애플리케이션을 강제 종료합니다.

구문

db2 "call rdsadmin.force_application(
    ?,
    'applications')"

파라미터

다음 출력 파라미터는 필수입니다.

다음 입력 파라미터는 필수입니다.

사용 노트

이 저장 프로시저는 데이터베이스에서 모든 애플리케이션을 강제로 종료하므로 유지 관리를 수행할 수 있습니다.

저장 프로시저는 IBM FORCE APPLICATION 명령을 사용합니다. FORCE APPLICATION 명령을 사용하려면 RDS for Db2 마스터 사용자에게는 없는 SYSADM, SYSMAINT, SYSCTRL 인증이 필요합니다. 하지만 Amazon RDS 저장 프로시저를 사용하면 마스터 사용자가 명령을 사용할 수 있습니다. 자세한 내용은 IBM Db2 설명서의 FORCE APPLICATION 명령을 참조하세요.

데이터베이스의 애플리케이션 종료 상태 점검에 대한 자세한 내용은 rdsadmin.get_task_status 섹션을 참조하세요.

예시

다음 예제에서는 RDS for Db2 데이터베이스의 모든 애플리케이션을 강제 종료합니다.

db2 "call rdsadmin.force_application(
    ?,
    'ALL')"

다음 예제에서는 RDS for Db2 데이터베이스의 9991, 8891, 1192 애플리케이션 핸들을 강제 종료합니다.

db2 "call rdsadmin.force_application(
    ?,
    '9991, 8891, 1192')"

rdsadmin.set_archive_log_retention

일부 RDS for Db2 데이터베이스의 아카이브 로그 파일을 보관하는 시간(시간 기준)을 구성합니다.

구문

db2 "call rdsadmin.set_archive_log_retention(
    ?,            
    'database_name',  
    'archive_log_retention_hours')"

파라미터

다음 출력 파라미터는 필수입니다.

다음 입력 파라미터는 필수입니다.

사용 노트

기본적으로 RDS for Db2는 로그를 5분 동안 보존합니다. 변경 데이터 캡처(CDC) 또는 IBM Q Replication에 AWS DMS 등의 복제 도구를 사용하는 경우 도구에 로그 보존을 5분 이상으로 설정하는 것이 좋습니다.

rdsadmin.show_archive_log_retention을 직접적으로 호출하여 현재 아카이브 로그 보존 설정을 볼 수 있습니다.

rdsadmin 데이터베이스에서는 아카이브 로그 보존 설정을 구성할 수 없습니다.

예시

다음 예제에서는 TESTDB라는 데이터베이스의 아카이브 로그 보존 시간을 24시간으로 설정합니다.

db2 "call rdsadmin.set_archive_log_retention(
    ?,
    'TESTDB', 
    '24')"

다음 예제에서는 TESTDB라는 데이터베이스의 아카이브 로그 보존을 비활성화합니다.

db2 "call rdsadmin.set_archive_log_retention(
    ?,
    'TESTDB', 
    '0')"

rdsadmin.show_archive_log_retention

일부 데이터베이스의 현재 아카이브 로그 보존 설정을 반환합니다.

구문

db2 "call rdsadmin.show_archive_log_retention(
    ?,
    'database_name')"

파라미터

다음 출력 파라미터는 필수입니다.

다음 입력 파라미터는 필수입니다.

예시

다음 예제에서는 TESTDB라는 데이터베이스의 아카이브 로그 보존 설정을 보여줍니다.

db2 "call rdsadmin.show_archive_log_retention(
    ?
    'TESTDB')"