Regel für die Aggregationsanalyse

In AWS Clean Rooms generiert eine Aggregationsanalyseregel aggregierte Statistiken mithilfe der Funktionen COUNT, SUM und and/or AVG anhand optionaler Dimensionen. Wenn die Aggregationsanalyseregel zu einer konfigurierten Tabelle hinzugefügt wird, ermöglicht sie dem Mitglied, das Abfragen durchführen kann, Abfragen in der konfigurierten Tabelle auszuführen.

Die Aggregationsanalyseregel unterstützt Anwendungsfälle wie Kampagnenplanung, Medienreichweite, Frequenzmessung und Zuordnung.

Die unterstützte Abfragestruktur und Syntax sind in definiert. Struktur und Syntax von Aggregationsabfragen

Zu den Parametern der Analyseregel, die in definiert sindRegel für die Aggregationsanalyse — Steuerelemente abfragen, gehören Abfragesteuerelemente und Steuerelemente für Abfrageergebnisse. Zu den Abfragesteuerelementen gehört die Möglichkeit, zu verlangen, dass eine konfigurierte Tabelle mit mindestens einer konfigurierten Tabelle verknüpft wird, deren Eigentümer das Mitglied ist, das Abfragen entweder direkt oder transitiv durchführen kann. Mit dieser Anforderung können Sie sicherstellen, dass die Abfrage an der Schnittstelle (INNERJOIN) zwischen Ihrer und ihrer Tabelle ausgeführt wird.

Struktur und Syntax von Aggregationsabfragen

Abfragen in Tabellen, für die eine Aggregationsanalyseregel gilt, müssen der folgenden Syntax entsprechen.

--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}]] [,...]]

In der folgenden Tabelle werden alle in der vorherigen Syntax aufgeführten Ausdrücke erklärt.

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

Beachten Sie bei der Struktur und Syntax von Aggregationsabfragen Folgendes:

Regel für die Aggregationsanalyse — Steuerelemente abfragen

Mit Steuerelementen für Aggregationsabfragen können Sie steuern, wie die Spalten in Ihrer Tabelle zur Abfrage der Tabelle verwendet werden. Sie können beispielsweise steuern, welche Spalte für die Verknüpfung verwendet wird, welche Spalte gezählt werden kann oder welche Spalte in WHERE Anweisungen verwendet werden kann.

In den folgenden Abschnitten werden die einzelnen Steuerelemente erläutert.

Steuerelemente für die Aggregation

Mithilfe von Aggregationssteuerelementen können Sie definieren, welche Aggregationsfunktionen zulässig sind und auf welche Spalten sie angewendet werden müssen. Aggregationsfunktionen können in den Ausdrücken SELECTHAVING, und verwendet werden. ORDER BY

Steuerelemente verbinden

Eine JOIN Klausel wird verwendet, um Zeilen aus zwei oder mehr Tabellen auf der Grundlage einer zugehörigen Spalte miteinander zu kombinieren.

Mithilfe von Join-Steuerelementen können Sie steuern, wie Ihre Tabelle mit anderen Tabellen in der verknüpft werden kanntable_expression. AWS Clean Rooms unterstützt nur INNERJOIN. INNERJOINAnweisungen können nur Spalten verwenden, die joinColumn in Ihrer Analyseregel explizit als a kategorisiert wurden, und zwar vorbehaltlich der von Ihnen definierten Kontrollen.

Sie INNER JOIN müssen mit einer Tabelle joinColumn aus Ihrer konfigurierten Tabelle und mit einer Tabelle joinColumn aus einer anderen konfigurierten Tabelle in der Kollaboration arbeiten. Sie entscheiden, als welche Spalten aus Ihrer Tabelle verwendet werden könnenjoinColumn.

Jede Übereinstimmungsbedingung innerhalb der ON Klausel muss die Gleichheitsvergleichsbedingung (=) zwischen zwei Spalten verwenden.

Es können mehrere Übereinstimmungsbedingungen innerhalb einer ON Klausel sein:

Das Folgende ist ein Beispiel für eine Abfrage mit einem AND logischen Operator.

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

Das Folgende ist ein Beispiel für eine Abfrage mit einem OR logischen Operator.

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

Im Folgenden finden Sie ein Beispiel für Transitivität.

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

Steuerelemente für Dimensionen

Dimensionssteuerelemente steuern die Spalte, anhand derer die Aggregationsspalten gefiltert, gruppiert oder aggregiert werden können.

Skalarfunktionen

Skalarfunktionen steuern, welche Skalarfunktionen für Dimensionsspalten verwendet werden können.

Die folgenden Skalarfunktionen werden unterstützt:

Weitere Informationen finden Sie in der AWS Clean Rooms SQL-Referenz.

Regel für die Aggregationsanalyse — Steuerelemente für Abfrageergebnisse

Mit den Steuerelementen für Aggregationsabfrageergebnisse können Sie steuern, welche Ergebnisse zurückgegeben werden, indem Sie eine oder mehrere Bedingungen angeben, die jede Ausgabezeile erfüllen muss, damit sie zurückgegeben wird. AWS Clean Rooms unterstützt Aggregationseinschränkungen in der Form von. COUNT (DISTINCT column) >= X Dieses Formular erfordert, dass jede Zeile mindestens X verschiedene Werte einer Auswahl aus Ihrer konfigurierten Tabelle aggregiert (z. B. eine Mindestanzahl von unterschiedlichen user_id Werten). Dieser Mindestschwellenwert wird automatisch durchgesetzt, auch wenn die übermittelte Abfrage selbst die angegebene Spalte nicht verwendet. Sie werden gemeinsam für jede konfigurierte Tabelle in der Abfrage anhand der konfigurierten Tabellen aller Mitglieder der Kollaboration durchgesetzt.

Jede konfigurierte Tabelle muss mindestens eine Aggregationsbeschränkung in ihrer Analyseregel enthalten. Besitzer konfigurierter Tabellen können mehrere columnName und zugeordnete Tabellen hinzufügen, minimum und sie werden gemeinsam durchgesetzt.

Einschränkungen bei der Aggregation

Aggregationseinschränkungen steuern, welche Zeilen in den Abfrageergebnissen zurückgegeben werden. Um zurückgegeben zu werden, muss eine Zeile die angegebene Mindestanzahl an unterschiedlichen Werten in jeder Spalte erfüllen, die in der Aggregationsbeschränkung angegeben ist. Diese Anforderung gilt auch dann, wenn die Spalte in der Abfrage oder in anderen Teilen der Analyseregel nicht ausdrücklich erwähnt wird.

Struktur der Regeln für die Aggregationsanalyse

Das folgende Beispiel zeigt eine vordefinierte Struktur für eine Aggregationsanalyseregel.

MyTableBezieht sich im folgenden Beispiel auf Ihre Datentabelle. Sie können jede Information user input placeholder durch Ihre eigenen Informationen ersetzen.

{
  "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] 
    },
  ]
}

Regel für die Aggregationsanalyse — Beispiel

Das folgende Beispiel zeigt, wie zwei Unternehmen AWS Clean Rooms mithilfe der Aggregationsanalyse zusammenarbeiten können.

Unternehmen A verfügt über Kunden- und Vertriebsdaten. Unternehmen A ist daran interessiert, die Aktivitäten zur Produktrückgabe zu verstehen. Unternehmen B ist einer der Einzelhändler von Unternehmen A und verfügt über Rückgabedaten. Unternehmen B verfügt auch über Segmentattribute für Kunden, die für Unternehmen A nützlich sind (z. B. ähnliche Produkte gekauft, den Kundendienst des Einzelhändlers in Anspruch genommen). Unternehmen B möchte keine Kundenrückgabedaten und Attributinformationen auf Zeilenebene bereitstellen. Unternehmen B möchte nur eine Reihe von Abfragen für Unternehmen A aktivieren, um aggregierte Statistiken über sich überschneidende Kunden bei einem Mindestaggregationsschwellenwert zu erhalten.

Unternehmen A und Unternehmen B beschließen, zusammenzuarbeiten, damit Unternehmen A die Produktrückgabeaktivitäten nachvollziehen und bessere Produkte für Unternehmen B und andere Vertriebskanäle liefern kann.

Um die Zusammenarbeit aufzubauen und eine Aggregationsanalyse durchzuführen, gehen die Unternehmen wie folgt vor:

Behebung von Problemen mit Regeln für die Aggregationsanalyse

Verwenden Sie die Informationen hier, um häufig auftretende Probleme bei der Arbeit mit Aggregationsanalyseregeln zu diagnostizieren und zu beheben.

Meine Abfrage lieferte keine Ergebnisse

Dies kann passieren, wenn es keine passenden Ergebnisse gibt oder wenn die übereinstimmenden Ergebnisse einen oder mehrere Mindestaggregationsschwellenwerte nicht erreichen.

Weitere Informationen zu Mindestschwellenwerten für die Aggregation finden Sie unter. Regel für die Aggregationsanalyse — Beispiel