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

Scheda Query pianificate nellarea di lavoro Query con query pianificate evidenziate.

La tabella seguente descrive ogni colonna disponibile.

NOTE
Icona di notifica sottoscrizioni ( Icona di notifica sottoscrizioni. ) è contenuto in ogni riga di una colonna senza titolo. Per ulteriori informazioni, consulta la sezione iscrizioni agli avvisi.
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.

  • 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.
TIP
Se si passa all'Editor query, è possibile selezionare Query per tornare alla scheda Modelli.

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 ( Icona delle impostazioni. ) in alto a destra nella schermata.

NOTE
La colonna Creato che fa riferimento alla data di creazione della pianificazione è nascosta per impostazione predefinita.

Scheda Query pianificate con licona Personalizza impostazioni tabella evidenziata.

Per rimuovere o aggiungere una colonna di tabella, attiva o disattiva le caselle di controllo corrispondenti. Quindi, seleziona Applica per confermare le scelte.

NOTE
Qualsiasi query creata tramite l’interfaccia utente diventa un modello denominato come parte del processo di creazione. Il nome del modello viene visualizzato nella colonna del modello. Se la query è stata creata tramite l’API, la colonna del modello è vuota.

Finestra di dialogo Personalizza impostazioni tabella.

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.

Scheda Query pianificate con i puntini di sospensione delle azioni in linea e il menu popup evidenziati.

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.

NOTE
Se una query è stata messa in quarantena, è necessario esaminare l'istruzione SQL del modello prima di abilitarne la pianificazione. In questo modo si evita lo spreco di ore di calcolo se la query del modello presenta ancora problemi.

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.

Scheda Query pianificate con una query pianificata eliminata ed evidenziata licona di sottoscrizione avviso disattivata.

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 ( 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.

Larea di lavoro delle query pianificate con i puntini di sospensione, licona di sottoscrizione degli avvisi e il menu a discesa delle azioni in linea evidenziato.

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.

Finestra di dialogo Sottoscrizioni avvisi.

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.
NOTE
Per ricevere notifiche sulle esecuzioni delle query in quarantena, è necessario innanzitutto registrare le esecuzioni delle query pianificate nella funzionalità di quarantena.

Per ulteriori informazioni, consulta la documentazione sulle sottoscrizioni di avvisi.

Visualizzare i dettagli della query query-details

Selezionare l'icona delle informazioni ( Unicona 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.

Scheda Query pianificate con licona delle informazioni e il pannello dei dettagli evidenziati.

Query in quarantena quarantined-queries

NOTE
L’avviso di quarantena non è disponibile per le query ad hoc "run-once". L’avviso di quarantena è applicabile solo per le query batch pianificate (CTAS e ITAS).

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.

Scheda Query pianificate con i puntini di sospensione e Attiva quarantena evidenziati dal menu a discesa delle azioni in linea.

È 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.

NOTE
Un'esecuzione di una query può avere un solo ritardo. Se modifichi la soglia di ritardo, questa viene modificata per l’utente abbonato all’avviso e per l’intera organizzazione.

Finestra di dialogo Avvisi nella scheda delle query pianificate con il campo di input del ritardo dellesecuzione della query evidenziato.

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 ( Icona del filtro ) per aprire la barra laterale del filtro.

Scheda Query pianificate con licona del filtro evidenziata.

Per filtrare l'elenco delle query in base alla frequenza di esecuzione, selezionare le caselle di controllo filtro Pianificato o Esegui una volta.

NOTE
Qualsiasi query eseguita ma non pianificata può essere eseguita una volta.

Scheda Query pianificate con la barra laterale del filtro evidenziata.

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.

Pagina dei dettagli della pianificazione.

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.

La pagina dei dettagli della pianificazione con il pannello delle proprietà evidenziato.

Selezionare un ID esecuzione query per passare alla pagina dei dettagli esecuzione e visualizzare le informazioni sulla query.

La schermata dei dettagli della pianificazione con un ID esecuzione evidenziato.

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 schermata dei dettagli dellesecuzione con la sezione panoramica evidenziata.

La sezione sullo stato della query fornisce il codice di errore e il messaggio di errore in caso di errore della query.

La schermata dei dettagli dellesecuzione con la sezione errori evidenziata.

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.

La schermata dei dettagli dellesecuzione con licona Copia SQL evidenziata.

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.

NOTE
I dettagli di esecuzione di un blocco anonimo che utilizza il comando DROP not verranno segnalati come sottoquery separata. Sono disponibili dettagli di esecuzione separati per le query CTAS, le query ITAS e le istruzioni COPY utilizzate come sottoquery di blocco anonime. I dettagli di esecuzione del comando DROP non sono attualmente supportati.

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.

La panoramica dellesecuzione della query visualizza una query di blocco anonima. Sono evidenziate più schede di query.

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.

La panoramica dellesecuzione della query visualizza una query di blocco anonima con il codice di errore per un singolo blocco evidenziato.

Seleziona Query per tornare alla schermata dei dettagli della pianificazione oppure Query pianificate per tornare alla scheda Query pianificate.

Schermata dei dettagli dellesecuzione con Query evidenziata.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb