快速入門：連接並查詢 PostgreSQL

在這個快速入門中，你可以使用 Visual Studio Code 的 PostgreSQL 擴充功能，連接 PostgreSQL 伺服器、建立資料表、插入列並執行查詢，全部都在 VS Code 內完成。

您將學到什麼

  • 打開連線對話框並連接到 PostgreSQL 伺服器
  • 用查詢編輯器建立資料庫和資料表
  • 插入與查詢資料
  • 在 結果 面板查看結果

先決條件

開始之前，請確定您具備下列項目：

連接到伺服器

  1. 透過按 Ctrl+Alt+D（Windows/Linux）或 Cmd+Alt+D（macOS）開啟 PostgreSQL 視圖，或在活動列中選擇 PostgreSQL 圖示。

  2. 將滑鼠移到「連線」區塊的標頭上，選擇新增連線（圖示）。+ 連線對話方塊開啟時，會選取 參數 索引標籤。

    連線對話截圖，參數標籤顯示。

  3. 填寫你 PostgreSQL 伺服器的連線欄位：

    Field 範例值 Description
    伺服器名稱 localhost 伺服器的主機名稱或 IP 位址。
    驗證類型 密碼 選擇密碼、Entra 認證、AWS IAM（RDS/Aurora）或無。
    使用者名稱 postgres 你的 PostgreSQL 登入資料。
    密碼 （你的密碼） 此帳戶的密碼。
    資料庫名稱 postgres 要連線的資料庫。
    連線名稱 Local dev server 此連線的可選顯示名稱。

    Tip

    選擇 「儲存密碼 」，這樣可以安全地將密碼儲存在 VS Code 的憑證庫中，這樣你就不會每次連線都被提示。 關於 Microsoft Entra ID 認證、AWS IAM 認證或其他身份設定，請參見連線與身份。

  4. 選取 [儲存並連線]。

    連線成功時，伺服器會以綠色狀態指示器出現在 連線 樹中。

建立資料庫

  1. 在 連線 樹中右鍵點擊你的伺服器節點，並選擇 新查詢。 會開啟一個連接伺服器的查詢編輯器。

  2. 將以下語句貼上，然後按 Ctrl+Shift+E（Windows/Linux）或 Cmd+Shift+E（macOS）執行：

    CREATE DATABASE tutorialdb;

  3. 在 連線 樹中右鍵點選伺服器節點，選擇 刷新 ，就能看到樹中新的 tutorialdb 資料庫。

建立數據表

  1. 把資料庫上下文改成 tutorialdb。 使用查詢編輯器工具列中的資料庫下拉選單，或從指令調色盤（pgsql.changeDatabase）執行並選擇 tutorialdb。

  2. 將以下陳述貼入查詢編輯器，並以 Ctrl+Shift+E / Cmd+Shift+E 執行：

    CREATE TABLE customers (
    id SERIAL PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    email VARCHAR(50) NOT NULL,
    city VARCHAR(50)
);

    訊息小組確認該陳述已成功完成。

插入數據

將查詢編輯器的內容替換為以下陳述句並執行：

INSERT INTO customers (name, email, city)
VALUES
    ('Alice Johnson', 'alice@example.com', 'Seattle'),
    ('Bob Smith', 'bob@example.com', 'Portland'),
    ('Carol Williams', 'carol@example.com', 'San Francisco');

訊息面板確認已插入三列。

查詢資料

將查詢編輯器的內容替換為以下陳述句並執行：

SELECT * FROM customers;

結果面板會顯示你插入的三列。

確認結果

為了確認資料是否被持久化，請執行一個篩選過的查詢：

SELECT name, city
FROM customers
WHERE city = 'Seattle';

結果面板會傳回位於Seattle的Alice Johnson一列資料。

排解連線問題

如果你無法連接伺服器，請檢查以下常見原因：

  • 連線被拒絕：確認 PostgreSQL 是否在預期的主機和埠上執行並監聽。 對於本地伺服器，請確認服務已啟動。
  • 密碼驗證失敗：請再次確認 使用者名稱 和 密碼 值。 請檢查伺服器的 pg_hba.conf 檔案，確認驗證方法是否允許您的連線。
  • SSL 錯誤：請在進階連線選項中設定 SSL 設定。 詳情請參見 連線與身份：SSL 與 TLS。

相關內容

  • Last updated on