Azure CLI を使用して Azure Database for PostgreSQL - Single Server のサーバー構成パラメーターをカスタマイズする

適用対象: Azure Database for PostgreSQL - 単一サーバー

重要

Azure Database for PostgreSQL - シングル サーバーは廃止パスにあります。 Azure Database for PostgreSQL - フレキシブル サーバーにアップグレードすることを強くお勧めします。 Azure Database for PostgreSQL - フレキシブル サーバーへの移行の詳細については、Azure Database for PostgreSQL 単一サーバーの現状に関するページをご覧ください。

コマンド ライン インターフェイス (Azure CLI) を使用して、Azure PostgreSQL サーバーの構成パラメーターを一覧表示、表示、更新できます。 エンジン構成のサブセットは、サーバーレベルで公開され、変更が可能です。

前提条件

このハウツー ガイドの手順を実行するには、以下が必要です。

  • Azure Database for PostgreSQL の作成に関する記事に従って、Azure Database for PostgreSQL サーバーおよびデータベースを作成します。
  • コンピューターに Azure CLI コマンド ライン インターフェイスをインストールするか、ブラウザーを使用して Azure portal の Azure Cloud Shell を使用します。

Azure Database for PostgreSQL サーバーのサーバー構成パラメーターを一覧表示する

サーバー内の変更可能なすべてのパラメーターとその値を一覧表示するには、az postgres server configuration list コマンドを実行します。

リソース グループ myresourcegroup にあるサーバー mydemoserver.postgres.database.azure.com のサーバー構成パラメーターを一覧表示できます。

az postgres server configuration list --resource-group myresourcegroup --server mydemoserver

サーバー構成パラメーター詳細を表示する

サーバーの特定の構成パラメーターに関する詳細を表示するには、az postgres server configuration show コマンドを実行します。

この例では、サーバー mydemoserver.postgres.database.azure.com のリソース グループ myresourcegrouplog_min_messages サーバー構成パラメーターの詳細を表示します。

az postgres server configuration show --name log_min_messages --resource-group myresourcegroup --server mydemoserver

サーバー構成パラメーターの値を変更する

特定のサーバー構成パラメーターの値を変更することもできます。これによって PostgreSQL サーバー エンジンの基盤となる構成値が更新されます。 構成を更新するには、az postgres server configuration set コマンドを使用します。

この例では、サーバー mydemoserver.postgres.database.azure.com のリソース グループ myresourcegrouplog_min_messages サーバー構成パラメーターを更新します。

az postgres server configuration set --name log_min_messages --resource-group myresourcegroup --server mydemoserver --value INFO

構成パラメーターの値をリセットする場合、省略可能な --value パラメーターを除外すると、既定値が適用されます。 上記の例の場合は、次のようになります。

az postgres server configuration set --name log_min_messages --resource-group myresourcegroup --server mydemoserver

このコマンドによって、log_min_messages 構成が既定値の WARNING にリセットされます。 サーバーの構成と許容値の詳細については、サーバー構成に関する PostgreSQL のドキュメントを参照してください。

次のステップ