Pianificazioni query

Puoi automatizzare l’esecuzione delle query creando pianificazioni di query. Le query pianificate vengono eseguite su una frequenza personalizzata per gestire i dati in base a frequenza, data e ora. Se necessario, puoi anche scegliere un set di dati di output per i risultati. Le query salvate come modello possono essere pianificate dall'Editor query.

IMPORTANT
È possibile aggiungere una pianificazione solo a una query già creata e salvata.

Tutte le query pianificate vengono aggiunte all’elenco in Query pianificate scheda. Da tale area di lavoro è possibile monitorare lo stato di tutti i processi di query pianificati tramite l’interfaccia utente. Il giorno Query pianificate scheda puoi trovare informazioni importanti sull’esecuzione della query e abbonarti agli avvisi. Le informazioni disponibili includono lo stato, i dettagli della pianificazione e i messaggi/codici di errore in caso di errore di esecuzione. Consulta la Monitorare il documento delle query pianificate per ulteriori informazioni.

Questo flusso di lavoro descrive il processo di pianificazione nell’interfaccia utente di Query Service. Per informazioni su come aggiungere pianificazioni utilizzando l’API, leggi la guida dell’endpoint "scheduled queries".

Creare una pianificazione di query create-schedule

Per pianificare una query, selezionare un modello di query dalla Modelli scheda o Modello colonna del Query pianificate scheda. Selezionando il nome del modello si passa all'editor di query.

Se si accede a una query salvata dall'Editor query, è possibile creare una pianificazione per la query o visualizzarne la pianificazione dal pannello dei dettagli.

TIP
Seleziona Visualizza pianificazione per passare all'area di lavoro pianificazioni e visualizzare immediatamente qualsiasi query pianificata eseguita.

Editor query con Visualizza pianificazione e Aggiungi pianificazione evidenziato.

Seleziona Aggiungi pianificazione per passare al pagina dettagli pianificazione.

In alternativa, seleziona la Schedules sotto il nome della query.

Editor query con la scheda Schedules evidenziata.

Verrà visualizzata l'area di lavoro pianificazioni. Nell’interfaccia utente viene visualizzato un elenco delle esecuzioni pianificate a cui è associato il modello. Seleziona Aggiungi pianificazione per creare una pianificazione.

Nellarea di lavoro Pianificazione editor query è evidenziata Aggiungi pianificazione.

Aggiungi dettagli pianificazione schedule-details

Viene visualizzata la pagina dei dettagli della pianificazione. In questa pagina è possibile modificare una serie di dettagli per la query pianificata. I dettagli includono frequenza e giorno feriale della query pianificata run, la data di inizio e di fine, il set di dati in cui esportare i risultati e avvisi sullo stato delle query.

Viene evidenziato il pannello Dettagli pianificazione.

Frequenza query pianificata scheduled-query-frequency

Puoi scegliere le seguenti opzioni per Frequenza:

  • Ogni ora: la query pianificata viene eseguita ogni ora per il periodo di data selezionato.
  • Giornaliero: la query pianificata verrà eseguita ogni X giorni all’ora e nel periodo di data selezionati. L'ora selezionata è in UTC e non il tuo fuso orario locale.
  • Ogni settimana: la query selezionata verrà eseguita nei giorni della settimana, dell’ora e del periodo di data selezionati. L'ora selezionata è in UTC e non il tuo fuso orario locale.
  • Mensile: la query selezionata verrà eseguita ogni mese al giorno, all’ora e al periodo di data selezionati. L'ora selezionata è in UTC e non il tuo fuso orario locale.
  • Annuale: la query selezionata verrà eseguita ogni anno al giorno, al mese, all’ora e al periodo di data selezionati. L'ora selezionata è in UTC e non il tuo fuso orario locale.

Fornisci dettagli set di dati dataset-details

Gestisci i risultati della query aggiungendo i dati a un set di dati esistente o creando un nuovo set di dati e aggiungendo i dati a esso.

Seleziona Crea e aggiungi al nuovo set di dati per creare un set di dati quando si esegue una query per la prima volta. Le esecuzioni successive continuano a inserire dati in tale set di dati. Infine, fornisci un nome e una descrizione per il set di dati.

IMPORTANT
Poiché si utilizza un set di dati esistente o si crea un nuovo set di dati, non devono includere INSERT INTO o CREATE TABLE AS SELECT come parte della query, poiché i set di dati sono già impostati. Inclusione di INSERT INTO o CREATE TABLE AS SELECT come parte delle query pianificate genererà un errore.

Il pannello Dettagli pianificazione con i dettagli del set di dati e il Crea e aggiungi al nuovo set di dati opzioni evidenziate.

In alternativa, seleziona Aggiungi a set di dati esistente seguito dall’icona del set di dati ( Icona del set di dati. ).

Il pannello Dettagli pianificazione con i dettagli del set di dati ed Aggiungi al set di dati esistente è evidenziato.

Il Seleziona set di dati di output viene visualizzata.

Quindi, sfoglia i set di dati esistenti o utilizza il campo di ricerca per filtrare le opzioni. Seleziona la riga del set di dati da utilizzare. I dettagli del set di dati vengono visualizzati nel pannello a destra. Seleziona Fine per confermare la scelta.

Viene evidenziata la finestra di dialogo Seleziona set di dati di output con il campo di ricerca, una riga di set di dati e l’opzione Fine.

Quarantena le query in caso di errore continuo quarantine

Durante la creazione di una pianificazione, puoi registrare la query nella funzione di quarantena per proteggere le risorse di sistema e prevenire potenziali interruzioni. La funzione di quarantena identifica e isola automaticamente le query che hanno ripetutamente esito negativo inserendole in una In quarantena stato. Mettendo in quarantena le query dopo dieci errori consecutivi, puoi intervenire, rivedere e rettificare i problemi prima di consentire ulteriori esecuzioni. In questo modo è possibile mantenere l'efficienza operativa e l'integrità dei dati.

L’area di lavoro Query pianificate con Quarantena query evidenziate e Sì selezionate.

Dopo aver registrato una query per la funzione di quarantena, puoi attivare gli avvisi per questa modifica dello stato della query. Se una query pianificata non è iscritta alla quarantena, non viene visualizzata come opzione su la finestra di dialogo Avvisi.

È inoltre possibile registrare una query pianificata nella funzione di quarantena dalle azioni in linea di Query pianificate scheda. Consulta la monitorare la documentazione delle query per ulteriori dettagli.

Impostare gli avvisi per uno stato di query pianificata alerts-for-query-status

È inoltre possibile abbonarsi agli avvisi di query come parte delle impostazioni di query pianificate. Puoi configurare le impostazioni per ricevere notifiche per una serie di situazioni. Gli avvisi possono essere impostati per uno stato di quarantena, ritardi nell’elaborazione delle query o una modifica dello stato della query. Le opzioni di avviso dello stato della query disponibili includono avvio, operazione riuscita ed errore. Gli avvisi possono essere ricevuti come notifiche pop-up o e-mail. Selezionare la casella di controllo per sottoscrivere gli avvisi relativi allo stato della query pianificata.

Il pannello Dettagli pianificazione con le opzioni Avviso evidenziate.

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. Una volta che una query è iscritto alla funzione di quarantena, qualsiasi query pianificata che non supera dieci esecuzioni consecutive viene automaticamente inserita in una In quarantena stato. Una query in quarantena richiede quindi l’intervento dell’utente prima di poter eseguire ulteriori esecuzioni. Nota: per poter sottoscrivere avvisi di quarantena, è necessario registrare le query per la funzione di quarantena.
delay
Questo avviso ti avvisa se è presente ritardo nell’esito di un’esecuzione di una query pianificata oltre una soglia specificata. È possibile impostare un'ora personalizzata che attivi l'avviso quando la query viene eseguita per tale durata senza completare o non riuscire. Il comportamento predefinito imposta un avviso per 150 minuti dopo l’inizio dell’elaborazione della query.
NOTE
Se si sceglie di impostare un Ritardo esecuzione query Avviso, è necessario impostare il ritardo desiderato in minuti nell’interfaccia utente di Platform. Immetti la durata in minuti. Il ritardo massimo è di 24 ore (1440 minuti).

Per una panoramica degli avvisi in Adobe Experience Platform, inclusa la struttura della definizione delle regole di avviso, vedi panoramica degli avvisi. Per informazioni sulla gestione degli avvisi e delle regole di avviso nell’interfaccia utente di Adobe Experience Platform, consulta Guida all’interfaccia utente Avvisi.

Impostare i parametri per una query con parametri pianificata set-parameters

IMPORTANT
La funzione per l’interfaccia con parametri per query è attualmente disponibile in una solo versione limitata e non è disponibile per tutti i clienti. Se non hai accesso alle query con parametri, continua con eliminare o disattivare una pianificazione sezione.

Se si crea una query pianificata per una query con parametri, è necessario impostare i valori dei parametri per queste esecuzioni della query.

La sezione Dettagli pianificazione del flusso di lavoro di creazione della pianificazione con la sezione Parametri query evidenziata.

Dopo aver confermato i dettagli della pianificazione, seleziona Salva per creare una pianificazione. Viene visualizzata di nuovo la scheda Pianificazioni del modello. In questa area di lavoro vengono visualizzati i dettagli della pianificazione appena creata, inclusi l’ID pianificazione, la pianificazione stessa e il set di dati di output della pianificazione.

Visualizza esecuzioni query pianificate scheduled-query-runs

Dal modello di Schedules , seleziona l’ID pianificazione per passare all’elenco delle query eseguite per la query appena pianificata.

Area di lavoro pianificazioni con la pianificazione appena creata evidenziata.

In alternativa, per visualizzare un elenco delle esecuzioni pianificate di un modello di query, passare alla Query pianificate e selezionare un nome di modello dall'elenco disponibile.

La scheda Query pianificate con un modello denominato evidenziato.

Viene visualizzato l'elenco delle query eseguite per la query pianificata.

La sezione dei dettagli dell’area di lavoro Query pianificate con un elenco delle esecuzioni delle query è evidenziata per una query pianificata.

Consulta la monitoraggio della guida con query pianificata per informazioni complete su come monitorare lo stato di tutti i processi di query tramite l’interfaccia utente.

Seleziona un ID esecuzione query dall’elenco, per passare alla panoramica dell’esecuzione della query. Per una disaggregazione completa delle informazioni disponibili panoramica dell’esecuzione delle query, consulta la documentazione sul monitoraggio delle query pianificate.

Per monitorare le query pianificate tramite l’API Query Service, consulta la sezione guida degli endpoint di esecuzione delle query pianificate.

Abilitare, disabilitare o eliminare una pianificazione delete-schedule

È possibile abilitare, disabilitare o eliminare una pianificazione dall'area di lavoro pianificazioni di una particolare query o dall' Query pianificate area di lavoro che elenca tutte le query pianificate.

Per accedere al Schedules della query scelta, è necessario selezionare il nome di un modello di query dalla scheda Modelli scheda o Query pianificate scheda. Consente di passare all'editor delle query per la query. Dall’editor delle query, seleziona Schedules per accedere all'area di lavoro pianificazioni.

Seleziona una pianificazione dalle righe delle pianificazioni disponibili per popolare il pannello dei dettagli. Utilizza l’interruttore per disabilitare (o abilitare) la query pianificata.

Eliminare le query disabilitate

IMPORTANT
È necessario disattivare la pianificazione prima di eliminare una pianificazione per una query.

L’elenco delle pianificazioni di un modello con il pannello dei dettagli evidenziato.

Viene visualizzata una finestra di dialogo di conferma. Seleziona Disattiva per confermare l’azione.

La finestra di dialogo di conferma Disattiva pianificazione.

Seleziona Eliminare una pianificazione per eliminare la pianificazione disabilitata.

Area di lavoro pianificazioni con Elimina pianificazione evidenziata.

In alternativa, Query pianificate La scheda offre una raccolta di azioni in linea per ogni query pianificata. Le azioni in linea disponibili includono Disattiva pianificazione o Abilita pianificazione, Elimina pianificazione, e Abbonati agli avvisi per la query pianificata. Per istruzioni complete su come eliminare o disabilitare una query pianificata tramite la scheda Query pianificate, vedi monitoraggio della guida con query pianificata.

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