本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

管理資料庫

下列預存程序會管理適用於 Db2 的 Amazon RDS 資料庫。若要執行這些程序，master 使用者必須先連線到資rdsadmin料庫。

rdsadmin.create_database

建立資料庫。

語法

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

參數

以下是必要參數：

下列是選用參數：

使用須知

rdsadmin.create_database如果您在建立 RDS for Db2 資料庫執行個體時未使用 Amazon RDS 主控台或指定資料庫名稱，則可以透過呼叫來建立資料庫。 AWS CLI如需詳細資訊，請參閱 建立資料庫執行個體。

特殊考量：

如需有關這些考量的詳細資訊，請參閱IBM Db2文件中的CREATE DATABASE指令。

在調用之前rdsadmin.create_database，您必須連接到rdsadmin數據庫。在下列範例中，將使用您的 RDS for Db2 資料庫執行個體資訊取代主體使用者名稱和主密碼：

db2 connect to rdsadmin user master_username using master_password

如需檢查建立資料庫狀態的資訊，請參閱rdsadmin.get_task_status。

範例

下列範例會建立一個資料庫，並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數據庫。在下列範例中，將使用您的 RDS for Db2 資料庫執行個體資訊取代主體使用者名稱和主密碼：

db2 connect to rdsadmin user master_username using master_password

如需有關檢查卸除資料庫狀態的資訊，請參閱rdsadmin.get_task_status。

範例

下面的例子刪除一個名為的數據庫TESTDB：

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

回應範例

如果您傳遞不正確的資料庫名稱，則預存程序會傳回下列回應範例：

SQL0438N Application raised error or warning with diagnostic text: "Cannot
drop database. Database with provided name does not exist". SQLSTATE=99993

如果您使用 Amazon RDS 主控台或建立資料庫 AWS CLI，則預存程序會傳回下列回應範例：

Return Status = 0

接收後Return Status = 0，調用存rdsadmin.get_task_status儲過程。類似下列範例的回應會說明狀態：

1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started.
2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task. 
Reason Dropping database created via rds CreateDBInstance api is not allowed. 
Only database created using rdsadmin.create_database can be dropped

rdsadmin.update_db_param

更新資料庫參數。

語法

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

參數

下列是必要參數：

使用須知

如需有關檢查更新資料庫參數狀態的資訊，請參閱rdsadmin.get_task_status。

範例

下列範例會將名為之資料庫100的archretrydelay參數更新為TESTDB：

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.restore_database如果您在建立 RDS for Db2 資料庫執行個體時未使用 Amazon RDS 主控台或指定資料庫名稱，則可以呼叫來還原資料庫。 AWS CLI如需詳細資訊，請參閱 建立資料庫執行個體。

還原資料庫之前，您必須為 RDS for Db2 資料庫執行個體佈建儲存空間，該儲存空間等於或大於備份大小和磁碟上原始 Db2 資料庫的總和。當您還原備份時，Amazon RDS 會在您的 RDS for Db2 資料庫執行個體上擷取備份檔案。

每個備份文件必須為 5 TB 或更小。如果備份檔案超過 5 TB，您必須將備份檔案分割為較小的檔案。

若要使用rdsadmin.restore_database預存程序還原所有檔案，請勿在檔案名稱中的時間戳記後加入檔案編號尾碼。例如，s3_prefix 會backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101還原下列檔案：

SAMPLE.0.rdsdb.DBPART000.20230615010101.001
SAMPLE.0.rdsdb.DBPART000.20230615010101.002
SAMPLE.0.rdsdb.DBPART000.20230615010101.003
SAMPLE.0.rdsdb.DBPART000.20230615010101.004
SAMPLE.0.rdsdb.DBPART000.20230615010101.005

若要改善資料庫還原作業的效能，您可以設定 RDS 使用的緩衝區和緩衝區操控點數目。若要檢查目前的組態，請使用rdsadmin.show_configuration。若要變更組態，請使用rdsadmin.set_configuration。

如需檢查還原資料庫狀態的資訊，請參閱rdsadmin.get_task_status。

若要在還原資料庫之後使資料庫上線並套用其他交易記錄，請參閱rdsadmin.rollforward_database。

範例

下列範例會使用單一檔案或多個具有 s3 backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101 _prefix 的檔案來還原離線備份：

db2 "call rdsadmin.restore_database(
    ?,
    'SAMPLE',
    'DOC-EXAMPLE-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',
    'DOC-EXAMPLE-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',
    'DOC-EXAMPLE-BUCKET',
    'logsfolder/S0000155.LOG',
    'END_OF_LOGS',
    'FALSE')"

rdsadmin.complete_rollforward

使資料庫從ROLL-FORWARD PENDING狀態上線。

語法

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

參數

需要以下輸出參數：

需要下列輸入參數：

使用須知

如果您rdsadmin.rollforward_database使用 complete_rollforward set to 呼叫FALSE，則您的資料庫ROLL-FORWARD PENDING處於離線狀態。若要完成向前捲動程序並使資料庫上線，請呼叫。rdsadmin.complete_rollforward

如需檢查完成向前捲動程序狀態的資訊，請參閱。rdsadmin.get_task_status

範例

下列範例會使資TESTDB料庫上線：

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

rdsadmin.db2pd_command

收集 Db2 資料庫之 RDS 的相關資訊。

語法

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

參數

需要下列輸入參數：

使用須知

此預存程序會收集可協助監視和疑難排解 RDS for Db2 資料庫的資訊。

預存程序會使用IBMdb2pd公用程式來執行各種命令。此db2pd公用程式需要SYSADM授權，Db2 主要使用者沒有授權。不過，使用 Amazon RDS 存放程序時，主要使用者可以使用公用程式執行各種命令。如需有關公用程式的詳細資訊，請參閱 IBM 說明文件中的 db2pd-監控和疑難排解 Db2 資料庫命令。

輸出限制為最大 2 MB。

如需檢查收集資料庫相關資訊之狀態的資訊，請參閱rdsadmin.get_task_status。

範例

下列範例會傳回適用於 Db2 資料庫執行個體的 RDS 執行時間：

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

下列範例會傳回名為的資料庫的執行時間TESTDB：

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

下列範例會傳回 RDS for Db2 資料庫執行個體的記憶體使用量：

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

下列範例會傳回 RDS for Db2 資料庫執行個體和名為TESTDB的資料庫的記憶體集：

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

rdsadmin.force_application

強制使用 RDS for Db2 資料庫的應用程式。

語法

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

參數

需要以下輸出參數：

需要下列輸入參數：

使用須知

這個預存程序會強制所有應用程式離開資料庫，以便您可以執行維護。

預存程序會使用IBMFORCE APPLICATION命令。此命FORCE APPLICATION令需要SYSADMSYSMAINT、或SYSCTRL授權，Db2 主要使用者所沒有的 RDS。不過，使用 Amazon RDS 存放程序時，主要使用者可以使用該命令。如需詳細資訊，請參閱 IBM 說明文件中的強制應用程式命令。

如需檢查強制執行應用程式離開資料庫之狀態的資訊，請參閱rdsadmin.get_task_status。

範例

下列範例會強制所有應用程式離開 RDS for Db2 資料庫：

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

下列範例會強制應用程式處理9991和1192關閉 RDS for Db2 資料庫：8891

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')"

參數

需要以下輸出參數：

需要下列輸入參數：

使用須知

您可以透過呼叫來檢視目前的封存記錄保留設定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')"