查询数据

借助 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
  • Cloud SQL for MySQL
  • Cloud SQL for PostgreSQL

对于 Cloud SQL，系统支持使用 Identity and Access Management (IAM) 数据库身份验证和内置数据库身份验证（密码以区域级 Secret 形式存储在 Secret Manager 中）的查询。如需详细了解 Cloud SQL 如何使用 Secret Manager 对内置用户进行身份验证，请参阅使用 Data API 为 Cloud SQL for MySQL 和 Cloud SQL for PostgreSQL 执行 SQL 语句。 对于 AlloyDB，仅支持使用 IAM 数据库身份验证的查询。

准备工作

在查询数据之前，请执行以下操作：

  1. 安装扩展程序。
  2. 配置扩展程序设置。
  3. 查看查找和探索数据中的指南。

创建新的 SQL 文件

您可以通过多种方式打开 SQL 编辑器。

通过“文件”菜单创建新的 SQL 文件

  1. 在 VS Code 菜单栏中，依次点击文件和新建文本文件。编辑器中会显示一个无标题文件。
  2. 以 .sql 扩展名保存新文件。
  3. 在编辑器标签页中，点击选择数据源。
  4. 完成配置查询设置中的步骤。

通过目录创建新查询

  1. 在活动栏的 Google Cloud Data Agent Kit 标签页中，展开 Catalog 以查找要查询的数据集。
  2. 右键点击或按住 Ctrl 键点击数据集的名称，然后选择查询以打开针对该数据集预配置的新 SQL 文件。

通过 BigQuery 部分创建新查询

  1. 在活动栏的 Google Cloud Data Agent Kit 标签页中，展开 BigQuery。
  2. 点击 + 新查询。编辑器中会显示一个以 BigQuery 为数据源的未命名 SQL 文件。

配置查询设置

SQL 查询所需的设置因 Google Cloud 服务而异。

AlloyDB

  1. 在 SQL 编辑器中，点击打开查询设置。
  2. 选择数据库。
  3. 选择 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 中作为区域级 Secret。

      1. 在用户列表中，选择一个数据库用户。如果无法加载列表，请在用户字段中输入用户名。 对于 Cloud SQL for MySQL，不支持默认的 root 用户。
      2. 在密码（存储在 Secret Manager 中）列表中，选择存储用户密码的区域级密文。如果您还没有 Secret，请选择在区域 REGION 中创建新 Secret，输入名称和密码，然后点击创建 Secret。密文是在与实例相同的区域中创建的。
      3. 可选：在密文版本列表中，选择特定版本。默认情况下，系统会选择 latest，该选项始终使用最新版本的 Secret。

      如需详细了解内置用户和区域密钥要求，请参阅使用 Data API 为 Cloud SQL for MySQL 和 Cloud SQL for PostgreSQL 执行 SQL 语句。

  7. 点击保存。

Spanner

  1. 在 SQL 编辑器中，点击打开查询设置。
  2. 选择数据库。
  3. 选择 Spanner。
  4. 选择一个实例。您的查询会路由到此实例。
  5. 选择要查询的数据库。
  6. 点击保存。

更改查询设置

查询设置仅适用于相应 SQL 文件。打开 SQL 文件后，您可以更改设置。

  1. 在编辑器中，点击显示的数据源。系统会显示查询设置编辑器。
  2. 完成配置查询设置中的步骤。

运行查询

创建查询文件并撰写查询后，点击 ▷ 运行查询。

查询结果窗格的结果标签页会显示查询结果。

如需运行查询编辑器中的部分 SQL 语句，请先突出显示相应的部分，然后再点击 ▷ 运行查询。

SQL 编辑器功能

并非所有 SQL 编辑器功能都支持所有数据源类型。下表列出了在预览期间按数据源类型支持的 SQL 编辑器功能。

功能

BigQuery

Bigtable

Spanner

Cloud SQL

AlloyDB for PostgreSQL

查询结果

✅

✅

✅

✅

✅

工作信息

不适用

不适用

不适用

不适用

不适用

执行详细信息

✅

✅

运行时间

❌

不支持

❌

不支持

❌

不支持

可视化图表

✅

✅

✅

✅

✅

查询设置

✅

✅

✅

✅

✅

支持多语句查询

✅

✅

✅

✅

✅

目录：在编辑器中插入资源名称

✅

✅

✅

✅

✅

后续步骤