快速入門：使用 Visual Studio Code 的 PostgreSQL 擴充套件連接並查詢資料庫

適用於 Visual Studio Code 的 PostgreSQL 擴充功能是一項功能強大的工具，旨在簡化 PostgreSQL 資料庫的開發和管理。 本指南會逐步引導您連線到 PostgreSQL 資料庫，並在 Visual Studio Code 環境中執行查詢。

Prerequisites

開始之前，請確認您已下載並安裝適當的工具和資源。

這些工具和資源可協助您遵循本文，並充分利用Visual Studio Code 中PostgreSQL延伸模組的 GitHub Copilot 整合。

• 安裝在您電腦上的 Visual Studio Code。
• PostgreSQL 資料庫安裝在本機或裝載於 雲端。
• Visual Studio Code 中安裝的 PostgreSQL 擴充功能。
• GitHub Copilot 擴充功能
• 已安裝 GitHub Copilot Chat 擴充功能。
• 用來連線到雲端裝載資料庫的 Azure 帳戶（選擇性）。

安裝 PostgreSQL 擴充功能

若要安裝 PostgreSQL 擴充功能：

1. 打開 Visual Studio Code，並透過活動列中的擴充功能圖示或使用 「View： Extensions 」指令，進入擴充功能檢視。
2. 在延伸模組 Marketplace 中搜尋 PostgreSQL 。
3. 選取Microsoft所撰寫的 PostgreSQL 擴充功能，然後選取 [ 安裝]。

安裝擴充功能後，PostgreSQL 頁面以大象圖示顯示於 Visual Studio Code 側邊欄。

將連線新增至 PostgreSQL

無論是裝載在本機還是遠端伺服器上，連線到 PostgreSQL 資料庫，都是管理和與您的數據互動的基本步驟。 此程式牽涉到提供必要的連線詳細數據，例如伺服器位址、埠和驗證認證，以建立用戶端應用程式與資料庫之間的安全連結。 透過適用於 Visual Studio Code 的 PostgreSQL 擴充功能，您可以順暢地連線到資料庫，並使用功能強大的工具來有效率地查詢、管理及探索您的數據。

1. 選取提要字段上的大象圖示，以開啟 PostgreSQL 擴充功能頁面。

2. 選取 [ 新增連線] 按鈕。

3. 手動輸入您的連線資料，或使用連接字串格式：

     psql -h <server>.postgres.database.azure.com -p 5432 -U
   

4. 如果使用 Azure，請登入您的 Azure 帳戶並瀏覽資料庫實例。 依訂用帳戶、資源群組、伺服器和資料庫名稱進行篩選。

Authentication

延伸模組支援兩種驗證方法：

• 使用者名稱/密碼：直接在聯機字段中輸入您的資料庫認證。
• Microsoft Entra ID 驗證：新增 Azure 裝載資料庫的 Microsoft Entra ID 帳戶。

測試並儲存連線

1. 選擇 「測試連線 」以驗證您的連線資訊。
2. 測試成功後，測試方塊會顯示一個勾號。
3. 選取 [Connect] \(連線\) 以建立連線。
4. 你的連線會自動儲存並顯示在連線視窗中。

探索資料庫物件

[物件總管] 提供資料庫物件的階層式檢視：

• 展開資料庫項目以檢視架構、資料表、檢視表、函式和預存程式。
• 在資料庫中右鍵點擊以查看以下選項：
  • 啟動新查詢
  • 用這個資料庫聊天（開始 pgsql 聊天體驗）
  • 連接 PSQL 以啟動 psql 終端連線
• 右鍵點擊表格，選擇「 選擇前1000 名」以查看其資料。 查詢會在 [查詢編輯器] 中開啟，結果會出現在 [結果查看器] 索引標籤中。

執行查詢

使用查詢編輯器來草稿和執行 SQL 查詢：

• 利用內容感知的 IntelliSense，自動補齊 SQL 關鍵字及物件名稱。
• 使用語法劃重點和自動格式化，以提升可讀性和準確性。
• 透過 [查詢歷程記錄] 窗格存取先前執行的查詢。

檢閱查詢結果

結果查看器提供與查詢結果互動的進階功能：

• 將結果匯出至 CSV、JSON 或 Excel 格式，以進行進一步分析。
• 使用搜尋、篩選和排序選項來精簡您的數據。
• 持續性資料檢視會在索引標籤之間切換時保留內容。

使用 GitHub Copilot 取得進階協助

GitHub Copilot 整合藉由提供 AI 支援的程式代碼建議、查詢優化秘訣和互動式資料庫協助，來增強 PostgreSQL 開發體驗。 此功能幫助您簡化工作流程、縮短開發時間，並深入了解資料庫運作。 本節將引導你了解如何在 Visual Studio Code 的 PostgreSQL 擴充套件中啟用並使用 Copilot。

確定已安裝 GitHub Copilot 和 Copilot Chat 擴充功能。

登入您的 GitHub 帳戶，並在擴充功能設定中啟用 @pgsql Copilot Chat 代理程式。

互動式資料庫提示

右鍵點擊資料庫，選擇 與該資料庫聊天 以與 Copilot 互動。

寫出像以下範例這樣的提示，以獲得詳細的見解與建議。

@pgsql tell me about the tables in the HR schema

欲了解更多資訊，請參閱 「配置 GitHub Copilot」。

使用 Visual Studio Code 連接到 Azure PostgreSQL 資料庫

透過以下步驟，使用 Visual Studio Code 連接 Azure 資料庫以實現 PostgreSQL 彈性伺服器實例：

1. 登入 Azure 入口網站，並找出適用於 PostgreSQL 的 Azure 資料庫彈性伺服器實例。
2. 前往你伺服器實例的 概覽 頁面。

透過 Visual Studio Code 連線

Azure 入口網站中的 [使用 Visual Studio Code 連線] 選項可簡化連線至適用於 PostgreSQL 的 Azure 資料庫彈性伺服器執行個體。 此功能可引導您完成必要必要條件並自動設定連線詳細數據，以簡化設定。 藉由使用此整合，您可以快速建立連線，並直接在 Visual Studio Code 環境中管理資料庫。

• 在概覽頁面選擇顯眼的「Connect with Visual Studio Code」按鈕。
• 側邊窗格顯示使用 Visual Studio Code 連接所需的條件。

確認需求

• 在側邊窗格中，透過選擇適當的勾選框確認所有前置條件（如 Visual Studio Code 與 PostgreSQL 擴充功能）都已滿足。

• 如有需要，請透過側邊窗格的連結下載 Visual Studio Code 及擴充功能。

• 選擇性地填寫連線參數，例如預設資料庫名稱、驗證方法和聯機共用。

  

在 Visual Studio Code 中開啟

• 選取側邊窗格中的 [ 在 Visual Studio Code 中開啟 ] 按鈕。
• 如果 Visual Studio Code 和擴充功能開啟超過 40 秒，側邊窗格會出現「 在 Visual Studio Code 中重試開啟 」按鈕。

啟動 Visual Studio Code

• 若安裝並執行 Visual Studio Code，PostgreSQL 擴充功能的連線對話框會自動啟動。
• 若安裝 Visual Studio Code 但未開啟，約 40 秒內啟動，接著會出現連線對話框。

自動填入連線詳細數據

PostgreSQL 擴充功能中的連線對話框會打開，伺服器 名稱 欄位會自動填入你的伺服器端點。

提供驗證詳細資料

選取您慣用的驗證方法：

• 密碼驗證：手動輸入您的使用者名稱和密碼。
• Entra Authentication：輸入您的 Azure 帳戶認證。

請指定其他連線細節，如 設定檔名稱、 資料庫名稱 （可選）、 伺服器群組及 埠號。

儲存並連線

選取 [ 儲存和連線 ] 按鈕以建立連線。 連線之後，展開 [物件總管] 樹狀結構中的伺服器，以檢視資料庫、結構描述和資料表，或使用內建查詢工具來管理資料庫物件。

Troubleshoot

如果您在連線過程中遇到問題：

• 確認 Visual Studio Code 和 PostgreSQL 擴充功能已安裝並啟用。

• 請確定適用於 PostgreSQL 的 Azure 資料庫防火牆設定中允許 IP 位址。

• 如果你不符合前提條件，側邊面板會提供回饋和解決問題的步驟，包括重新嘗試連線。

意見反應與支援

針對 Bug、功能要求和問題，請使用 Visual Studio Code 中的內建意見反應工具。 你可以透過 Visual Studio Code 說明選單或 PGSQL 指令面板完成此回饋流程。

• 說明功能表

  • 移至 [說明] > [報告問題]

• 命令選擇區

  • 使用 Ctrl + Shift + P 開啟命令選擇區並執行： PGSQL: Report Issue

相關內容

• 什麼是 Visual Studio Code 的 PostgreSQL 擴充功能？
• 快速入門：在 Visual Studio Code 中配置 GitHub Copilot for PostgreSQL 擴充功能
• 適用於 Visual Studio Code 的 PostgreSQL 擴充功能