Referenční informace k systémové tabulce historie dotazů

Důležité

Tato systémová tabulka je ve verzi Public Preview. Aby bylo možné získat přístup k tabulce, musí být schéma v system katalogu povolené. Další informace naleznete v tématu Povolení schémat systémových tabulek.

Tento článek obsahuje informace o systémové tabulce historie dotazů včetně přehledu schématu tabulky.

Důležité

Pokud chcete získat přístup k systémové tabulce historie dotazů, musíte schéma povolit query . Pokyny k povolení systémových schémat naleznete v tématu Povolení schémat systémových tabulek.

Cesta k tabulce: Tato systémová tabulka se nachází na system.query.historyadrese .

Použití tabulky historie dotazů

Tabulka historie dotazů obsahuje záznamy pro každé spuštění příkazu SQL pomocí SQL Warehouse. Tabulka obsahuje záznamy pro celý účet ze všech pracovních prostorů ve stejné oblasti, ze které přistupujete k tabulce.

Ve výchozím nastavení mají k systémové tabulce přístup jenom správci. Pokud chcete data tabulky sdílet s uživatelem nebo skupinou, doporučuje Databricks vytvořit dynamické zobrazení pro každého uživatele nebo skupinu. Viz Vytvoření dynamického zobrazení.

Schéma systémové tabulky historie dotazů

Tabulka historie dotazů používá následující schéma:

Název sloupce	Datový typ	Popis	Příklad
account_id	string	ID účtu.	11e22ba4-87b9-4cc2 -9770-d10b894b7118
workspace_id	string	ID pracovního prostoru, ve kterém byl dotaz spuštěn.	1234567890123456
statement_id	string	ID, které jednoznačně identifikuje provádění příkazu. Toto ID můžete použít k vyhledání spuštění příkazu v uživatelském rozhraní historie dotazů.	7a99b43c-b46c-432b -b0a7-814217701909
session_id	string	ID relace Sparku.	01234567-cr06-a2mp -t0nd-a14ecfb5a9c2
execution_status	string	Stav ukončení příkazu. Možné hodnoty jsou: - FINISHED: Provádění bylo úspěšné. - FAILED: spuštění selhalo s důvodem selhání popsaného v doprovodné chybové zprávě. - CANCELED: spuštění bylo zrušeno.	FINISHED
compute	struct	Struktura, která představuje typ výpočetního prostředku použitého ke spuštění příkazu a ID prostředku, pokud je to možné. Hodnota type bude buď WAREHOUSE nebo SERVERLESS_COMPUTE.	{ type: WAREHOUSE, cluster_id: NULL, warehouse_id: ec58ee3772e8d305 }
executed_by_user_id	string	ID uživatele, který příkaz spustil.	2967555311742259
executed_by	string	E-mailová adresa nebo uživatelské jméno uživatele, který příkaz spustil.	example@databricks.com
statement_text	string	Text příkazu SQL Pokud jste nakonfigurovali klíče spravované zákazníkem, statement_text je prázdné.	SELECT 1
statement_type	string	Typ příkazu. Například: ALTER, COPYaINSERT.	SELECT
error_message	string	Zpráva popisující chybový stav Pokud jste nakonfigurovali klíče spravované zákazníkem, error_message je prázdné.	[INSUFFICIENT_PERMISSIONS] Insufficient privileges: User does not have permission SELECT on table 'default.nyctaxi_trips'.
client_application	string	Klientská aplikace, která příkaz spustila. Příklad: Editor SQL Databricks, Tableau a Power BI. Toto pole je odvozeno z informací poskytovaných klientskými aplikacemi. I když se očekává, že hodnoty budou v průběhu času statické, nelze zaručit.	Databricks SQL Editor
client_driver	string	Konektor použitý k připojení k Azure Databricks ke spuštění příkazu. Příklad: Ovladač SQL Databricks pro Go, Ovladač ODBC Databricks, Ovladač Databricks JDBC.	Databricks JDBC Driver
total_duration_ms	bigint	Celková doba provádění příkazu v milisekundách (s výjimkou doby načítání výsledku).	1
waiting_for_compute_duration_ms	bigint	Doba strávená čekáním na zřízení výpočetních prostředků v milisekundách	1
waiting_at_capacity_duration_ms	bigint	Čas strávený čekáním ve frontě na dostupnou výpočetní kapacitu v milisekundách	1
execution_duration_ms	bigint	Čas strávený prováděním příkazu v milisekundách	1
compilation_duration_ms	bigint	Čas strávený načítáním metadat a optimalizací příkazu v milisekundách	1
total_task_duration_ms	bigint	Součet všech dob trvání úkolů v milisekundách Tentokrát představuje kombinovaný čas, který trvalo spuštění dotazu napříč všemi jádry všech uzlů. Pokud se paralelně provádí více úkolů, může to být výrazně delší než doba trvání hodin. Pokud úkoly čekají na dostupné uzly, může být kratší než doba trvání na nástěnné hodiny.	1
result_fetch_duration_ms	bigint	Čas strávený v milisekundách načte výsledky příkazu po dokončení provádění.	1
start_time	časové razítko	Čas, kdy Databricks obdržel požadavek. Informace o časovém pásmu se zaznamenávají na konci hodnoty s reprezentací +00:00 UTC.	2022-12-05T00:00:00.000+0000
end_time	časové razítko	Čas ukončení provádění příkazu s výjimkou času načtení výsledku. Informace o časovém pásmu se zaznamenávají na konci hodnoty s reprezentací +00:00 UTC.	2022-12-05T00:00:00.000+00:00
update_time	časové razítko	Čas, kdy příkaz naposledy obdržel aktualizaci průběhu. Informace o časovém pásmu se zaznamenávají na konci hodnoty s reprezentací +00:00 UTC.	2022-12-05T00:00:00.000+00:00
read_partitions	bigint	Počet oddílů přečtených po vyřazení.	1
pruned_files	bigint	Počet vyříznutých souborů.	1
read_files	bigint	Počet souborů přečtených po vyřazení.	1
read_rows	bigint	Celkový počet řádků přečtených příkazem	1
produced_rows	bigint	Celkový počet řádků vrácených příkazem	1
read_bytes	bigint	Celková velikost dat přečtených příkazem v bajtech	1
read_io_cache_percent	int	Procento bajtů trvalých dat načtených z mezipaměti vstupně-výstupních operací	50
from_result_cache	boolean	TRUE označuje, že výsledek příkazu byl načten z mezipaměti.	TRUE
spilled_local_bytes	bigint	Velikost dat v bajtech se během provádění příkazu dočasně zapisuje na disk.	1
written_bytes	bigint	Velikost v bajtech trvalých dat zapsaných do cloudového úložiště objektů.	1
shuffle_read_bytes	bigint	Celkové množství dat v bajtech posílaných přes síť.	1
query_source	struct	Struktura, která obsahuje páry klíč-hodnota představující jednu nebo více entit Databricks, které byly zapojeny do provádění tohoto příkazu, jako jsou úlohy, poznámkové bloky nebo řídicí panely. Toto pole zaznamenává pouze entity Databricks.	{ job_info: { job_id: 64361233243479 job_run_id: 887406461287882 job_task_key: “job_task_1” job_task_run_id: 110378410199121 }
executed_as	string	Název uživatele nebo instančního objektu, jehož oprávnění bylo použito ke spuštění příkazu.	example@databricks.com
executed_as_user_id	string	ID uživatele nebo instančního objektu, jehož oprávnění bylo použito ke spuštění příkazu.	2967555311742259

Zobrazení profilu dotazu pro záznam

Pokud chcete přejít na profil dotazu založený na záznamu v tabulce historie dotazů, postupujte takto:

1. Identifikujte záznam zájmu a zkopírujte záznam statement_id.
2. Odkazujte na záznam workspace_id a ujistěte se, že jste přihlášeni ke stejnému pracovnímu prostoru jako záznam.
3. Na bočním panelu pracovního prostoru klikněte na Historie dotazů.
4. Do pole ID příkazu vložte záznamstatement_id.
5. Klikněte na název dotazu. Zobrazí se přehled metrik dotazů.
6. Klikněte na Zobrazit profil dotazu.