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 の中から選択できます。
Important
自動バキューム チューニングは現在、General Purpose およびメモリ最適化のサーバー コンピューティング レベル (4 個以上の仮想コアを持つもの) に対してサポートされています。 バースト可能サーバー コンピューティング レベルはサポートされていません。
次のコマンドを使用してインテリジェント チューニング機能をアクティブにします。
az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning --value ONアクティブにするチューニング ターゲットを選択します。
すべてのチューニング ターゲットをアクティブにするには、次のコマンドを使用します。
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-autovacuum2 つのチューニング ターゲットをアクティブにするには、次のコマンドを使用します。
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 と 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新しい値のみを指定すると、現在の設定が上書きされます。 新しいチューニング ターゲットを追加するときは、コマンドに既存のチューニング ターゲットを必ず含めるようにしてください。