Regola di analisi di aggregazione

InAWS Clean Rooms, una regola di analisi di aggregazione genera statistiche aggregate utilizzando le funzioni COUNT, SUM e/o AVG insieme a dimensioni opzionali. Quando la regola di analisi di aggregazione viene aggiunta a una tabella configurata, consente al membro che può eseguire query sulla tabella configurata.

La regola di analisi di aggregazione supporta casi d'uso come la pianificazione delle campagne, la copertura dei media, la misurazione della frequenza e l'attribuzione.

La struttura e la sintassi delle query supportate sono definite in. Struttura e sintassi delle interrogazioni di aggregazione

I parametri della regola di analisi, definita inRegola di analisi dell'aggregazione: controlli di interrogazione, includono i controlli di interrogazione e i controlli dei risultati delle query. I suoi controlli di interrogazione includono la possibilità di richiedere che una tabella configurata sia aggiunta ad almeno una tabella configurata di proprietà del membro che può eseguire query, direttamente o in modo transitivo. Questo requisito ti consente di garantire che la query venga eseguita sull'intersezione (INNERJOIN) della tua tabella e della loro.

Struttura e sintassi delle interrogazioni di aggregazione

Le query su tabelle che dispongono di una regola di analisi di aggregazione devono rispettare la sintassi seguente.

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

Nella tabella seguente vengono illustrate tutte le espressioni elencate nella sintassi precedente.

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

Per quanto riguarda la struttura e la sintassi delle query di aggregazione, tieni presente quanto segue:

Regola di analisi dell'aggregazione: controlli di interrogazione

Con i controlli di interrogazione di aggregazione, puoi controllare come le colonne della tabella vengono utilizzate per interrogare la tabella. Ad esempio, è possibile controllare quale colonna viene utilizzata per l'unione, quale colonna può essere contata o quale colonna può essere utilizzata nelle WHERE istruzioni.

Nelle sezioni seguenti viene illustrato ogni controllo.

Controlli di aggregazione

Utilizzando i controlli di aggregazione, è possibile definire quali funzioni di aggregazione consentire e a quali colonne devono essere applicate. Le funzioni di aggregazione possono essere utilizzate nelle espressioni SELECTHAVING, e. ORDER BY

Unisci i controlli

Una JOIN clausola viene utilizzata per combinare righe di due o più tabelle, in base a una colonna correlata tra di esse.

È possibile utilizzare i controlli Join per controllare il modo in cui la tabella può essere unita ad altre tabelle in. table_expression AWS Clean Roomssupporta solo INNERJOIN. INNERJOINle istruzioni possono utilizzare solo colonne che sono state classificate in modo esplicito come una delle regole di analisi, joinColumn in base ai controlli definiti dall'utente.

INNERJOINDevono operare su una joinColumn tabella configurata e su un'altra tabella configurata nella collaborazione. joinColumn Sei tu a decidere quali colonne della tabella possono essere utilizzate comejoinColumn.

Ogni condizione di corrispondenza all'interno della ON clausola è richiesta per utilizzare la condizione di confronto di uguaglianza (=) tra due colonne.

Le condizioni di corrispondenza multiple all'interno di una ON clausola possono essere:

Di seguito è riportato un esempio di interrogazione con un operatore logicoAND.

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

Di seguito è riportato un esempio di interrogazione con un operatore OR logico.

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

Di seguito è riportato un esempio di transitività.

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

Controlli dimensionali

I controlli delle dimensioni controllano la colonna lungo la quale le colonne di aggregazione possono essere filtrate, raggruppate o aggregate.

Funzioni scalari

Le funzioni scalari controllano quali funzioni scalari possono essere utilizzate nelle colonne dimensionali.

Sono supportate le seguenti funzioni scalari:

Per maggiori dettagli, consulta AWS Clean RoomsSQL Reference.

Regola di analisi di aggregazione: controlli dei risultati delle query

Con i controlli dei risultati delle query di aggregazione, è possibile controllare quali risultati vengono restituiti specificando una o più condizioni che ogni riga di output deve soddisfare per poter essere restituita. AWS Clean Roomssupporta vincoli di aggregazione sotto forma di. COUNT (DISTINCT column) >= X Questo modulo richiede che ogni riga aggreghi almeno X valori distinti di una scelta dalla tabella configurata (ad esempio, un numero minimo di valori distinti). user_id Questa soglia minima viene applicata automaticamente, anche se la query inviata stessa non utilizza la colonna specificata. Vengono applicate collettivamente a ogni tabella configurata nell'interrogazione effettuata dalle tabelle configurate di ciascun membro della collaborazione.

Ogni tabella configurata deve avere almeno un vincolo di aggregazione nella regola di analisi. I proprietari delle tabelle configurate possono aggiungerne di più columnName e associarle minimum e vengono applicate collettivamente.

Vincoli di aggregazione

I vincoli di aggregazione controllano quali righe dei risultati della query vengono restituite. Per essere restituita, una riga deve soddisfare il numero minimo specificato di valori distinti in ogni colonna specificata nel vincolo di aggregazione. Questo requisito si applica anche se la colonna non è menzionata esplicitamente nella query o in altre parti della regola di analisi.

Struttura delle regole di analisi dell'aggregazione

L'esempio seguente mostra una struttura predefinita per una regola di analisi di aggregazione.

Nell'esempio seguente, MyTablefa riferimento alla tabella di dati. È possibile sostituire ogni segnaposto di input dell'utente con le proprie informazioni.

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

Regola di analisi dell'aggregazione: esempio

L'esempio seguente dimostra come due aziende possono collaborare AWS Clean Rooms utilizzando l'analisi di aggregazione.

L'azienda A dispone di dati sui clienti e sulle vendite. L'azienda A è interessata a comprendere l'attività di restituzione dei prodotti. La società B è uno dei rivenditori della società A e dispone di dati sui resi. La società B dispone inoltre di attributi di segmento relativi ai clienti utili all'azienda A (ad esempio, ha acquistato prodotti correlati, utilizza il servizio clienti del rivenditore). L'azienda B non desidera fornire dati sui resi dei clienti a livello di riga e informazioni sugli attributi. La società B desidera solo abilitare una serie di query per l'azienda A per ottenere statistiche aggregate sui clienti che si sovrappongono a una soglia minima di aggregazione.

La società A e la società B decidono di collaborare in modo che l'azienda A possa comprendere l'attività di restituzione dei prodotti e fornire prodotti migliori presso l'azienda B e altri canali.

Per creare la collaborazione ed eseguire un'analisi di aggregazione, le aziende eseguono le seguenti operazioni:

Risoluzione dei problemi relativi alle regole di analisi di aggregazione

Utilizza queste informazioni per aiutarti a diagnosticare e risolvere i problemi più comuni quando lavori con le regole di analisi di aggregazione.

La mia query non ha prodotto alcun risultato

Questo può accadere quando non ci sono risultati corrispondenti o quando i risultati corrispondenti non soddisfano una o più soglie minime di aggregazione.

Per ulteriori informazioni sulle soglie minime di aggregazione, consulta. Regola di analisi dell'aggregazione: esempio