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.
Qual è la differenza tra ID, ID istanza e ID profilo
- 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
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
| code language-sql |
|---|
|
Scopri come risolvere i problemi relativi ai tipi di evento eliminati in percorsi_step_events.
Quale regola ha impedito l’ingresso di un profilo in un determinato percorso
Questa query restituisce il set di regole e le informazioni sulle regole rifiutate quando a un profilo viene impedito l’accesso a un percorso a causa di regole di limite o idoneità.
Esempio
| code language-sql |
|---|
|
Quanti errori si sono verificati in ogni nodo di un percorso specifico per un determinato periodo di tempo
Questa query conta i profili distinti che hanno riscontrato errori in ciascun nodo di un percorso, raggruppati per nome di nodo. Include tutti i tipi di errori di esecuzione delle azioni e di recupero.
Query Data Lake
| code language-sql |
|---|
|
Quanti eventi sono stati eliminati da un percorso specifico in un determinato intervallo di tempo
Questa query conta il numero totale di eventi eliminati da un percorso. Filtra vari codici evento di eliminazione, tra cui errori del processo di esportazione del segmento, scartamenti del dispatcher e scartamenti della macchina dello stato.
Query Data Lake
| code language-sql |
|---|
|
Cosa succede a un profilo specifico in un percorso specifico in un intervallo di tempo specifico
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.
Query Data Lake
| code language-sql |
|---|
|
Tempo trascorso tra due nodi
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 |
|---|
|
Controllare i dettagli di un serviceEvent
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
Trovare se un profilo è stato immesso in un Percorso specifico
Questa query controlla se un profilo specifico è stato inserito in un percorso contando gli eventi associati a tale combinazione di profilo e percorso.
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.
Trovare se un profilo ha ricevuto un messaggio specifico
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.
Trova tutti i messaggi ricevuti da un profilo negli ultimi 30 giorni
Questa query recupera tutte le azioni di messaggio eseguite correttamente per un profilo specifico negli ultimi 30 giorni, raggruppate per nome del messaggio.
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.
Trova tutti i percorsi inseriti da un profilo negli ultimi 30 giorni
Questa query restituisce tutti i percorsi immessi da un profilo specifico negli ultimi 30 giorni, insieme al conteggio delle voci per ogni percorso.
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.
Numero di profili idonei per un percorso giornaliero
Questa query fornisce un raggruppamento giornaliero del numero di profili distinti che sono entrati in un percorso in un determinato periodo di tempo.
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
Tempo impiegato per completare un processo di esportazione del pubblico
Questa query calcola la durata di un processo di esportazione del pubblico rilevando la differenza di tempo tra il momento in cui il processo è stato messo in coda e quello in cui è stato completato.
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.
Numero di profili scartati dal percorso perché duplicati
Questa query conta il numero di profili distinti che sono stati eliminati a causa di errori di duplicazione delle istanze durante l’attività Read Audience.
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.
Numero di profili eliminati dal percorso a causa di uno spazio dei nomi non valido
Questa query restituisce il numero di profili scartati perché presentavano uno spazio dei nomi non valido o un’identità mancante per lo spazio dei nomi richiesto.
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.
Numero di profili scartati dal percorso perché nessuna mappa di identità
Questa query conta i profili scartati perché mancava una mappa di identità necessaria per l’esecuzione del percorso.
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à.
Numero di profili scartati dal percorso perché il percorso si trovava nel nodo di test e il profilo non era un profilo di test
Questa query identifica i profili scartati quando il percorso era in esecuzione in modalità di test, ma per il profilo non era impostato l’attributo testProfile su true.
Query Data Lake
| code language-sql |
|---|
|
Esempio
| code language-sql |
|---|
|
La query restituisce tutti gli ID profilo 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.
Numero di profili eliminati dal percorso a causa di un errore interno
Questa query restituisce il numero di profili che sono stati eliminati a causa di errori di sistema interni durante l’esecuzione del percorso.
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.
Panoramica del pubblico di lettura per una determinata versione del percorso
Questa query fornisce una panoramica completa dell’attività Read Audience, inclusi i dettagli del processo di esportazione dei segmenti, i codici evento, gli stati e i conteggi dei profili per tutte le fasi del processo di esportazione del pubblico.
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.
Errori di lettura del pubblico per una determinata versione del percorso
Questa query filtra i codici evento di errore specifici correlati agli errori Read Audience, come gli errori di creazione di argomenti, di chiamata API, i timeout e i processi di esportazione non riusciti.
Query Data Lake
| code language-sql |
|---|
|
Ottieni stato elaborazione processo di esportazione
Questa query recupera lo stato di elaborazione dei processi di esportazione del pubblico, mostrando se hanno avuto esito positivo o negativo insieme alle metriche di esportazione del profilo.
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
Ottieni metriche sui profili esportati, compresi gli scarti e le metriche dei processi di esportazione per ogni processo di esportazione
Questa query combina i conteggi dei profili scartati con le metriche dei processi di esportazione per fornire una visualizzazione completa delle prestazioni di esportazione del pubblico per ogni singolo processo di esportazione.
Query Data Lake
| code language-sql |
|---|
|
Ottieni metriche aggregate (processi di esportazione e scarti del pubblico) su tutti i processi di esportazione
Questa query aggrega le metriche generali in tutti i processi di esportazione per una determinata versione del percorso, utili per percorsi ricorrenti o percorsi attivati da eventi business con riutilizzo degli argomenti.
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
Profilo scartato a causa di una realizzazione del pubblico diversa da quella configurata
Questa query identifica i profili scartati perché il loro stato di realizzazione del pubblico non corrisponde alla configurazione di Qualificazione del pubblico del percorso (ad esempio, configurato per "entrate" ma profilo "uscito").
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.
Eventi di qualificazione del pubblico eliminati per qualsiasi altro motivo per un profilo specifico
Questa query recupera tutte le qualifiche del pubblico o gli eventi esterni scartati per un profilo specifico a causa di errori del servizio interno.
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
Verifica se è stato ricevuto un evento di business per un percorso
Questa query conta quante volte un evento di business è stato ricevuto da un percorso, raggruppato per data, entro un intervallo di tempo specificato.
Query Data Lake
| code language-sql |
|---|
|
Esempio
| code language-sql |
|---|
|
Controlla se un evento esterno di un profilo è stato eliminato perché non è stato trovato alcun percorso correlato
Questa query identifica quando un evento esterno per un profilo specifico è stato scartato perché non vi era alcun percorso attivo o corrispondente configurato per ricevere tale evento.
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.
Controlla se un evento esterno di un profilo è stato scartato per qualsiasi altro motivo
Questa query recupera gli eventi esterni scartati per un profilo specifico a causa di errori del servizio interno, insieme all’ID evento e al codice di errore.
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.
Controllare il conteggio di tutti gli eventi eliminati da stateMachine tramite errorCode
Questa query aggrega tutti gli eventi eliminati dal computer dello stato del percorso, raggruppati per codice di errore per identificare i motivi più comuni degli scarti.
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.
Controlla tutti gli eventi scartati perché il rientro non era consentito
Questa query identifica tutti gli eventi scartati perché un profilo ha tentato di entrare nuovamente in un percorso quando il rientro non era consentito nella configurazione del percorso.
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
Numero di percorsi attivi giornalieri
Questa query restituisce un conteggio giornaliero di versioni univoche del percorso con attività, che consente di comprendere i pattern di esecuzione del percorso nel tempo.
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
Numero di profili in uno stato specifico per un tempo specifico
Questa query utilizza espressioni di tabella comuni (CTE, Common Table Expression) per identificare i profili attualmente in attesa in un nodo specifico di un percorso, individuando i profili passati attraverso il nodo ma non ancora passati ai nodi successivi.
Query Data Lake
| code language-sql |
|---|
|
Esempio
| code language-sql |
|---|
|
Quanti profili sono usciti dal percorso nello specifico periodo di tempo
Questa query conta le istanze di percorso che sono uscite durante un determinato periodo di tempo, comprese le uscite dovute a completamento, errori, timeout o errori di limitazione.
Query Data Lake
| code language-sql |
|---|
|
Esempio
| code language-sql |
|---|
|
Quanti profili sono usciti dal percorso nello specifico periodo di tempo con nodo/stato
Questa query fornisce un’analisi dettagliata delle uscite di percorso, mostrando il nome del nodo e lo stato di uscita per ogni istanza uscita per aiutare a identificare dove e perché i profili hanno lasciato il percorso.
Query Data Lake
| code language-sql |
|---|
|
Esempio
| code language-sql |
|---|
|
Query relative alle metriche delle prestazioni Azione personalizzata query-custom-action
Numero totale di chiamate, errori e richieste riuscite al secondo di ciascun endpoint in un periodo di tempo specifico
Questa query fornisce metriche delle prestazioni per le azioni HTTP personalizzate, tra cui chiamate totali, chiamate riuscite, conteggi di errori per tipo (4xx, 5xx, timeout, limitate) e velocità effettiva nelle richieste al secondo per ogni endpoint.
Query Data Lake
| code language-sql |
|---|
|
Esempio
| code language-sql |
|---|
|
Serie temporale di chiamate riuscite, errori e velocità effettiva di ciascun endpoint in un periodo di tempo specifico
Questa query fornisce le stesse metriche delle prestazioni della query precedente, ma è organizzata come una serie temporale, mostrando come le prestazioni degli endpoint variano nel tempo con granularità minuto per minuto.
Query Data Lake
| code language-sql |
|---|
|
Esempio
| code language-sql |
|---|
|
Latenza di risposta di ciascun endpoint al 50°, 95°, 99° e 99,9° percentile in un periodo di tempo specifico
Questa query calcola i percentili del tempo di risposta per gli endpoint di azione personalizzati, consentendoti di comprendere la distribuzione della latenza e identificare i valori anomali delle prestazioni con soglie percentili diverse.
Query Data Lake
| code language-sql |
|---|
|
Esempio
| code language-sql |
|---|
|
Serie temporale dei percentili della latenza di risposta di ciascun endpoint in un periodo di tempo specifico
Questa query fornisce percentili di latenza organizzati come serie temporali, che consentono di monitorare come i tempi di risposta degli endpoint cambiano nel tempo a diversi livelli percentili.
Query Data Lake
| code language-sql |
|---|
|
Esempio
| code language-sql |
|---|
|
Tempo di attesa in coda sugli endpoint limitati al 50° e 95° percentile in un periodo di tempo specifico
Questa query analizza i tempi di attesa in coda per gli endpoint limitati, mostrando i tempi di attesa del 50° e del 95° percentile per aiutarti a comprendere l’impatto della limitazione sulle azioni personalizzate.
Query Data Lake
| code language-sql |
|---|
|
Esempio
| code language-sql |
|---|
|
Serie temporale dei percentili del tempo di attesa della coda per ogni endpoint limitato
Questa query fornisce percentili del tempo di attesa della coda come serie temporale, consentendoti di monitorare l’impatto della limitazione sui tempi di attesa nel tempo per ogni endpoint.
Query Data Lake
| code language-sql |
|---|
|
Esempio
| code language-sql |
|---|
|
Numero di errori per tipo e codice per un endpoint specifico in un periodo di tempo specifico
Questa query fornisce una suddivisione dettagliata degli errori per un endpoint specifico, raggruppati per tipo di errore e codice di errore, incluse informazioni sui tentativi.
Query Data Lake
| code language-sql |
|---|
|
Esempio
| code language-sql |
|---|
|
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76