Guida dell’interfaccia utente di Query Editor

Query Editor è uno strumento interattivo fornito da Adobe Experience Platform Query Service che consente di scrivere, convalidare ed eseguire query per i dati sull'esperienza del cliente nell'interfaccia utente Experience Platform. L'editor delle query supporta lo sviluppo di query per l'analisi e l'esplorazione dei dati e consente di eseguire query interattive a scopo di sviluppo e 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 esplorare l'interfaccia utente di Query Service su Platform, vedere Panoramica dell'interfaccia utente di Query Service.

Introduzione getting-started

L’editor delle query fornisce un’esecuzione flessibile delle query tramite la connessione a Query Service e le query vengono eseguite solo quando la connessione è attiva.

Accesso all’editor delle query accessing-query-editor

Nell'interfaccia utente Experience Platform, selezionare Query nel menu di navigazione sinistro per aprire l'area di lavoro Servizio query. Quindi, per iniziare a scrivere le query, seleziona Crea query in alto a destra dello schermo. Questo collegamento è disponibile da una qualsiasi delle pagine dell’area di lavoro Servizio query.

Connessione a Query Service connecting-to-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.

Esecuzione delle query dall’editor delle query run-a-query

Le query eseguite dall’editor delle query vengono eseguite 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.

Creazione di query tramite l’Editor di query avanzato query-authoring

Utilizzando l’editor delle query, puoi scrivere, eseguire e salvare query per i dati sull’esperienza del cliente. Tutte le query eseguite o salvate nell’editor delle query sono disponibili per tutti gli utenti dell’organizzazione che hanno accesso a Query Service.

Selettore database database-selector

Selezionare un database per la query dal menu a discesa in alto a destra dell'editor di query. Il database selezionato viene visualizzato nel menu a discesa.

Impostazioni settings

Un'icona delle impostazioni sopra il campo di input di Query Editor include opzioni per abilitare/disabilitare il tema scuro o disabilitare/abilitare il completamento automatico.

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

Completamento automatico auto-complete

L'editor delle query suggerisce automaticamente parole chiave SQL potenziali insieme ai dettagli di tabella o colonna per la query durante la scrittura. La funzione di completamento automatico è attivata per impostazione predefinita e può essere disattivata o attivata in qualsiasi momento dalle impostazioni dell’editor delle query.

L’impostazione di configurazione del completamento automatico è per utente e viene memorizzata per gli accessi consecutivi per tale utente. 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.

Eseguire più query sequenziali execute-multiple-sequential-queries

Utilizza l’Editor query avanzato per scrivere più di una query ed eseguire tutte le query 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. Per ulteriori informazioni, consulta la documentazione dei registri di query.

Esegui query selezionata execute-selected-query

Se hai scritto più query ma devi eseguirne una sola, puoi evidenziare la query scelta e selezionare la
Icona Esegui query selezionata. Questa icona è disattivata per impostazione predefinita finché non selezioni la sintassi della query all’interno dell’editor.

Annulla sessione editor query cancel-query

Controlla l’esecuzione delle query e migliora la produttività annullando le query con tempi di esecuzione lunghi. Questa azione cancella l'Editor query durante l'esecuzione di una query. Tieni presente che la query continua a essere eseguita in background. Se si tratta di una query CTAS, verrà comunque generato un set di dati di output. Per annullare l'esecuzione nell'editor e continuare a comporre un'istruzione SQL, selezionare Annulla query dopo aver eseguito una query.

Viene visualizzata una finestra di dialogo di conferma. Selezionare Conferma per annullare l'esecuzione della query.

Conteggio risultati result-count

L’editor delle query può contenere un massimo di 50.000 righe. Puoi scegliere il numero di righe da visualizzare contemporaneamente nella console dell’editor delle query. Per modificare il numero di righe visualizzate nella console, seleziona l'elenco a discesa Numero risultati e le opzioni 50, 100, 150, 300 e 500.

Scrittura delle query writing-queries

L'editor di query è organizzato in modo da semplificare al massimo la scrittura delle query. La schermata seguente mostra come viene visualizzato l'editor nell'interfaccia utente, con il campo di immissione SQL e Riproduci evidenziati.

Per ridurre al minimo il tempo di sviluppo, ti consigliamo di sviluppare le query con limiti al numero di 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 per generare un set di dati con l'output.

Strumenti di scrittura nell’editor delle query writing-tools

Utilizza gli strumenti di scrittura dell’editor delle query per migliorare il processo di creazione delle query. Le funzionalità includono opzioni per la formattazione del testo, la copia delle istruzioni SQL, la gestione dei dettagli delle query e il salvataggio o la pianificazione del lavoro in corso.

Formatta testo format-text

La funzionalità Formatta testo rende la query più leggibile aggiungendo uno stile di sintassi standardizzato. Selezionare Formato testo per standardizzare tutto il testo nell'editor di query.

Copia SQL copy-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.

Dettagli query query-details

Per visualizzare una query nell'editor delle query, selezionare un modello salvato dalla scheda Modelli. Il pannello Dettagli query fornisce ulteriori informazioni e strumenti per gestire la query selezionata. Mostra inoltre metadati utili, ad esempio l’ultima volta che la query è stata modificata e chi l’ha modificata, se applicabile.

Dal pannello dei dettagli puoi generare un set di dati di output direttamente dall’interfaccia utente, eliminare o denominare la query visualizzata, visualizzare la pianificazione di esecuzione della query e aggiungere la query a una pianificazione.

Per generare un set di dati di output, selezionare Esegui come CTAS. Viene visualizzata la finestra di dialogo Immettere i dettagli del set di dati di output. Immettere un nome e una descrizione, quindi selezionare Esegui come CTAS. Il nuovo set di dati viene visualizzato nella scheda Sfoglia di Set di dati. Per ulteriori informazioni sui set di dati disponibili per la tua organizzazione, consulta la documentazione sulla visualizzazione dei set di dati.

Dopo aver eseguito l'azione Esegui come CTAS, viene visualizzato un messaggio di conferma per segnalare l'azione riuscita. Questo messaggio a comparsa contiene un collegamento che consente di accedere facilmente all’area di lavoro dei registri delle query. Per ulteriori informazioni sui registri query, consulta la documentazione dei registri query.

Salvataggio delle query saving-queries

L’editor delle query 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 superiore destro dell'editor di query. Prima di salvare una query, è necessario specificare un nome per la query utilizzando il pannello Dettagli query.

Quando salvi una query nell’editor delle query, viene visualizzato un messaggio di conferma per informarti dell’azione riuscita. Questo messaggio a comparsa contiene un collegamento che consente di accedere facilmente all’area di lavoro di pianificazione delle query. Per informazioni su come eseguire query su una cadenza personalizzata, consulta la documentazione sulle query di pianificazione.

Query pianificate scheduled-queries

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 e salvata. La stessa limitazione non si applica all’API Query Service.

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

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 esecuzione non riuscita. Per ulteriori informazioni, vedere il documento Monitorare le query pianificate.

Come trovare le query precedenti previous-queries

Tutte le query eseguite dall'editor di query vengono acquisite nella tabella Registro. È possibile utilizzare la funzionalità di ricerca nella scheda Registro per trovare le esecuzioni delle query. Le query salvate sono elencate nella scheda Modelli.

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

[Disponibilità limitata]{class="badge informative"} Visualizzatore oggetti object-browser

Utilizza il browser oggetti per cercare e filtrare facilmente i set di dati. Il browser oggetti riduce il tempo impiegato per la ricerca di tabelle e set di dati in ambienti di grandi dimensioni con numerosi set di dati. Grazie all’accesso semplificato ai dati e ai metadati rilevanti, puoi concentrarti di più sull’authoring delle query e meno sulla navigazione.

Per spostarsi nel database con il browser oggetti, immettere un nome di tabella nel campo di ricerca oppure selezionare Tabelle per espandere l'elenco dei set di dati e delle tabelle disponibili. Quando si utilizza il campo di ricerca, l’elenco delle tabelle disponibili viene filtrato in modo dinamico in base all’input.

Ogni set di dati contenuto nel database selezionato è elencato in una barra di spostamento a sinistra dell'editor di query.

Lo schema visualizzato nel browser oggetti è uno schema osservabile. Ciò significa che puoi utilizzarlo per monitorare le modifiche e gli aggiornamenti in tempo reale, man mano che le modifiche sono immediatamente visibili. Gli schemi osservabili consentono di garantire la sincronizzazione dei dati e supportano le attività di debug o di analisi.

Limitazioni attuali current-limitations

Di seguito è riportato un elenco delle limitazioni correnti:

Accedere ai metadati della tabella table-metadata

Oltre alle ricerche rapide, ora è possibile accedere facilmente ai metadati per qualsiasi tabella selezionando l’icona "i" accanto al nome della tabella. In questo modo vengono fornite informazioni dettagliate sulla tabella selezionata, che consentono di prendere decisioni informate durante la scrittura delle query.

Esplora tabelle secondarie

Per esplorare tabelle secondarie o collegate, seleziona la freccia a discesa accanto al nome di una tabella nell’elenco. In questo modo la tabella viene espansa per mostrare tutte le tabelle figlio associate e viene fornita una chiara visualizzazione della struttura dei dati e vengono consentite costruzioni di query più complesse. L'icona accanto al nome del campo indica il tipo di dati della colonna. to ti aiuta a identificarlo durante le query complesse.

Esecuzione di query tramite Editor query executing-queries

Per eseguire una query in Query Editor, è possibile immettere SQL nell'editor o caricare una query precedente dalla scheda Registro o Modelli e selezionare Riproduci. Lo stato dell'esecuzione della query viene visualizzato nella scheda Console e i dati di output vengono visualizzati nella scheda Risultati.

Console console

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

Risultati della query query-results

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 tra 50 e 500 righe di risultati a seconda del conteggio dei risultati scelto. Questa vista consente di verificare che la query produca l’output previsto. Per generare un set di dati con la query, rimuovere i limiti sulle righe restituite ed eseguire 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 delle query in Query Editor, consulta l'esercitazione sulla generazione di set di dati.

Esempi examples

Query Service offre soluzioni per una varietà di casi d’uso in diversi settori e scenari aziendali. Questi esempi dimostrano la flessibilità e l'impatto del servizio nel soddisfare le diverse esigenze. Per scoprire in che modo Query Service può apportare valore alle tue esigenze aziendali specifiche, esplora la raccolta completa di documenti relativi ai casi d'uso. Scopri come utilizzare Query Service per fornire informazioni approfondite e soluzioni per migliorare l’efficienza operativa e il successo aziendale.

Video tutorial sull’esecuzione di query con Query Service query-tutorial-video

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 si conoscono le funzionalità disponibili nell'editor delle query e si conosce come esplorare l'applicazione, è possibile iniziare a creare query personalizzate direttamente in Platform. Per ulteriori informazioni sull'esecuzione di query SQL sui set di dati in Data Lake, vedere la guida in esecuzione di query.