Query Editor Guida all’interfaccia utente

Query Editor è uno strumento interattivo fornito da Adobe Experience Platform Query Service, che consente di scrivere, convalidare ed eseguire query per dati sulla customer experience all’interno dell’interfaccia Experience Platform utente. Query Editor supporta lo sviluppo di query per l’analisi e l’esplorazione dei dati e consente di eseguire query interattive a scopo di sviluppo, nonché query non interattive per compilare i set di dati in Experience Platform.

Per ulteriori informazioni sui concetti e le funzionalità di Query Service, consulta la Panoramica del servizio query. Per ulteriori informazioni su come navigare nell’interfaccia utente del servizio query su Platform, consulta la Panoramica dell’interfaccia utente del servizio query.

Introduzione

Query Editor fornisce un’esecuzione flessibile delle query tramite la connessione a Query Service e le query vengono eseguite solo mentre questa connessione è attiva.

Connessione a Query Service

Query Editor l'inizializzazione e la connessione richiedono alcuni secondi all' Query Service apertura. La console indica quando è connessa, come illustrato di seguito. Se tenti di eseguire una query prima che l’editor si sia connesso, l’esecuzione ritarda fino al completamento della connessione.

Immagine

Esecuzione delle query da Query Editor

Le query eseguite da Query Editor vengono eseguite in modo interattivo. Ciò significa che se chiudi il browser o se ti allontani, la query viene annullata. Questo vale anche per le query create per generare set di dati dagli output delle query.

Creazione di query utilizzando Query Editor

Utilizzando Query Editor, puoi scrivere, eseguire e salvare query per i dati sulla customer experience. Tutte le query eseguite in Query Editor o salvate sono disponibili per tutti gli utenti dell’organizzazione con accesso a Query Service.

Accesso al Query Editor

Nell'interfaccia utente Experience Platform, seleziona Query nel menu di navigazione a sinistra per aprire l'area di lavoro Query Service. Quindi, seleziona Crea query in alto a destra nella schermata per iniziare a scrivere query. Questo collegamento è disponibile da una qualsiasi delle pagine nell’ area di lavoro Query Service .

Immagine

Scrittura di query

L’ editor delle query è organizzato in modo da rendere la scrittura di query il più semplice possibile. La schermata seguente mostra come l'editor appare nell'interfaccia utente, con il pulsante Play e il campo di immissione SQL evidenziato.

Immagine

Per ridurre al minimo il tempo di sviluppo, è consigliabile sviluppare le query con limiti sulle righe restituite. Ad esempio, SELECT fields FROM table WHERE conditions LIMIT number_of_rows. Dopo aver verificato che la query produca l’output previsto, rimuovi i limiti ed esegui la query con CREATE TABLE tablename AS SELECT per generare un set di dati con l’output.

Strumenti di scrittura in Query Editor

  • Evidenziazione automatica della sintassi: semplifica la lettura e l'organizzazione di SQL.

Immagine

  • Completamento automatico della parola chiave SQL: inizia a digitare la query e utilizza i tasti freccia per passare al termine desiderato e premi Invio.

Immagine

  • Completamento automatico tabella e campo: inizia a digitare il nome della tabella SELECT da cui desideri eseguire l’operazione, quindi utilizza i tasti freccia per passare alla tabella che stai cercando e premi Invio. Una volta selezionata una tabella, la funzione di completamento automatico riconoscerà i campi presenti nella tabella.

Immagine

Rilevamento degli errori

Query Editor convalida automaticamente una query durante la scrittura, fornendo una convalida SQL generica e una convalida di esecuzione specifica. Se sotto la query viene visualizzata una sottolineatura rossa (come illustrato nell’immagine seguente), la query presenta un errore.

Immagine

Quando vengono rilevati errori, è possibile visualizzare i messaggi di errore specifici passando il mouse sul codice SQL.

Immagine

Dettagli query

Durante la visualizzazione di una query in Query Editor, il pannello Dettagli query fornisce gli strumenti per gestire la query selezionata.

Immagine

Questo pannello consente di generare un set di dati di output direttamente dall’interfaccia utente, eliminare o denominare la query visualizzata e aggiungere una pianificazione alla query.

Questo pannello mostra anche metadati utili, come l’ultima volta che la query è stata modificata e chi l’ha modificata, se applicabile. Per generare un set di dati, seleziona Set di dati di output. Viene visualizzata la finestra di dialogo Set di dati di output. Immetti un nome e una descrizione, quindi seleziona Esegui query. Il nuovo set di dati viene visualizzato nella scheda Set di dati dell’interfaccia utente Query Service in Platform.

Query pianificate

NOTA

È possibile aggiungere una pianificazione solo a una query già creata, salvata ed eseguita. Inoltre, non sarà in grado di aggiungere una pianificazione a una query con parametri.

Per aggiungere una pianificazione a una query, selezionare Aggiungi pianificazione.

Immagine

Viene visualizzata la pagina Dettagli pianificazione . In questa pagina puoi scegliere la frequenza della query pianificata, le date di esecuzione della query pianificata e il set di dati in cui esportare la query.

Immagine

Puoi scegliere le seguenti opzioni per Frequenza:

  • Orario: 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 al periodo di data selezionato. L'ora selezionata è in UTC e non nel fuso orario locale.
  • Settimanale: La query selezionata verrà eseguita nei giorni della settimana, dell’ora e del periodo di data selezionati. L'ora selezionata è in UTC e non nel fuso orario locale.
  • Mensile: La query selezionata viene eseguita ogni mese al giorno, all’ora e al periodo di data selezionato. L'ora selezionata è in UTC e non nel fuso orario locale.
  • Annuale: La query selezionata viene eseguita ogni anno al giorno, al mese, all’ora e al periodo di data selezionato. L'ora selezionata è in UTC e non nel fuso orario locale.

Per il set di dati, puoi utilizzare un set di dati esistente o crearne uno nuovo.

IMPORTANTE

Poiché utilizzi un set di dati esistente o crei un nuovo set di dati, non devi includerlo 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 genera un errore.

Dopo aver confermato tutti questi dettagli, seleziona Salva per creare una pianificazione.

Viene visualizzata nuovamente la pagina dei dettagli della query e vengono visualizzati i dettagli della nuova pianificazione creata, inclusi l’ID pianificazione, la pianificazione stessa e il set di dati di output della pianificazione. Puoi utilizzare l’ID pianificazione per cercare ulteriori informazioni sulle esecuzioni della query pianificata stessa. Per ulteriori informazioni, consulta la guida agli endpoint di esecuzione delle query pianificate.

NOTA

È possibile pianificare solo un modello di query uno utilizzando l'interfaccia utente. Se desideri aggiungere ulteriori pianificazioni a un modello di query, dovrai utilizzare l’API . Se una pianificazione è già stata aggiunta utilizzando l’API , puoi aggiungere not altre pianificazioni utilizzando l’interfaccia utente . Se più pianificazioni sono già collegate a un modello di query, verrà visualizzata solo la pianificazione meno recente. Per informazioni su come aggiungere pianificazioni utilizzando l'API, leggi la guida all'endpoint delle query pianificate.

Inoltre, devi aggiornare la pagina se desideri assicurarti di avere lo stato più recente della pianificazione che stai visualizzando.

Eliminare una pianificazione

Per eliminare una pianificazione, seleziona Elimina una pianificazione.

Immagine

IMPORTANTE

Se si desidera eliminare una pianificazione per una query, è necessario prima disattivare la pianificazione.

Salvataggio delle query

Query Editor fornisce una funzione di salvataggio che ti consente di salvare una query e lavorarci in un secondo momento. Per salvare una query, seleziona Salva nell'angolo in alto a destra di Query Editor. Prima di salvare una query, è necessario specificare un nome per la query utilizzando il pannello Dettagli query .

Come trovare le query precedenti

Tutte le query eseguite da Query Editor vengono acquisite nella tabella Registro. Puoi utilizzare la funzionalità di ricerca nella scheda Registro per trovare le esecuzioni delle query. Le query salvate sono elencate nella scheda Sfoglia .

Per ulteriori informazioni, consulta la Panoramica dell’interfaccia utente del servizio query .

NOTA

Le query non eseguite non vengono salvate dal registro. Affinché la query sia disponibile in Query Service, deve essere eseguita o salvata in Query Editor.

Esecuzione di query tramite Editor query

Per eseguire una query in Query Editor, è possibile immettere SQL nell'editor o caricare una query precedente dalla scheda Log o Sfoglia e selezionare Play. Lo stato di esecuzione della query viene visualizzato nella scheda Console qui sotto, mentre i dati di output sono visualizzati nella scheda Risultati.

Console

La console fornisce informazioni sullo stato e il funzionamento di Query Service. Nella console viene visualizzato lo stato della connessione a Query Service, le operazioni di query eseguite ed eventuali messaggi di errore risultanti da tali query.

Immagine

NOTA

La console mostra solo gli errori derivanti dall’esecuzione di una query. Non mostra gli errori di convalida delle query prima dell’esecuzione di una query.

Risultati della query

Al termine di una query, i risultati vengono visualizzati nella scheda Risultati, accanto alla scheda Console . Questa visualizzazione mostra l’output tabulare della query, visualizzando fino a 100 righe. Questa visualizzazione ti consente di verificare che la query produca l’output previsto. Per generare un set di dati con la query, rimuovi i limiti sulle righe restituite ed esegui la query con CREATE TABLE tablename AS SELECT per generare un set di dati con l’output. Per istruzioni su come generare un set di dati dai risultati della query in Query Editor, consulta l’ esercitazione sulla generazione di set di dati .

Immagine

Eseguire query con il video tutorial Query Service

Il video seguente mostra come eseguire le query nell’interfaccia Adobe Experience Platform e in un client PSQL. Inoltre, vengono dimostrate l’utilizzo di singole proprietà in un oggetto XDM, di funzioni definite in Adobe e di CREATE TABLE AS SELECT (CTAS).

Passaggi successivi

Ora che sai quali funzioni sono disponibili in Query Editor e come navigare nell’applicazione, puoi iniziare a creare query personalizzate direttamente in Platform. Per ulteriori informazioni sull'esecuzione di query SQL rispetto ai set di dati in Data Lake, vedere la guida sull'esecuzione di query a2/>.

In questa pagina