Visual Studio Code用 PostgreSQL 拡張機能を使用すると、サポートされているAzure Database for PostgreSQL リソースをVisual Studio Codeから直接管理できます。 Azure Database for PostgreSQLフレキシブル サーバーに接続したら、サーバー ダッシュボードを開いてサーバー のライフサイクルの制御、ネットワーク アクセスの管理、パラメーターの変更、バックアップの作成または復元、サーバーの複製、キャプチャされたログのダウンロードを行うことができます。 Azure HorizonDB (プレビュー) 接続では、ファイアウォール規則用の小さなネットワーク構成ページがサポートされます。
Note
この記事のほとんどのタスクは、フレキシブル サーバー接続Azure Database for PostgreSQLにのみ適用されます。 Azure HorizonDB (プレビュー) では、ファイアウォール規則の管理のみがサポートされます。 ローカル PostgreSQL インスタンスと Docker コンテナーでは、これらのAzure管理ページは公開されません。
Tip
サーバーを作成する必要がある場合、またはサーバーに接続する必要がある場合は、「 PostgreSQL サーバーの作成 」または「 接続と ID」から始めます。
Azure管理ページを開く
- [接続] ツリーで、管理するAzure Database for PostgreSQL リソースに接続します。
- サーバー ノードを右クリックし、[ ダッシュボード] を選択します。
- 柔軟なサーバー ライフサイクル アクションAzure Database for PostgreSQL場合は、サーバー ダッシュボードで [アクション>開始、停止、または再起動] を選択します。
- Azure管理ページを開くには、[サーバー設定] を選択し、ネットワーク構成、サーバー パラメーター、バックアップ、サーバー ログなどのサポートされているページを選択します。
サーバーを起動、停止、または再起動する
ライフサイクル アクションは、ダッシュボード ツール バーの [アクション] メニューから、または [接続 ] ツリーのサーバーのコンテキスト メニューから実行できます。
サーバーを起動する
- [接続] ツリーで、サーバーを右クリックして [サーバーの開始] を選択するか、ダッシュボードを開いて [アクション>開始] を選択します。
- 拡張機能が進行状況通知を表示し、操作の結果をAzureポーリングするまで待ちます。
- 管理ページを再接続または開く前に、サーバーが 準備完了 状態に戻っていることを確認します。
サーバーを停止する
- [接続] ツリーで、サーバーを右クリックして [サーバーの停止] を選択するか、ダッシュボードを開いて [アクション>ストップ] を選択します。
- 確認ダイアログで、[停止] を選択 します。
- 拡張機能が停止操作を完了するまで待ちます。
- サーバーを再度起動した後に再接続します。
Caution
サーバーを停止すると、現在の 接続 セッションが切断されます。 拡張機能は、停止操作の完了後に接続を自動的に閉じます。
Note
サーバーが停止すると、Azureはコンピューティングの課金を停止しますが、ストレージ料金は引き続き適用されます。
サーバーを再起動する
再起動が必要なパラメーターを保存し、再起動プロンプトで [はい ] を選択すると、拡張機能によって再起動が自動的に開始されます。 サーバーを自分で再起動する場合は、次の手順に従います。
- [接続] ツリーで、サーバーを右クリックして [サーバーの再起動] を選択するか、ダッシュボードを開いて [アクション>Restart を選択します。
- 拡張機能がサーバーを再起動し、サーバーの状態を更新するまで待ちます。
- サーバーが 準備完了 状態に戻った後も作業を続けます。
ネットワークアクセスの管理
ネットワーク アクセスを管理するには>Network 構成を開きます。
| Platform | サポートされているネットワーク構成設定 |
|---|---|
| Azure Database for PostgreSQL - フレキシブル サーバー | ファイアウォール規則、パブリック アクセス、Azure サービス アクセス、および広範な IPv4 許可リスト規則 |
| Azure HorizonDB (プレビュー) | ファイアウォール規則とAzure サービスのアクセス |
フレキシブル サーバー Azure Database for PostgreSQL場合、[ネットワーク構成] ページでは、パブリック アクセスが有効になるまでファイアウォールの編集が無効になります。 また、有効な変更を行うまで 、保存 は無効に維持されます。 Azure HorizonDB (プレビュー) にはパブリック アクセス制御は表示されませんが、[このサーバーへのAzure内の任意のAzure サービスからのパブリック アクセスを許可する] チェック ボックスが含まれています。
ファイアウォール規則を追加または編集する
- サーバー設定>Network 構成を開きます。
- フレキシブル サーバー Azure Database for PostgreSQL場合は、[パブリック アクセス] で、現在オフになっている場合はパブリック アクセスを有効にします。
- ファイアウォール規則の表で、空の行を使用して 、ファイアウォール規則名、 開始 IP アドレス、 および終了 IP アドレスを入力するか、既存の行を更新します。
- 保存を選びます。
ルールを編集するときは、次の検証規則を使用します。
| フィールド | 要件 |
|---|---|
| ファイアウォール規則名 | 必須、一意であること。使用できるのは1～80文字の英字、数字、ハイフン (-)、アンダースコア (_) のみです |
| 開始 IP アドレス | 必須、有効な IPv4 アドレス |
| 終了 IP アドレス | 必須、有効な IPv4 アドレス、および開始 IP アドレスより低くない |
Note
このページには検証エラーがインラインで表示され、編集されたすべてのルールが有効になるまで 保存 がブロックされます。
現在のクライアント IP アドレスを許可する
- サーバー設定>Network 構成を開きます。
- [ファイアウォール規則] テーブルで、[ 現在のクライアント IP アドレスの追加] で始まるリンクを選択します。
- 挿入されたルールを確認し、[ 保存] を選択します。
ダッシュボードでパブリック IP アドレスを検出できない場合、リンクは [ 現在の IP アドレスを自動的に特定できない] に変わります。 代わりに、空のファイアウォール規則行にアドレスを手動で入力します。
より広範なアクセス設定を構成する
個々の IP 規則で十分でない場合は、[ネットワーク構成] ページで次のAzure Database for PostgreSQLフレキシブル サーバー オプションを使用します。
| Option | 次の場合に使用します。 |
|---|---|
| パブリック アクセス | サーバーがパブリック IP アドレス経由の接続を受け入れるようにします。 |
| Azure 内の任意の Azure サービスにこのサーバーへのパブリック アクセスを許可する | Azureホストされるサービスは、各サービス IP 範囲を手動で追加せずにサーバーに到達する必要があります。 |
| 0.0.0.0 - 255.255.255.255 を追加 | 任意の IPv4 アドレスを許可するルールを作成する必要があります。 これは、厳密に制御された環境でのみ使用します。 |
Important
開始 IP アドレスと終了 IP アドレスの両方に 0.0.0.0 を入力しないでください。 拡張機能は、その範囲を無効として扱います。 Azureホステッド サービスを接続する場合は、代わりに、Azure内の任意のAzure サービスからこのサーバーへのパブリック アクセスを許可するを使用します。
Note
Azure HorizonDB (プレビュー) ネットワーク構成には、パブリック アクセス、パラメーター、バックアップ、サーバー ログ、複製、ライフサイクル アクションは含まれません。
Tip
Azure ID 情報が不足しているために、Azure HorizonDB (プレビュー) 接続に対して利用不可のメッセージが ネットワーク構成 ページに表示される場合は、ページで メタデータの取得 を選択してその情報を取得してください。 これは、 サーバー ダッシュボードで使用できるのと同じメタデータ フェッチです。
パラメーターの変更
サーバーの設定>サーバーパラメーターを開き、サーバーの PostgreSQL パラメーターを検索、フィルター処理、編集、リセットします。
パラメーターを検索する
- > Server パラメーターを開きます。
- [すべて]、[変更済み]、[静的]、[動的]、[読み取り専用] などのフィルター ボタンを使用して、リストを絞り込みます。
- テキスト ボックスを使用して、パラメーター名または説明で検索します。
- より大きなワーキング セットが必要な場合は、 ページあたりの行数 を
25、50、または100に変更します。 - 同様の設定を編集する前にグループ化する場合は、列を並べ替えます。
パラメーターの変更を保存する
- > Server パラメーターを開きます。
- 変更するパラメーターを見つけます。
- [値] 列で値を直接編集します。
- パラメーターに情報ボタンが表示されている場合は、そのボタンをポイントして許可された値を確認します。
- 保存を選びます。
パラメーターの再起動が必要な場合、ページはパラメーターの下に [保留中の再起動] 行を追加します。 1 つ以上の静的パラメーターを保存すると、拡張機能によってサーバーを直ちに再起動するかどうかを確認するメッセージが表示されます。
パラメーターを既定値にリセットする
- > Server パラメーターを開きます。
- リセットするパラメーターを見つけます。
- パラメーターの横にあるリセット アイコンを選択します。
- 保存を選びます。
バックアップの管理
サーバー設定>バックアップを開き、自動バックアップとオンデマンド バックアップを操作します。
オンデマンド バックアップを作成する
- サーバー設定>Backups を開きます。
- [今すぐバックアップ] を選択します。
- [ バックアップの作成] に、 バックアップ名を入力します。
- を選択してを作成します。
バックアップ名には、文字、数字、ハイフン (-)、アンダースコア (_) のみを含めることができます。
Note
このページでは、サーバーが準備完了状態でない間、別のバックアップが既に実行されている間、または現在のワークロードで手動バックアップがサポートされていない場合に、バックアップを無効にすることができます。
バックアップから復元する
- サーバー設定>Backups を開きます。
- 使用するバックアップを見つけます。
- [このバックアップから復元] を選択します。
- 復元ワークフローを完了して、そのバックアップから新しいAzure Database for PostgreSQLフレキシブル サーバーを作成します。
オンデマンド バックアップを削除する
- サーバー設定>Backups を開きます。
- 削除するオンデマンド バックアップを見つけます。
- を選択して、を削除します。
- [ バックアップの削除] で、もう一度 [削除 ] を選択して確認します。
自動バックアップはAzureによって管理され、拡張機能から削除することはできません。
バックアップの保持期間を変更する
- サーバー設定>Backups を開きます。
- 保持スライダーを目的の日数に移動します。
- 保存を選びます。
自動またはオンデマンドでバックアップ リストをフィルター処理し、過去 24 時間や過去 7 日間などの時間フィルターで絞り込み、テーブルを名前、状態、完了時刻、保持期間、または種類で並べ替えることもできます。
サーバーを複製する
現在のサーバーに基づいて新しい Azure Database for PostgreSQL フレキシブル サーバーを作成する場合は、Clone Server を使用します。
- ダッシュボードを開きます。
- サーバー 設定>Clone サーバーを選択します。
- 複製ワークフローを完了して、新しいサーバーを作成します。
サーバー ログのキャプチャとダウンロード
サーバー設定>サーバー ログを開いて診断ログをキャプチャし、トラブルシューティング用にダウンロードします。
ログ キャプチャのオンとオフを切り替える
- サーバー設定>サーバー ログを開きます。
- [Capture logs for download]\(ログのキャプチャ\) をオンまたはオフにします。
- ログ キャプチャがオンの場合は、 ログの保持期間を設定します。
- 保存を選びます。
ログ ファイルのフィルター処理とダウンロード
- サーバー設定>サーバー ログを開きます。
- リストを絞り込む には、すべての種類、 サーバー ログ、または アップグレード ログ を使用します。
- 時間フィルターまたはファイル名検索ボックスを使用して、必要なファイルを見つけます。
- 1 つ以上のログ ファイルを選択するか、1 行のダウンロード ボタンを使用します。
- [ダウンロード] を選択します。
ログ テーブルでは、 名前、 最終更新日時、 サイズ (KB)、 および種類による並べ替えがサポートされています。 100 を超えるファイルが現在のフィルターと一致すると、ページに改ページ コントロールが表示されます。