Query Service Guida all’interfaccia utente

Adobe Experience Platform Query Service fornisce un’interfaccia utente che può essere utilizzata per scrivere ed eseguire query, visualizzare le query eseguite in precedenza e accedere a quelle salvate dagli utenti della tua organizzazione. Per accedere all’interfaccia utente in Adobe Experience Platform, seleziona Query nel menu di navigazione a sinistra.

Query Editor

Il Query Editor consente di scrivere ed eseguire query senza utilizzare un client esterno. Seleziona Crea query per aprire Query Editor e crea una nuova query. È inoltre possibile accedere al Query Editor selezionando una query dalla Log o Modelli schede. Selezionando una query eseguita o salvata in precedenza si aprirà la Query Editor e visualizza l'istruzione SQL per la query selezionata.

Dashboard delle query con Crea query evidenziato.

Query Editor fornisce uno spazio di modifica in cui è possibile iniziare a digitare una query. Durante la digitazione, l'editor completa automaticamente le parole riservate SQL, le tabelle e i nomi dei campi all'interno delle tabelle. Al termine della scrittura della query, selezionare Play per eseguire la query. Il Console sotto l’editor mostra ciò che Query Service , che indica quando è stata restituita una query. Il Risultato accanto alla Console, visualizza i risultati della query. Consulta la Guida all’editor delle query per ulteriori informazioni sull'utilizzo di Query Editor.

Zoom in visualizzazione della Query Editor.

Query pianificate

È possibile pianificare l'esecuzione di query già salvate come modello con una frequenza regolare. Quando pianifichi una query, puoi scegliere la frequenza delle esecuzioni, la data di inizio e di fine, il giorno della settimana in cui viene eseguita la query pianificata e il set di dati in cui esportare la query. Le pianificazioni delle query vengono impostate mediante l'Editor query.

Per informazioni su come pianificare una query tramite l’interfaccia utente, consulta guida alle query pianificate. Per informazioni su come aggiungere pianificazioni utilizzando l’API, leggi la guida dell’endpoint "scheduled queries".

Una volta pianificata, la query viene visualizzata nell’elenco delle query pianificate nel Query pianificate scheda. Per informazioni dettagliate sulla query, sulle esecuzioni, sul creatore e sugli intervalli, seleziona una query pianificata dall’elenco.

L’area di lavoro Query, con la scheda Query pianificate evidenziata, mostra le righe delle pianificazioni delle query.

Colonna	Descrizione
Nome	Il campo del nome corrisponde al nome del modello o ai primi caratteri della query SQL. Tutte le query create tramite l’interfaccia utente con l’editor delle query sono denominate all’inizio. Se la query è stata creata tramite l’API, il nome della query è un frammento dell’istruzione SQL iniziale utilizzata per creare la query.
Modello	Nome del modello della query. Selezionate un nome di modello per passare all'editor di query. Il modello di query viene visualizzato nell’editor delle query per comodità. Se non è presente alcun nome di modello, la riga viene contrassegnata con un trattino e non è possibile reindirizzare all’editor delle query per visualizzare la query.
SQL	Frammento della query SQL.
Frequenza di esecuzione	Questa è la frequenza con cui la query è impostata per l'esecuzione. I valori disponibili sono `Run once` e `Scheduled`. Le query possono essere filtrate in base alla loro frequenza di esecuzione.
Creato da	Nome dell'utente che ha creato la query.
Creato	La marca temporale in formato UTC in cui è stata creata la query.
Timestamp dell’ultima esecuzione	Il timestamp più recente in cui è stata eseguita la query. In questa colonna viene evidenziato se una query è stata eseguita in base alla pianificazione corrente.
Stato ultima esecuzione	Stato dell’esecuzione della query più recente. I tre valori di stato sono: `successful` `failed` o `in progress`.

Consulta la documentazione per ulteriori informazioni su come monitorare le query tramite l’interfaccia utente di Query Service.

Modelli

Il Modelli Questa scheda mostra le query salvate dagli utenti dell’organizzazione. È utile considerarli come progetti di query, in quanto le query salvate qui potrebbero essere ancora in fase di costruzione. Query visualizzate nel Modelli viene visualizzata anche come query di esecuzione nel Log , se sono state precedentemente eseguite da Query Service.

Visualizzazione ingrandita della scheda Modelli del dashboard Query che visualizza diverse query salvate.

Colonna	Descrizione
Nome	Il campo del nome è il nome della query creato dall'utente o i primi caratteri della query SQL. Tutte le query create tramite l’interfaccia utente con l’editor delle query sono denominate all’inizio. Se la query è stata creata tramite l’API, il nome della query è un frammento dell’istruzione SQL iniziale utilizzata per creare la query. È possibile selezionare il nome della query per aprirla in Query Editor. È inoltre possibile utilizzare la barra di ricerca per cercare Nome di una query. Le ricerche distinguono tra maiuscole e minuscole.
SQL	I primi caratteri della query SQL. Passando il puntatore del mouse sul codice viene visualizzata la query completa.
Modificato da	Ultimo utente che ha modificato la query. Qualsiasi utente dell’organizzazione con accesso a Query Service può modificare le query.
Ultima modifica	La data e l’ora dell’ultima modifica alla query, nel fuso orario del browser.

Consulta la modelli di query per ulteriori informazioni sui modelli nell’interfaccia utente di Platform.

Registro

Il Log fornisce un elenco delle query eseguite in precedenza. Per impostazione predefinita, il registro elenca le query in ordine cronologico inverso.

Visualizzazione ingrandita della scheda Registro del dashboard Query che visualizza un elenco di query in ordine cronologico inverso.

Colonna	Descrizione
Nome	Il nome della query, costituito dai primi caratteri della query SQL. Seleziona il nome del modello per aprire Dettagli registro query vista per l'esecuzione. È possibile utilizzare la barra di ricerca per eseguire una ricerca in base al nome di una query. Le ricerche distinguono tra maiuscole e minuscole.
Ora di inizio	L’ora in cui è stata eseguita la query.
Tempo di completamento	L’ora in cui è stata completata la query.
Stato	Stato corrente della query.
Set di dati	Set di dati di input utilizzato dalla query. Seleziona il set di dati per passare alla schermata dei dettagli del set di dati di input.
Client	Client utilizzato per la query.
Creato da	Nome della persona che ha creato la query.

!![Note]
Seleziona l’icona della matita () da una riga qualsiasi del registro query per passare al Query Editor. La query è precompilata per facilitarne la modifica.

Consulta la documentazione dei registri di query per ulteriori informazioni sui file di registro generati automaticamente da un evento di query.

Credenziali

Il Credenziali nella scheda vengono visualizzate sia le credenziali in scadenza che quelle senza scadenza. Per ulteriori informazioni su come utilizzare queste credenziali per connettersi con client esterni, leggere guida alle credenziali.

Il dashboard Query con la scheda Credenziali evidenziata.

Passaggi successivi

Ora che conosci Query Service interfaccia utente su Platform, puoi accedere a Query Editor per iniziare a creare progetti di query personalizzati da condividere con altri utenti dell’organizzazione. Per ulteriori informazioni sull’authoring e l’esecuzione di query in Query Editor, vedere Query Editor guida utente.