使用分析构建器查询 - AWS Clean Rooms
使用分析构建器查询单个表（聚合）使用分析构建器查询两个表（聚合或列表）

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

使用分析构建器查询

您无需编写 SQL 代码即可使用分析构建器来构建查询。使用分析构建器，您可以为具有以下特征的协作构建查询：

  • 单个使用聚合分析规则且不需要 JOIN 的表

  • 两个使用聚合分析规则的表（每个成员一个）

  • 两个使用列表分析规则的表（每个成员一个）

  • 两个使用聚合分析规则的表（每个成员一个）和两个使用列表分析规则的表（每个成员一个）

如果要手动编写 SQL 查询，请参阅使用 SQL 代码编辑器查询配置表。

分析构建器在 AWS Clean Rooms 控制台的查询选项卡的分析部分中显示为分析构建器用户界面选项。

重要

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

提示

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

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

使用分析构建器查询单个表（聚合）

此过程演示如何使用 AWS Clean Rooms 控制台中的 Analys is Builder 用户界面来生成查询。该查询适用于具有单个表的协作，该表使用聚合分析规则而不使用聚合分析规则 JOIN 必需的。

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

  1. 登录 AWS Management Console 并使用您的AWS Clean Rooms 主机打开主机 AWS 账户 （如果您尚未这样做）。

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

  3. 选择您的成员能力状态为查询的协作。

  4. 在查询选项卡的表下，查看表及其关联的分析规则类型。（分析规则类型应为聚合分析规则。）

    注意

    如果您没有看到所期望的表，可能是由于以下原因：

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

  6. 构建查询。

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

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

    2. （可选）对于添加分段 - 可选，请选择一个或多个参数。

      注意

      只有在为表指定维度时才会显示添加分段 - 可选。

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

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

      要删除筛选条件，请选择移除。

      注意

      ORDER BY 不支持聚合查询。

      只有 AND 过滤器中支持运算符。

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

  7. 展开预览 SQL 代码。

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

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

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

  8. 选择运行。

    注意

    如果可以接收结果的成员尚未配置查询结果设置，您将无法运行查询。

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

注意

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

使用分析构建器查询两个表（聚合或列表）

此过程介绍如何使用 AWS Clean Rooms 控制台中的分析生成器为具有以下特征的协作生成查询：

  • 两个使用聚合分析规则的表（每个成员一个）

  • 两个使用列表分析规则的表（每个成员一个）

  • 两个使用聚合分析规则的表（每个成员一个）和两个使用列表分析规则的表（每个成员一个）

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

  1. 登录 AWS Management Console 并使用您的AWS Clean Rooms 主机打开主机 AWS 账户 （如果您尚未这样做）。

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

  3. 选择您的成员能力状态为查询的协作。

  4. 在查询选项卡的表下，查看两个表及其关联的分析规则类型（聚合分析规则或列表分析规则）。

    注意

    如果您没有在列表中看到所期望的表，可能是由于以下原因：

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

  6. 构建查询。

    如果协作包含两个使用聚合分析规则的表和两个使用列表分析规则的表，请先选择聚合或列表，然后根据所选分析规则按照提示进行操作。

    如果两个表使用聚合分析规则 如果两个表使用列表分析规则

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

    2. 对于匹配记录，请选择一个或多个记录。

      注意

      使用分析构建器时，只能对一对列进行匹配。

    3. （可选）对于添加分段 - 可选，请选择一个或多个参数。

      注意

      只有在为表指定维度时才会显示添加分段 - 可选。

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

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

      要删除筛选条件，请选择移除。

      注意

      ORDER BY 不支持聚合查询。

      只有 AND 过滤器中支持运算符。

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

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

    2. 对于匹配记录，请选择一个或多个记录。

      注意

      使用分析构建器时，只能对一对列进行匹配。

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

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

      要删除筛选条件，请选择移除。

      注意

      LIMIT 不支持列表查询。

      只有 AND 过滤器中支持运算符。

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

  7. 展开预览 SQL 代码。

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

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

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

  8. 选择运行。

    注意

    如果可以接收结果的成员尚未配置查询结果设置，您将无法运行查询。

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

注意

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