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.
Tutte le query pianificate vengono aggiunte all'elenco nella scheda Query pianificate. Da tale area di lavoro è possibile monitorare lo stato di tutti i processi di query pianificati tramite l’interfaccia utente. Nella scheda Query pianificate puoi trovare informazioni importanti sull'esecuzione della query e iscriverti agli avvisi. Le informazioni disponibili includono lo stato, i dettagli della pianificazione e i messaggi/codici di errore in caso di errore di esecuzione. Per ulteriori informazioni, vedere il documento Monitorare le query pianificate.
Questo flusso di lavoro descrive il processo di pianificazione nell’interfaccia utente di Query Service. Per informazioni su come aggiungere pianificazioni utilizzando l'API, leggere la guida dell'endpoint per le query pianificate.
Creare una pianificazione di query create-schedule
Per pianificare una query, selezionare un modello di query dalla scheda Modelli o dalla colonna Modello della scheda Query pianificate. 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.
Seleziona Aggiungi pianificazione per passare alla pagina dettagli pianificazione.
In alternativa, selezionare la scheda Schedules sotto il nome della query.
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.
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 dell'esecuzione pianificata della query, la data di inizio e di fine, il set di dati in cui esportare i risultati e avvisi sullo stato della query.
Frequenza query pianificata scheduled-query-frequency
Puoi scegliere le seguenti opzioni per Frequenza:
- Oraria: la query pianificata verrà eseguita ogni ora per il periodo di date selezionato.
- Giornaliero: la query pianificata verrà eseguita ogni X giorni alla data e all'ora selezionate. L'ora selezionata è tra UTC e non il tuo fuso orario locale.
- Settimanale: la query selezionata verrà eseguita nei giorni della settimana, dell'ora e del periodo selezionato. L'ora selezionata è tra 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 è tra 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 è tra 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.
Selezionare 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.
INSERT INTO
o CREATE TABLE AS SELECT
come parte della query, poiché i set di dati sono già impostati. L'inclusione di INSERT INTO
o CREATE TABLE AS SELECT
come parte delle query pianificate genererà un errore.
In alternativa, selezionare Aggiungi al set di dati esistente seguito dall'icona del set di dati ( ).
Viene visualizzata la finestra di dialogo Seleziona set di dati di output.
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.
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 funzionalità di quarantena identifica e isola automaticamente le query che hanno ripetutamente esito negativo inserendole in uno stato In quarantena. 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.
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 è registrata in quarantena, non viene visualizzata come opzione nella finestra di dialogo Avvisi.
È inoltre possibile registrare una query pianificata nella funzionalità di quarantena dalle azioni in linea della scheda Query pianificate. Per ulteriori dettagli, consulta la documentazione delle query di monitoraggio.
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.
La tabella seguente spiega i tipi di avviso per le query supportati:
start
success
failed
quarantine
delay
Per una panoramica degli avvisi in Adobe Experience Platform, inclusa la struttura della definizione delle regole di avviso, vedere la panoramica degli avvisi. Per informazioni sulla gestione degli avvisi e delle regole di avviso nell'interfaccia utente di Adobe Experience Platform, vedere la guida dell'interfaccia utente degli avvisi.
Impostare i parametri per una query con parametri pianificata set-parameters
Se si crea una query pianificata per una query con parametri, è necessario impostare i valori dei parametri per queste esecuzioni della query.
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
Dalla scheda Schedules del modello, seleziona l'ID pianificazione per passare all'elenco delle query eseguite per la query appena pianificata.
In alternativa, per visualizzare un elenco delle esecuzioni pianificate di un modello di query, passare alla scheda Query pianificate e selezionare un nome di modello dall'elenco disponibile.
Viene visualizzato l'elenco delle query eseguite per la query pianificata.
Per informazioni complete su come monitorare lo stato di tutti i processi di query tramite l'interfaccia utente, vedere la guida monitoraggi pianificati per query.
Selezionare un ID esecuzione query dall'elenco per passare alla panoramica esecuzione query. Per un'analisi completa delle informazioni disponibili nella panoramica sull'esecuzione delle query, vedere la documentazione relativa al monitoraggio delle query pianificate.
Per monitorare le query pianificate tramite l'API Query Service, vedere la guida degli endpoint per l'esecuzione pianificata delle query.
Abilitare, disabilitare o eliminare una pianificazione delete-schedule
È possibile abilitare, disabilitare o eliminare una pianificazione dall'area di lavoro pianificazioni di una determinata query o dall'area di lavoro Query pianificate in cui sono elencate tutte le query pianificate.
Per accedere alla scheda Schedules della query scelta, è necessario selezionare il nome di un modello di query dalla scheda Templates o dalla scheda Scheduled Queries. Consente di passare all'editor delle query per la query. Dall'editor delle query, selezionare Schedules per accedere all'area di lavoro delle 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
Viene visualizzata una finestra di dialogo di conferma. Seleziona Disattiva per confermare l'azione.
Selezionare Elimina una pianificazione per eliminare la pianificazione disabilitata.
In alternativa, la scheda Query pianificate offre una raccolta di azioni in linea per ogni query pianificata. Le azioni in linea disponibili includono Disabilita 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, vedere la guida Monitoraggio query pianificate.