Documentazione Experience Platform Guida di Query Service

Pianificazioni query

Ultimo aggiornamento: 4 aprile 2025

Argomenti:
Query

Creato per:

Utente
Sviluppatore

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

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.

TIP

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

Editor query con Visualizza pianificazione e Aggiungi pianificazione evidenziati.

Seleziona Aggiungi pianificazione per passare alla pagina dettagli pianificazione.

In alternativa, selezionare la scheda Schedules sotto il nome della query.

Leditor delle 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.

Area di lavoro di pianificazione delleditor delle query con Aggiungi pianificazione evidenziata.

Aggiungi dettagli pianificazione

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.

IMPORTANT

L’interfaccia utente dell’utilità di pianificazione delle query non supporta la pianificazione indefinita o permanente. È necessario specificare una data di fine. Non esiste alcun limite massimo per la data di fine.

Il pannello Dettagli pianificazione è evidenziato.

Frequenza query pianificata

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

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.

IMPORTANT

Poiché si sta utilizzando un set di dati esistente o creando un nuovo set di dati, non deve includere 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.

Il pannello Dettagli pianificazione con i dettagli del set di dati e le opzioni Crea e aggiungi al nuovo set di dati sono evidenziati.

In alternativa, selezionare Aggiungi al set di dati esistente seguito dall'icona del set di dati ( ).

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

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.

Finestra di dialogo Seleziona set di dati di output con il campo di ricerca, una riga di set di dati e Fine evidenziati.

Quarantena le query in caso di errore continuo

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.

Area di lavoro Pianificazioni query con Quarantena query evidenziata e Sì selezionata.

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

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

Pannello Dettagli pianificazione con le opzioni di 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 è registrata nella funzionalità di quarantena, qualsiasi query pianificata che non riesce a eseguire dieci esecuzioni consecutive viene automaticamente posta in uno stato In quarantena. 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 notifica se si verifica un ritardo nell'esito di un'esecuzione di una query pianificata 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. Il comportamento predefinito imposta un avviso per 150 minuti dopo l’inizio dell’elaborazione della query.

NOTE

Se scegli di impostare un avviso di Ritardo esecuzione query, devi impostare il ritardo desiderato in minuti nell'interfaccia utente di Experience 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, 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

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

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

Dalla scheda Schedules del modello, 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 scheda Query pianificate e selezionare un nome di modello dall'elenco disponibile.

Scheda Query pianificate con un modello denominato evidenziato.

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

Calcola ore a livello di processo

Tieni traccia delle ore di calcolo utilizzate a livello di esecuzione delle query per le query batch CTAS/ITAS. Questa funzione offre informazioni approfondite sull’utilizzo dei calcoli, consentendoti di ottimizzare l’allocazione delle risorse e migliorare le prestazioni delle query.

AVAILABILITY

La funzionalità Compute Hours è esclusiva per gli utenti che hanno acquistato lo SKU Data Distiller. Per ulteriori informazioni, contatta il rappresentante Adobe.

La sezione dei dettagli dellarea di lavoro Query pianificate con un elenco di query viene eseguita evidenziata per una query pianificata.

Nella tabella seguente vengono fornite le descrizioni di ogni colonna disponibile nella sezione dei dettagli in cui sono elencate le esecuzioni delle query pianificate.

Titolo colonna

Descrizione

ID esecuzione query

Visualizza un identificatore univoco per ogni esecuzione di query, che consente di tenere traccia e fare riferimento a singole esecuzioni delle query pianificate.

Inizio esecuzione query

Indica la data e l’ora di inizio dell’esecuzione della query, per aiutarti a monitorare l’inizio di ogni esecuzione.

Esecuzione query completata

Mostra la data e l’ora di completamento dell’esecuzione della query, per fornire ad insight la durata e lo stato dell’esecuzione.

Stato

Visualizza lo stato corrente dell'esecuzione della query, ad esempio Completed, Running, o Failed, per valutare rapidamente il risultato.

Set di dati

Elenca i set di dati utilizzati nell’esecuzione della query, per mostrare quali origini dati sono state coinvolte nell’esecuzione.

Calcola ore

Mostra il tempo di calcolo utilizzato per ogni esecuzione della query, misurato in ore. Questo consente di tenere traccia dell’utilizzo delle risorse e di ottimizzare le prestazioni delle query.

NOTE

I dati delle ore di calcolo sono disponibili a partire dal 08/15/2024. I dati precedenti a questa data vengono visualizzati come 'Non disponibile'.

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

È 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

IMPORTANT

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

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.

Finestra di dialogo per disabilitare la conferma della pianificazione.

Selezionare Elimina una pianificazione per eliminare la pianificazione disabilitata.

Area di lavoro pianificazioni con Elimina pianificazione evidenziata.

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.

recommendation-more-help