Azure CLI を使用して Azure Database for PostgreSQL - フレキシブル サーバー用のインテリジェント チューニングを構成する

適用対象: Azure Database for PostgreSQL - フレキシブル サーバー

Azure CLI を使用して、Azure Database for PostgreSQL フレキシブル サーバー インスタンスのインテリジェント チューニング構成を確認および更新できます。

インテリジェント チューニングの詳細については、「概要」を参照してください。

前提条件

• Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

• Azure CLI をインストールするか、最新バージョンにアップグレードします。 「Azure CLI のインストール」を参照してください。

• az login コマンドを使用して、お使いの Azure アカウントにサインインします。 id プロパティは、ご使用の Azure アカウントのサブスクリプション ID のことです。

  az login
  

• 複数のサブスクリプションがある場合は、az account set コマンドを使用して、サーバーを作成する適切なサブスクリプションを選択します。

  az account set --subscription <subscription id>
  

• Azure Database for PostgreSQL フレキシブル サーバー インスタンスをまだ作成していない場合は、az postgres flexible-server create コマンドを使用して作成します。

  az postgres flexible-server create --resource-group myresourcegroup --name myservername
  

現在の設定の確認

az postgres flexible-server parameter show コマンドを使用して、インテリジェント チューニング機能の現在の設定を確認します。

次のコマンドを使用して、リソース グループ mydemoserver.postgres.database.azure.com のサーバー myresourcegroup に対してこの機能がアクティブになっているかどうかを確認できます。

az postgres flexible-server parameter show --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning --query value

intelligent_tuning.metric_targets サーバー パラメーターの現在の設定を調べるには、次のコマンドを使用します。

az postgres flexible-server parameter show --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --query value

インテリジェント チューニングを有効にする

インテリジェント チューニングを有効または無効にするには、az postgres flexible-server parameter set コマンドを使用します。 次のチューニング ターゲット none、Storage-checkpoint_completion_target、Storage-min_wal_size、Storage-max_wal_size、Storage-bgwriter_delay、tuning-autovacuum、および all の中から選択できます。

1. 次のコマンドを使用してインテリジェント チューニング機能をアクティブにします。

   az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning --value ON
   

2. アクティブにするチューニング ターゲットを選択します。

   • すべてのチューニング ターゲットをアクティブにするには、次のコマンドを使用します。

     az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --value all
     

   • 自動バキューム チューニングのみを有効にするには、次のコマンドを使用します。

     az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --value tuning-autovacuum
     

   • 2 つのチューニング ターゲットをアクティブにするには、次のコマンドを使用します。

     az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --value tuning-autovacuum,Storage-bgwriter_delay
     

   パラメーターの値を既定値にリセットしたい場合は、省略可能な --value パラメーターを除外するだけです。 その後、サービスによって既定値が適用されます。 前の例では、コマンドは次のようになり、intelligent_tuning.metric_targets は none に設定されます。

   az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets
   

チューニング ターゲットの値を選択する際の考慮事項

intelligent_tuning.metric_targets サーバー パラメーターから値を選択する場合は、次の考慮事項を考慮してください。

• NONE 値は、他のすべての値よりも優先されます。 NONE と他の値の任意の組み合わせを選択した場合、パラメーターは NONE に設定されていると認識されます。 これは intelligent_tuning = OFF と同等で、チューニングは行われません。

• ALL 値は他のすべての値よりも優先されますが、NONE は例外です。 ALL を、NONE を除くものとの任意の組み合わせで選択した場合、一覧表示されているすべてのパラメーターがチューニングされます。

• ALL 値には、既存のすべてのメトリック ターゲットが含まれます。 さらに、この値は、今後追加する可能性のある新しいメトリック ターゲットにも自動的に適用されます。 これにより、Azure Database for PostgreSQL フレキシブル サーバー インスタンスを包括的かつ将来に備えてチューニングできます。

• 追加のチューニング ターゲットを含める必要がある場合は、既存と新規のチューニング ターゲットの両方を指定する必要があります。 たとえば、bgwriter_delay が既に有効になっており、自動バキューム チューニングを追加したい場合、コマンドは次のようになります。

  az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --value tuning-autovacuum,Storage-bgwriter_delay
  

  新しい値のみを指定すると、現在の設定が上書きされます。 新しいチューニング ターゲットを追加するときは、コマンドに既存のチューニング ターゲットを必ず含めるようにしてください。

次の手順

• Azure Database for PostgreSQL - フレキシブル サーバーでのインテリジェント チューニングの実行