查詢資料

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

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

支援的資料來源

您可以使用 Data Agent Kit，在下列Google Cloud 資料服務中查詢資料表和檢視畫面：

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

對於 Cloud SQL，系統支援使用 Identity and Access Management (IAM) 資料庫驗證和內建資料庫驗證 (密碼儲存在 Secret Manager 中做為區域密碼) 的查詢。如要進一步瞭解 Cloud SQL 如何透過 Secret Manager 驗證內建使用者，請參閱「使用 Data API 執行 SQL 陳述式」一文，瞭解 MySQL 適用的 Cloud SQL 和 PostgreSQL 適用的 Cloud SQL。如果是 AlloyDB，則僅支援使用 IAM 資料庫驗證的查詢。

事前準備

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

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

建立新的 SQL 檔案

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

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

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

從目錄建立新查詢

  1. 在活動列的「Google Cloud Data Agent Kit」分頁中，展開「Catalog」，找出要查詢的資料集。
  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. 按一下 [儲存]。

Bigtable

  1. 在 SQL 編輯器中，按一下「開啟查詢設定」。
  2. 選取「資料庫」。
  3. 選取「Bigtable」。
  4. 選取執行個體。
  5. 選用：如要使用預設應用程式設定檔以外的應用程式設定檔，請選取該設定檔。
  6. 撰寫查詢。
  7. 按一下 [儲存]。

Cloud SQL

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

  6. 在「驗證方式」下方，選取驗證方式：

    • IAM 資料庫驗證：使用 Google Cloud 帳戶進行驗證。

    • 內建資料庫驗證：以內建資料庫使用者身分驗證，這類使用者的密碼會以區域密碼形式儲存在 Secret Manager 中。

      1. 在「使用者」清單中，選取資料庫使用者。如果無法載入清單，請在「使用者」欄位中輸入使用者名稱。 MySQL 適用的 Cloud SQL 不支援預設 root 使用者。
      2. 在「Password (stored in Secret Manager)」(密碼 (儲存在 Secret Manager 中)) 清單中，選取儲存使用者密碼的區域密碼。如果還沒有密鑰，請選取「Create new secret in region REGION」(在區域 REGION 中建立新密鑰)，輸入「Name」(名稱) 和 「Password」(密碼)，然後按一下「Create Secret」(建立密鑰)。系統會在與執行個體相同的區域中建立密碼。
      3. 選用：在「Secret version」(密鑰版本) 清單中，選取特定版本。預設會選取「最新」，一律使用最新版本的密鑰。

      如要進一步瞭解內建使用者和區域密碼規定，請參閱「MySQL 適用的 Cloud SQL」和「PostgreSQL 適用的 Cloud SQL」一文，瞭解如何使用 Data API 執行 SQL 陳述式。

  7. 按一下 [儲存]。

Spanner

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

變更查詢設定

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

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

執行查詢

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

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

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

SQL 編輯器功能

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

功能

BigQuery

Bigtable

Spanner

Cloud SQL

AlloyDB for PostgreSQL

查詢結果

✅

✅

✅

✅

✅

工作資訊

不適用

不適用

不適用

不適用

不適用

執行作業詳細資料

✅

✅

經過時間

❌

不支援

❌

不支援

❌

不支援

視覺化

✅

✅

✅

✅

✅

查詢設定

✅

✅

✅

✅

✅

支援多個陳述式查詢

✅

✅

✅

✅

✅

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

✅

✅

✅

✅

✅

後續步驟