彙總分析規則

在 中 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 僅支援 INNER JOIN。 INNERJOIN陳述式只能使用在分析規則joinColumn中明確分類為 的資料欄，但需受您定義的控制項所限制。

INNER JOIN 必須在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 Rooms SQL 參考。

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

使用彙總查詢結果控制項，您可以指定每個輸出列必須符合的一或多個條件來控制傳回的結果。 AWS Clean Rooms 支援 形式的彙總限制COUNT (DISTINCT column) >= X。此表單要求每一列至少從您設定的資料表彙總 X 個不同的值 （例如，最低數量的不同user_id值）。即使提交的查詢本身未使用指定的資料欄，系統也會自動強制執行此最低閾值。它們會在協同合作中每個成員所設定資料表的查詢中，於每個已設定的資料表中共同強制執行。

每個設定的資料表在其分析規則中必須至少有一個彙總限制條件。已設定的資料表擁有者可以新增多個 columnName 和關聯minimum，而且它們會集體強制執行。

彙總限制

彙總限制控制查詢結果中傳回哪些資料列。若要傳回，資料列必須符合彙總限制中指定之每個資料欄中指定的相異值下限。即使查詢或分析規則的其他部分未明確提及資料欄，此要求也適用。

彙總分析規則結構

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

在下列範例中， 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 公司和其他管道交付更好的產品。

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

對彙總分析規則問題進行故障診斷

當您使用彙總分析規則時，請使用此處的資訊來協助您診斷和修正常見問題。

我的查詢未傳回任何結果

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

如需最低彙總閾值的詳細資訊，請參閱彙總分析規則 - 範例。