初始化 pgactive 延伸模組功能

若要在 RDS for PostgreSQL 資料庫執行個體上初始化 pgactive 延伸模組，請將 rds.enable_pgactive 參數值設定為 1，然後在資料庫中建立延伸模組。這樣做就會自動開啟參數 rds.logical_replication 和 track_commit_timestamp，並將 wal_level 的值設定為 logical。

您必須具有做為 rds_superuser 角色的許可，才能執行這些任務。

您可以使用 AWS Management Console 或 AWS CLI 建立所需的 RDS for PostgreSQL 資料庫執行個體。下列步驟假設您的 RDS for PostgreSQL 資料庫執行個體與自訂資料庫參數群組相關聯。如需建立自訂資料庫參數群組的相關資訊，請參閱 Amazon RDS 的參數群組。

主控台

若要初始化 pgactive 延伸模組功能

1. 登入 AWS Management Console，開啟位於 https://console.aws.amazon.com/rds/ 的 Amazon RDS 主控台。

2. 在導覽窗格中，選擇您的 RDS for PostgreSQL 資料庫執行個體。

3. 針對您的 RDS for PostgreSQL 資料庫執行個體開啟組態索引標籤。在執行個體詳細資訊中，找到資料庫執行個體參數群組連結。

4. 選擇連結以開啟與您的 RDS for PostgreSQL 資料庫執行個體相關聯的自訂參數。

5. 找到 rds.enable_pgactive 參數，並將其設定為 1 以初始化 pgactive 功能。

6. 選擇儲存變更。

7. 從 Amazon RDS 主控台的導覽窗格中，選擇資料庫。

8. 選取您的 RDS for PostgreSQL 資料庫執行個體，然後從動作選單中選擇重新開機。

9. 確認資料庫執行個體重新開機，以讓您的變更生效。

10. 當資料庫執行個體可用時，您可以使用 psql 或任何其他 PostgreSQL 用戶端連線至 RDS for PostgreSQL 資料庫執行個體。

    下列範例假設您的 RDS for PostgreSQL 資料庫執行個體擁有名為 postgres 的預設資料庫。

    psql --host=mydb.111122223333.aws-region.rds.amazonaws.com --port=5432 --username=postgres --password=PASSWORD --dbname=postgres
    

11. 若要驗證 pgactive 是否已初始化，請執行下列命令。

    postgres=>SELECT setting ~ 'pgactive' 
    FROM pg_catalog.pg_settings
    WHERE name = 'shared_preload_libraries';

    如果 pgactive 在 shared_preload_libraries 中，則上述命令將傳回以下內容：

    
    ?column? 
    ----------
     t

AWS CLI

若要初始化 pgactive 延伸模組功能

若要使用 AWS CLI 初始化 pgactive，請呼叫 modify-db-parameter-group 操作來修改自訂參數群組中的特定參數，如下列程序所示。

1. 使用下列 AWS CLI 命令將 rds.enable_pgactive 設定為 1，以初始化 RDS for PostgreSQL 資料庫執行個體的 pgactive 功能。

   postgres=>aws rds modify-db-parameter-group \
      --db-parameter-group-name custom-param-group-name \
      --parameters "ParameterName=rds.enable_pgactive,ParameterValue=1,ApplyMethod=pending-reboot" \
      --region aws-region

2. 使用下列 AWS CLI 命令將 RDS for PostgreSQL 資料庫執行個體重新開機，以便初始化 pgactive 程式庫。

   aws rds reboot-db-instance \
       --db-instance-identifier your-instance \
       --region aws-region

3. 當執行個體可用時，請使用 psql 連線至 RDS for PostgreSQL 資料庫執行個體。。

   psql --host=mydb.111122223333.aws-region.rds.amazonaws.com --port=5432 --username=master user --password=PASSWORD --dbname=postgres
   

4. 若要驗證 pgactive 是否已初始化，請執行下列命令。

   postgres=>SELECT setting ~ 'pgactive' 
   FROM pg_catalog.pg_settings
   WHERE name = 'shared_preload_libraries';

   如果 pgactive 在 shared_preload_libraries 中，則上述命令將傳回以下內容：

   
   ?column? 
   ----------
    t