Linee guida generali per l'esecuzione delle query in Query Service

Questo documento descrive dettagli importanti da conoscere durante la scrittura di query in Adobe Experience Platform Query Service.

Per informazioni dettagliate sulla sintassi SQL utilizzata in Query Service, leggere la documentazione relativa alla sintassi SQL.

Modelli di esecuzione delle query

In Adobe Experience Platform Query Service sono disponibili due modelli di esecuzione delle query: interattivo e non interattivo. L’esecuzione interattiva viene utilizzata per lo sviluppo delle query e la generazione di rapporti negli strumenti di business intelligence, mentre la modalità non interattiva viene utilizzata per processi e query operative di grandi dimensioni come parte di un flusso di lavoro di elaborazione dei dati.

Esecuzione di query interattive

Le query possono essere eseguite in modo interattivo inviandole tramite l'interfaccia utente Query Service o tramite un client connesso. Quando si esegue Query Service tramite un client connesso, viene eseguita una sessione attiva tra il client e Query Service fino a quando non viene restituita la query inviata o si verifica un timeout.

L’esecuzione di query interattive presenta le seguenti limitazioni:

Per impostazione predefinita, i risultati delle query interattive vengono restituiti al client e sono non persistenti. Per mantenere i risultati come set di dati in Experience Platform, la query deve utilizzare la sintassi CREATE TABLE AS SELECT.

Esecuzione di query non interattiva

Le query inviate tramite l'API Query Service vengono eseguite in modo non interattivo. L'esecuzione non interattiva indica che Query Service riceve la chiamata API ed esegue la query nell'ordine in cui viene ricevuta. Le query non interattive generano sempre un nuovo set di dati in Experience Platform per la ricezione dei risultati o l'inserimento di nuove righe in un set di dati esistente.

Accesso a un campo specifico all’interno di un oggetto

Per accedere a un campo all'interno di un oggetto nella query, è possibile utilizzare la notazione del punto (.) o la notazione della parentesi quadra ([]). L'istruzione SQL seguente utilizza la notazione del punto per passare dall'oggetto endUserIds all'oggetto mcid.

SELECT endUserIds._experience.mcid
FROM {ANALYTICS_TABLE_NAME}
WHERE endUserIds._experience.mcid IS NOT NULL
AND TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 1

L'istruzione SQL seguente utilizza la notazione tra parentesi per scorrere l'oggetto endUserIds fino all'oggetto mcid.

SELECT endUserIds['_experience']['mcid']
FROM {ANALYTICS_TABLE_NAME}
WHERE endUserIds._experience.mcid IS NOT NULL
AND TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 1

Entrambe le query di esempio di cui sopra restituiscono un oggetto appiattito, anziché un singolo valore:

              endUserIds._experience.mcid
--------------------------------------------------------
 (48168239533518554367684086979667672499,"(ECID)",true)
(1 row)

L'oggetto endUserIds._experience.mcid restituito contiene i valori corrispondenti per i seguenti parametri:

Quando la colonna viene dichiarata solo per l'oggetto, restituisce l'intero oggetto come stringa. Per visualizzare solo l’ID, utilizza:

SELECT endUserIds._experience.mcid.id
FROM {ANALYTICS_TABLE_NAME}
WHERE endUserIds._experience.mcid IS NOT NULL
AND TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 1

     endUserIds._experience.mcid.id
----------------------------------------
 48168239533518554367684086979667672499
(1 row)

Virgolette

Le virgolette singole, le virgolette doppie e le virgolette posteriori hanno utilizzi diversi nelle query di Query Service.

Virgolette singole

Virgolette singole (') utilizzate per creare stringhe di testo. Può essere ad esempio utilizzato nell'istruzione SELECT per restituire un valore di testo statico nel risultato e nella clausola WHERE per valutare il contenuto di una colonna.

La query seguente dichiara un valore di testo statico ('datasetA') per una colonna:

SELECT
  'datasetA',
  timestamp,
  web.webPageDetails.name
FROM {ANALYTICS_TABLE_NAME}
WHERE TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10

Nella query seguente viene utilizzata una stringa tra virgolette singole ('homepage') nella clausola WHERE per restituire eventi per una pagina specifica.

SELECT
  timestamp,
  endUserIds._experience.mcid.id
FROM {ANALYTICS_TABLE_NAME}
WHERE web.webPageDetails.name = 'homepage'
AND TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10

Virgolette doppie

Virgolette doppie (") utilizzate per dichiarare un identificatore con spazi.

La query seguente utilizza le virgolette doppie per restituire i valori dalle colonne specificate quando una colonna contiene uno spazio nel relativo identificatore:

SELECT
  no_space_column,
  "space column"
FROM
( SELECT
    'column1' as no_space_column,
    'column2' as "space column"
)

Virgolette posteriori

Le virgolette posteriori ` vengono utilizzate per l'escape dei nomi di colonna riservati only quando si utilizza la sintassi di notazione del punto. Ad esempio, poiché order è una parola riservata in SQL, è necessario utilizzare le virgolette per accedere al campo commerce.order:

SELECT
  commerce.`order`
FROM {ANALYTICS_TABLE_NAME}
WHERE TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10

Le virgolette posteriori vengono inoltre utilizzate per accedere a un campo che inizia con un numero. Ad esempio, per accedere al campo 30_day_value, è necessario utilizzare la notazione delle virgolette posteriori.

SELECT
    commerce.`30_day_value`
FROM {ANALYTICS_TABLE_NAME}
WHERE TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10

Le virgolette posteriori sono non necessarie se si utilizza la notazione tra parentesi quadre.

 SELECT
  commerce['order']
 FROM {ANALYTICS_TABLE_NAME}
 WHERE TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
 LIMIT 10

Visualizzazione delle informazioni della tabella

Dopo la connessione a Query Service, puoi visualizzare tutte le tabelle disponibili su Platform utilizzando i comandi \d o SHOW TABLES.

Vista tabella standard

Il comando \d mostra la vista standard PostgreSQL per l'elenco delle tabelle. Di seguito è riportato un esempio dell'output di questo comando:

             List of relations
 Schema |       Name      | Type  |  Owner
--------+-----------------+-------+----------
 public | luma_midvalues  | table | postgres
 public | luma_postvalues | table | postgres
(2 rows)

Vista tabella dettagliata

Il comando SHOW TABLES è un comando personalizzato che fornisce informazioni più dettagliate sulle tabelle. Di seguito è riportato un esempio dell'output di questo comando:

       name      |        dataSetId         |     dataSet    | description | resolved
-----------------+--------------------------+----------------+-------------+----------
 luma_midvalues  | 5bac030c29bb8d12fa992e58 | Luma midValues |             | false
 luma_postvalues | 5c86b896b3c162151785b43c | Luma midValues |             | false
(2 rows)

Informazioni schema

Per visualizzare informazioni più dettagliate sugli schemi all'interno della tabella, è possibile utilizzare il comando \d {TABLE_NAME}, dove {TABLE_NAME} è il nome della tabella di cui si desidera visualizzare le informazioni sullo schema.

L'esempio seguente mostra le informazioni sullo schema per la tabella luma_midvalues, che verrebbero visualizzate utilizzando \d luma_midvalues:

                         Table "public.luma_midvalues"
      Column       |             Type            | Collation | Nullable | Default
-------------------+-----------------------------+-----------+----------+---------
 timestamp         | timestamp                   |           |          |
 _id               | text                        |           |          |
 productlistitems  | anyarray                    |           |          |
 commerce          | luma_midvalues_commerce     |           |          |
 receivedtimestamp | timestamp                   |           |          |
 enduserids        | luma_midvalues_enduserids   |           |          |
 datasource        | datasource                  |           |          |
 web               | luma_midvalues_web          |           |          |
 placecontext      | luma_midvalues_placecontext |           |          |
 identitymap       | anymap                      |           |          |
 marketing         | marketing                   |           |          |
 environment       | luma_midvalues_environment  |           |          |
 _experience       | luma_midvalues__experience  |           |          |
 device            | device                      |           |          |
 search            | search                      |           |          |

È inoltre possibile ottenere ulteriori informazioni su una colonna specifica aggiungendo il nome della colonna al nome della tabella. Scritto nel formato \d {TABLE_NAME}_{COLUMN}.

L'esempio seguente mostra informazioni aggiuntive per la colonna web e verrebbe richiamato utilizzando il comando seguente: \d luma_midvalues_web:

                 Composite type "public.luma_midvalues_web"
     Column     |               Type                | Collation | Nullable | Default
----------------+-----------------------------------+-----------+----------+---------
 webpagedetails | luma_midvalues_web_webpagedetails |           |          |
 webreferrer    | web_webreferrer                   |           |          |

Unione di set di dati

Puoi unire più set di dati per includere nella query dati provenienti da altri set di dati.

L'esempio seguente unisce i due set di dati seguenti (your_analytics_table e custom_operating_system_lookup) e crea un'istruzione SELECT per i primi 50 sistemi operativi in base al numero di visualizzazioni di pagina.

Query

SELECT
  b.operatingsystem AS OperatingSystem,
  SUM(a.web.webPageDetails.pageviews.value) AS PageViews
FROM your_analytics_table a
     JOIN custom_operating_system_lookup b
      ON a._experience.analytics.environment.operatingsystemID = b.operatingsystemid
WHERE TIMESTAMP >= TO_TIMESTAMP('2018-01-01') AND TIMESTAMP <= TO_TIMESTAMP('2018-12-31')
GROUP BY OperatingSystem
ORDER BY PageViews DESC
LIMIT 50;

Risultati

Deduplica

Query Service supporta la deduplicazione dei dati o la rimozione di righe duplicate dai dati. Per ulteriori informazioni sulla deduplicazione, leggere la Guida alla deduplicazione di Query Service.

Calcoli del fuso orario in Query Service

Query Service standardizza i dati persistenti in Adobe Experience Platform utilizzando il formato di marca temporale UTC. Per ulteriori informazioni su come tradurre il requisito del fuso orario da e verso un timestamp UTC, consulta la sezione Domande frequenti su come modificare il fuso orario da e verso un timestamp UTC.

Passaggi successivi

La lettura di questo documento ha introdotto alcune importanti considerazioni durante la scrittura di query tramite Query Service. Per ulteriori informazioni su come utilizzare la sintassi SQL per scrivere query personalizzate, leggere la documentazione sulla sintassi SQL.

Per ulteriori esempi di query che possono essere utilizzate in Query Service, consulta la seguente documentazione sul caso d’uso: