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

# 最低聚合阈值
<a name="custom-min-agg-thresholds"></a>

数据聚合是一种增强隐私的技术，它通过防止查询返回有关个人或小群体的结果来帮助强制匿名化。在表上配置了最小聚合阈值时，会 AWS Clean Rooms 抑制不符合数据提供者指定的最小阈值的结果。

**Topics**
+ [聚合阈值](#custom-min-agg-aggregation-thresholds)
+ [覆盖特定输出列的最小聚合阈值](#custom-min-agg-output-override)
+ [允许在聚合函数中嵌套表达式](#custom-min-agg-nested-expressions)
+ [在控制台中配置最低聚合阈值](#custom-min-agg-console)
+ [注意事项和限制](#custom-min-agg-considerations)

## 聚合阈值
<a name="custom-min-agg-aggregation-thresholds"></a>

您可以在自定义分析规则中为配置的表配置最小聚合阈值。数据提供者指定`identityColumns`和`minimumIdentityCount`，N。支持的值介于 `minimumIdentityCount` 2 到 100,000 之间。该`identityColumns`值必须是`string``varchar`、或`char`类型。最低聚合阈值可确保 SQL 查询结果中的每一行至少有 N 个不同的数据主体参与其中。有关如何与查询过滤器`identityColumns`交互的信息，请参阅[比较控件](custom-comparison-controls.md)。

以下示例将最小聚合阈值设置为 100`user_id`，并将其作为`identityColumns`值：

```
{
  "aggregationThresholds": [
    {
      "identityColumns": [
        "user_id"
      ],
      "minimumIdentityCount": 100,
      "type": "COUNT_DISTINCT"
    }
  ]
}
```

## 覆盖特定输出列的最小聚合阈值
<a name="custom-min-agg-output-override"></a>

输出列具有不同的敏感度级别，数据提供者可以根据输出列强制执行不同的`minimumIdentityCount`值。例如，`campaign_id`可能是低敏感度列，其最小阈值为 5 个不同的数据主体，`postal_code`而`income_bracket`由于它们是高敏感度列，因此其最低阈值为 100。

每列覆盖接受`0`，这使该输出列免于最小聚合，或介于 2 到 100,000 之间的值。

以下示例为该`campaign_id`列设置了最低聚合阈值覆盖：

```
{
  "outputColumnThresholds": [
    {
      "outputColumnName": "campaign_id",
      "minimumIdentityCount": 5
    }
  ]
}
```

## 允许在聚合函数中嵌套表达式
<a name="custom-min-agg-nested-expressions"></a>

允许在聚合函数内使用表达式会增加在无尘室查询中重新识别数据主体的风险。的默认设置`allowedAggregateExpressionType`为`COLUMNS_ONLY`，建议将其作为隐私增强配置。使用此设置，聚合函数中仅接受列，例如：
+ SUM（成本）
+ COUNT(DISTINCTcampaign\_id)

或者，对于查询运行器是可信合作伙伴的协作，您可以允许`ANY_EXPRESSION`在聚合函数内部。此设置提高了可在您的数据上运行的 SQL 查询的灵活性，但会带来隐私风险，因为查询运行器可以在聚合函数中隔离小组。

**需要进行隐私和合规审查**  
在允许`ANY_EXPRESSION`内部聚合职能部门之前，请咨询您的隐私、安全、法律和合规团队，以确保这符合您组织的要求。

以下是聚合函数中通常被认为安全的表达式的示例：
+ SUM（成本 \* 数量）

以下是聚合函数中被视为隐私风险的表达式示例：
+ SUM(CASEWHENzip\_code = '10001' THEN 工资 0) ELSE END

以下是一个完整的`aggregationThresholds`示例：

```
{
  "aggregationThresholds": [
    {
      "identityColumns": [
        "user_id"
      ],
      "minimumIdentityCount": 100,
      "type": "COUNT_DISTINCT",
      "allowedAggregateExpressionType": "COLUMNS_ONLY",
      "outputColumnThresholds": [
        {
          "outputColumnName": "campaign_id",
          "minimumIdentityCount": 5
        }
      ]
    }
  ]
}
```

## 在控制台中配置最低聚合阈值
<a name="custom-min-agg-console"></a>

在配置的表存在之后，您可以将最小聚合阈值配置为向配置表添加自定义分析规则的一部分。有关完整的自定义分析规则指导流程，请参阅[为表添加自定义分析规则（引导流程）](add-analysis-rule.md#add-custom-analysis-rule-wizard)。

**配置最低聚合阈值**

1. 登录 AWS 管理控制台 并打开 AWS Clean Rooms 控制台，地址为[https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home)。

1. 在左侧导航窗格中，选择 “**表”**，然后选择您配置的表。

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

1. 对于**分析规则类型**，选择**自定义**。

1. 选择 “**查看每项新分析” ** 或 “**允许特定合作者**进行任何分析”。其余步骤遵循 “**允许特定合作者进行任何分析” ** 路径。

1. 选择**添加 AWS 账户**以配置哪些合作伙伴可以在此配置表上提交分析，然后选择 AWS 账户 允许。

1. 在 ** “指定分析结果控件-可选” ** 中，对于 “**强制执行聚合阈值？”**，选择 “**是” **。

1. 配置最低聚合阈值。

   1. 选择您的身份列。标识列必须为`string``varchar`、或`char`类型。

   1. 指定您的最低身份人数。支持的值介于 2 到 100,000 之间。

   1. **聚合类型**已预先配置为不重复****计数。

1. 对于**允许在聚合函数中嵌套表达式？**，默认为 “**否” **。关闭此选项是隐私增强配置。有关更多信息，请参阅 [允许在聚合函数中嵌套表达式](#custom-min-agg-nested-expressions)。

1. （可选）配置输出列覆盖。

   1. 选择 “**添加列覆盖” **。

   1. 从下拉列表中选择您的输出列。

   1. 指定您的最低身份人数。支持的值是`0`免除该列的最小聚合值，或介于 2 到 100,000 之间。

   有关更多信息，请参阅 [覆盖特定输出列的最小聚合阈值](#custom-min-agg-output-override)。

1. （推荐）配置允许比较的列。

   1. 默认情况下，所有列都有资格进行比较。明确配置允许对哪些列进行文字和列间比较是增强隐私的配置。

   1. 选择 “**自定义列表” **。

   1. 选择允许对哪些列进行文字比较。例如，允许该`state`列允许查询运行器使用文字过滤器运行查询，例如`WHERE state = 'New York'`。

   1. 选择哪些列可用于列与列的比较。例如，允许该`state`列允许查询运行器通过列比较来运行跨表联接，例如`JOIN my_table t ON t.state = partner_table.state`。

   有关更多信息，请参阅 [比较控件](custom-comparison-controls.md)。

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

1. 选择**下一步**。差分隐私已关闭，不支持最低聚合阈值或比较控件。有关更多信息，请参阅 [限制](custom-considerations.md#custom-limitations)。

1. 查看您的自定义分析规则配置。

1. 选择**配置分析规则**。

1. 将配置的表关联到协作。有关更多信息，请参阅 [步骤 2：关联已配置的表](associate-configured-table.md#associate-config-table)。

## 注意事项和限制
<a name="custom-min-agg-considerations"></a>

使用最低聚合阈值时，需要注意事项和限制。完整列表请参阅 [注意事项和限制](custom-considerations.md)。