system.delta_lake_metadata_log

Таблица system.delta_lake_metadata_log фиксирует события доступа к метаданным и их разбора для таблиц Delta Lake, которые читает ClickHouse. Она предоставляет подробную информацию о каждом файле метаданных, что полезно для отладки, аудита и понимания эволюции структуры таблиц Delta Lake.

Назначение

Эта таблица регистрирует каждый файл метаданных, прочитанный из таблиц Delta Lake. Она помогает пользователям отследить, как ClickHouse интерпретирует метаданные таблиц Delta, и диагностировать проблемы, связанные с эволюцией схемы, выбором снимка (snapshot) или планированием выполнения запросов.

Примечание

Эта таблица предназначена в первую очередь для целей отладки.

Столбцы

Имя	Тип	Описание
event_date	Date	Дата файла журнала.
event_time	DateTime	Временная метка события.
query_id	String	Идентификатор запроса, инициировавшего чтение метаданных.
table_path	String	Путь к таблице Delta Lake.
file_path	String	Путь к корневому JSON-файлу метаданных.
content	String	Содержимое в формате JSON (исходные метаданные из файла .json).

Выполнение запросов в ClickHouse Cloud

Данные в этой системной таблице хранятся локально на каждом узле в ClickHouse Cloud. Поэтому для получения полного обзора всех данных требуется функция clusterAllReplicas. Подробности см. здесь.

Управление уровнем детализации журналирования

Вы можете управлять тем, какие события, связанные с метаданными, записываются в журнал с помощью настройки delta_lake_log_metadata.

Чтобы записывать в журнал все метаданные, используемые в текущем запросе:

SELECT * FROM my_delta_table SETTINGS delta_lake_log_metadata = 1;

SYSTEM FLUSH LOGS delta_lake_metadata_log;

SELECT *
FROM system.delta_lake_metadata_log
WHERE query_id = '{previous_query_id}';