比較コントロール

SQL では、リテラル比較は、データセットの列をクエリに直接入力されたリテラル値と照合します。列比較は、同じテーブル内または結合されたテーブル間で、2 つの異なる列の値を互いに照合します。

デフォルトの動作

比較コントロールは許可リストです。を設定するとallowedLiteralComparisonColumns、リストする列のみがリテラル値と比較され、リストしないすべての列がブロックされます。column-to-column比較allowedColumnComparisonColumnsの場合も同様です。一方の許可リストに列を追加しても、もう一方の許可リストには列は追加されません。

を設定しない場合comparisonControls、は比較制限 AWS Clean Rooms を適用しません。クエリは任意の列をリテラル値または別の列と比較できます。

を設定せずに最小集約しきい値を設定comparisonControlsした場合、比較は制限されません。ただし、でリストされている列でリテラル比較を許可 AWS Clean Rooms しないでくださいidentityColumns。この制限はしきい値自体から取得されるため、比較コントロールを設定するかどうかにかかわらず適用されます。詳細については、「最小集計しきい値」を参照してください。

許可されていない出力列comparisonControlsとともにを設定する場合、2 つのコントロールは独立しており、両方が適用されます。比較コントロールは、クエリが比較できる列を制御します。許可されていない出力列は、クエリ結果に表示される列を制御します。列は比較で許可でき、結果から除外されます。詳細については、「許可されない出力列」を参照してください。

リテラル比較

リテラル比較は、1 つのハードコードされた定数 (文字列、数値、または日付) に対して列を評価します。クエリの実行中に演算子の右側が変更されることはありません。構文の例は次のとおりです。

WHERE status = 'Active'
WHERE 料金 > 49.99

を使用する場合最小集計しきい値、 AWS Clean Rooms はidentityColumns値に対するリテラル比較を許可しません。これにより、クエリランナーが個々のユーザーまたは特定のユーザーのセットにフィルタリングされたクエリを送信できなくなります。小さなグループや個々のデータサブジェクトを除外できる低基数列でリテラル比較を許可しないでください。


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

リテラル比較用の列の選択

リテラル比較は、個人や小グループを識別しない列でのみ許可します。低カーディナリティ列 (age_band、粗いリージョンコードなど) で許可することは避けてください。これらの列は設定値ではありませんがidentityColumns、リテラルと比較すると、結果を小さく識別可能な母集団に絞り込むことができます。campaign_id やなどのカーディナリティが高く、識別できないディメンションproduct_skuの方が安全です。

例: キャンペーン列でのリテラル比較の許可

パブリッシャーは、すべての出力行が少なくとも 100 人の個別のユーザー () を表すように、最小集約しきい値でカスタム分析ルールを設定しますuser_id。広告主はこのテーブルに対してクエリを実行しますが、一度に 1 つのキャンペーンのリーチを測定するなど、分析の範囲を特定の広告キャンペーンに絞り込む必要があります。

user_id は ID 列であるため、リテラルと比較することはできません。これにより、広告主は結果を 1 人のユーザーにフィルタリングできなくなります。ただし、 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フィルタリングされます。2 番目のクエリは、個々のデータセットを分離しようとするため拒否されます。

列の比較

列比較では、1 つの行の値を別の列の値と動的に評価します。構文の例は次のとおりです。

WHERE retail_price < wholesale_price
WHERE users.id = orders.user_id

を使用する場合最小集計しきい値、データプロバイダーは、オーディエンスの重複レポートなど、テーブル間で結合する必要があるユースケースidentityColumnsの値の列比較を許可できます。


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

例: 重複レポートの ID 列で列比較を許可する

パブリッシャーとアドバタイザーは、対象者の重複、つまり両方のデータセットに表示されるユーザーの数を、個々のユーザーが誰であるかを知ることなく測定したいと考えています。これには、column-to-column比較である user_idの 2 つのテーブルを結合する必要があります。パブリッシャーは、特定のキャンペーン IDs を対象とする対象者の重複分析をアドバタイザーが実行できるようにします。

user_id は 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;

column-to-column比較は行ごとに動的に評価され、クエリランナーが既知の値をターゲットにしないため、結合は成功します。その結果、最小集計しきい値が適用され、少なくとも 100 人の個別のユーザーを表す場合にのみ重複カウントが返されます。2 番目のクエリは、 email がallowedColumnComparisonColumns許可リストに含まれておらず、比較に使用できないため、ブロックuser_idされます。