> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Системная таблица, содержащая информацию о файлах метаданных, прочитанных из Iceberg-таблиц. Каждая запись представляет собой либо корневой файл метаданных, либо метаданные, извлечённые из Avro-файла, либо запись из некоторого Avro-файла.

# system.iceberg_metadata_log

<Info>
  **Запросы в ClickHouse Cloud**

  Данные в этой системной таблице хранятся локально на каждом узле ClickHouse Cloud. Поэтому, чтобы получить полное представление обо всех данных, требуется функция `clusterAllReplicas`. Дополнительные сведения см. [здесь](/ru/reference/system-tables/overview#system-tables-in-clickhouse-cloud).
</Info>

<div id="description">
  ## Описание
</div>

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

В этой таблице регистрируются все файлы метаданных и записи, считанные из таблиц Iceberg, включая корневые файлы метаданных, списки манифестов и записи манифестов. Она помогает пользователям отслеживать, как ClickHouse интерпретирует метаданные таблиц Iceberg, и диагностировать проблемы, связанные с эволюцией схемы, разрешением файлов или планированием запросов.

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

<div id="controlling-log-verbosity">
  ### Управление уровнем детализации журналирования
</div>

Вы можете управлять тем, какие события метаданных записываются в журнал, с помощью настройки [`iceberg_metadata_log_level`](/ru/reference/settings/session-settings#iceberg_metadata_log_level).

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

```sql theme={null}
SELECT * FROM my_iceberg_table SETTINGS iceberg_metadata_log_level = 'manifest_file_entry';

SYSTEM FLUSH LOGS iceberg_metadata_log;

SELECT content_type, file_path, row_in_file
FROM system.iceberg_metadata_log
WHERE query_id = '{previous_query_id}';
```

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

```sql theme={null}
SELECT * FROM my_iceberg_table SETTINGS iceberg_metadata_log_level = 'metadata';

SYSTEM FLUSH LOGS iceberg_metadata_log;

SELECT content_type, file_path, row_in_file
FROM system.iceberg_metadata_log
WHERE query_id = '{previous_query_id}';
```

Дополнительную информацию см. в описании настройки [`iceberg_metadata_log_level`](/ru/reference/settings/session-settings#iceberg_metadata_log_level).

<div id="good-to-know">
  ### Полезно знать
</div>

* Используйте `iceberg_metadata_log_level` на уровне запроса только тогда, когда вам нужно детально исследовать таблицу Iceberg. В противном случае таблица логов может переполниться избыточными метаданными, что приведёт к снижению производительности.
* Таблица содержит повторяющиеся записи, поскольку предназначена прежде всего для отладки и не гарантирует уникальность для каждой сущности. Отдельные строки хранят содержимое и статус отсечения, поскольку они собираются в разные моменты работы программы. Содержимое собирается при чтении метаданных, а статус отсечения — при проверке метаданных на возможность отсечения. **Никогда не используйте саму таблицу для дедупликации.**
* Если вы используете `content_type` с большей детализацией, чем `ManifestListMetadata`, кэш метаданных Iceberg для списков манифестов отключается.
* Аналогично, если вы используете `content_type` с большей детализацией, чем `ManifestFileMetadata`, кэш метаданных Iceberg для файлов манифестов отключается.
* Если запрос SELECT был отменён или завершился ошибкой, таблица логов всё равно может содержать записи о метаданных, обработанных до сбоя, но не будет содержать информации о сущностях метаданных, которые не были обработаны.

<div id="columns">
  ## Столбцы
</div>

* `hostname` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — Имя хоста сервера, выполняющего запрос.
* `event_date` ([Date](/ru/reference/data-types/date)) — Дата записи.
* `event_time` ([DateTime](/ru/reference/data-types/datetime)) — Время события.
* `query_id` ([String](/ru/reference/data-types/string)) — Query id.
* `content_type` ([Enum8('None' = 0, 'Metadata' = 1, 'ManifestListMetadata' = 2, 'ManifestListEntry' = 3, 'ManifestFileMetadata' = 4, 'ManifestFileEntry' = 5)](/ru/reference/data-types/enum)) — Тип содержимого.
* `table_path` ([String](/ru/reference/data-types/string)) — Путь к таблице.
* `file_path` ([String](/ru/reference/data-types/string)) — Путь к файлу.
* `content` ([String](/ru/reference/data-types/string)) — Содержимое в формате JSON (содержимое JSON‑файла, метаданные Avro или запись Avro).
* `row_in_file` ([Nullable(UInt64)](/ru/reference/data-types/nullable)) — Строка в файле.
* `pruning_status` ([Nullable(Enum8('NotPruned' = 0, 'PartitionPruned' = 1, 'MinMaxIndexPruned' = 2))](/ru/reference/data-types/nullable)) — Статус отсечения файла по партициям или min-max индексу.

<div id="content-type-values">
  ### Значения `content_type`
</div>

* `None`: Содержимое отсутствует.
* `Metadata`: Корневой файл метаданных.
* `ManifestListMetadata`: Метаданные списка манифестов.
* `ManifestListEntry`: Запись в списке манифестов.
* `ManifestFileMetadata`: Метаданные файла манифеста.
* `ManifestFileEntry`: Запись в файле манифеста.

<div id="see-also">
  ## См. также
</div>

* [Движок таблицы Iceberg](/ru/reference/engines/table-engines/integrations/iceberg)
* [Табличная функция Iceberg](/ru/reference/functions/table-functions/iceberg)
* [system.iceberg\_history](/ru/reference/system-tables/iceberg_history)