彙總分析規則

在中AWS Clean Rooms，彙總分析規則會使用 COUNT、SUM 和/或 AVG 函數沿選用維度來產生彙總統計資料。將彙總分析規則新增至已設定的資料表時，可讓查詢的成員在已設定的資料表上執行查詢。

彙總分析規則支援宣傳活動規劃、媒體觸及率、頻率測量和歸因等使用案例。

支援的查詢結構和語法在中定義聚合查詢結構和語法。

中彙總分析規則-查詢控制項定義的分析規則參數包括查詢控制項和查詢結果控制項。其查詢控制項包括要求將已設定的資料表連結至少一個由成員擁有的已設定資料表，這些資料表可以直接或傳輸進行查詢。此要求允許您確保查詢在您的表和他們的交叉點 (INNERJOIN) 上運行。

聚合查詢結構和語法

對具有彙總分析規則的資料表進行查詢，必須遵循下列語法。

    --select_aggregate_function_expression
SELECT 
aggregation_function(column_name) [[AS] column_alias ] [, ...]

    --select_grouping_column_expression                        
  [, {column_name|scalar_function(arguments)} [[AS] column_alias ]][, ...]   

--table_expression
FROM table_name [[AS] table_alias ]
  [[INNER] JOIN table_name [[AS] table_alias] ON join_condition] [...]

--where_expression
[WHERE where_condition]          

--group_by_expression                          
[GROUP BY {column_name|scalar_function(arguments)}, ...]]                  

--having_expression
[HAVING having_condition]                               

--order_by_expression    
[ORDER BY {column_name|scalar_function(arguments)} [{ASC|DESC}]] [,...]]

下表說明上述語法中列出的每個運算式。

FROM consumer_table 
INNER JOIN provider_table
ON
consumer_table.identifier1 = provider_table.identifier1
AND
consumer_table.identifier2 = provider_table.identifier2

對於彙總查詢結構和語法，請注意下列事項：

彙總分析規則-查詢控制項

使用彙總查詢控制項，您可以控制如何使用資料表中的資料行來查詢資料表。例如，您可以控制哪個資料行用於聯結、哪個資料行可以計算，或是哪個資料行可用於WHERE陳述式。

以下各節將說明每個控制項。

彙總控制項

透過使用彙總控制項，您可以定義要允許哪些彙總函數，以及必須套用到哪些資料行。聚合函數可以在SELECT、HAVING和ORDERBY運算式中使用。

加入控制

一個JOIN子句用於從兩個或多個表，基於它們之間的相關列合併行。

您可以使用聯結控制項來控制如何將表格連接至中的其他表格table_expression。 AWS Clean Rooms僅支持INNERJOIN。 INNERJOIN陳述式只能使用已在分析規則joinColumn中明確分類為的欄 (視您定義的控制項而定)。

INNERJOIN必須joinColumn從您已配置的表格和協同作業joinColumn中另一個已配置的表格上進行操作。您可以決定表格中的哪些欄可用作joinColumn。

ON子句中的每個匹配條件都需要在兩列之間使用相等比較條件（=）。

條ON款中的多個比對條件可以是：

以下是具有AND邏輯運算子的查詢範例。

SELECT some_col, other_col 
FROM table1 
    JOIN table2 
    ON table1.id = table2.id AND table1.name = table2.name

以下是具有OR邏輯運算子的查詢範例。

SELECT some_col, other_col 
FROM table1 
    JOIN table2 
    ON table1.id = table2.id OR table1.name = table2.name

以下是傳遞性的一個例子。

ON 
my_table.identifer = third_party_table.identifier
....
ON
third_party_table.identifier = member_who_can_query_table.id

標註控制

維度控制項會控制可篩選、分組或彙總彙總資料欄的資料欄。

純量函數

純量函數控制哪些純量函數可以在維度列上使用。

支援下列純量函數：

如需詳細資訊，請參閱 AWS Clean RoomsSQL 參考。

彙總分析規則-查詢結果控制項

使用彙總查詢結果控制項，您可以指定每個輸出資料列必須符合才能傳回的一或多個條件，來控制要傳回的結果。 AWS Clean Rooms支援的形式的彙總限制COUNT (DISTINCT column) >= X。此表單要求每個資料列從已設定的資料表彙總至少 X 個不同選擇值 (例如，不同user_id值的最小數目)。即使提交的查詢本身並未使用指定的資料行，這個最小臨界值也會自動強制執行。它們會從協同合作中每個成員的已配置表格中，在查詢中的每個已配置表格中集體強制執行。

每個已配置的表格在其分析規則中必須至少有一個彙總條件約束。已配置的資料表擁有者可以新增多個columnNameminimum與相關聯的資料表擁有者，並

彙總約束

彙總條件約束可控制傳回查詢結果中的哪些資料列。若要傳回，資料列必須符合彙總條件約束中指定之每個資料行中不同值的指定最小數目。即使查詢或分析規則的其他部分未明確提及資料行，此需求也適用。

彙總分析規則結構

下列範例顯示彙總分析規則的預先定義結構。

在下面的例子中，MyTable是指您的數據表。您可以使用自己的資訊取代每個使用者輸入預留位置。

{
  "aggregateColumns": [
    {
      "columnNames": [MyTable column names], "function": [Allowed Agg Functions]
    },
  ],
  "joinRequired": ["QUERY_RUNNER"],  
  "joinColumns": [MyTable column names],
  "dimensionColumns": [MyTable column names],
  "scalarFunctions": [Allowed Scalar functions],
  "outputConstraints": [
    {
      "columnName": [MyTable column names], "minimum": [Numeric value] 
    },
  ]
}

彙總分析規則-範例

下面的例子演示了兩家公司如何AWS Clean Rooms使用聚合分析進行協作。

A 公司有客戶和銷售數據。A 公司有興趣了解產品退貨活動。B 公司是 A 公司的零售商之一，擁有退貨數據。B 公司還具有對 A 公司有用的客戶的節段屬性 (例如，已購買的相關產品，使用零售商的客戶服務)。B 公司不想提供資料列層級的客戶退貨資料和屬性資訊。B 公司只希望為 A 公司啟用一組查詢，以便以最小聚總閾值取得重疊客戶的彙總統計資料。

A 公司和 B 公司決定合作，以便 A 公司能夠了解產品退貨活動，並在 B 公司和其他渠道提供更好的產品。

若要建立協同作業並執行彙總分析，公司會執行下列動作：

疑難排解彙總分析規則問

使用此處的資訊可協助您診斷並修正使用彙總分析規則時的常見問題。

我的查詢沒有返回任何結果

當沒有相符結果，或符合結果不符合一或多個最小彙總閾值時，就會發生這種情況。

如需最小聚總臨界值的詳細資訊，請參閱彙總分析規則-範例。