Azure 伺服器管理

Visual Studio Code 的 PostgreSQL 擴充功能讓你能直接從 Visual Studio Code 管理支援的 適用於 PostgreSQL 的 Azure 資料庫 資源。 當您連線至 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器後,您可以開啟伺服器儀表板,以控制伺服器生命週期、管理網路存取、變更參數、建立或還原備份、複製伺服器、下載擷取的日誌,並檢視 Azure 控制平面的活動。 Azure HorizonDB(預覽版)連線支援網路設定、防火牆規則及活動記錄。

Note

本文中大多數任務僅適用於 適用於 PostgreSQL 的 Azure 資料庫 靈活伺服器連線。 Azure HorizonDB(預覽版)支援防火牆規則管理及活動記錄,但並非本文所述的每個彈性伺服器管理頁面。 本地 PostgreSQL 實例與容器不會揭露這些 Azure 管理頁面。

Tip

如果你還需要建立伺服器或連接伺服器,請從 「建立 PostgreSQL 伺服器 」或「 連線與身份」開始。

開啟 Azure 管理頁面

  1. 在 Connections 樹中,連接你想管理的 適用於 PostgreSQL 的 Azure 資料庫 資源。
  2. 右鍵點擊伺服器節點,選擇 儀表板。
  3. 對於 適用於 PostgreSQL 的 Azure 資料庫 的彈性伺服器生命週期動作,請在伺服器儀表板中選擇>開始、停止或重新啟動。
  4. 要開啟 Azure 管理頁面,請選擇伺服器設定,然後選擇支援的頁面,如網路設定、伺服器參數、備份或伺服器日誌。

啟動、停止或重新啟動伺服器

你可以從儀表板工具列中的 動作 選單,或從 連線 樹狀結構中伺服器的內容選單執行生命週期操作。

啟動伺服器

  1. 在 連線 樹中,右鍵點擊伺服器並選擇 啟動伺服器,或開啟儀表板選擇 動作>開始。
  2. 等擴充功能顯示進度通知並向 Azure 查詢操作結果。
  3. 在重新連線或開啟管理頁面之前,先確認伺服器會回到 Ready 狀態。

停止伺服器

  1. 在 連線 樹中,右鍵點伺服器並選擇 停止伺服器,或打開儀表板選擇 動作>停止。
  2. 在確認對話框中,選擇 停止。
  3. 請稍候,直到擴充功能完成停止作業。
  4. 重新啟動伺服器後再重新連線。

注意事項

停止伺服器會中斷目前的 Connections 工作階段。 擴充功能會在停止作業完成後自動關閉連線。

Note

當伺服器停止運作時,Azure 會停止計算費用,但儲存費用仍然適用。

重新啟動伺服器

如果你儲存需要重新啟動的參數,並在重新啟動提示中選擇 「是」 ,擴充功能會自動啟動重新啟動。 當你想自己重啟伺服器時,請使用這些步驟。

  1. 在 連線 樹中,右鍵點選伺服器並選擇 重新啟動伺服器,或打開儀表板選擇 動作>重新啟動。
  2. 等擴充功能重新啟動伺服器並刷新伺服器狀態。
  3. 伺服器回到 Ready 狀態後繼續工作。

管理網路存取

開啟伺服器設定>的網路設定以管理網路存取。

平台 支援的網路設定
適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器 防火牆規則、公開存取、Azure 服務存取,以及廣泛的 IPv4 允許清單規則
Azure HorizonDB(預覽) 防火牆規則與 Azure 服務存取

對於 適用於 PostgreSQL 的 Azure 資料庫 靈活伺服器,網路設定頁面會在啟用公開存取前停用防火牆編輯功能。 它也會讓 儲存 維持停用,直到你進行有效的變更。 Azure HorizonDB(預覽版)不會顯示公開存取控制,但包含「允許從 Azure 內任何 Azure 服務對此伺服器的公開存取」這個選項。

新增或編輯防火牆規則

  1. 開啟 伺服器設定>網路設定。
  2. 針對適用於 PostgreSQL 的 Azure 資料庫彈性伺服器,在公開存取底下,開啟公開存取 (若目前為關閉)。
  3. 在防火牆規則表中,使用空列輸入 防火牆規則名稱、 開始 IP 位址和 結束 IP 位址,或更新現有的列。
  4. 選取 [儲存]。

編輯規則時請使用以下驗證規則:

Field 需求
防火牆規則名稱 必須、唯一、1-80 字元、字母、數字、連字號(-)及底線(_)僅限
起始 IP 位址 必須且有效的 IPv4 位址
結束 IP 位址 必須且有效的 IPv4 位址,且不得低於起始 IP 位址

Note

頁面會直接顯示驗證錯誤,並停用 儲存,直到每一條已編輯的規則都有效為止。

允許您目前的用戶端 IP 位址

  1. 開啟 伺服器設定>網路設定。
  2. 在防火牆規則表中,選擇以 「新增目前用戶端 IP 位址」開頭的連結。
  3. 檢視插入的規則並選擇 儲存。

如果儀表板無法偵測到你的公開 IP 位址,連結就會自動變成 無法自動判斷目前的 IP 位址。 改為在空白的防火牆規則列中手動輸入該位址。

設定更廣泛的存取設定

當單一 IP 規則不夠時,請在網路設定頁面使用以下 適用於 PostgreSQL 的 Azure 資料庫 靈活伺服器選項:

Option 在下列情況下使用
公開存取 你希望伺服器能接受透過公共 IP 位址的連線。
允許 Azure 內任何 Azure 服務公開存取此伺服器 你希望 Azure 託管的服務能直接到達伺服器,但又不會手動新增每個服務 IP 範圍。
加 0.0.0.0 - 255.255.255.255 你想建立一條允許任何 IPv4 位址的規則。 只在嚴密控制的環境中使用。

Important

不要同時輸入 0.0.0.0 起始和結束的 IP 位址。 擴充功能會將該範圍視為無效。 如果你想讓 Azure 託管的服務連接,請使用允許 Azure 內任何 Azure 服務對此伺服器的公開存取。

Note

Azure HorizonDB(預覽版)網路配置不包含公開存取、參數、備份、伺服器日誌、複製或生命週期動作。

Tip

如果網路設定頁面顯示 Azure HorizonDB(預覽版)連線因缺少 Azure 身份資訊而無法取得的訊息,請在該頁面選擇「取得元資料」以取得該訊息。 這和 伺服器儀表板上提供的元資料擷取相同。

參數變更

開啟 伺服器設定>伺服器參數 以搜尋、篩選、編輯及重設伺服器的 PostgreSQL 參數。

找到一個參數

  1. 開啟 伺服器設定>伺服器參數。
  2. 使用 篩選按鈕如全部、 修改、 靜態、 動態或 唯讀 來縮小清單範圍。
  3. 使用文字框可依參數名稱或描述搜尋。
  4. 如果你需要更大的工作集,可以將 每頁行 數改為 25、 50或 100。
  5. 如果你想在編輯前先把類似的設定分組,可以先排序一欄。

儲存參數變更

  1. 開啟 伺服器設定>伺服器參數。
  2. 找出你想改變的參數。
  3. 直接在 「值 」欄位編輯該值。
  4. 如果參數顯示資訊按鈕,將滑鼠移過去查看允許的值。
  5. 選取 [儲存]。

若參數需要重新啟動,頁面會在參數下方新增一列 待續始 。 當你儲存一個或多個靜態參數時,擴充功能會詢問你是否要立即重新啟動伺服器。

將參數重設為預設值

  1. 開啟 伺服器設定>伺服器參數。
  2. 找到你想重置的參數。
  3. 選擇參數旁邊的重置圖示。
  4. 選取 [儲存]。

管理備份

開啟 伺服器設定>備份 ,支援自動及按需備份。

建立隨選備份

  1. 開啟 伺服器設定>備份。
  2. 選取 [立即備份]。
  3. 在 建立備份中,輸入 備份名稱。
  4. 選取 ,創建。

備用名稱只能包含字母、數字、連字號(-)和底線(_)。

Note

當伺服器尚未處於準備狀態、另一個備份正在運行,或當前工作負載不支援手動備份時,頁面可以立即停用備份。

從備份還原

  1. 開啟 伺服器設定>備份。
  2. 找到你想用的備份。
  3. 選取 從這個備份還原。
  4. 完成還原工作流程,從該備份建立新的 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器。

刪除隨需備份

  1. 開啟 伺服器設定>備份。
  2. 找到你想要移除的隨選備份。
  3. 選擇 刪除。
  4. 在 刪除備份中,再次選擇 刪除 以確認。

自動備份仍由 Azure 管理,無法從擴充功能中刪除。

變更備份保留期

  1. 開啟 伺服器設定>備份。
  2. 把保留滑桿調整到你想要的天數。
  3. 選取 [儲存]。

你也可以用 自動 或 隨選篩選備份清單,並用時間篩選器(如 過去24小時 或 過去7天)縮小範圍,並依 名稱、 狀態、 完成時間、 保留至 或類型排序表格。

用 pg_dump 備份資料庫(預覽)

「備份資料庫到檔案」指令會執行單一資料庫的用戶端pg_dump備份,並將結果寫入您選擇的輸出資料夾。 與 Azure 管理備份不同,您可以將此工作流程用於任何 PostgreSQL 連線,包括本機、Docker 及 Azure 連線。

備份與還原介面預設為啟用。 如果該指令看不到,請確認pgsql.enablePgDumpRestoreUI在編輯器設定中設定為true。

Note

「備份資料庫至檔案」 指令需要 pg_dump 用戶端工具。 如果 pg_dump 找不到,安裝 PostgreSQL 用戶端工具,或將包含該二進位檔的目錄加入 pgsql.pgBinaryDirs (絕對目錄路徑清單)並重新啟動編輯器。

建立備份

  1. 在 連線 樹狀結構中,對伺服器或資料庫節點按右鍵,選擇 「備份並還原>備份資料庫到檔案」。

  2. 在 「備份你的資料庫 」面板中,選擇要備份的 資料庫 。

  3. 為備份輸出設定 輸出資料夾 和 檔名。

  4. 選擇 格式:

    Format Description
    自訂 (.backup) 支援壓縮與平行還原的二進位格式。 建議用於大多數備份。
    純 SQL(.sql) 人類可讀的 SQL 腳本。 沒有壓縮。
    目錄 每個資料表一個檔案。 支援平行備份與還原。
    Tar(.tar) SQL 檔案檔案庫。 沒有壓縮。
  5. 對於 自訂 或 目錄 格式,請設定 壓縮 等級。 建議等級6。

  6. 在 內容中,選擇 Schema + data、 僅 Schema 或 僅 Data 。

  7. 要在執行指令前先檢視產生的指令,請參考 指令預覽。 選擇 複製指令 來複製它。

  8. 選擇 開始備份。

面板會在備份執行期間即時顯示 pg_dump 輸出。 完成後,選擇 「開啟備份 」開啟輸出資料夾,或選擇 「再備份 」重新開始。 若備份失敗,請選擇「查看完整日誌以了解詳情」,或選擇使用 Copilot 除錯以協助 AI 進行故障排除。

微調備份設定

選擇 進階選項 以開啟具有額外設定的抽屜:

  • 範圍:將備份限制於特定 架構 或 資料表。
  • 內容:包含或排除「預資料」、「資料」及「後資料」區段,並選擇是否包含大型物件。
  • 效能與日誌:設定 平行作業 (僅限目錄格式)並切換 詳細記錄。
  • 還原行為:選擇是否包含所有權與權限(GRANTs),以及是否在資料載入時停用觸發器,以進行後續還原。
  • SQL 格式選項:對於 純 SQL 格式,新增清除、建立資料庫或 INSERT-based 陳述式。
  • 安全性:切換 啟用列安全性 以控制傾印中列層級的安全處理。

Note

「備份資料庫到檔案」指令僅建立備份;它不會還原。 若要還原擴充功能中的封存備份,請參閱 Pg restore。 使用 psql 還原純 SQL 檔案。

克隆伺服器

當你想建立一個基於現有伺服器的新 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器時,請使用 Clone Server。

  1. 開啟儀表板。
  2. 選擇 伺服器設定>中的複製伺服器。
  3. 完成複製工作流程以建立新伺服器。

擷取並下載伺服器日誌

打開 伺服器設定>伺服器日誌 ,擷取診斷日誌並下載進行故障排除。

開啟或關閉日誌擷取

  1. 開啟 伺服器設定>伺服器日誌。
  2. 請開啟或關閉 擷取日誌下載 功能。
  3. 如果日誌擷取已開啟,請設定 日誌保留期。
  4. 選取 [儲存]。

過濾與下載日誌檔案

  1. 開啟 伺服器設定>伺服器日誌。
  2. 使用 所有類型、 伺服器日誌或 升級日誌 來縮小範圍。
  3. 使用時間篩選器或檔名搜尋框來找到你需要的檔案。
  4. 選擇一個或多個日誌檔,或在一列內使用下載按鈕。
  5. 選擇 下載。

日誌表支援依名稱、最後修改、大小(KB)及類型排序。 當超過 100 個檔案符合目前篩選條件時,頁面會顯示分頁控制。

查看活動

開啟伺服器設定>活動日誌,檢視伺服器Azure控制平面的活動,包括操作變更、健康事件,以及使用者發起的管理操作,如啟動、停止和組態操作。 此頁面適用於 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器和 Azure HorizonDB(預覽版)連線。

  1. 開啟 伺服器設定>活動記錄。
  2. 使用 時間範圍(Timespan)、 嚴重度(Severity)和 狀態(Status )篩選器來縮小範圍,或依照操作、發起者或狀態搜尋。 選擇 重置過濾器 以清除它們。
  3. 選擇事件以展開其細節,例如操作名稱、狀態、事件時間及啟動者。
  4. 若要保留一份以供分析,請選擇 下載為 CSV。

Note

Azure 會保留過去 90 天的活動日誌紀錄。 早於 90 天的開始時間無法使用。