Query Editor Guida all’interfaccia utente

Ultimo aggiornamento: 2023-11-06
  • Argomenti:
  • Queries
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Developer
    User
    Admin
    Leader

Query Editor è uno strumento interattivo fornito da Adobe Experience Platform Query Service, che consente di scrivere, convalidare ed eseguire query per i dati sulla customer experience in Experience Platform dell'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 popolare i set di dati in Experience Platform.

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

NOTA

Alcune funzionalità di Query Service non sono fornite dalla versione precedente di Query Editor. Le schermate utilizzate in questo documento vengono acquisite utilizzando la versione migliorata dell’editor delle query, salvo diversa indicazione. Consulta la sezione sulla Editor query avanzato per ulteriori dettagli.

Introduzione

Query Editor fornisce un’esecuzione flessibile delle query tramite la connessione a Query ServiceLe query, e vengono eseguite solo quando la connessione è attiva.

Accesso Query Editor

In Experience Platform UI, seleziona Query nel menu di navigazione sinistro per aprire Query Service Workspace. Quindi, per iniziare a scrivere le query, seleziona Crea query in alto a destra. Questo collegamento è disponibile da una qualsiasi delle pagine di Query Service Workspace.

La scheda Panoramica dell’area di lavoro Query in cui è evidenziata l’opzione Crea query.

Connessione a Query Service

L’editor delle query impiega alcuni secondi per inizializzare e connettersi a Query Service quando viene aperto. La console indica quando è collegata, come illustrato di seguito. Se tenti di eseguire una query prima che l’editor si sia connesso, l’esecuzione viene rimandata fino al completamento della connessione.

L'output della console dell'editor di query al momento della connessione iniziale.

Esecuzione delle query da Query Editor

Query eseguite da Query Editor esegui in modo interattivo, il che significa che se chiudi il browser o esci, la query viene annullata. Lo stesso vale per le query eseguite per generare set di dati dagli output delle query.

L'edizione avanzata dell'editor di query consente di scrivere più query nell'editor ed eseguirle in sequenza. Consulta la sezione su esecuzione di più query sequenziali per ulteriori informazioni.

Creazione di query tramite Query Editor

Utilizzo di Query Editor, puoi scrivere, eseguire e salvare query per i dati sull’esperienza del cliente. Tutte le query eseguite o salvate in Query Editor sono disponibili per tutti gli utenti dell’organizzazione con accesso a Query Service.

IMPORTANTE

L’editor legacy verrà ritirato il 1° aprile 2024 e non sarà più disponibile.

Opzione Editor di query ottimizzata

Un interruttore dell’interfaccia utente consente di passare dalla versione legacy alla versione avanzata dell’editor di query. La versione precedente è abilitata per impostazione predefinita, ma la versione avanzata fornisce migliori funzioni per l’accessibilità e il supporto di più temi. Abilita la versione avanzata per accedere alle impostazioni dell’editor di query.

L’Editor query con l’Editor query avanzato è evidenziato.

Attivando l’interruttore, l’editor diventa leggero e migliora la leggibilità della sintassi. Sopra il campo di input dell’editor di query viene visualizzata un’icona delle impostazioni che incorpora l’interruttore di completamento automatico. Dall’icona delle impostazioni, puoi abilitare il tema scuro o disabilitare/abilitare il completamento automatico.

SUGGERIMENTO

L’editor di query avanzato consente di: Disabilita completamento automatico sintassi durante l’authoring di una query senza perdere l’avanzamento. In genere, se si disattiva la funzione di completamento automatico durante la modifica, tutte le modifiche apportate alla query andranno perse.

Per attivare i temi scuri o chiari, selezionare l'icona delle impostazioni (Un'icona delle impostazioni.) seguito dall'opzione nel menu a discesa visualizzato.

L’editor delle query con l’icona delle impostazioni e l’opzione del menu a discesa Abilita tema scuro sono evidenziate.

Eseguire più query sequenziali

L'edizione avanzata dell'editor di query consente di scrivere più di una query nell'editor ed eseguirle tutte in modo sequenziale.

L’esecuzione di più query in una sequenza genera ciascuna una voce di registro. Tuttavia, solo i risultati della prima query vengono visualizzati nella console dell’editor delle query. Se hai la necessità di risolvere i problemi o confermare le query eseguite, controlla il registro delle query. Consulta la documentazione dei registri di query per ulteriori informazioni.

NOTA

Se una query CTAS viene eseguita dopo la prima query nell’editor delle query, viene comunque creata una tabella, ma non è presente alcun output nella console dell’editor delle query.

Esegui query selezionata

Se hai scritto più query ma devi eseguirne una sola, puoi evidenziare la query scelta e selezionare la
Esegui query selezionata icona. Questa icona è disabilitata per impostazione predefinita, a meno che non selezioni una query nell’editor.

L’editor delle query con Esegui query selezionata icona evidenziata.

Conteggio risultati

L’editor delle query può contenere un massimo di 50.000 righe. Tuttavia, nella console dell’editor di query vengono visualizzate solo 50 righe alla volta. Per modificare il numero di righe visualizzate nella console, seleziona la Conteggio risultati e scegliere tra i valori 50, 100, 150, 300 e 500.

L’editor delle query con il menu a discesa Conteggio risultati è evidenziato.

Scrittura delle query

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

Editor query con il campo di input SQL e Play evidenziati.

Per ridurre al minimo il tempo di sviluppo, ti consigliamo di sviluppare le query con limiti per le 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.

Istruzione SQL nell'editor delle query che illustra l'evidenziazione dei colori della sintassi.

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

Alcuni caratteri di SQL con il menu a discesa di completamento automatico che fornisce le opzioni dall’editor delle query.

  • Completamento automatico tabella e campo: Inizia a digitare il nome della tabella che desideri SELECT da, quindi utilizzare i tasti freccia per passare alla tabella desiderata e premere Invio. Dopo aver selezionato una tabella, il completamento automatico riconosce i campi della tabella.

L’input dell’editor delle query che visualizza i suggerimenti per i nomi delle tabelle a discesa.

Formato testo

Il Formato testo rende la query più leggibile aggiungendo uno stile di sintassi standardizzato. Seleziona Formato testo per standardizzare tutto il testo all'interno dell'editor di query.

Editor query con Formato testo e le istruzioni SQL evidenziate.

Copia SQL

Selezionare l'icona Copia per copiare SQL dall'editor di query negli Appunti. Questa funzione di copia è disponibile sia per i modelli di query che per le query appena create nell’Editor query.

Nell’area di lavoro Query è presente un modello di query di esempio con l’icona Copia evidenziata.

Attivazione/disattivazione della configurazione dell’interfaccia utente a completamento automatico

Il Query Editor suggerisce automaticamente parole chiave SQL potenziali insieme ai dettagli di tabella o colonna per la query durante la scrittura. La funzione di completamento automatico è abilitata per impostazione predefinita e può essere disabilitata o abilitata in qualsiasi momento selezionando Completamento automatico della sintassi passa in alto a destra nell’editor di query.

L’impostazione di configurazione del completamento automatico è per utente e viene memorizzata per gli accessi consecutivi per tale utente.

Editor query con l'opzione di completamento automatico della sintassi evidenziata.

La disattivazione di questa funzione interrompe l’elaborazione di diversi comandi di metadati e fornisce consigli che in genere migliorano la velocità dell’autore durante la modifica delle query.

Quando si utilizza l’interruttore per abilitare la funzione di completamento automatico, dopo una breve pausa diventano disponibili i suggerimenti consigliati per i nomi di tabelle e colonne e le parole chiave SQL. Un messaggio di operazione riuscita nella console sotto l’editor di query indica che la funzione è attiva.

Se disattivate la funzione di completamento automatico, è necessario aggiornare la pagina per rendere effettiva la funzione. Viene visualizzata una finestra di dialogo di conferma con tre opzioni quando disattivi il Completamento automatico della sintassi toggle:

  • Annulla
  • Salva modifiche e aggiorna
  • Aggiorna senza salvare le modifiche
IMPORTANTE

Se si sta scrivendo o modificando una query quando si disabilita questa funzione, è necessario salvare le modifiche apportate alla query prima di aggiornare la pagina. In caso contrario, tutto l'avanzamento andrà perduto.

Finestra di dialogo di conferma per disattivare la funzione di completamento automatico.

Per disattivare la funzione di completamento automatico, selezionare l'opzione di conferma appropriata.

Rilevamento di 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 riportata di seguito), si verifica un errore all'interno della query.

L'input dell'editor delle query che visualizza SQL sottolineato in rosso indica un errore.

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

Finestra di dialogo con un messaggio di errore.

Dettagli query

Per visualizzare una query nell’editor delle query, seleziona un modello salvato dall’ Modelli scheda. Il pannello Dettagli query fornisce ulteriori informazioni e strumenti per gestire la query selezionata.

Editor query con il pannello Dettagli query evidenziato.

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. Il Set di dati di output viene visualizzata. Inserisci un nome e una descrizione, quindi seleziona Esegui query. Il nuovo set di dati viene visualizzato in Set di dati scheda della Query Service interfaccia utente su Platform.

Query pianificate

Le query salvate come modello possono essere pianificate dall'Editor query. La pianificazione delle query consente di automatizzare l’esecuzione delle query su una cadenza personalizzata. Puoi pianificare le query in base a frequenza, data e ora e, se necessario, scegliere anche un set di dati di output per i risultati. Le pianificazioni delle query possono anche essere disabilitate o eliminate tramite l’interfaccia utente.

Le pianificazioni vengono impostate nell'editor delle query. Quando si utilizza l'editor delle query, è possibile aggiungere una pianificazione solo a una query già creata, salvata ed eseguita. La stessa limitazione non si applica al Query Service API:

Consulta la documentazione sulle pianificazioni delle query per scoprire come creare pianificazioni di query nell’interfaccia utente. In alternativa, per scoprire come aggiungere pianificazioni utilizzando l’API, leggi guida dell’endpoint "scheduled queries".

Tutte le query pianificate vengono aggiunte all’elenco in Query pianificate scheda. Da tale area di lavoro è possibile monitorare lo stato di tutti i processi di query pianificati tramite l’interfaccia utente. Il giorno Query pianificate , puoi trovare informazioni importanti sull’esecuzione della query e abbonarti agli avvisi. Le informazioni disponibili includono lo stato, i dettagli della pianificazione e i messaggi/codici di errore in caso di esecuzione non riuscita. Consulta la Monitorare il documento delle query pianificate per ulteriori informazioni.

Salvataggio delle query

Il Query Editor fornisce una funzione di salvataggio che 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 poter salvare una query, è necessario specificarne il nome utilizzando Dettagli query pannello.

NOTA

Le query denominate e salvate in mediante l'Editor query sono disponibili come modelli nel dashboard Query Modelli scheda. Consulta la documentazione sui modelli per ulteriori informazioni.

Come trovare le query precedenti

Tutte le query eseguite da Query Editor vengono acquisiti nella tabella Log. È possibile utilizzare la funzionalità di ricerca in Log per trovare le esecuzioni della query. Le query salvate sono elencate in Modelli scheda.

Se è stata pianificata una query, il Query pianificate fornisce una migliore visibilità tramite l’interfaccia utente per tali processi di query. Consulta la documentazione sul monitoraggio delle query per ulteriori informazioni.

NOTA

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

Esecuzione di query tramite Editor query

Per eseguire una query in Query Editor, è possibile immettere le istruzioni SQL nell'editor o caricare una query precedente dal Log o Modelli e seleziona Play. Lo stato dell’esecuzione della query viene visualizzato nel Console e i dati di output sono visualizzati nella scheda Risultati scheda.

Console

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

Scheda Console della console dell’editor delle query.

NOTA

La console mostra solo gli errori derivanti dall’esecuzione di una query. Non mostra gli errori di convalida della query che si verificano prima dell’esecuzione di una query.

Risultati della query

Al termine di una query, i risultati vengono visualizzati nella Risultati accanto alla scheda Console scheda. Questa vista mostra l’output tabulare della query, visualizzando fino a 100 righe. Questa vista 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. Consulta la esercitazione sulla generazione di set di dati per istruzioni su come generare un set di dati dai risultati della query in Query Editor.

La scheda Risultati della console Editor query che visualizza i risultati di un’esecuzione di query.

Eseguire query con Query Service video tutorial

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

Passaggi successivi

Ora che sai quali funzioni sono disponibili in Query Editor e come esplorare l’applicazione, puoi iniziare a creare query personalizzate direttamente in Platform. Per ulteriori informazioni sull’esecuzione di query SQL sui set di dati in Data Lake, consulta la guida esecuzione di query.

In questa pagina