本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用分析构建器查询
<a name="query-data-analysis-builder"></a>

您无需编写 SQL 代码即可使用分析构建器来构建查询。使用分析构建器，您可以为具有以下特征的协作构建查询：
+ 单个使用[聚合分析规则](analysis-rules-aggregation.md)且不需要 JOIN 的表
+ 两个使用[聚合分析规则](glossary.md#glossary-agg-analysis-rule)的表（每个成员一个）
+ 两个使用[列表分析规则](glossary.md#glossary-list-analysis-rule)的表（每个成员一个）
+ 两个使用聚合分析规则的表（每个成员一个）和两个使用列表分析规则的表（每个成员一个）

如果要手动编写 SQL 查询，请参阅[使用 SQL 代码编辑器查询配置表](use-sql-editor.md)。

分析生成器在 AWS Clean Rooms 控制台的 “**分析” 选项卡的 “**分析**” 部分中显示为 “**分析**生成器” 用户界面**选项。

**重要**  
如果您打开**分析构建器用户界面**，开始在分析构建器中构建查询，然后关闭**分析构建器用户界面**，则不会保存您的查询。

**提示**  
如果查询运行时发生计划的维护，查询会终止并回滚。必须重新开始查询。

以下主题介绍分析构建器的使用。

**Topics**
+ [使用分析构建器查询单个表（聚合）](#use-analysis-builder-one-table)
+ [使用分析构建器查询两个表（聚合或列表）](#use-analysis-builder-two-tables)

## 使用分析构建器查询单个表（聚合）
<a name="use-analysis-builder-one-table"></a>

此过程演示如何使用 AWS Clean Rooms 控制台中的 Analys **is Builder 用户界面**来生成查询。该查询适用于具有单个表的协作，该表使用[聚合分析规则](analysis-rules-aggregation.md)且无需 JOIN。

**使用分析构建器查询单个表**

登录 AWS 管理控制台 并在 [https://console.aws.amazon.com/clean](https://console.aws.amazon.com/cleanrooms/home) room AWS Clean Rooms s 上打开控制台。

1. 在左侧导航窗格中，选择**协作**。

1. 选择**您的成员能力**状态为**运行查询**的协作。

1. 在 “**分析**” 选项卡的 “**表**” 下，查看表格及其关联的分析规则类型。（分析规则类型应为**聚合分析规则**。）
**注意**  
如果您没有看到所期望的表，可能是由于以下原因：  
该表尚未[关联](associate-configured-table.md)。
该表没有[配置分析规则](add-analysis-rule.md)。

1. 在**分析**部分下，打开**分析构建器用户界面**。

1. 构建查询。

   如果要查看所有聚合指标，请跳至步骤 9。

   1. 对于**选择指标**，请查看默认情况下预先选择的聚合指标，并在需要时删除任何指标。

   1. （可选）对于**添加分段 - 可选**，请选择一个或多个参数。
**注意**  
只有在为表指定维度时才会显示**添加分段 - 可选**。

   1. （可选）对于**添加筛选条件 - 可选**，请选择**添加筛选条件**，然后选择**参数**、运算符和**值**。

      要添加更多筛选条件，请选择**再添加一个筛选条件**。

      要删除筛选条件，请选择**移除**。
**注意**  
ORDER BY 不支持聚合查询。  
筛选条件仅支持 AND 运算符。

   1. （可选）对于**添加描述 - 可选**，请输入描述以帮助识别查询列表中的查询。

1. 展开**预览 SQL 代码**。

   1. 查看分析构建器生成的 SQL 代码。

   1. 要复制 SQL 代码，请选择**复制**。

   1. 要编辑 SQL 代码，请选择**在 SQL 代码编辑器中编辑**。

1. 选择**运行**。
**注意**  
如果可以接收结果的成员尚未配置查询结果设置，您将无法运行查询。

1. 继续调整参数并再次运行查询，或者选择 **\+** 按钮在新选项卡中开始新查询。

**注意**  
AWS Clean Rooms 旨在提供清晰的错误消息。如果错误消息中没有足够的详细信息来帮助您进行故障排除，请联系客户团队。向他们说明错误情况和错误信息（包括任何标识符）。有关更多信息，请参阅 [故障排除 AWS Clean Rooms](troubleshooting.md)。

## 使用分析构建器查询两个表（聚合或列表）
<a name="use-analysis-builder-two-tables"></a>

此过程介绍如何使用 AWS Clean Rooms 控制台中的分析生成器为具有以下特征的协作生成查询：
+ 两个使用[聚合分析规则](analysis-rules-aggregation.md)的表（每个成员一个）
+ 两个使用[列表分析规则](analysis-rules-list.md)的表（每个成员一个）
+ 两个使用聚合分析规则的表（每个成员一个）和两个使用列表分析规则的表（每个成员一个）

**使用分析构建器查询两个表**

登录 AWS 管理控制台 并在 [https://console.aws.amazon.com/clean](https://console.aws.amazon.com/cleanrooms/home) room AWS Clean Rooms s 上打开控制台。

1. 在左侧导航窗格中，选择**协作**。

1. 选择处于 “**您的成员权限” 状态为 “****运行查询**” 的协作...

1. 在**分析**选项卡的**表格**下，查看两个表及其关联的分析规则类型（**聚合分析规则**或**列表分析规则**）。
**注意**  
如果您没有在列表中看到所期望的表，可能是由于以下原因：  
这些表尚未[关联](associate-configured-table.md)。
这些表没有[配置分析规则](add-analysis-rule.md)。

1. 在**分析**部分下，打开**分析构建器用户界面**。

1. 构建查询。

   如果协作包含两个使用**聚合分析规则**的表和两个使用**列表分析规则**的表，请先选择**聚合**或**列表**，然后根据所选分析规则按照提示进行操作。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/query-data-analysis-builder.html)

1. 展开**预览 SQL 代码**。

   1. 查看分析构建器生成的 SQL 代码。

   1. 要复制 SQL 代码，请选择**复制**。

   1. 要编辑 SQL 代码，请选择**在 SQL 代码编辑器中编辑**。

1. 选择**运行**。
**注意**  
如果可以接收结果的成员尚未配置查询结果设置，您将无法运行查询。

1. 继续调整参数并再次运行查询，或者选择 **\+** 按钮在新选项卡中开始新查询。

**注意**  
AWS Clean Rooms 旨在提供清晰的错误消息。如果错误消息中没有足够的详细信息来帮助您进行故障排除，请联系客户团队。向他们说明错误情况和错误信息（包括任何标识符）。有关更多信息，请参阅 [故障排除 AWS Clean Rooms](troubleshooting.md)。