管理已保存的查询
本文档介绍了如何管理已保存的查询和传统版已保存的查询。
已保存的查询
使用以下部分了解如何管理已保存的查询。已保存的查询是由 Dataform 提供支持的 BigQuery Studio 代码资源。
所需权限
如需管理已保存的查询，您需要以下 Identity and Access Management (IAM) 角色：
- Bigquery Job User (
roles/bigquery.jobUser) - Bigquery Read Session User (
roles/bigquery.readSessionUser) - Code Owner (
roles/dataform.codeOwner)
如需详细了解 BigQuery IAM，请参阅使用 IAM 进行访问权限控制。
授予对已保存查询的访问权限
如需向其他用户授予对已保存查询的访问权限，请将这些用户添加到相应的 IAM 角色。
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和查询文件夹，然后根据需要展开共享查询文件夹。找到要授予其访问权限的已保存查询。
点击已保存的查询旁边的 查看操作，然后点击共享 > 管理权限。
在管理权限窗格中，点击添加用户/群组。
在新的主账号字段中，输入主账号。
在角色列表中，选择以下角色之一：
- Code Owner：可以对已保存的查询执行任何操作，包括删除或共享已保存的查询。
- Code Editor：可以修改查询。
- Code Viewer：可以查看查询。
可选：如需查看角色和高级共享设置的完整列表，请点击高级共享。
点击保存。
如需恢复为已保存的查询信息，请点击关闭。
共享已保存的查询
您可以通过生成并共享指向已保存查询的链接来与其他用户共享已保存的查询。您必须先授予用户访问已保存查询的权限，这些用户才能查看您共享的查询。
要运行共享查询，用户必须有权访问相应查询所访问的数据。如需了解详情，请参阅授予对数据集的访问权限。
如果您打算共享已保存的查询，请考虑在查询中添加描述其用途的注释。
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和查询文件夹，然后根据需要展开共享查询文件夹。找到您要共享的已保存查询。
点击查询旁边的 查看操作，然后点击共享 > 复制链接。
与其他用户共享该链接。
查看所有已保存的查询
如需查看项目中所有已保存查询的列表，请执行以下操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，点击查询旁边的 查看操作，然后执行以下操作之一：
- 如需在当前标签页中打开该列表，请点击全部显示。
- 如需在新标签页中打开该列表，请点击在以下位置全部显示 > 新标签页。
- 如需在拆分标签页中打开该列表，请点击在以下位置全部显示 > 拆分标签页。
查看已保存的查询元数据
如需查看已保存的查询元数据，请按照以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和查询文件夹，然后根据需要展开共享查询文件夹。点击要查看其元数据的已保存查询的名称。
查看摘要窗格，查看有关已保存查询的信息，例如其使用的区域和上次修改日期。
使用已保存的查询版本
使用以下部分了解如何查看、比较和恢复已保存查询的版本。
查看已保存的查询版本
如需查看已保存的查询版本，请按照以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和查询文件夹，然后根据需要展开共享查询文件夹。点击要查看其活动的已保存查询的名称。
点击活动标签页，按日期查看已保存查询版本的列表（按降序排列）。
比较已保存的查询版本
如需比较已保存的查询版本，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和查询文件夹，然后根据需要展开共享查询文件夹。点击要比较其版本信息的已保存查询的名称。
在活动标签页中，点击已保存的查询版本旁边的 查看操作，然后点击比较。此时会打开比较窗格，将您选择的已保存查询版本与当前已保存查询版本进行比较。
可选：如需以内嵌方式（而不是在单独的窗格中）比较版本，请点击比较，然后点击内嵌。
恢复已保存的查询版本
使用以下任一选项来恢复已保存的查询版本。通过从比较窗格中恢复数据，您可以在选择是否恢复之前将已保存查询的先前版本与当前版本进行比较。
“活动”窗格
- 在探索器窗格中，展开您的项目和查询文件夹，然后根据需要展开共享查询文件夹。点击要恢复其旧版本的查询的名称。
- 选择活动窗格。
- 点击要恢复的已保存查询版本旁边的 查看操作，然后点击恢复。
- 点击确认以确认操作。
“比较”窗格
- 在探索器窗格中，展开您的项目和查询文件夹，然后根据需要展开共享查询文件夹。点击要恢复其旧版本的查询的名称。
- 选择活动窗格。
- 点击已保存的查询版本旁边的 查看操作，然后点击比较。此时会打开比较窗格，将您选择的已保存查询版本与最新的已保存查询版本进行比较。
- 如果要在比较后恢复之前保存的查询版本，请点击恢复。
- 点击确认以确认操作。
下载已保存的查询
如需下载已保存的查询，请按照以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和查询文件夹，然后根据需要展开共享查询文件夹。点击已保存的查询名称将其打开。
点击下载。
删除已保存的查询
如需删除已保存的查询，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和查询文件夹，然后根据需要展开共享查询文件夹。找到您要删除的已保存查询。
点击已保存的查询旁边的 查看操作，然后点击删除。
如需确认删除，请在对话框中输入
delete。点击删除。
传统版已保存的查询
请参阅以下部分，了解如何管理传统版已保存查询。
共享传统版已保存查询
您可以共享公开范围为“项目”或“公开”的传统版查询。如果将公开范围设置为“项目”，则其具备所需权限的主账号可以查看、更新或删除该查询。如果将公开范围设置为“公开”，则任何知道查询链接的人员都可以查看该查询，但无法执行更新或删除操作。
您可以通过生成并共享指向传统版已保存查询的链接来与其他用户共享传统版已保存查询。
如需运行传统版共享查询，用户必须有权访问相应查询所访问的数据。如需了解详情，请参阅授予对数据集的访问权限。
如果您打算共享传统版已保存查询，请考虑在查询中添加描述其用途的注释。
- 在探索器窗格中，展开您的项目和（传统版）查询文件夹，然后找到您要共享的传统版已保存查询。
- 点击查询旁边的 查看操作，然后点击获取链接。
- 与要授予查询访问权限的用户共享链接。
迁移传统版已保存查询
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和（传统版）查询文件夹，然后根据需要展开项目查询文件夹。
点击一个已保存的传统查询的名称将其打开。
点击
保存查询（传统版）> 将查询另存为...。在保存查询对话框中，输入名称并选择查询的位置。
点击保存。
删除传统版已保存查询
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和（传统版）查询文件夹，然后根据需要展开项目查询文件夹。
找到您要删除的传统版已保存查询。
点击查询旁边的 查看操作，然后点击删除。
如需确认删除，请在对话框中输入
delete。点击删除。