使用 Bigtable Studio 管理数据
本页面介绍了如何在 Google Cloud 控制台中使用 Bigtable Studio 探索和管理 Bigtable 数据 。
Bigtable Studio 包含一个 Explorer 窗格，该窗格与以下工具集成：
- 查询构建器，一种交互式表单，可让您构建和运行查询，而无需编写代码
- 查询编辑器，您可以在其中创建和执行 SQL 命令
- SQL 查询结果表
如果您是 Bigtable 新手，请了解如何
创建实例和写入数据（使用
cbt CLI
）。
所需的角色
如需获得查询表所需的权限，请让管理员向您授予包含该表的实例的以下 IAM 角色：
-
全部：
Bigtable Reader (
roles/bigtable.reader)
如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。
您也可以通过自定义 角色或其他预定义 角色来获取所需的权限。
探索数据
您可以使用探索器对 Bigtable 资源执行以下操作：
| Bigtable 资源 | 探索器操作 |
|---|---|
| 表 |
|
| 列族 |
|
| 特定列族 |
|
| 授权视图 |
|
| 逻辑视图 |
|
| 连续的具体化视图 |
|
如需访问 Explorer，请按以下步骤操作：
在 Google Cloud 控制台中，打开 Bigtable 实例 页面。
从列表中选择一个实例。
在导航菜单中，点击 Bigtable Studio 。Explorer 窗格会显示实例中的表和授权视图列表。
搜索资源
在 Explorer 窗格中，使用搜索 字段搜索所有 Bigtable 资源，但授权视图和列族除外。
在查询构建器中查询数据
查询构建器是一种交互式表单，可让您从 Google Cloud 控制台向 Bigtable Data API 发送读取请求，而无需编写 代码或 SQL 语句。如需了解详情，请参阅在 控制台中构建查询。
在查询编辑器中使用 SQL 查询数据
使用查询编辑器，您可以运行 SQL SELECT 语句的任意组合，
包括使用 管道语法的语句。
如需查询数据，请按以下步骤操作：
在 Google Cloud 控制台中，打开 Bigtable 实例 页面。
从列表中选择一个实例。
在导航菜单中，点击 Bigtable Studio 。
编写查询：
- 点击 然后选择编辑器，打开一个新标签页。
- 在查询编辑器出现时，编写查询。如果查询是有效的 SQL，系统会显示有效 消息。
- 可选：如需返回查询列中的所有单元格，而不是仅返回
最新的单元格，请将表 ID 附加
(with_history => TRUE)。
可选：如需以 SQL 样式设置语句的格式，请点击格式 。
点击运行 。查询结果会显示在结果 表中。
如需查看行的数据的格式化显示，请点击结果表中的相应行。系统会打开行详细信息 窗格。每个列限定符及其值都会显示在新的一行中。如果您使用
(with_history => TRUE)运行查询，则列中的每个单元格都会以结构体的形式呈现，其中包含单元格的 值和时间戳。可选：如需仅运行编辑器中选定的部分文本，请突出显示该文本，然后点击运行所选内容 。突出显示的查询的结果会显示在结果 表中。
如需从查询编辑器中移除所有文本，请点击清除 。
如需详细了解如何编写 SQL 语句来查询 您的 Bigtable 数据，包括示例，请参阅 GoogleSQL for Bigtable 概览。
导出查询结果
您可以通过以下任一方式导出查询结果：
- 以 CSV 或 JSON 格式下载本地文件。
- 导出至 Google 表格。
- 以 CSV、TSV 或 JSON 文件格式复制到剪贴板。
如需从查询编辑器或查询构建器导出查询结果，请按以下步骤操作：
在 Google Cloud 控制台中，打开 Bigtable 实例 页面。
从列表中选择一个实例。
在导航菜单中，点击 Bigtable Studio 。
Explorer 窗格会显示实例中的表、视图和查询列表。
从构建器 或编辑器 标签页运行查询。
结果会显示在结果 表中。
在结果 工具栏上，点击导出 。
从菜单中选择一个导出选项。
如果您选择了导出至 Google 表格，系统会显示一个对话框。点击打开 以在 Google 表格中查看结果。
创建视图
Bigtable Studio 可让您创建和保存 Bigtable 表的视图。如需了解详情，请参阅每种视图类型的文档。
授权视图
您可以使用查询构建器创建和保存授权 视图，这些视图是表子集，您可以单独授予对这些视图的访问权限，而不是对表的访问权限。您还可以在 Bigtable Studio 中授予访问权限和删除授权视图，方法是使用 Explorer 窗格中的操作 菜单。
如需了解详情，请参阅创建和管理授权 视图。
连续的物化视图
您可以使用查询编辑器创建连续的具体化视图，该视图是持续运行的 SQL 查询的预计算结果，会通过增量更新与其源表同步。连续的物化视图通常包含基于其源表中的值汇总的数据。
如需了解详情，请参阅以下文档：
逻辑视图
您可以使用查询编辑器创建逻辑视图，该视图是可以像查询表一样查询的保存的查询。逻辑视图操作需要超出 roles/bigtable.reader 中授予的权限。如需了解详情，请参阅
创建和管理逻辑视图。
参数化视图
您还可以使用查询编辑器创建 参数化视图，该视图 扩展了逻辑视图的功能，可以根据应用提供的上下文（尤其是在使用 AI 代理或大语言模型 (LLM) 的应用中）过滤到特定数据 范围。如需了解详情，请参阅 参数化视图概览。
已保存的查询
您可以使用 Bigtable Studio 创建、保存和管理 SQL 脚本，并将它们作为保存的查询使用。如需了解详情，请参阅以下文档：