DocumentazioneExperience PlatformGuida di Query Service

Registri query

Last update: Thu Jul 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Utente
  • Sviluppatore
IMPORTANT
Alcune funzioni dei registri di query sono attualmente in una versione limitata e non sono disponibili per tutti i clienti. L’interfaccia utente potrebbe apparire leggermente diversa senza un’icona di modifica. È inoltre possibile che il processo di selezione di un nome di query passi all'editor query anziché alla visualizzazione Dettagli registro query.

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 check-query-logs

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 Platform con query e registro evidenziati.

I registri di Query Service vengono presentati in un formato di tabella personalizzabile. Per personalizzare le colonne della tabella, selezionare l'icona Impostazioni ( A 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.

IMPORTANT
Alcune funzioni dei registri di query sono attualmente in una versione limitata e non sono disponibili per tutti i clienti.

È 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 edit-logs

Accanto al nome del modello di ogni riga o al frammento SQL è presente l'icona di una matita ( Unicona 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 filter-logs

Puoi filtrare l’elenco dei registri di query in base a diverse impostazioni. Selezionare l'icona filtro ( 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
ccf2b369-4031-483f-af63-a93b5ae5e3fb