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

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 資料庫執行個體資訊：

db2 connect to rdsadmin user master_username using master_password

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

如需呼叫 rdsadmin.create_database 時所傳回的錯誤訊息，請參閱 預存程序錯誤。

範例

下列範例會建立名為 TESTJP 的資料庫，其中包含日本的 database_code_set、database_territory 和 database_collation 參數的正確組合：

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 預存程序來停用來源資料庫執行個體上的資料庫。

如需檢查停用資料庫狀態的相關資訊，請參閱 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')"

參數

以下是必要輸出參數：

以下是必要輸入參數：

使用須知

所有資料庫預設都會在建立時啟用。如果您停用獨立資料庫執行個體上的資料庫來節省記憶體資源或進行其他資料庫組態變更，請呼叫 rdsadmin.activate_database 預存程序，以再次啟用資料庫。

此預存程序只會啟用位於獨立資料庫執行個體上的資料庫，且該資料庫是透過呼叫 rdsadmin.deactivate_database 預存程序來停用。若要在複本來源資料庫執行個體上啟用資料庫，您必須呼叫 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 資料庫執行個體上重新啟用資料庫。若要判斷是否需要重新啟用資料庫，請連線至資料庫並執行 db2 get db cfg show detail。

針對獨立資料庫執行個體上的資料庫，您可以使用 rdsadmin.reactivate_database 儲存程序來重新啟用資料庫。或者，如果您已呼叫 rdsadmin.deactivate_database 預存程序，則可以改為呼叫 rdsadmin.activate_database 預存程序。

針對複本來源資料庫執行個體上的資料庫，您必須使用 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 資料庫執行個體資訊：

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 資料庫執行個體備份到 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 資料庫執行個體進行備份，將其串流至 Amazon S3，然後視需要還原。如需將資料庫還原至 RDS for Db2 資料庫執行個體的詳細資訊，請參閱 rdsadmin.restore_database。

呼叫預存程序之前，請檢閱下列考量事項：

呼叫 rdsadmin.backup_database 之前，您必須連線到 rdsadmin 資料庫。在下列範例中，將 master_username 和 master_password 取代為您的 RDS for Db2 資料庫執行個體資訊：

db2 connect to rdsadmin user master_username using master_password

備份資料庫之後，請務必終止連線。

terminate

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

如需呼叫 rdsadmin.backup_database 時所傳回的錯誤訊息，請參閱 預存程序錯誤。

範例

所有範例都會將名為 的資料庫備份MYDB至名為 的 Amazon S3 儲存貯體，amzn-s3-demo-bucket並將 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。

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：在沒有壓縮、高使用率和自訂計算的情況下，指定離線和無法使用的資料庫

在下列範例中，資料庫離線，速度更快，但表示資料庫在備份期間無法使用。此範例不會執行檔案壓縮，對系統資源有高度影響，並使用 20 個上傳串流至 Amazon S3。它會將資料表空間數目上限設定為平行讀取，如果處理能力不足，可能會導致備份請求失敗。它也會設定要使用的緩衝區數量上限，如果記憶體不足，可能會導致備份請求失敗。

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 資料庫執行個體。

語法

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

參數

以下是必要輸出參數：

以下是必要輸入參數：

使用須知

您可以使用此預存程序將 Db2 資料庫遷移至 RDS for Db2 資料庫執行個體。如需詳細資訊，請參閱使用 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')"

範例 1：不將含有交易日誌的資料庫上線

下列範例會向前捲動至含有交易日誌的資料庫之線上備份，然後不將資料庫上線：

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

參數

以下是必要輸出參數：

以下是必要輸入參數：

使用須知

如果您呼叫 rdsadmin.rollforward_database 並將 complete_rollforward 設定為 FALSE，則您的資料庫處於 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 公用程式需要 SYSADM 授權，RDS for Db2 主要使用者並沒有該授權。不過，透過 Amazon RDS 預存程序，主要使用者可以使用公用程式來執行各種命令。如需關於公用程式的詳細資訊，請參閱 IBM Db2 文件中的 db2pd - 監控 Db2 資料庫命令並進行故障診斷。

輸出上限為 2 GB。

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

範例

範例 1：傳回資料庫執行個體的運行時間

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

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

範例 2：傳回資料庫的運行時間

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

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

範例 3：傳回資料庫執行個體的記憶體用量

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

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

範例 4：傳回資料庫執行個體和資料庫的記憶體集

下列範例會傳回 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')"

參數

以下是必要輸出參數：

以下是必要輸入參數：

使用須知

此預存程序會強制所有應用程式退出資料庫，讓您可以執行維護。

預存程序使用 IBM FORCE APPLICATION 命令。FORCE APPLICATION 命令需要 SYSADM、SYSMAINT 或 SYSCTRL 授權，RDS for Db2 主要使用者並沒有該授權。不過，透過 Amazon RDS 預存程序，主要使用者即可以使用命令。如需詳細資訊，請參閱 IBM Db2 文件中的 FORCE APPLICATION 命令。

如需檢查強制應用程式退出資料庫狀態的相關資訊，請參閱 rdsadmin.get_task_status。

範例

範例 1：指定所有應用程式

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

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

範例 2：指定多個應用程式

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

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 分鐘。如果您使用 等複寫工具 AWS DMS 進行變更資料擷取 (CDC) 或 IBM Q Replication，建議您在這些工具中設定超過 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 資料庫執行個體上資料庫中資料表資料的存取。RDS for Db2 支援資料庫上的兩種 FGAC 類型：

呼叫預存程序之前，請檢閱下列考量事項：

範例

下列範例會在名為 的資料庫上執行 FGAC 命令testdb。

範例 1：建立新的安全標籤，稱為 FRUITSET

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

範例 2：為當 EMP_ID 設定為少於三個 時啟用的資料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設定為 時啟用的資料DEPARTMENT欄建立新的遮罩 security_user

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