Query Editor guida utente

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 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 la compilazione dei set di dati in Experience Platform.

Per ulteriori informazioni sui concetti e sulle funzionalità di Query ServiceQuery Service, consultate la panoramica diQuery Service. Per ulteriori informazioni su come navigare nell'interfaccia utente di Servizio query, Platformvedere la panoramica dell'interfaccia utente di Servizioquery.

Introduzione

Query Editor consente l'esecuzione flessibile delle query connettendosi a Query Service, e le query verranno eseguite solo quando la connessione è attiva.

Collegamento a Query Service

Query Editor l'inizializzazione e la connessione Query Service quando viene aperta richiedono alcuni secondi. 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.

Immagine

Modalità di esecuzione delle query Query Editor

Query eseguite dall' Query Editor esecuzione 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.

Creazione di query tramite Query Editor

Utilizzando Query Editorquesta funzione, potete scrivere, eseguire e salvare le query per i dati relativi all'esperienza cliente. Tutte le query eseguite Query Editoro salvate sono disponibili per tutti gli utenti dell'organizzazione con accesso a Query Service.

Accesso al Query Editor

Nell’ Experience Platform interfaccia utente, fate clic Queries nel menu di navigazione a sinistra per aprire l’ Query Service area di lavoro. Fare clic Create Query nella parte superiore destra della schermata per iniziare a scrivere le query. Questo collegamento è disponibile da una qualsiasi delle pagine nell’ Query Service area di lavoro.

Immagine

Scrittura di query

Query Editor è organizzato in modo da rendere più semplice la scrittura di query. La schermata seguente mostra l’aspetto dell’editor nell’interfaccia utente, con il pulsante Riproduci e il campo di immissione SQL evidenziati.

Immagine

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 in Query Editor

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

Immagine

  • Completamento automatico parola chiave SQL: Iniziate a digitare la query, quindi utilizzate i tasti freccia per passare al termine desiderato e premete Invio.

Immagine

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

Immagine

Rilevamento errori

Query Editor 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.

Immagine

Quando vengono rilevati degli errori, è possibile visualizzare i messaggi di errore specifici posizionando il puntatore del mouse sul codice SQL.

Immagine

Dettagli query

Durante la visualizzazione di una query in Query Editor, il Query Details pannello 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 assegnare un nome alla query visualizzata e visualizzare il codice SQL in un formato di facile copia nella SQL Query scheda. 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 Output Dataset la finestra di dialogo. Immettete un nome e una descrizione, quindi fate clic Run Query. Il nuovo set di dati viene visualizzato nella Datasets scheda dell'interfaccia Query Service utente in Platform.

Salvataggio delle query

Query Editor fornisce una funzione save che consente di salvare una query e di lavorarci in un secondo momento. Per salvare una query, fate clic Save nell’angolo in alto a destra di Query Editor. Prima di salvare una query, è necessario specificare un nome per la query utilizzando il Query Details pannello.

Come trovare le query precedenti

Tutte le query eseguite da Query Editor vengono acquisite nella tabella Log. È possibile utilizzare la funzionalità di ricerca nella Log scheda per individuare le esecuzioni delle query. Le query salvate sono elencate nella Browse scheda.

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, è necessario eseguirla o salvarla in Query Editor.

Esecuzione di query con l'Editor query

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

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

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 Results scheda accanto alla Console scheda. 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, vedere l'esercitazione sulla generazione di set di dati in Query Editor.

Immagine

Esecuzione di query con video Query Service di esercitazione

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

Passaggi successivi

Ora che sai quali funzioni sono disponibili 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 dataset in Data Lake, vedere la guida sull' esecuzione di query. Per query SQL di esempio per l'utilizzo dati Adobe Analytics e Adobe Target, vedere il riferimento alle query diesempio.

In questa pagina