Tabella di sistema di riferimento della cronologia delle query

Questo articolo include informazioni sulla tabella di sistema della cronologia delle query, compresa una sintesi dello schema della tabella.

percorso tabella: questa tabella di sistema si trova in system.query.history.

Uso della tabella cronologia query

La tabella della cronologia delle query include i record per le query eseguite utilizzando SQL Warehouses o Serverless Compute per i notebook e i processi . La tabella include record globali dell'account di tutti gli spazi di lavoro nella stessa regione da cui si accede alla tabella.

Per impostazione predefinita, solo gli amministratori hanno accesso alla tabella di sistema. Se si desidera condividere i dati della tabella con un utente o un gruppo, Databricks consiglia di creare una visualizzazione dinamica per ogni utente o gruppo. Vedere Creare una visualizzazione dinamica.

Schema della cronologia delle query nella tabella di sistema

La tabella della cronologia delle query utilizza la seguente struttura:

Accedi al testo della dichiarazione mascherata

Le istruzioni SQL possono contenere informazioni sensibili come nomi clienti, indirizzi email o altre informazioni personali identificabili (PII). Il statement_text campo restituisce <REDACTED> di default. Gli account admin e i membri del databricks_pii_access gruppo possono leggere il testo SQL completo.

Il databricks_pii_access gruppo non è creato per te. Un amministratore dell'account deve crearlo. Il nome del gruppo è distinto dalla mazzevolezza e la maiuscola.

Crea il gruppo e gestisci l'iscrizione utilizzando uno qualsiasi di questi metodi:

• Console account. Vedi Aggiungi gruppi al tuo account.
• API dei gruppi account. Vedi Gestisci gruppi usando l'API.
• Sistema per la Gestione dell'Identità Cross-domain (SCIM). Consulta Sincronizzare utenti e gruppi da Microsoft Entra ID utilizzando SCIM.
• Gestione automatica dell'identità. Vedere Gestione automatica delle identità.

Se databricks_pii_access è stato creato dalle impostazioni di amministratore dello spazio di lavoro, un amministratore dell'account può revocare il permesso di gestione dell'amministratore dello spazio sul gruppo:

1. Accedere alla console dell'account come amministratore dell'account.
2. Nella barra laterale, fare clic su Gestione utenti.
3. Nella scheda Gruppi , clicca databricks_pii_accesssu .
4. Fare clic sulla scheda Permessi.
5. Rimuovi la Gestione dagli amministratori dello spazio di lavoro. Vedere Gestire le autorizzazioni per un gruppo.

Dopo aver aggiunto membri, i presidi possono databricks_pii_access leggere senza maschera statement_text. Rivedi dashboard, avvisi e job che leggono statement_text e confermano che il principale che gestisce ogni carico di lavoro è nel gruppo.

È possibile creare una nuova chiave o riutilizzare una chiave esistente. Usando l'ID chiave completo, eseguire il comando seguente:

curl -v -X PATCH https://my-workspace-url/api/2.1/unity-catalog/catalogs/system -H 'Authorization: Bearer <pat token>' --data '{
"managed_encryption_settings": {
        "azure_key_vault_key_id": "https://my-key-vault.vault.azure.net/keys/my-key-name/my-key-version",
        "azure_encryption_settings": {
          "azure_tenant_id": "my-tenant-id"
        }
      }
}'

Attendere fino a 24 ore per system.query.history iniziare a visualizzare i campi crittografati.

::::

Visualizza il profilo di query per un record

Per passare al profilo di una query basato su un record nella tabella della cronologia delle query, seguire i passaggi seguenti:

1. Identifica il record di interesse, quindi copia il statement_id del record.
2. Fare riferimento al record workspace_id per assicurarsi di essere connessi alla stessa area di lavoro del record.
3. Fare clic Cronologia delle query nella barra laterale dell'area di lavoro.
4. Nel campo Statement ID incolla statement_id al record.
5. Fare clic sul nome di una query. Viene visualizzata una panoramica delle metriche di query.
6. Fare clic su Vedere profilo delle query.

Comprendere la colonna query_source

La colonna query_source contiene un set di identificatori univoci di Azure Databricks entità coinvolte nell'esecuzione dell'istruzione.

Se la query_source colonna contiene più ID, significa che l'esecuzione dell'istruzione è stata attivata da più entità. Ad esempio, un risultato del lavoro può attivare un avviso che chiama una query SQL. In questo esempio tutti e tre gli ID verranno popolati all'interno di query_source. I valori di questa colonna non vengono ordinati in base all'ordine di esecuzione.

Le possibili origini di query sono:

• alert_id: istruzione attivata da un avviso
• sql_query_id: istruzione eseguita dall'interno di questa sessione dell'editor SQL
• dashboard_id: istruzione eseguita da un dashboard
• genie_space_id: istruzione eseguita da un agente Genie
• notebook_id: istruzione eseguita da un notebook
• job_info.job_id: istruzione eseguita all'interno di un processo
• job_info.job_run_id: istruzione eseguita da un'esecuzione di un lavoro
• job_info.job_task_run_id: Istruzione eseguita all'interno di un'esecuzione di un compito lavorativo

Combinazioni valide di query_source

Gli esempi seguenti illustrano come la query_source colonna viene popolata a seconda della modalità di esecuzione della query:

• Le query eseguite durante un'esecuzione di un processo includono una struttura popolata job_info.

  {
alert_id: null,
sql_query_id: null,
dashboard_id: null,
notebook_id: null,
job_info: {
job_id: 64361233243479,
job_run_id: null,
job_task_run_id: 110378410199121
},
legacy_dashboard_id: null,
genie_space_id: null
}

• Le query dagli avvisi includono un sql_query_id e un alert_id.

  {
alert_id: e906c0c6-2bcc-473a-a5d7-f18b2aee6e34,
sql_query_id: 7336ab80-1a3d-46d4-9c79-e27c45ce9a15,
dashboard_id: null,
notebook_id: null,
job_info: null,
legacy_dashboard_id: null,
genie_space_id: null
}

• Le interrogazioni dai cruscotti includono dashboard_id, ma non job_info.

  {
alert_id: null,
sql_query_id: null,
dashboard_id: 887406461287882,
notebook_id: null,
job_info: null,
legacy_dashboard_id: null,
genie_space_id: null
}