Azure CLI を使用して Azure Database for PostgreSQL 単一サーバーを管理する
適用対象:
Azure Database for PostgreSQL - 単一サーバー
重要
Azure Database for PostgreSQL - シングル サーバーは廃止パスにあります。 Azure Database for PostgreSQL - フレキシブル サーバーにアップグレードすることを強くお勧めします。 Azure Database for PostgreSQL - フレキシブル サーバーへの移行の詳細については、Azure Database for PostgreSQL 単一サーバーの現状に関するページをご覧ください。
この記事では、Azure でデプロイされた単一サーバーを管理する方法を示します。 管理タスクには、コンピューティングとストレージのスケーリング、管理者パスワードのリセット、サーバーの詳細の表示が含まれます。
前提条件
Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。 この記事では、Azure CLI バージョン 2.0 以降をローカルで実行している必要があります。 インストールされているバージョンを確認するには、az --version コマンドを実行します。 インストールまたはアップグレードする必要がある場合は、Azure CLI のインストールに関するページを参照してください。
az login コマンドを使用して、アカウントにログインする必要があります。 id プロパティに注意してください。これは、お使いの Azure アカウントのサブスクリプション ID を参照します。
az login
az account set コマンドを使用して、アカウントの特定のサブスクリプションを選択します。 コマンドの subscription 引数の値として使用する、az login 出力の id 値をメモしておきます。 複数のサブスクリプションをお持ちの場合は、リソースが課金の対象となる適切なサブスクリプションを選択してください。 すべてのサブスクリプションを取得するには、az account list を使用します。
az account set --subscription <subscription id>
まだサーバーを作成していない場合は、このクイックスタートを参照して作成してください。
Azure Cloud Shell
Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。 ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。
Azure Cloud Shell を開始するには、以下のようにします。
| オプション | 例とリンク |
|---|---|
| コードまたはコマンド ブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にはコピーされません。 | ![Azure Cloud Shell の [使ってみる] の例を示すスクリーンショット。](../../includes/media/cloud-shell-try-it/hdi-azure-cli-try-it.png) |
| https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。 |  |
| Azure portal の右上にあるメニュー バーの [Cloud Shell] ボタンを選択します。 | ![Azure portal の [Cloud Shell] ボタンを示すスクリーンショット](../../includes/media/cloud-shell-try-it/hdi-cloud-shell-menu.png) |
Azure Cloud Shell を使用するには、以下のようにします。
Cloud Shell を開始します。
コード ブロック (またはコマンド ブロック) の [コピー] ボタンを選択し、コードまたはコマンドをコピーします。
Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードまたはコマンドを Cloud Shell セッションに貼り付けます。
Enter キーを選択して、コードまたはコマンドを実行します。
コンピューティングとストレージのスケーリング
次のコマンドを使用して、価格レベル、コンピューティング、ストレージを簡単にスケールアップできます。 az postgres server overviewで、実行できるすべてのサーバー操作を表示できます。
az postgres server update --resource-group myresourcegroup --name mydemoserver --sku-name GP_Gen5_4 --storage-size 6144
上記の引数の詳細を次に示します。
| 設定 | 値の例 | 説明 |
|---|---|---|
| name | mydemoserver | Azure Database for PostgreSQL サーバー名として一意の名前を入力します。 サーバー名に含めることができるのは、英小文字、数字、およびハイフン (-) のみであり、 3 ～ 63 文字にする必要があります。 |
| resource-group | myresourcegroup | Azure リソース グループの名前を指定します。 |
| sku-name | GP_Gen5_2 | 価格レベルとコンピューティング構成の名前を入力します。 省略表現の {価格レベル} {コンピューティング世代} {仮想コア} という規則に従います。 詳細については、価格レベルに関するページを参照してください。 |
| storage-size | 6144 | サーバーのストレージ容量 (単位はメガバイト)。 最小値は 5120 で、1024 ずつ増加します。 |
重要
- ストレージをスケールアップすることはできますが、ストレージをスケールダウンすることはできません
- Basic から汎用またはメモリ最適化への価格レベルのスケールアップはサポートされていません。 bash スクリプトを使用するか、PostgreSQL Workbench を使用すると、手動でスケールアップできます
サーバー上の PostgreSQL データベースを管理します。
これらのコマンドのいずれかを使用して、サーバー上のデータベースのデータベース プロパティの作成、削除、一覧表示、表示を行うことができます
| コマンドレット | 使用法 | 説明 |
|---|---|---|
| az postgres db create | az postgres db create -g myresourcegroup -s mydemoserver -n mydatabasename |
データベースを作成します。 |
| az postgres db delete | az postgres db delete -g myresourcegroup -s mydemoserver -n mydatabasename |
サーバーからデータベースを削除します。 このコマンドでは、サーバーは削除されません。 |
| az postgres db list | az postgres db list -g myresourcegroup -s mydemoserver |
サーバー上のすべてのデータベースの一覧を表示します |
| az postgres db show | az postgres db show -g myresourcegroup -s mydemoserver -n mydatabasename |
データベースの詳細を表示します |
管理パスワードの更新
このコマンドで、管理者ロールのパスワードを変更できます
az postgres server update --resource-group myresourcegroup --name mydemoserver --admin-password <new-password>
重要
パスワードは、8 文字以上 128 文字以下にしてください。 パスワードには、英大文字、英小文字、数字、英数字以外の文字のうち、3 つのカテゴリの文字が含まれている必要があります。
サーバーの削除
PostgreSQL 単一サーバーを削除するだけの場合は、az postgres server delete コマンドを実行してください。
az postgres server delete --resource-group myresourcegroup --name mydemoserver