Antigravity IDE 整合式 SQL 編輯器的 Google Cloud Data Agent Kit 擴充功能，可讓您直接在 Antigravity IDE 中，對 Google Cloud 資料執行 SQL 查詢。
支援的資料來源
您可以使用擴充功能，在下列 Google Cloud資料服務中查詢資料表和檢視區塊：
- BigQuery
- Spanner
- AlloyDB for PostgreSQL
- MySQL 適用的 Cloud SQL
- PostgreSQL 適用的 Cloud SQL
AlloyDB 和 Cloud SQL 支援使用 IAM 驗證的查詢。您無法查詢設定為使用 Auth Proxy 或密碼驗證的資料庫。
事前準備
查詢資料前，請先完成下列工作：
建立新的 SQL 檔案
您可以透過多種方式開啟 SQL 編輯器。
從「檔案」選單建立新的 SQL 檔案
- 在 VS Code 選單列中，依序點選「File」和「New Text File」。編輯器中會顯示未命名的檔案。
- 使用
.sql副檔名儲存新檔案。 - 在編輯器分頁中，按一下「選取連線」。
- 完成「設定查詢設定」中的步驟。
從目錄建立新查詢
- 在活動列的「Google Cloud Data Agent Kit」分頁中，展開「Catalog」，找出要查詢的資料集。
- 以滑鼠右鍵按一下或按住 Ctrl 鍵並點選資料集名稱，然後選取「查詢」，開啟已預先設定該資料集的新 SQL 檔案。
從 BigQuery 區段建立新查詢
- 在活動列的「Google Cloud Data Agent Kit」(Google Cloud 資料代理程式套件) 分頁中，展開「BigQuery」。
- 按一下「+ 新增查詢」。編輯器中會顯示以 BigQuery 為資料來源的無標題 SQL 檔案。
設定查詢設定
SQL 查詢所需的設定會因 Google Cloud 服務而異。
AlloyDB
- 在 SQL 編輯器中，按一下「開啟查詢設定」。
- 選取「資料庫」。
- 選取「AlloyDB」AlloyDB。
- 選取叢集。
- 選取執行個體。查詢會傳送至這個執行個體。
- 選取資料庫。
- 按一下 [儲存]。
BigQuery
- 在 SQL 編輯器中，按一下「開啟查詢設定」。
- 選取 [BigQuery]。
- 按一下 [儲存]。
Cloud SQL
- 在 SQL 編輯器中，按一下「開啟查詢設定」。
- 選取「資料庫」。
- 選取「Cloud SQL」。
- 選取執行個體。查詢會傳送至這個執行個體。
- 選取要查詢的資料庫。
- 按一下 [儲存]。
Spanner
- 在 SQL 編輯器中，按一下「開啟查詢設定」。
- 選取「資料庫」。
- 選取「Spanner」。
- 選取執行個體。查詢會傳送至這個執行個體。
- 選取要查詢的資料庫。
- 按一下 [儲存]。
變更查詢設定
查詢設定適用於每個 SQL 檔案。開啟 SQL 檔案後，即可變更設定。
- 在編輯器中，按一下顯示的資料來源。系統會顯示「查詢設定」編輯器。
- 完成「設定查詢設定」中的步驟。
執行查詢
建立查詢檔案並撰寫查詢後，請按一下「▷ Run Query」(執行查詢)。
「查詢結果」窗格的「結果」分頁會顯示查詢結果。
如要在查詢編輯器中執行部分 SQL 陳述式，請先醒目顯示部分陳述式，再點選「▷ 執行查詢」。
SQL 編輯器功能
並非所有資料來源類型都支援所有 SQL 編輯器功能。下表列出預覽期間，各資料來源類型支援的 SQL 編輯器功能。
功能 |
BigQuery |
Spanner |
Cloud SQL |
AlloyDB for PostgreSQL |
「查詢結果」窗格分頁 |
||||
查詢結果 |
✅ |
✅ |
✅ |
✅ |
工作資訊 |
✅ |
不適用 |
不適用 |
不適用 |
執行作業詳細資料 |
✅ |
❌ 不支援 |
❌ 不支援 |
❌ 不支援 |
視覺化 |
✅ |
✅ |
✅ |
✅ |
SQL 編輯器設定 |
||||
查詢設定 |
✅ |
✅ |
✅ |
✅ |
其他功能 |
||||
支援多重陳述式查詢 |
✅ |
✅ |
✅ |
✅ |
目錄：在編輯器中插入資源名稱 |
✅ |
✅ |
✅ |
✅ |