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

# 为配置表添加分析规则。
<a name="add-analysis-rule"></a>

以下各节介绍了如何为您的配置表添加分析规则。通过定义分析规则，您可以授权可以查询的成员运行与 AWS Clean Rooms支持的特定分析规则匹配的查询。

AWS Clean Rooms 支持以下类型的分析规则：
+ [聚合分析规则](analysis-rules-aggregation.md)
+ [列表分析规则](analysis-rules-list.md)
+ [中的自定义分析规则 AWS Clean Rooms](analysis-rules-custom.md)

每个配置表只能有一个分析规则。您可以在将配置表与协作关联之前随时配置分析规则。

**重要**  
如果您在协作中使用 Clean Rooms 加密计算且有加密数据表，则添加到加密配置表的分析规则应与数据的加密方式一致。例如，如果您为 SELECT（聚合分析规则）加密了数据，则不应添加 JOIN（列表分析规则）的分析规则。

**Topics**
+ [为表添加聚合分析规则（引导流程）](#add-agg-analysis-rule-console-wizard)
+ [为表添加列表分析规则（引导流程）](#add-list-analysis-rule-console-wizard)
+ [为表添加自定义分析规则（引导流程）](#add-custom-analysis-rule-wizard)
+ [为表添加分析规则（JSON 编辑器）](#add-analysis-rule-console-json-editor)
+ [后续步骤](#add-analysis-rule-next-step)

## 为表添加聚合分析规则（引导流程）
<a name="add-agg-analysis-rule-console-wizard"></a>

*聚合分析规则*支持使用 COUNT、SUM 和 AVG 函数按可选维度聚合统计数据而不会泄露行级信息的查询。

此过程描述了使用 AWS Clean Rooms 控制台中的**引导流程**选项为配置表添加聚合分析规则的过程。

**注意**  
使用非 S3 数据源的配置表仅支持[自定义分析规则](#add-custom-analysis-rule-wizard)。

**为表添加聚合分析规则（引导流程）**

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

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

1. 选择配置表。

1. 在配置表详细信息页面上，选择**配置分析规则**。

1. 在 “**步骤 1：选择分析规则类型**” 下，在 “**分析规则类型**” 下，选择 “**聚合**” 选项。

1. 在**创建方法**下，选择**引导流程**，然后选择**下一步**。

1. 在**步骤 2: 指定查询控制**下，对于**聚合函数**：

   1. 从下拉列表中选择一个**聚合函数**：
      + **COUNT**
      + **COUNT DISTINCT**
      + **SUM**
      + **SUM DISTINCT**
      + **AVG**

   1. 从**列**下拉列表中选择哪些列可以用于**聚合函数**。

   1. （可选）选择**添加其他函数**以添加另一个聚合函数，并将一个或多个列与该函数相关联。
**注意**  
至少需要一个聚合函数。

   1. （可选）选择**移除**以删除聚合函数。

1. 对于**联接控制**，

   1. 为**允许单独查询表**选择一个选项：    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/add-analysis-rule.html)

   1. 在**指定联接列**下，选择要允许在 INNER JOIN 语句中使用的列。

      如果您在上一步中选择了**是**，则这是*可选的*。

   1. 在**指定允许的匹配运算符**下，选择哪些运算符（如果有）可用于在多个联接列上进行匹配。如果您选择两列或更多 JOIN 列，则需要其中一个运算符。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/add-analysis-rule.html)

1. *（可选）*对于**维度控制**，在**指定维度列**下拉列表中，选择要允许在 SELECT 语句中使用的列，以及查询的 WHERE、GROUP BY 和 ORDER BY 部分。
**注意**  
聚合函数或联接列不能用作**维度**列。

1. 对于**标量函数**，请为**要允许哪些标量函数？**选择一个选项。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/add-analysis-rule.html)

   有关更多信息，请参阅 [标量函数](analysis-rules-aggregation.md#scalar-functions)。

1. 选择**下一步**。

1. 在**步骤 3: 指定查询结果控制**下，为**聚合约束**：

   1. 选择每个**列名称**的下拉列表。

   1. 选择应用 COUNT DISTINCT 函数后返回的每个输出行必须满足的每个**不同值的最小数量**的下拉列表。

   1. 选择**添加约束**，添加更多聚合约束。

   1. （可选）选择**移除**以删除聚合约束。

1. 对于**应用于输出的其他分析**，请根据您的目标选择一个选项。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/add-analysis-rule.html)

1. 选择**下一步**。

1. 在**步骤 4: 查看并配置**下，查看您在之前的步骤中所做的选择，必要时进行编辑，然后选择**配置分析规则**。

您将看到一条确认消息，指出您成功为表配置了聚合分析规则。

## 为表添加列表分析规则（引导流程）
<a name="add-list-analysis-rule-console-wizard"></a>

*列表分析规则*支持输出关联表与可查询成员的表之间重叠情况行级列表的查询。

此过程描述了使用 AWS Clean Rooms 控制台中的 “**引导流程**” 选项将列表分析规则添加到配置的表中的过程。

**注意**  
使用非 S3 数据源的配置表仅支持[自定义分析规则](#add-custom-analysis-rule-wizard)。

**为表添加列表分析规则（引导流程）**

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

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

1. 选择配置表。

1. 在配置表详细信息页面上，选择**配置分析规则**。

1. 在 “**步骤 1：选择分析规则类型**” 下，在 “**分析规则类型**” 下，选择 “**列表**” 选项。

1. 在**创建方法**下，选择**引导流程**，然后选择**下一步**。

1. 在**步骤 2: 指定查询控制**下，对于**联接控制**：

   1. 在**指定联接列**下，选择要允许在 INNER JOIN 语句中使用的列。

   1. 在**指定允许的匹配运算符**下，选择哪些运算符（如果有）可用于在多个联接列上进行匹配。如果您选择两列或更多 JOIN 列，则需要其中一个运算符。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/add-analysis-rule.html)

1. *（可选）*对于**列表控制**，在**指定列表列**下拉列表中，选择要允许在查询输出中使用（即在 SELECT 语句中使用）或用于筛选结果（即 WHERE 语句）的列。

1. 选择**下一步**。

1. 在**步骤 3: 指定查询结果控制**下，对于**应用于输出的其他分析**，请根据您的目标选择一个选项。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/add-analysis-rule.html)

1. 在**步骤 4: 查看并配置**下，查看您在之前的步骤中所做的选择，必要时进行编辑，然后选择**配置分析规则**。

您将看到一条确认消息，指出您成功为表配置了列表分析规则。

## 为表添加自定义分析规则（引导流程）
<a name="add-custom-analysis-rule-wizard"></a>

自定义分析规则允许对已配置的表进行自定义 SQL 查询或 PySpark 作业。如果使用下列项，则需要自定义分析规则：
+ [分析模板](create-analysis-template.md)允许一组特定的预先批准的 SQL 查询或 PySpark 作业，或者一组可以提供使用您的数据的查询的特定帐户。
+ [AWS Clean Rooms 差异隐私](differential-privacy.md)，可防止用户识别尝试。
+ 非 S3 数据源，例如 Amazon Athena 或 Snowflake。

此过程描述了使用 AWS Clean Rooms 控制台中的 “**引导流程**” 选项将自定义分析规则添加到配置的表中的过程。

**为表添加自定义分析规则（引导流程）**

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

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

1. 选择配置表。

1. 在配置表详细信息页面上，选择**配置分析规则**。

1. 在 “**步骤 1：选择分析规则类型**” 下，在 “**分析规则类型**” 下，选择 “**自定义**” 选项。

1. 在**创建方法**下，选择**引导流程**，然后选择**下一步**。

1. 在 “**步骤 2：指定分析控件**” 下，对于**直接分析控件**，根据您的目标选择一个选项。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/add-analysis-rule.html)

1. 在 “**步骤 3：指定分析结果控件**” 下，

   1. 对于 **Job 结果控件**，请注意，不支持其他结果控件。

   1. 在 “**查询结果控件**” 下，对于 “**输出中不允许**的列”，根据您的目标选择要允许在查询输出中使用的列。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/add-analysis-rule.html)

   1. 对于**应用于输出的**其他分析，请根据您的目标选择是否可以将其他分析应用于查询输出。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/add-analysis-rule.html)

   1. 选择**下一步**。

1. （可选）在 “**步骤 4：设置差异隐私**” 下，确定是要开启还是关闭差异隐私。

   差别隐私是一种经过数学验证的技术，可以保护您的数据以免受到重新识别攻击。
**注意**  
AWS Clean Rooms 差异隐私仅适用于数据存储在 Amazon S3 中的协作。

   对于**差异隐私**，请根据您的目标选择是开启还是关闭差分隐私。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/add-analysis-rule.html)

1. 在**步骤 5: 查看并配置**下，查看您在之前的步骤中所做的选择，必要时进行编辑，然后选择**配置分析规则**。

您将看到一条确认消息，指出您成功为表配置了自定义分析规则。

## 为表添加分析规则（JSON 编辑器）
<a name="add-analysis-rule-console-json-editor"></a>

以下过程说明如何使用 AWS Clean Rooms 控制台中的 **JSON 编辑器**选项向表中添加分析规则。

**注意**  
使用非 S3 数据源的配置表仅支持[自定义分析规则](#add-custom-analysis-rule-wizard)。

**为表添加聚合、列表或自定义分析规则（JSON 编辑器）**

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

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

1. 选择配置表。

1. 在配置表详细信息页面上，选择**配置分析规则**。

1. 在 “**步骤 1：选择分析规则类型**” 下，在 “**分析规则类型**” 下，选择 “**聚合**”、“**列表**” 或 “**自定义**” 选项。

1. 在**创建方法**下，选择 **JSON 编辑器**，然后选择**下一步**。

1. 在**步骤 2: 指定控制**下，您可以选择插入查询结构（**插入模板**）或插入文件（**从文件导入**）。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/add-analysis-rule.html)

1. 选择**下一步**。

1. 在**步骤 3: 查看并配置**下，查看您在之前的步骤中所做的选择，必要时进行编辑，然后选择**配置分析规则**。

您将收到一条确认消息，指出您成功为表配置了分析规则。

## 后续步骤
<a name="add-analysis-rule-next-step"></a>

现在，您已经为配置表配置了分析规则，您已准备好：
+ [将配置表与协作关联](associate-configured-table.md)
+ [查询数据表](running-sql-queries.md)（以可以查询的成员身份）