Share via

PowerShell を使用して Azure Database for PostgreSQL サーバーのパラメーターをカスタマイズする

  • [アーティクル]

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

重要

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

PowerShell を使用して、Azure Database for PostgreSQL サーバーの構成パラメーターを一覧表示、表示、更新できます。 エンジン構成のサブセットは、サーバー レベルで公開され、変更が可能です。

前提条件

このハウツー ガイドを完了するには、次が必要です。

重要

Az.PostgreSql PowerShell モジュールがプレビュー段階にある間は、コマンド Install-Module -Name Az.PostgreSql -AllowPrerelease を使用して、Az PowerShell モジュールとは別にこれをインストールする必要があります。 Az.PostgreSql PowerShell モジュールは、一般提供された段階で将来の Az PowerShell モジュール リリースの一部となり、Azure Cloud Shell 内からネイティブに使用できるようになります。

PowerShell をローカルで使用する場合は、Connect-AzAccount コマンドレットを使用して Azure アカウントに接続します。

Azure Cloud Shell

Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。 ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。

Azure Cloud Shell を開始するには、以下のようにします。

オプション 例とリンク
コードまたはコマンド ブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にはコピーされません。 Azure Cloud Shell の [使ってみる] の例を示すスクリーンショット。
https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。 Azure Cloud Shell を起動するボタン。
Azure portal の右上にあるメニュー バーの [Cloud Shell] ボタンを選択します。 Azure portal の [Cloud Shell] ボタンを示すスクリーンショット

Azure Cloud Shell を使用するには、以下のようにします。

  1. Cloud Shell を開始します。

  2. コード ブロック (またはコマンド ブロック) の [コピー] ボタンを選択し、コードまたはコマンドをコピーします。

  3. Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードまたはコマンドを Cloud Shell セッションに貼り付けます。

  4. Enter キーを選択して、コードまたはコマンドを実行します。

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

サーバー内の変更可能なすべてのパラメーターとその値を一覧表示するには、Get-AzPostgreSqlConfiguration コマンドレットを実行します。

次の例では、リソース グループ myresourcegroup に含まれているサーバー mydemoserver のサーバー構成パラメーターが一覧表示されます。

Get-AzPostgreSqlConfiguration -ResourceGroupName myresourcegroup -ServerName mydemoserver

一覧表示されている各パラメーターの定義については、PostgreSQL リファレンスの「環境変数」セクションを参照してください。

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

サーバーの特定の構成パラメーターに関する詳細を表示するには、Get-AzPostgreSqlConfiguration コマンドレットを実行して Name パラメーターを指定します。

この例では、リソース グループ myresourcegroup にあるサーバー mydemoserver の slow_query_log サーバー構成パラメーターの詳細が表示されます。

Get-AzPostgreSqlConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName mydemoserver

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

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

リソース グループ myresourcegroup にあるサーバー mydemoserver の slow_query_log サーバー構成パラメーターを更新する場合。

Update-AzPostgreSqlConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName mydemoserver -Value On

次のステップ

PowerShell を使用して Azure Database for PostgreSQL サーバーのストレージを自動拡張する。