> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Tabla del sistema que contiene información sobre archivos de metadatos leídos de tablas Iceberg. Cada entrada representa un archivo de metadatos raíz, metadatos extraídos de un archivo Avro o una entrada de un archivo Avro.

# system.iceberg_metadata_log

<Info>
  **Consultas en ClickHouse Cloud**

  Los datos de esta tabla del sistema se almacenan localmente en cada nodo de ClickHouse Cloud. Por lo tanto, para obtener una vista completa de todos los datos, es necesario usar la función `clusterAllReplicas`. Consulta [aquí](/es/reference/system-tables/overview#system-tables-in-clickhouse-cloud) para más detalles.
</Info>

## Descripción

La tabla `system.iceberg_metadata_log` registra eventos de acceso a metadatos y de análisis para las tablas Iceberg leídas por ClickHouse. Proporciona información detallada sobre cada archivo de metadatos o entrada procesados, lo que resulta útil para tareas de depuración, auditoría y para comprender la evolución de la estructura de las tablas Iceberg.

Esta tabla registra cada archivo de metadatos y cada entrada leídos de tablas Iceberg, incluidos los archivos de metadatos raíz, las listas de manifiestos y las entradas de manifiesto. Ayuda a los usuarios a seguir cómo ClickHouse interpreta los metadatos de las tablas Iceberg y a diagnosticar problemas relacionados con la evolución del esquema, la resolución de archivos o la planificación de consultas.

Esta tabla está pensada principalmente para tareas de depuración.

### Control de la verbosidad del registro

Puede controlar qué eventos de metadatos se registran mediante la configuración [`iceberg_metadata_log_level`](/es/reference/settings/session-settings/iceberg-metadata#iceberg_metadata_log_level).

Para registrar todos los metadatos utilizados en la consulta actual:

```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}';
```

Para registrar únicamente el archivo JSON raíz de metadatos utilizado en la consulta actual:

```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}';
```

Consulte la descripción de la configuración [`iceberg_metadata_log_level`](/es/reference/settings/session-settings/iceberg-metadata#iceberg_metadata_log_level) para obtener más información.

### Conviene saberlo

* Use `iceberg_metadata_log_level` a nivel de consulta solo cuando necesite investigar su tabla Iceberg en detalle. De lo contrario, podría llenar la tabla de registro con una cantidad excesiva de metadatos y sufrir una degradación del rendimiento.
* La tabla contiene entradas duplicadas, ya que está pensada principalmente para depuración y no garantiza la unicidad por entidad. Filas independientes almacenan el contenido y el estado de poda porque se recopilan en momentos distintos del programa. El contenido se recopila cuando se leen los metadatos; el estado de poda se recopila cuando se comprueban los metadatos para determinar si se pueden podar. **Nunca confíe en la propia tabla para la deduplicación.**
* Si usa un `content_type` más detallado que `ManifestListMetadata`, la caché de metadatos de Iceberg se desactiva para las listas de manifiestos.
* Del mismo modo, si usa un `content_type` más detallado que `ManifestFileMetadata`, la caché de metadatos de Iceberg se desactiva para los archivos de manifiesto.
* Si la consulta SELECT se canceló o falló, la tabla de registro aún puede contener entradas de metadatos procesados antes del fallo, pero no contendrá información sobre las entidades de metadatos que no se hayan procesado.

Es seguro truncar o eliminar esta tabla en cualquier momento.

## Columnas

* `hostname` ([LowCardinality(String)](/es/reference/data-types/lowcardinality)) — Nombre del host del servidor que ejecuta la consulta.
* `clickhouse_version` ([LowCardinality(String)](/es/reference/data-types/lowcardinality)) — Versión del servidor de ClickHouse que generó la fila.
* `system_processor` ([LowCardinality(String)](/es/reference/data-types/lowcardinality)) — Arquitectura de CPU del servidor de ClickHouse que generó la fila.
* `event_date` ([Date](/es/reference/data-types/date)) — Fecha de la entrada.
* `event_time` ([DateTime](/es/reference/data-types/datetime)) — Hora del evento.
* `query_id` ([String](/es/reference/data-types/string)) — ID de la consulta.
* `content_type` ([Enum8('None' = 0, 'Metadata' = 1, 'ManifestListMetadata' = 2, 'ManifestListEntry' = 3, 'ManifestFileMetadata' = 4, 'ManifestFileEntry' = 5)](/es/reference/data-types/enum)) — Tipo de contenido.
* `table_path` ([String](/es/reference/data-types/string)) — Ruta de la tabla.
* `file_path` ([String](/es/reference/data-types/string)) — Ruta del archivo.
* `content` ([String](/es/reference/data-types/string)) — Contenido en formato JSON (contenido de archivo JSON, metadatos de Avro o entrada de Avro).
* `row_in_file` ([Nullable(UInt64)](/es/reference/data-types/nullable)) — Fila del archivo.
* `pruning_status` ([Nullable(Enum8('NotPruned' = 0, 'PartitionPruned' = 1, 'MinMaxIndexPruned' = 2))](/es/reference/data-types/nullable)) — Estado de la poda de particiones o de la poda del índice min-max para el archivo.

### Valores de `content_type`

* `None`: Sin contenido.
* `Metadata`: Archivo de metadatos raíz.
* `ManifestListMetadata`: Metadatos de la lista de manifiestos.
* `ManifestListEntry`: Entrada en la lista de manifiestos.
* `ManifestFileMetadata`: Metadatos del archivo de manifiesto.
* `ManifestFileEntry`: Entrada en el archivo de manifiesto.

## Véase también

* [Motor de tabla Iceberg](/es/reference/engines/table-engines/integrations/iceberg)
* [Función de tabla Iceberg](/es/reference/functions/table-functions/iceberg)
* [system.iceberg\_history](/es/reference/system-tables/iceberg_history)