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

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

이러한 저장 프로시저는 다양한 작업에 사용됩니다. 단, 이 목록이 전부는 아닙니다.

구문, 파라미터, 사용 정보 및 예시에 대한 자세한 내용은 다음 기본 제공 저장 프로시저를 참조하세요.

rdsadmin.create_database

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

구문

db2 "call rdsadmin.create_database(
    'database_name',
    'database_page_size',
    'database_code_set',
    'database_territory',
    'database_collation',
    'database_autoconfigure_str',
    'database_non-restrictive')"

파라미터

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

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

사용 노트

db2_compatibility_vector 파라미터를 수정하려는 경우 데이터베이스를 만들기 전에 파라미터를 수정합니다. 자세한 내용은 db2_compatibility_vector 파라미터 설정 섹션을 참조하세요.

특별 고려 사항:

이러한 고려 사항에 대한 자세한 내용은 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 섹션을 참조하세요.

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

예시

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

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

rdsadmin.deactivate_database

데이터베이스를 비활성화합니다.

구문

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

파라미터

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

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

사용 노트

데이터베이스를 비활성화하여 메모리 리소스를 절약하거나 다른 데이터베이스 구성을 변경할 수 있습니다. 비활성화된 데이터베이스를 다시 온라인 상태로 전환하려면 rdsadmin.activate_database 저장 프로시저를 직접적으로 호출합니다.

복제 중에 rdsadmin.deactivate_database 저장 프로시저를 직접적으로 호출하여 소스 DB 인스턴스에서 데이터베이스를 비활성화할 수 없습니다.

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

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

예시

다음 예시에서는 TESTDB라는 데이터베이스를 비활성화합니다.

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

rdsadmin.activate_database

데이터베이스를 활성화합니다.

rdsadmin.reactivate_database와 rdsadmin.activate_database의 차이에 대한 자세한 내용은 사용 노트 섹션을 참조하세요.

구문

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

파라미터

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

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

사용 노트

모든 데이터베이스는 만들어질 때 기본적으로 활성화됩니다. 독립형 DB 인스턴스에서 데이터베이스를 비활성화하여 메모리 리소스를 절약하거나, 다른 데이터베이스 구성을 변경하려는 경우 rdsadmin.activate_database 저장 프로시저를 직접적으로 호출하여 데이터베이스를 다시 활성화합니다.

이 저장 프로시저는 독립형 DB 인스턴스에 있고 rdsadmin.deactivate_database 저장 프로시저를 직접적으로 호출하여 비활성화된 데이터베이스만 활성화합니다. 복제본 소스 DB 인스턴스에서 데이터베이스를 활성화하려면 rdsadmin.reactivate_database 저장 프로시저를 직접적으로 호출해야 합니다.

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

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

예시

다음 예시에서는 TESTDB라는 데이터베이스를 활성화합니다.

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

rdsadmin.reactivate_database

데이터베이스를 재활성화합니다.

rdsadmin.activate_database와 rdsadmin.reactivate_database의 차이에 대한 자세한 내용은 사용 노트 섹션을 참조하세요.

구문

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

파라미터

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

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

사용 노트

rdsadmin.reactivate_database 저장 프로시저를 직접적으로 호출하면 저장 프로시저가 먼저 rdsadmin.deactivate_database 저장 프로시저를 직접적으로 호출하여 데이터베이스를 비활성화한 다음 rdsadmin.activate_database 저장 프로시저를 직접적으로 호출하여 데이터베이스를 활성화합니다.

데이터베이스 구성을 변경한 후 RDS for Db2 DB 인스턴스에서 데이터베이스를 재활성화해야 할 수 있습니다. 데이터베이스를 재활성화해야 하는지 확인하려면 데이터베이스에 연결하고 db2 get db cfg show detail을 실행합니다.

독립형 DB 인스턴스에 있는 데이터베이스의 경우 rdsadmin.reactivate_database 저장 프로시저를 사용하여 데이터베이스를 재활성화할 수 있습니다. 또는 rdsadmin.deactivate_database 저장 프로시저를 이미 직접적으로 호출한 경우 rdsadmin.activate_database 저장 프로시저를 대신 호출할 수 있습니다.

복제본 소스 DB 인스턴스에 있는 데이터베이스의 경우 rdsadmin.reactivate_database 저장 프로시저를 사용하여 데이터베이스를 재활성화해야 합니다.

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

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

예시

다음 예시에서는 TESTDB라는 데이터베이스를 재활성화합니다.

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

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 섹션을 참조하세요.

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

예시

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

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

rdsadmin.update_db_param

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

구문

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

파라미터

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

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

사용 노트

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

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

예시

예시 1: 파라미터 업데이트

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

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

예시 2: 객체 검증 연기

다음 예제에서는 종속성 검사를 피하기 위해 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으로 제어할 수 있는 구성 설정이 나와 있습니다.

예시

예시 1: 만들 버퍼 수 지정

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

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

예시 2: 만들 버퍼 조작기 수 지정

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

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

예제 3: 복원 중에 사용할 경로 또는 I/O 스트림 수 지정

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

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_NUM_MULTI_PATHS', 
    '5')"

예제 4: 백업 데이터를 스트리밍하도록 복원 설정

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

db2 "call rdsadmin.set_configuration(
    'USE_STREAMING_RESTORE', 
    'TRUE')"

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.backup_database

RDS for Db2 DB 인스턴스에서 Amazon S3 버킷으로 데이터베이스를 백업합니다.

구문

db2 "call rdsadmin.backup_database(
    ?,
    'database_name', 
    's3_bucket_name', 
    's3_prefix', 
    'backup_type',
    'compression_option',
    'util_impact_priority', 
    'num_files',
    'parallelism',
    'num_buffers')"

파라미터

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

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

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

사용 노트

이 저장 프로시저는 Amazon S3 통합을 사용하여 데이터베이스 백업을 Amazon S3 버킷으로 직접 스트리밍하는 비동기 백업 작업을 생성합니다. 로컬 서버나 RDS for Db2 DB 인스턴스에서 백업을 만들고, 이를 Amazon S3로 스트리밍한 다음 원하는 곳 어디에서나 복원할 수 있습니다. RDS for Db2 DB 인스턴스로 데이터베이스를 복원하는 것에 대한 자세한 내용은 rdsadmin.restore_database 섹션을 참조하세요.

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

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

db2 connect to rdsadmin user master_username using master_password

데이터베이스를 백업한 후 연결을 종료해야 합니다.

terminate

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

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

예시

모든 예제는 MYDB라는 데이터베이스를 amzn-s3-demo-bucket이라는 Amazon S3 버킷에 백업하고 s3_prefix를 backups/daily로 설정합니다.

예제 #1: 사용률 중앙값과 단일 업로드 스트림으로 데이터베이스를 오프라인으로 지정하고 사용할 수 없음

다음 예제에서는 데이터베이스가 오프라인 상태이므로 더 빠르지만 백업 중에 데이터베이스를 사용할 수 없습니다. 이 예제에서는 파일 압축을 수행하지 않고, 시스템 리소스에 중간 영향을 미치며, Amazon S3에 대한 단일 업로드 스트림을 사용합니다.

db2 call "rdsadmin.backup_database(
    ?, 
    'MYDB',
    'amzn-s3-demo-bucket', 
    'backups/daily',
    'OFFLINE',
    'NONE', 
    50, 
    1)"

예제 #2: 향상된 압축, 중간 사용률 및 소수의 병렬 업로드 스트림으로 온라인 및 사용 가능한 데이터베이스 지정

다음 예제에서 데이터베이스는 온라인 상태이며 백업 중에 사용할 수 있습니다. 이 예제에서는 향상된 압축을 수행하므로 파일 크기가 작지만 CPU 집약적입니다. 시스템 리소스에 미치는 영향의 중앙값보다 약간 높으며, Amazon S3에 5개의 업로드 스트림을 사용합니다.

db2 call "rdsadmin.backup_database(
    ?, 
    'MYDB',
    'amzn-s3-demo-bucket', 
    'backups/daily',
    'ONLINE',
    'ZLIB', 
    60, 
    5)"

예제 #3: 데이터베이스를 오프라인으로 지정하고 기본값 및 시스템 계산에서 사용할 수 없음

다음 예제에서는 데이터베이스가 오프라인 상태이므로 더 빠르지만 백업 중에 데이터베이스를 사용할 수 없습니다. 이 예제에서는 파일의 기본 압축을 사용하고 시스템 리소스에 영향을 미칩니다. 또한 RDS for Db2는 Amazon S3에 대한 병렬 업로드 스트림 수, 병렬로 읽을 테이블스페이스 및 사용할 버퍼를 계산할 수 있습니다.

db2 "call rdsadmin.backup_database(
    ?, 
    'MYDB', 
    'amzn-s3-demo-bucket',
    'backups/daily', 
    'OFFLINE')"

예제 #4: 압축 없이 데이터베이스를 오프라인으로 지정하고 사용할 수 없음, 높은 사용률 및 사용자 지정 계산

다음 예제에서는 데이터베이스가 오프라인 상태이므로 더 빠르지만 백업 중에 데이터베이스를 사용할 수 없습니다. 이 예제에서는 파일 압축을 수행하지 않고, 시스템 리소스에 큰 영향을 미치며, Amazon S3에 20개의 업로드 스트림을 사용합니다. 병렬로 읽을 최대 테이블스페이스 수를 설정하므로 처리 능력이 충분하지 않으면 백업 요청이 실패할 수 있습니다. 또한 사용할 최대 버퍼 수를 설정하여 메모리가 부족할 경우 백업 요청이 실패할 수 있습니다.

db2 "call rdsadmin.backup_database(
    ?, 
    'MYDB', 
    'amzn-s3-demo-bucket', 
    'backups/daily', 
    'OFFLINE', 
    'NONE', 
    90, 
    20, 
    256, 
    268435456)"

rdsadmin.restore_database

Amazon S3 버킷에서 RDS for Db2 DB 인스턴스로 데이터베이스를 복원합니다.

구문

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

파라미터

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

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

사용 노트

이 저장 프로시저를 사용하여 Db2 데이터베이스를 RDS for Db2 DB 인스턴스로 마이그레이션할 수 있습니다. 자세한 내용은 AWS 서비스를 사용하여 Db2에서 Amazon RDS for Db2로 데이터 마이그레이션 섹션을 참조하세요. 또한 이 저장 프로시저를 사용하여 동일한 복원 이미지를 사용하는 동일한 데이터베이스의 여러 복사본을 서로 다른 데이터베이스 이름으로 생성할 수 있습니다.

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

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

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

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

예시

다음 예제에서는 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, 
    'rollforward_to_option', 
    'complete_rollforward')"

파라미터

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

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

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

사용 노트

다양한 시나리오에서 온프레미스로 생성되는 로그를 포함하는 온라인 백업에 rds.rollforward_database를 사용할 수 있습니다.

시나리오 1: 데이터베이스 복원, 포함된 로그를 롤포워드, 데이터베이스를 온라인 상태로 전환

rdsadmin.restore_database()가 완료되면 예제 1의 구문을 사용하여 트랜잭션 로그가 있는 데이터베이스를 온라인 상태로 전환합니다.

시나리오 2: 데이터베이스를 온라인 상태로 전환하지만 포함된 로그를 롤포워드하지 않음

rdsadmin.restore_database()가 완료되면 예제 2의 구문을 사용하여 트랜잭션 로그가 없는 데이터베이스를 온라인 상태로 전환합니다.

시나리오 3: 백업에 포함된 로그를 앞 버전으로 이동하고 온프레미스에서 생성되는 추가 트랜잭션 로그 적용

rdsadmin.restore_database()가 완료되면 예제 3 또는 예제 4의 구문을 사용하여 데이터베이스를 온라인 상태로 전환하지 않고 로그를 롤포워드합니다.

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

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

예시

예제 1: 트랜잭션 로그가 있는 데이터베이스를 온라인 상태로 전환

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

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

예시 2: 트랜잭션 로그가 없는 데이터베이스를 온라인으로 가져오기

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

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

예시 3: 트랜잭션 로그가 있는 데이터베이스를 온라인으로 가져오지 않기

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

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

예시 4: 추가 트랜잭션 로그가 있는 데이터베이스를 온라인으로 가져오지 않기

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

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

rdsadmin.rollforward_status

ROLLFORWARD DATABASE database_name QUERY STATUS의 출력을 반환합니다.

구문

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

파라미터

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

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

사용 노트

rdsadmin.rollforward_database를 직접적으로 호출한 후 rdsadmin.rollforward_status를 직접적으로 호출하여 데이터베이스의 롤포워드 상태를 확인할 수 있습니다.

이 저장 프로시저의 상태 점검에 대한 자세한 내용은 rdsadmin.get_task_status 섹션을 참조하세요.

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.rollforward_status 섹션을 참조하세요.

예시

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

db2 "call rdsadmin.complete_rollforward(
    ?,
    '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 섹션을 참조하세요.

예시

예시 1: DB 인스턴스의 가동 시간 반환

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

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

예시 2: 데이터베이스의 가동 시간 반환

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

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

예시 3: DB 인스턴스의 메모리 사용량 반환

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

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

예시 4: DB 인스턴스 및 데이터베이스의 메모리 세트 반환

다음 예제는 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 섹션을 참조하세요.

예시

예시 1: 모든 애플리케이션 지정

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

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

예시 2: 여러 애플리케이션 지정

다음 예제에서는 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 데이터베이스에서는 아카이브 로그 보존 설정을 구성할 수 없습니다.

예시

예시 1: 보존 시간 설정

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

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

예시 2: 보존 시간 비활성화

다음 예제에서는 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')"

rdsadmin.list_archive_log_information

크기, 만든 날짜 및 시간, 지정된 데이터베이스의 개별 로그 파일 이름 등 아카이브 로그 파일에 대한 세부 정보를 반환합니다. 또한 데이터베이스의 로그 파일에 따라 사용된 총 스토리지 양도 반환합니다.

구문

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

파라미터

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

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

예시

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

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

rdsadmin.fgac_command

세분화된 액세스 제어(FGAC) 명령을 실행합니다.

구문

db2 "call rdsadmin.fgac_command(
    ?,
    'database_name',
    'fgac_cmd')"

파라미터

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

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

사용 노트

이 저장 프로시저는 행 또는 열 수준에서 RDS for Db2 DB 인스턴스의 데이터베이스에 있는 테이블 데이터에 대한 액세스를 제어합니다. RDS for Db2는 데이터베이스에서 두 가지 유형의 FGAC를 지원합니다.

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

예시

다음 예제에서는 모두 testdb라는 데이터베이스에서 FGAC 명령을 실행합니다.

예제 1: FRUITSET라는 새 보안 레이블 생성

db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE SECURITY LABEL COMPONENT FRUITSET SET{''apple'',''banana''}')"

예제 2: EMP_ID가 3 미만으로 설정된 경우 활성화된 EMP_ID 열에 대한 새 마스크 생성

db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE MASK id_MASK ON EMPLOYEE FOR COLUMN EMP_ID RETURN CASE WHEN (EMP_ID < 3) THEN EMP_ID ELSE NULL END ENABLE')"

예제 3: SESSION_USER가 security_user로 설정된 경우 활성화된 DEPARTMENT 열에 대한 새 마스크 생성

db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE MASK DEPARTMENT_MASK ON EMPLOYEE FOR COLUMN DEPARTMENT RETURN CASE  WHEN SESSION_USER = ''security_user'' THEN DEPARTMENT ELSE NULL END ENABLE')"

예제 4: treelabel라는 새 보안 레이블 생성

db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE SECURITY LABEL COMPONENT treelabel  TREE(''COMPANY'' ROOT, ''HR'' UNDER ''COMPANY'', ''FINANCE'' UNDER ''COMPANY'', ''IT'' UNDER ''COMPANY'')')"