Documentazione Experience Platform Guida di Query Service

Registri query

Ultimo aggiornamento: 4 aprile 2025

Argomenti:
Query

Creato per:

Utente
Sviluppatore

Adobe Experience Platform mantiene un registro di tutti gli eventi di query che si verificano sia tramite l’API che tramite l’interfaccia utente. Queste informazioni sono disponibili nell'interfaccia utente di Query Service dalla scheda Registri.

I file di registro vengono generati automaticamente da qualsiasi evento di query e contengono informazioni quali l'istruzione SQL utilizzata, lo stato della query, il tempo impiegato e l'ultima esecuzione. È possibile utilizzare i dati di registro delle query come strumento potente per la risoluzione di problemi inefficienti o di query con problemi. Informazioni di registro più complete vengono conservate come parte della funzione del registro di controllo e sono disponibili nella documentazione del registro di controllo.

Controllare i registri query

Per controllare i registri delle query, selezionare Query per passare all'area di lavoro del servizio query e selezionare Registro tra le opzioni disponibili.

NOTE

Per impostazione predefinita, sono escluse sia le query di sistema che le query del dashboard. Consulta la sezione filters per informazioni su come perfezionare i registri visualizzati in base alle impostazioni.

Interfaccia utente di Experience Platform con query e registro evidenziati.

Personalizza ed esegui ricerche

I registri di Query Service vengono presentati in un formato di tabella personalizzabile. Per personalizzare le colonne della tabella, selezionare l'icona Impostazioni ( ) a destra dello schermo. Viene visualizzata una finestra di dialogo Personalizza tabella in cui è possibile deselezionare ogni colonna.

Puoi anche cercare i registri relativi a modelli di query specifici digitando il nome del modello nel campo di ricerca.

Larea di lavoro Registro query con la barra di ricerca e lelenco a discesa Gestisci tabella colonne è evidenziato.

Nella sezione Log della panoramica di Query Service è disponibile una descrizione per ogni colonna della tabella di log.

Esplorare i dati di registro

Ogni riga rappresenta i dati di registro per un'esecuzione di query associata a un modello di query. Seleziona una riga della tabella per inserire nella barra laterale a destra i dati di registro per l’esecuzione.

Larea di lavoro Registro query con una riga selezionata e i dati di registro nella barra laterale a destra evidenziati.

Nel pannello dei dettagli del registro, potete eseguire diverse azioni. È possibile eseguire la query come CTAS, che crea un nuovo set di dati di output, visualizzare o copiare la query SQL completa utilizzata nell'esecuzione oppure eliminare la query.

NOTE

L'opzione Esegui come CTAS è disponibile solo per una query SELECT.

Larea di lavoro Registro query con una riga selezionata, Esegui come CTAS, Elimina query e licona Copia SQL evidenziata.

È inoltre possibile selezionare il nome di un modello di query dalla colonna Nome per passare direttamente alla visualizzazione Dettagli registro query.

NOTE

Se la query è stata creata utilizzando l’API e non è stato fornito alcun nome di modello durante l’inizializzazione, vengono invece visualizzati i primi decine di caratteri della query SQL.

Visualizzazione dettagli registro query.

Modifica registri

Accanto al nome del modello di ogni riga o al frammento SQL è presente l'icona di una matita ( ) da utilizzare per passare all'editor di query. La query viene quindi precompilata nell’editor per la modifica.

Larea di lavoro Registro query con licona a forma di matita evidenziata.

Filtra registri

Puoi filtrare l’elenco dei registri di query in base a diverse impostazioni. Selezionare l'icona filtro ( ) in alto a sinistra nell'area di lavoro per aprire un set di opzioni filtro nella barra a sinistra.

Area di lavoro registro query con licona del filtro evidenziata.

Viene visualizzato l’elenco dei filtri disponibili.

Larea di lavoro Registro query con le opzioni di filtro visualizzate ed evidenziate.

Nella tabella seguente viene fornita una descrizione di ogni filtro.

Filtro

Descrizione

Escludi query dashboard

Questa casella di controllo è attivata per impostazione predefinita ed esclude i registri generati dalle query utilizzate per generare le informazioni. Queste query sono generate dal sistema e nascondono i record dei registri generati dagli utenti e necessari per il monitoraggio, l’amministrazione e la risoluzione dei problemi. Per visualizzare i registri generati dal sistema, deseleziona la casella di controllo.

Escludi query di sistema

Questa casella di controllo è attivata per impostazione predefinita ed esclude i registri generati dal sistema. Le query generate dal sistema spesso includono attività in background o operazioni di manutenzione che potrebbero non essere rilevanti per il monitoraggio degli utenti, l’amministrazione o la risoluzione dei problemi. Se devi controllare i registri generati dal sistema, deseleziona questa casella di controllo per includerli nella vista del registro.

Data di inizio

Per filtrare i registri per le query create durante un periodo specifico, impostare le date Inizio e Fine nella sezione Data inizio.

Data completamento

Per filtrare i registri per le query completate durante un periodo specifico, impostare le date Inizio e Fine nella sezione Data completata.

Stato

Per filtrare i registri in base allo Stato della query, selezionare il pulsante di opzione appropriato. Le opzioni disponibili includono Inviato, In corso, Completato e Non riuscito. Puoi filtrare i registri solo in base a una condizione di stato alla volta.

Client

Per filtrare i registri in base al client di query utilizzato, immettere uno dei seguenti valori accettati nel campo di testo libero: API, Adobe Query Service UI o QsAccel.

Le mie query

Utilizza l'interruttore Query personali per filtrare i registri delle query eseguite da te.

ID registro query

Per filtrare in base all’ID registro univoco di una query, immetti l’ID registro nel campo di testo libero. Queste informazioni sono disponibili in Dettagli registro.

Tutti i filtri applicati vengono visualizzati sopra i risultati del registro filtrato.

Scheda Registro dellarea di lavoro Query, con lelenco dei filtri applicati evidenziato.

Passaggi successivi

La lettura di questo documento consente di comprendere meglio come i registri delle query vengono utilizzati e accessibili nell’interfaccia utente di Query Service.

Per ulteriori informazioni sulle funzionalità di Query Service, consulta la Panoramica dell'interfaccia utente o la Guida API di Query Service.

Per informazioni su come Query Service migliora la visibilità delle esecuzioni pianificate delle query, consulta il documento sulle query di monitoraggio.

recommendation-more-help