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.
NOTA
| Colonna | Descrizione |
|---|---|
| Nome | Il campo del nome corrisponde al nome del modello o ai primi caratteri della query SQL. Tutte le query create tramite l’interfaccia utente con l’editor delle query sono denominate all’inizio. Se la query è stata creata tramite l’API, il nome diventa un frammento dell’istruzione SQL iniziale utilizzata per creare la query. Per visualizzare un elenco di tutte le esecuzioni associate alla query, selezionare un elemento dalla colonna Nome. Per ulteriori informazioni, vedere la sezione query esegue dettagli pianificazione. |
| Modello | Nome del modello della query. Selezionate un nome di modello per passare all'editor di query. Il modello di query viene visualizzato nell’editor delle query per comodità. Se non è presente alcun nome di modello, la riga viene contrassegnata con un trattino e non è possibile reindirizzare all’editor delle query per visualizzare la query. |
| SQL | Frammento della query SQL. |
| Frequenza di esecuzione | La frequenza con cui la query è impostata per l'esecuzione. I valori disponibili sono Run once e Scheduled. |
| Creato da | Nome dell'utente che ha creato la query. |
| Creato | La marca temporale in formato UTC in cui è stata creata la query. |
| Timestamp ultima esecuzione | Il timestamp più recente in cui è stata eseguita la query. In questa colonna viene evidenziato se una query è stata eseguita in base alla pianificazione corrente. |
| Stato ultima esecuzione | Stato dell’esecuzione della query più recente. I valori di stato sono: Success, Failed, In progress e No runs. |
| Stato pianificazione |
Stato corrente della query pianificata. Sono disponibili sei valori potenziali: Registrazione, Attivo, Inattivo, Eliminato, un trattino e In quarantena.
|
SUGGERIMENTOPersonalizzare le impostazioni della tabella per le query pianificate
È 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 (
NOTA
Per rimuovere o aggiungere una colonna di tabella, attiva o disattiva le caselle di controllo corrispondenti. Quindi, seleziona Applica per confermare le scelte.
NOTA
Gestire le query pianificate con azioni in linea
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
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.
NOTAEliminare una query pianificata
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
Per sottoscrivere avvisi per l'esecuzione di query pianificate, selezionare ... (puntini di sospensione) o l'icona di sottoscrizione avviso (
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:
| Tipo di avviso | Descrizione |
|---|---|
start | Questo avviso avvisa quando viene avviata o avviata l'elaborazione di una query pianificata. |
success | Questo avviso informa l'utente quando una query pianificata viene eseguita correttamente, indicando che la query è stata eseguita senza errori. |
failed | Questo avviso viene attivato quando una query pianificata viene eseguita con un errore o non viene eseguita correttamente. Consente di identificare e risolvere tempestivamente i problemi. |
quarantine | Questo avviso viene attivato quando un’esecuzione di query pianificata viene messa in quarantena. Quando le query vengono registrate nella funzionalità di quarantena, qualsiasi query pianificata che non riesce a eseguire dieci esecuzioni consecutive viene automaticamente posta in stato Quarantined. Quindi richiedono il tuo intervento prima che possano aver luogo ulteriori esecuzioni. |
delay | Questo avviso notifica se si verifica un ritardo nell'esito di un'esecuzione di una query oltre la soglia specificata. È possibile impostare un'ora personalizzata che attivi l'avviso quando la query viene eseguita per tale durata senza completare o non riuscire. |
NOTAPer ulteriori informazioni, consulta la documentazione sulle sottoscrizioni di avvisi.
Visualizzare i dettagli della query
Selezionare l'icona delle informazioni (
Query in quarantena
NOTAQuando 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
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.
NOTA
Consulta la sezione abbonamento agli avvisi per scoprire come abbonarti agli avvisi Ritardo esecuzione query.
Filtrare le query
Puoi filtrare le query in base alla frequenza di esecuzione. Dalla scheda Query pianificate, seleziona l'icona 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.
NOTA
Dopo aver abilitato i criteri di filtro, seleziona Nascondi filtri per chiudere il pannello dei filtri.
La query esegue i dettagli della pianificazione
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.
| Nome colonna | Descrizione |
|---|---|
| ID esecuzione query | ID esecuzione query per l’esecuzione giornaliera. Selezionare ID esecuzione query per passare alla Panoramica esecuzione query. |
| Inizio esecuzione query | Il timestamp in cui è stata eseguita la query. Il timestamp è in formato UTC. |
| Esecuzione query completata | La marca temporale in cui è stata completata la query. Il timestamp è in formato UTC. |
| Stato | Stato dell’esecuzione della query più recente. I valori di stato sono: Success, Failed, In progress o Quarantined. |
| Set di dati | Il set di dati coinvolto nell’esecuzione. |
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.
