Esempi di query query-examples
In questa sezione sono elencati diversi esempi comunemente utilizzati per eseguire query sugli eventi dei passaggi di Percorso in Data Lake.
Assicurati che i campi utilizzati nelle query abbiano valori associati nello schema corrispondente.
- id: univoco per tutte le voci evento del passaggio. Due eventi di passaggio diversi non possono avere lo stesso ID.
- instanceId: instanceID è lo stesso per tutti gli eventi di passaggio associati a un profilo all’interno di un’esecuzione di percorso. Se un profilo torna nel percorso, verrà utilizzato un instanceId diverso. Questo nuovo instanceId sarà lo stesso per tutti gli eventi di passaggio dell’istanza reinserita (dall’inizio alla fine).
- profileID: l’identità del profilo corrispondente allo spazio dei nomi del percorso.
note note |
---|
NOTE |
Per la risoluzione dei problemi, si consiglia di utilizzare journeyVersionID invece di journeyVersionName durante la query sui percorsi. Ulteriori informazioni sugli attributi delle proprietà del percorso in questa sezione. |
Casi d’uso di base/query comuni common-queries
accordion | ||
---|---|---|
Quanti profili sono stati inseriti in un percorso in un determinato intervallo di tempo | ||
Questa query fornisce il numero di profili distinti che sono entrati nel percorso specificato nell’intervallo di tempo specificato. Query Data Lake
Scopri come risolvere i problemi relativi ai tipi di evento eliminati in percorsi_step_events. |
Esempio
code language-sql |
---|
|
Query Data Lake
code language-sql |
---|
|
Query Data Lake
code language-sql |
---|
|
Query Data Lake
Questa query restituisce tutti gli eventi di passaggio e di servizio per il profilo e il percorso specificati per il tempo specificato in ordine cronologico.
code language-sql |
---|
|
Queste query possono essere utilizzate, ad esempio, per stimare il tempo trascorso in un’attività Attendi. Questo ti consente di verificare che l’attività Attendi sia configurata correttamente.
Query Data Lake
code language-sql |
---|
|
Query Data Lake
code language-sql |
---|
|
Il set di dati Eventi passaggio di Percorso contiene tutti gli eventi stepEvents e serviceEvents. stepGli eventi vengono utilizzati nel reporting in quanto si riferiscono ad attività (evento, azioni, ecc.) di profili in un percorso. serviceEvents sono memorizzati nello stesso set di dati e indicano informazioni aggiuntive a scopo di debug, ad esempio il motivo dell’eliminazione di un evento esperienza.
Di seguito è riportato un esempio di query per verificare i dettagli di un serviceEvent:
Query Data Lake
code language-sql |
---|
|
Errori messaggio/azione message-action-errors
accordion | ||||
---|---|---|---|---|
Elenco di ogni errore riscontrato nei percorsi | ||||
Questa query ti consente di elencare ogni errore riscontrato nei percorsi durante l’esecuzione di un messaggio/azione. Query Data Lake
Esempio
Questa query restituisce tutti i diversi errori che si sono verificati durante l’esecuzione di un’azione in un percorso, insieme al conteggio del numero di volte in cui si sono verificati. |
Query basate su profili profile-based-queries
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
Il risultato deve essere maggiore di 0. Questa query restituisce il numero esatto di volte in cui un profilo è entrato in un percorso.
Metodo 1: se il nome del messaggio non è univoco nel percorso (viene utilizzato in più posizioni).
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
Il risultato deve essere maggiore di 0. Questa query indica solo se l’azione del messaggio è stata eseguita correttamente sul lato percorso.
Metodo 2: se il nome del messaggio è univoco nel percorso.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
La query restituisce l’elenco di tutti i messaggi con il relativo conteggio richiamato per il profilo selezionato.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
La query restituisce l’elenco di tutti i messaggi con il relativo conteggio richiamato per il profilo selezionato.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
La query restituisce l'elenco di tutti i nomi di percorso insieme al numero di volte in cui il profilo sottoposto a query è entrato nel percorso.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
La query restituisce, per il periodo definito, il numero di profili che sono entrati nel percorso ogni giorno. Se un profilo immesso tramite più identità, verrà conteggiato due volte. Se è abilitata la rientrata, il conteggio dei profili potrebbe essere duplicato in giorni diversi se è rientrato nel percorso in un giorno diverso.
Scopri come risolvere i problemi relativi ai tipi di evento eliminati in percorsi_step_events.
Query relative al pubblico di lettura read-segment-queries
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
La query restituisce la differenza di tempo, espressa in minuti, tra il momento in cui il processo di esportazione del pubblico è stato messo in coda e il momento in cui è stato finalmente terminato.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
La query restituisce tutti gli ID profilo che sono stati scartati dal percorso perché erano duplicati.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
La query restituisce tutti gli ID profilo scartati dal percorso perché presentavano uno spazio dei nomi non valido o nessuna identità per tale spazio dei nomi.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
La query restituisce tutti gli ID profilo scartati dal percorso perché manca la mappa di identità.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
La query restituisce tutti gli ID profilo che sono stati scartati dal percorso perché il processo di esportazione è stato eseguito in modalità di test ma l’attributo testProfile del profilo non è stato impostato su true.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
La query restituisce tutti gli ID profilo scartati dal percorso a causa di un errore interno.
Query Data Lake
code language-sql |
---|
|
Verranno restituiti tutti gli eventi di servizio relativi alla versione di percorso specificata. Possiamo seguire la catena di operazioni:
- creazione di argomenti
- creazione di processi di esportazione
- terminazione del processo di esportazione (con metriche sui profili esportati)
- cessazione elaborazione lavoratore
Possiamo anche rilevare problemi come:
- errori nella creazione di processi di esportazione o argomento (inclusi timeout nelle chiamate API di esportazione del pubblico)
- processi di esportazione che possono essere bloccati (nel caso in cui per una determinata versione del percorso, non vi siano eventi relativi alla chiusura del processo di esportazione)
- problemi del lavoratore, se abbiamo ricevuto l'evento di cessazione del processo di esportazione ma nessun lavoratore ne elabora l'elaborazione uno
IMPORTANTE: se questa query non restituisce alcun evento, la causa potrebbe essere uno dei seguenti:
- la versione del percorso non ha raggiunto la pianificazione
- se la versione del percorso deve aver attivato il processo di esportazione chiamando l’orchestratore, si è verificato un errore nel flusso a monte: problema di implementazione del percorso, evento di business o problema con il modulo di pianificazione.
Query Data Lake
code language-sql |
---|
|
Query Data Lake
code language-sql |
---|
|
Se non viene restituito alcun record, significa che:
- si è verificato un errore durante la creazione dell’argomento o del processo di esportazione
- il processo di esportazione è ancora in esecuzione
Query Data Lake
code language-sql |
---|
|
Query Data Lake
code language-sql |
---|
|
Questa query è diversa dalla precedente.
Restituisce le metriche complessive per una determinata versione del percorso, indipendentemente dai processi che possono essere stati eseguiti per essa (in caso di percorsi ricorrenti, eventi di business attivati da quelli che sfruttano il riutilizzo degli argomenti).
Query relative alla qualifica del pubblico segment-qualification-queries
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
Questa query restituisce tutti gli ID profilo scartati dalla versione del percorso a causa di una realizzazione errata del pubblico.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
Questa query restituisce tutti gli eventi (eventi esterni/eventi di qualificazione del pubblico) che sono stati eliminati a causa di qualsiasi altro motivo per un profilo.
Query basate su eventi event-based-queries
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
Scopri come risolvere i problemi relativi ai tipi di evento eliminati in percorsi_step_events.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
Scopri come risolvere i problemi relativi ai tipi di evento eliminati in percorsi_step_events.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
Scopri come risolvere i problemi relativi ai tipi di evento eliminati in percorsi_step_events.
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
Scopri come risolvere i problemi relativi ai tipi di evento eliminati in percorsi_step_events.
Query comuni basate su percorso journey-based-queries
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
La query restituisce, per il periodo definito, il numero di percorsi univoci attivati ogni giorno. Un singolo percorso che si attiva su più giorni verrà conteggiato una volta al giorno.
Query su istanze di percorso journey-instances-queries
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|
Query Data Lake
code language-sql |
---|
|
Esempio
code language-sql |
---|
|