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

比较控件

在 SQL 中，文字比较将数据集中的一列与直接键入到查询中的文字值进行匹配。列比较将来自两个不同列的值相互匹配，无论是在同一个表中还是在联接的表中。

默认 行为

比较控件是一个允许列表。设置后allowedLiteralComparisonColumns，只能将列出的列与文字值进行比较，并且您未列出的每列都会被屏蔽。这同样适用于列与列allowedColumnComparisonColumns的比较。将一列添加到一个许可列表不会将其添加到另一个许可列表中。

如果您未进行配置comparisonControls，则不 AWS Clean Rooms 应用任何比较限制，查询可以将任何列与文字值或另一列进行比较。

如果您未配置comparisonControls但设置了最低聚合阈值，则比较将不受其他限制。但是， AWS Clean Rooms 决不允许对中identityColumns列出的列进行字面比较。该限制来自阈值本身，因此无论您是否配置比较控件，它都适用。有关更多信息，请参阅 最低聚合阈值。

如果将不允许的输出列comparisonControls一起配置，则这两个控件是独立的，并且都适用。比较控件控制查询可以比较哪些列；不允许的输出列决定哪些列可以出现在查询结果中。在比较中可以允许某一列，但仍不允许显示在结果中。有关更多信息，请参阅 不允许的输出列。

字面比较

文字比较根据单个硬编码常量（字符串、数字或日期）对列进行评估。在查询执行期间，运算符的右侧永远不会改变。语法示例包括：

使用时最低聚合阈值， AWS Clean Rooms 不允许对identityColumns值进行文字比较。这可以防止查询运行器提交向下筛选的个人或特定用户组的查询。避免允许对可能挑出小组或单个数据主体的低基数列进行文字比较。

{
  "comparisonControls": {
    "allowedLiteralComparisonColumns": [
      "status",
      "price"
    ]
  }
}

示例：允许对广告系列专栏进行字面比较

发布者使用最低聚合阈值配置自定义分析规则，以便每个输出行代表至少 100 个不同的用户 (user_id)。广告商根据此表进行查询，但需要将分析范围限定为特定的广告活动，例如，一次衡量一个广告活动的覆盖面。

由于user_id是身份列，因此无法将其与文字进行比较，这使广告商无法将结果筛选到单个用户。但是campaign_id和event_date是高基数、不可识别的维度，因此发布商将它们添加到其中allowedLiteralComparisonColumns，这使广告商可以按广告系列进行筛选，并将分析范围缩小到某个日期范围：

{
  "aggregationThresholds": [
    {
      "identityColumns": ["user_id"],
      "minimumIdentityCount": 100
    }
  ],
  "comparisonControls": {
    "allowedLiteralComparisonColumns": ["campaign_id", "event_date"]
  }
}

鉴于前面的配置，允许以下查询：

-- Allowed: campaign_id and event_date are both in allowedLiteralComparisonColumns
SELECT campaign_id, COUNT(DISTINCT user_id) AS reach
FROM impressions
WHERE campaign_id = 'CMP-1024'
  AND event_date >= '2026-01-01'
GROUP BY campaign_id;

如果配置相同，则此查询会被阻止：

-- Blocked: user_id is the identity column and can never be compared to a literal
SELECT campaign_id, COUNT(DISTINCT user_id) AS reach
FROM impressions
WHERE user_id = 'U-88231'
GROUP BY campaign_id;

第一个查询仍然只返回由至少 100 个不同用户支持的行，而文字比较campaign_id和event_date筛选了考虑哪些行。第二个查询被拒绝，因为它试图挑出单个数据主体。

栏目对比

列比较会针对每行动态评估一列的值与另一列的值。语法示例包括：

使用时最低聚合阈值，数据提供者可以允许对需要跨表联接的用例（例如受众重叠报告）的identityColumns值进行列比较。

{
  "comparisonControls": {
    "allowedColumnComparisonColumns": [
      "user_id"
    ]
  }
}

示例：允许对重叠报告的标识列进行列比较

出版商和广告商希望衡量其受众重叠程度，即两个数据集中出现的用户数量，而双方都不想知道任何个人用户是谁。这需要将两个表连接起来user_id，这是一种列与列的比较。发布商允许广告商进行针对特定广告活动 ID 的受众重叠分析。

因为user_id是身份列，出版商已经屏蔽了对该列的文字比较（因此没有人可以筛选到特定的人）。要启用跨表联接，发布者会添加user_id到allowedColumnComparisonColumns。要启用广告活动筛选，发布商会添加campaign_id到allowedLiteralComparisonColumns。

{
  "aggregationThresholds": [
    {
      "identityColumns": ["user_id"],
      "minimumIdentityCount": 100
    }
  ],
  "comparisonControls": {
    "allowedLiteralComparisonColumns": ["campaign_id"],
    "allowedColumnComparisonColumns": ["user_id"]
  }
}

鉴于前面的配置，允许以下查询：

-- Allowed: user_id is compared against another column (column-to-column join)
SELECT COUNT(DISTINCT p.user_id) AS overlapping_users
FROM publisher_audience p
  JOIN advertiser_audience a
ON p.user_id = a.user_id;

如果配置相同，则此查询会被阻止：

-- Blocked: email is not in allowedColumnComparisonColumns
SELECT COUNT(DISTINCT p.user_id) AS overlapping_users
FROM publisher_audience p
  JOIN advertiser_audience a
  ON p.email = a.email;

联接之所以成功，是因为列与列的比较是对每行进行动态评估，并且不让查询运行器将目标设定为已知值。结果强制执行最低聚合阈值，确保仅当重叠数代表至少 100 个不同用户时才返回重叠数。第二个查询被屏蔽，因为email不在allowedColumnComparisonColumns许可名单中，也不能用于比较，user_id只能使用。

比较控件和表达式

比较控件遵循间接文字比较，而不仅仅是直接WHEREcolumn = 'literal'谓词。如果您允许ANY_EXPRESSION内部聚合函数通过allowedAggregateExpressionType，则比较控件仍会阻止对不在allowedLiteralComparisonColumns的列上进行文字比较。即使文字嵌套在表达式中，这也适用。

以下示例显示了一个由于zip_code不在许可列表中而仍处于屏蔽状态的查询，尽管该字面量位于CASE表达式内而不是作为直接谓词编写：

-- Blocked: zip_code is not in allowedLiteralComparisonColumns,
-- even though the literal comparison is nested inside a CASE expression
SELECT SUM(CASE WHEN zip_code = '00001' THEN salary ELSE 0 END) AS total
FROM employees;

这就是为什么这两个控件是互补的：允许在聚合体内使用表达式可以拓宽查询的计算范围，而比较控件仍然限制查询可以按值挑出哪些列。有关更多信息，请参阅 允许在聚合函数中嵌套表达式。