Show Menu
ARGOMENTI×

Guida utente per l’editor di query

Query Editor è uno strumento interattivo fornito da Adobe Experience Platform Query Service che consente di scrivere, convalidare ed eseguire query per i dati relativi all'esperienza cliente all'interno dell'interfaccia utente di Experience Platform. 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 set di dati in Experience Platform.
Per ulteriori informazioni sui concetti e sulle funzionalità di Query Service, consultate la panoramica di Query Service. Per ulteriori informazioni su come navigare nell’interfaccia utente del servizio query sulla piattaforma, consultate la panoramica dell’interfaccia utente del servizio query.

Introduzione

L'Editor query consente l'esecuzione flessibile delle query collegandosi a Servizio query e le query verranno eseguite solo quando la connessione è attiva.

Connessione a Query Service

L'editor di query richiede alcuni secondi per l'inizializzazione e la connessione al servizio di query quando viene aperto. Console indica quando è connesso, come mostrato di seguito. Se si tenta di eseguire una query prima che l'editor si sia connesso, l'esecuzione ritarda fino al completamento della connessione.

Esecuzione delle query dall'editor query

Le query eseguite dall'Editor query vengono eseguite in modo interattivo. Questo significa che se chiudete il browser o se vi allontanate, la query viene annullata. Ciò è vero anche per le query effettuate per generare set di dati dagli output delle query.

Authoring delle query con Editor query

Utilizzando l'editor di query è possibile scrivere, eseguire e salvare query per i dati relativi all'esperienza cliente. Tutte le query eseguite in Query Editor, o salvate, sono disponibili per tutti gli utenti dell'organizzazione con accesso a Query Service.

Accesso all'Editor query

Nell’interfaccia utente della piattaforma Experience, fai clic su Query nel menu di navigazione a sinistra per aprire l’area di lavoro Servizio query. Fare clic su 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 Servizio query.

Scrittura di query

Editor query è organizzato in modo da semplificare la scrittura delle query. La schermata seguente mostra l’aspetto dell’editor nell’interfaccia utente, con il pulsante Riproduci e il campo di immissione SQL evidenziati.
Per ridurre al minimo il tempo di sviluppo, si consiglia di 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, rimuovere i limiti ed eseguire la query con CREATE TABLE tablename AS SELECT cui generare un dataset con l'output.

Strumenti di scrittura nell’Editor query

  • Evidenziazione automatica della sintassi: Semplifica la lettura e l'organizzazione di SQL.
  • Completamento automatico parola chiave SQL: Iniziate a digitare la query, quindi utilizzate i tasti freccia per passare al termine desiderato e premete Invio .
  • Tabella e campo con completamento automatico: Iniziate a digitare il nome della tabella da cui desiderate SELECT uscire, quindi utilizzate i tasti freccia per passare alla tabella cercata e premete Invio . Dopo aver selezionato una tabella, la funzione di completamento automatico riconoscerà i campi nella tabella.

Rilevamento errori

Editor query convalida automaticamente una query durante la scrittura, fornendo la convalida SQL generica e la convalida dell'esecuzione specifica. Se sotto la query viene visualizzata una sottolineatura rossa (come illustrato nell'immagine seguente), all'interno della query viene visualizzato un errore.
Quando vengono rilevati degli errori, è possibile visualizzare i messaggi di errore specifici posizionando il puntatore del mouse sul codice SQL.

Dettagli query

Durante la visualizzazione di una query in Editor query, il pannello Dettagli ** query fornisce gli strumenti per gestire la query selezionata.
Questo pannello consente di generare un set di dati di output direttamente dall'interfaccia utente, eliminare o assegnare un nome alla query visualizzata e visualizzare il codice SQL in un formato di semplice copia nella scheda Query SQL. Questo pannello mostra anche utili metadati, ad esempio l’ultima volta che la query è stata modificata e l’utente che l’ha modificata, se applicabile. Per generare un set di dati, fare clic su ​Output Dataset​ . Viene visualizzata la finestra di dialogo DataSet di output . Immettete un nome e una descrizione, quindi fate clic su ​Esegui query**. Il nuovo set di dati viene visualizzato nella scheda Set di dati dell'interfaccia utente Servizio query sulla piattaforma.

Salvataggio delle query

L'Editor query fornisce una funzione di salvataggio che consente di salvare una query e di lavorarci in un secondo momento. Per salvare una query, fate clic su Salva nell’angolo in alto a destra dell’Editor query. 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 dall'Editor query vengono acquisite nella tabella Registro. È possibile utilizzare la funzionalità di ricerca nella scheda Registro per individuare le esecuzioni delle query. Le query salvate sono elencate nella scheda Sfoglia .
Per ulteriori informazioni, consulta la panoramica dell’interfaccia utente del servizio query.
Le query non eseguite non vengono salvate dal registro. Affinché la query sia disponibile in Query Service, è necessario eseguirla o salvarla in Query Editor.

Esecuzione di query con l'Editor query

Per eseguire una query in Editor query, è possibile immettere SQL nell'editor o caricare una query precedente dalla scheda Registro o Sfoglia , quindi fare clic su Riproduci . Lo stato dell'esecuzione della query viene visualizzato nella scheda Console sottostante e i dati di output sono visualizzati nella scheda Risultati .

Console

La console fornisce informazioni sullo stato e il funzionamento di Query Service. La console visualizza lo stato della connessione a Query Service, le operazioni di query in esecuzione ed eventuali messaggi di errore risultanti da tali query.
Nella console sono visualizzati solo gli errori risultanti dall’esecuzione di una query. Non vengono visualizzati errori di convalida delle query prima dell'esecuzione di una query.

Risultati 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 consente di verificare che la query produca l'output previsto. Per generare un dataset con la query, rimuovere i limiti sulle righe restituite ed eseguire la query con CREATE TABLE tablename AS SELECT cui generare un dataset con l'output. Per istruzioni su come generare un set di dati dai risultati della query nell'Editor query, vedere l'esercitazione sulla generazione dei set di dati.

Passaggi successivi

Ora che si conoscono le funzionalità disponibili in Editor query e come navigare nell'applicazione, è possibile iniziare a creare query personalizzate direttamente in Piattaforma. Per ulteriori informazioni sull'esecuzione di query SQL rispetto ai dataset in Data Lake, vedere la guida sull' esecuzione di query . Per query SQL di esempio per l'utilizzo dei dati di Adobe Analytics e Adobe Target, consultate il riferimento alle query di esempio.