pgactive 拡張機能の初期化

RDS for PostgreSQL DB インスタンスの pgactive 拡張機能を初期化するには、rds.enable_pgactive パラメータの値を 1 に設定し、データベースに拡張を作成します。これを行うと、rds.logical_replication パラメータと track_commit_timestamp パラメータが自動的に有効になり、wal_level の値が logical に設定されます。

これらのタスクを実行するには、rds_superuser ロールとしてアクセス許可が必要です。

AWS Management Console または AWS CLI を使用して、必要な RDS for PostgreSQL DB インスタンスを作成できます。以下のステップでは、RDS for PostgreSQL DB インスタンスがカスタム DB パラメータグループに関連付けられていることを前提としています。カスタム DB パラメータグループの作成については、「Amazon RDS のパラメータグループ」を参照してください。

コンソール

pgactive 拡張機能を初期化するには

1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

2. ナビゲーションペインで、RDS for PostgreSQL DB インスタンスを選択します。

3. RDS for PostgreSQL DB インスタンスの [設定] タブを開きます。インスタンスの詳細で、[DB インスタンスパラメータグループ] リンクを見つけます。

4. リンクを選択して、RDS for PostgreSQL DB インスタンスに関連付けられたカスタムパラメータを開きます。

5. rds.enable_pgactive パラメータを見つけて 1 に設定し、pgactive 機能を初期化します。

6. [Save changes] (変更の保存) をクリックします。

7. Amazon RDS コンソールのナビゲーションペインで、[データベース] を選択します。

8. RDS for PostgreSQL DB インスタンスを選択し、[アクション] メニューから [再起動] を選択します。

9. DB インスタンスの再起動を確定して、変更を有効にします。

10. DB インスタンスが使用可能になったら、psql または他の任意の PostgreSQL インスタンスを使用して RDS for PostgreSQL DB インスタンスに接続します。

    次の例では、RDS for PostgreSQL DB インスタンスに 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 DB インスタンスの 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 DB インスタンスを再起動し、pgactive ライブラリを初期化します。

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

3. インスタンスが使用可能になったら、psql を使用して RDS for PostgreSQL DB インスタンスに接続します。

   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