Monitorare le query pianificate
Adobe Experience Platform fornisce una migliore visibilità dello stato di tutti i processi di query tramite l’interfaccia utente. Dalla scheda Query pianificate è ora possibile trovare informazioni importanti sulle esecuzioni delle query, inclusi lo stato, i dettagli della pianificazione e i messaggi/codici di errore in caso di esito negativo. Puoi anche abbonarti agli avvisi per le query in base al loro stato tramite l'interfaccia utente per una di queste query tramite la scheda Query pianificate.
Query pianificate
La scheda Query pianificate fornisce una panoramica di tutte le query CTAS e ITAS pianificate. È possibile trovare i dettagli di esecuzione per tutte le query pianificate, nonché i codici di errore e i messaggi per eventuali query non riuscite.
Per passare alla scheda Query pianificate, seleziona Query dalla barra di navigazione a sinistra, quindi Query pianificate
La tabella seguente descrive ogni colonna disponibile.
Run once
e Scheduled
.Success
, Failed
, In progress
e No runs
.Stato corrente della query pianificata. Sono disponibili sei valori potenziali: Registrazione, Attivo, Inattivo, Eliminato, un trattino e In quarantena.
- Lo stato Registrazione indica che il sistema sta ancora elaborando la creazione della nuova pianificazione per la query. Non è possibile disattivare o eliminare una query pianificata durante la registrazione.
- Lo stato Attivo indica che la query pianificata ha non ancora superato la data e l'ora di completamento.
- Lo stato Inattiva indica che la query pianificata ha passato la data e l'ora di completamento o è stata contrassegnata da un utente come inattiva.
- Lo stato Eliminato indica che la pianificazione della query è stata eliminata.
- Il trattino indica che la query pianificata è una query occasionale non ricorrente.
- Lo stato In quarantena indica che la query non è riuscita per dieci esecuzioni consecutive e richiede l'intervento dell'utente prima che possano essere eseguite ulteriori esecuzioni.
Personalizzare le impostazioni della tabella per le query pianificate customize-table
È possibile modificare le colonne nella scheda Query pianificate in base alle proprie esigenze. Per aprire la finestra di dialogo delle impostazioni di Personalizza tabella e modificare le colonne disponibili, selezionare l'icona delle impostazioni ( ) in alto a destra nella schermata.
Per rimuovere o aggiungere una colonna di tabella, attiva o disattiva le caselle di controllo corrispondenti. Quindi, seleziona Applica per confermare le scelte.
Gestire le query pianificate con azioni in linea inline-actions
La visualizzazione Query pianificate offre diverse azioni in linea per gestire tutte le query pianificate da un'unica posizione. Le azioni in linea sono indicate con puntini di sospensione in ogni riga. Selezionare i puntini di sospensione di una query pianificata che si desidera gestire per visualizzare le opzioni disponibili in un menu a comparsa. Le opzioni disponibili includono Disabilita pianificazione o Abilita pianificazione, Elimina pianificazione, Abbonati per eseguire query sugli avvisi e Abilita o Disabilita quarantena.
Disattivare o attivare una query pianificata disable
Per disabilitare una query pianificata, selezionare i puntini di sospensione per la query pianificata che si desidera gestire, quindi selezionare Disabilita pianificazione dalle opzioni del menu a comparsa. Viene visualizzata una finestra di dialogo per confermare l’azione. Seleziona Disattiva per confermare l'impostazione.
Dopo aver disabilitato una query pianificata, puoi abilitare la pianificazione attraverso lo stesso processo. Seleziona i puntini di sospensione, quindi seleziona Abilita pianificazione tra le opzioni disponibili.
Eliminare una query pianificata delete
Per eliminare una query pianificata, selezionare i puntini di sospensione per la query pianificata che si desidera gestire, quindi selezionare Elimina pianificazione dalle opzioni del menu a comparsa. Viene visualizzata una finestra di dialogo per confermare l’azione. Seleziona Elimina per confermare l'impostazione.
Una volta eliminata, la query pianificata viene non rimossa dall'elenco delle query pianificate. Le azioni in linea fornite dai puntini di sospensione vengono rimosse e sostituite dall’icona di aggiunta avviso disattivata. Non è possibile sottoscrivere avvisi per la pianificazione eliminata. La riga rimane nell’interfaccia utente per fornire informazioni sulle esecuzioni eseguite come parte della query pianificata.
Se si desidera pianificare le esecuzioni per tale modello di query, selezionare il nome del modello dalla riga appropriata per passare all'editor di query, quindi seguire le istruzioni per aggiungere una pianificazione a una query come descritto nella documentazione.
Iscriversi agli avvisi alert-subscription
Per sottoscrivere avvisi per l'esecuzione di query pianificate, selezionare ...
(puntini di sospensione) o l'icona di sottoscrizione avviso (
) per la query pianificata da gestire. Viene visualizzato il menu a discesa delle azioni in linea. Selezionare Sottoscrivi tra le opzioni disponibili.
Viene visualizzata la finestra di dialogo Avvisi. La finestra di dialogo Avvisi ti sottoscrive sia alle notifiche dell'interfaccia utente che agli avvisi e-mail. Sono disponibili diverse opzioni di sottoscrizione degli avvisi: start
, success
, failure
, quarantine
e delay
. Seleziona la casella o le caselle appropriate e seleziona Salva per iscriverti.
La tabella seguente spiega i tipi di avviso per le query supportati:
start
success
failed
quarantine
delay
Per ulteriori informazioni, consulta la documentazione sulle sottoscrizioni di avvisi.
Visualizzare i dettagli della query query-details
Selezionare l'icona delle informazioni ( ) per visualizzare il pannello dei dettagli della query. Il pannello dei dettagli contiene tutte le informazioni rilevanti sulla query oltre ai fatti inclusi nella tabella delle query pianificate. Le informazioni aggiuntive includono l’ID della query, la data dell’ultima modifica, l’SQL della query, l’ID della pianificazione e la pianificazione del set corrente.
Query in quarantena quarantined-queries
Quando ci si iscrive alla funzione di quarantena, qualsiasi query pianificata che non supera dieci esecuzioni consecutive viene automaticamente messa in quarantena. Una query con questo stato diventa inattiva e non viene eseguita alla frequenza pianificata. Quindi richiede il tuo intervento prima che possano aver luogo ulteriori esecuzioni. In questo modo vengono salvaguardate le risorse di sistema in quanto è necessario esaminare e correggere i problemi con l’SQL prima di eseguire ulteriori esecuzioni.
Per abilitare una query pianificata per la funzionalità di quarantena, selezionare i puntini di sospensione (...
) seguiti da Attiva quarantena dal menu a discesa visualizzato.
È inoltre possibile registrare le query nella funzione di quarantena durante il processo di creazione della pianificazione. Per ulteriori informazioni, consulta la documentazione sulle pianificazioni delle query.
Ritardo esecuzione query query-run-delay
Tieni sotto controllo le ore di calcolo impostando avvisi per i ritardi nelle query. Puoi monitorare le prestazioni delle query e ricevere notifiche se lo stato di una query rimane invariato dopo un determinato periodo. Utilizzare l'avviso 'Ritardo esecuzione query' per ricevere una notifica se una query continua a essere elaborata dopo un periodo di tempo specifico senza essere stata completata.
Quando sottoscrivi avvisi per le esecuzioni pianificate delle query, uno degli avvisi disponibili è Ritardo esecuzione query. Questo avviso richiede di impostare una soglia per il tempo di esecuzione, nel qual caso viene inviata una notifica del ritardo nell’elaborazione.
Per scegliere una durata di soglia che attivi la notifica, immettere un numero nel campo di immissione testo o utilizzare le frecce su e giù per aumentare di un minuto. Poiché la soglia è impostata in minuti, la durata massima per osservare un ritardo di esecuzione di una query è di 1440 minuti (24 ore). Il periodo di tempo predefinito per un ritardo di esecuzione è di 150 minuti.
Consulta la sezione abbonamento agli avvisi per scoprire come abbonarti agli avvisi Ritardo esecuzione query.
Filtrare le query filter
Puoi filtrare le query in base alla frequenza di esecuzione. Dalla scheda Query pianificate, seleziona l'icona del filtro ( ) per aprire la barra laterale del filtro.
Per filtrare l'elenco delle query in base alla frequenza di esecuzione, selezionare le caselle di controllo filtro Pianificato o Esegui una volta.
Dopo aver abilitato i criteri di filtro, seleziona Nascondi filtri per chiudere il pannello dei filtri.
La query esegue i dettagli della pianificazione query-runs
Per aprire la pagina dei dettagli della pianificazione, selezionare un nome di query dalla scheda Query pianificate. Questa vista fornisce un elenco di tutte le esecuzioni eseguite come parte della query pianificata. Le informazioni fornite includono l’ora di inizio e di fine, lo stato e il set di dati utilizzati.
Queste informazioni sono fornite in una tabella a cinque colonne. Ogni riga indica un’esecuzione di query.
Success
, Failed
, In progress
o Quarantined
.I dettagli della query pianificata sono visibili nel pannello Proprietà. Questo pannello include l’ID della query iniziale, il tipo di client, il nome del modello, l’SQL della query e la frequenza della pianificazione.
Selezionare un ID esecuzione query per passare alla pagina dei dettagli esecuzione e visualizzare le informazioni sulla query.
Panoramica dell’esecuzione delle query query-run-overview
La Panoramica sull'esecuzione delle query fornisce informazioni sulle singole esecuzioni per questa query pianificata e un raggruppamento più dettagliato dello stato di esecuzione. Questa pagina include anche le informazioni sul client e i dettagli di eventuali errori che potrebbero aver causato l’esito negativo della query.
La sezione sullo stato della query fornisce il codice di errore e il messaggio di errore in caso di errore della query.
Da questa vista è possibile copiare l'istruzione SQL per query negli Appunti. Per copiare la query, selezionare l'icona Copia in alto a destra del frammento SQL. Un messaggio a comparsa conferma che il codice è stato copiato.
Eseguire i dettagli per le query con blocco anonimo anonymous-block-queries
Le query che utilizzano blocchi anonimi per comporre le istruzioni SQL vengono separate nelle singole sottoquery. La separazione in sottoquery consente di esaminare singolarmente i dettagli di esecuzione per ogni blocco di query.
I blocchi anonimi vengono identificati tramite l'utilizzo di un prefisso $$
prima della query. Per ulteriori informazioni sui blocchi anonimi nel servizio query, vedere il documento blocco anonimo.
Le sottoquery di blocco anonime dispongono di schede a sinistra dello stato di esecuzione. Selezionare una scheda per visualizzare i dettagli dell'esecuzione.
Nel caso in cui una query di blocco anonimo non riesca, puoi trovare il codice di errore per quel particolare blocco tramite questa interfaccia utente.
Seleziona Query per tornare alla schermata dei dettagli della pianificazione oppure Query pianificate per tornare alla scheda Query pianificate.