查詢資料

Google Cloud Data Agent Kit IDE 擴充功能的統一 SQL 編輯器，可讓您直接從 IDE 對 Google Cloud 資料執行 SQL 查詢。

如果您搭配使用 Data Agent Kit 外掛程式和支援的程式碼編寫代理，可以在代理中執行 SQL 查詢，或使用自然語言提示生成 SQL 查詢。

支援的資料來源

Data Agent Kit 可讓您查詢下列Google Cloud 資料服務中的資料表和檢視表：

  • BigQuery
  • Spanner
  • AlloyDB for PostgreSQL
  • MySQL 適用的 Cloud SQL
  • PostgreSQL 適用的 Cloud SQL

AlloyDB 和 Cloud SQL 支援使用 IAM 驗證的查詢。您無法查詢設定為使用 Auth Proxy 或密碼驗證的資料庫。

事前準備

查詢資料前，請先完成下列工作：

  1. 安裝擴充功能。
  2. 設定擴充功能。
  3. 請參閱「尋找及探索資料」一文中的指南。

建立新的 SQL 檔案

您可以透過多種方式開啟 SQL 編輯器。

從「檔案」選單建立新的 SQL 檔案

  1. 在 VS Code 選單列中，依序點選「File」和「New Text File」。編輯器中會顯示未命名的檔案。
  2. 使用 .sql 副檔名儲存新檔案。
  3. 在編輯器分頁中，按一下「選取連線」。
  4. 完成「設定查詢設定」中的步驟。

從目錄建立新查詢

  1. 在活動列的「Google Cloud Data Agent Kit」分頁中，展開「目錄」，找出要查詢的資料集。
  2. 以滑鼠右鍵按一下或按住 Ctrl 鍵並點選資料集名稱，然後選取「查詢」，開啟已預先設定該資料集的新 SQL 檔案。

從 BigQuery 區段建立新查詢

  1. 在活動列的「Google Cloud Data Agent Kit」分頁中，展開「BigQuery」。
  2. 按一下「+ 新增查詢」。編輯器中會顯示未命名的 SQL 檔案，並將 BigQuery 設為資料來源。

設定查詢設定

SQL 查詢所需的設定會因 Google Cloud 服務而異。

AlloyDB

  1. 在 SQL 編輯器中，按一下「開啟查詢設定」。
  2. 選取「資料庫」。
  3. 選取「AlloyDB」AlloyDB。
  4. 選取叢集。
  5. 選取執行個體。查詢會轉送至這個執行個體。
  6. 選取資料庫。
  7. 按一下 [儲存]。

BigQuery

  1. 在 SQL 編輯器中，按一下「開啟查詢設定」。
  2. 選取 [BigQuery]。
  3. 按一下 [儲存]。

Cloud SQL

  1. 在 SQL 編輯器中，按一下「開啟查詢設定」。
  2. 選取「資料庫」。
  3. 選取「Cloud SQL」。
  4. 選取執行個體。查詢會轉送至這個執行個體。
  5. 選取要查詢的資料庫。
  6. 按一下 [儲存]。

Spanner

  1. 在 SQL 編輯器中，按一下「開啟查詢設定」。
  2. 選取「資料庫」。
  3. 選取「Spanner」。
  4. 選取執行個體。查詢會轉送至這個執行個體。
  5. 選取要查詢的資料庫。
  6. 按一下 [儲存]。

變更查詢設定

查詢設定適用於每個 SQL 檔案。開啟 SQL 檔案後，即可變更設定。

  1. 在編輯器中，按一下顯示的資料來源。系統會顯示「查詢設定」編輯器。
  2. 完成「設定查詢設定」中的步驟。

執行查詢

建立查詢檔案並撰寫查詢後，請按一下「▷ Run Query」(執行查詢)。

「查詢結果」窗格的「結果」分頁會顯示查詢結果。

如要在查詢編輯器中執行部分 SQL 陳述式，請先醒目顯示部分陳述式，然後點選「▷ 執行查詢」。

SQL 編輯器功能

並非所有資料來源類型都支援所有 SQL 編輯器功能。下表列出預覽期間，各資料來源類型支援的 SQL 編輯器功能。

功能

BigQuery

Spanner

Cloud SQL

AlloyDB for PostgreSQL

「查詢結果」窗格分頁

查詢結果

✅

✅

✅

✅

工作資訊

✅

不適用

不適用

不適用

執行作業詳細資料

✅

❌

不支援

❌

不支援

❌

不支援

視覺化

✅

✅

✅

✅

SQL 編輯器設定

查詢設定

✅

✅

✅

✅

其他功能

支援多重陳述式查詢

✅

✅

✅

✅

目錄：在編輯器中插入資源名稱

✅

✅

✅

✅

後續步驟