Solución de problemas de Metadatos de S3

Utilice la siguiente información para diagnosticar y solucionar los problemas comunes que es posible que surjan cuando se trabaja con Metadatos de Amazon S3.

No puedo eliminar mi bucket de tablas administradas de AWS ni las tablas de metadatos

Para poder eliminar una tabla de metadatos, primero debe eliminar la configuración de tabla de metadatos asociada en el bucket de uso general. Para obtener más información, consulte Eliminación de configuraciones de tablas de metadatos.

Para poder eliminar el bucket de tablas administradas de AWS, debe eliminar todas las configuraciones de tablas de metadatos asociadas a este bucket y todas las tablas de metadatos del bucket. Para obtener más información, consulte Eliminación de configuraciones de tablas de metadatos y Eliminación de tablas de metadatos.

No puedo establecer ni cambiar la configuración de cifrado de mi tabla de metadatos administrada de AWS

Al crear la configuración de las tablas de metadatos, puede cifrar las tablas de metadatos administradas de AWS con cifrado del servidor con las claves de AWS Key Management Service (AWS KMS) (SSE-KMS). Si decide utilizar SSE-KMS, debe proporcionar una clave de KMS administrada por el cliente en la misma región que el bucket de uso general. Solo puede establecer el tipo de cifrado para las tablas durante la creación de estas. Después de crear una tabla administrada de AWS, no se puede cambiar la configuración de cifrado. Para especificar SSE-KMS para las tablas de metadatos, debe tener ciertos permisos. Para obtener más información, consulte Permisos para SSE-KMS.

La configuración de cifrado de una tabla de metadatos tiene prioridad sobre la configuración de cifrado de bucket predeterminada. Si no especifica el cifrado de una tabla, esta heredará la configuración de cifrado predeterminada del bucket.

De forma predeterminada, a los buckets de tablas administradas de AWS se les aplica el cifrado del servidor con claves administradas por Amazon S3 (SSE-S3). Después de crear la primera configuración de metadatos, puede establecer en la configuración de cifrado predeterminada para el bucket de tablas administradas de AWS que utilice el cifrado del servidor con claves de AWS Key Management Service (AWS KMS) (SSE-KMS). Para obtener más información, consulte Cifrado para buckets de tablas administradas de AWS y Especificación del cifrado del servidor con claves de AWS KMS (SSE-KMS) en buckets de tablas.

Cuando intento volver a crear la configuración de mi tabla de metadatos, aparece un error

Al eliminar una configuración de tabla de metadatos, solo se elimina la configuración. El bucket de tablas administradas de AWS y las tablas de metadatos seguirán existiendo, incluso si elimina la configuración de tabla de metadatos.

Si elimina la configuración de tabla de metadatos y desea volver a crear una configuración para el mismo bucket de uso general, primero debe eliminar manualmente las tablas de diario e inventario anteriores del bucket de tablas administradas de AWS. De lo contrario, no se podrá crear la nueva configuración de la tabla de metadatos porque esas tablas ya existen.

Para eliminar las tablas de metadatos, consulte Eliminación de tablas de metadatos.

No puedo habilitar una tabla de inventario en mi configuración

Si creó la configuración de Metadatos de S3 antes del 15 de julio de 2025, no podrá habilitar una tabla de inventario en dicha configuración. Le recomendamos que elimine y vuelva a crear la configuración para poder crear una tabla de inventario y hacer caducar los registros de tabla de diario. Para obtener más información, consulte Habilitación de las tablas de inventario en configuraciones de metadatos creadas antes del 15 de julio de 2025.

No puedo habilitar la caducidad de registros de la tabla de diario en mi configuración

Si creó la configuración de Metadatos de S3 antes del 15 de julio de 2025, no podrá habilitar la caducidad de registros de tablas de diario en dicha configuración. Le recomendamos que elimine la configuración y la vuelva a crear para poder hacer caducar los registros de la tabla de diario y crear una tabla de inventario. Para obtener más información, consulte Habilitación de las tablas de inventario en configuraciones de metadatos creadas antes del 15 de julio de 2025.

No puedo consultar mis tablas de metadatos

Si no puede consultar las tablas de metadatos, verifique lo siguiente:

• Cuando utilice Amazon Athena o Amazon Redshift para consultar las tablas de metadatos, debe escribir los nombres de los espacios de nombres de las tablas de metadatos entre comillas (") o comillas inversas (`); de lo contrario, es posible que la consulta no funcione.

• Cuando utilice Apache Spark en Amazon EMR u otros motores de terceros para consultar las tablas de metadatos, le recomendamos que utilice el punto de conexión de REST Iceberg de Tablas de Amazon S3. La consulta podría no ejecutarse correctamente si no utiliza este punto de conexión. Para obtener más información, consulte Acceso a tablas mediante el punto de conexión Iceberg REST de Tablas de Amazon S3.

• Asegúrese de que dispone de los permisos de AWS Identity and Access Management (IAM) adecuados para consultar tablas de metadatos. Para obtener más información, consulte Permisos para consultar tablas de metadatos.

• Si utiliza Amazon Athena y recibe errores al intentar ejecutar las consultas, haga lo siguiente:

  • Si recibe el error “Insufficient permissions to execute the query. Principal does not have any privilege on specified resource” cuando intenta ejecutar una consulta en Athena, se le deberán conceder los permisos necesarios de Lake Formation para la tabla. Para obtener más información, consulte Concesión de permisos sobre una tabla o base de datos.

  • Si recibe el error “Iceberg cannot access the requested resource” al intentar ejecutar la consulta, vaya a la consola de AWS Lake Formation y asegúrese de haberse concedido permisos para el espacio de nombres de base de datos y catálogo de buckets de tablas que creó. No especifique una tabla al conceder estos permisos. Para obtener más información, consulte Concesión de permisos sobre una tabla o base de datos.

Recibo errores 405 cuando intento utilizar determinados comandos de la AWS CLI de Metadatos de S3 y operaciones de la API

Al llamar a la operación de la API V1 GetBucketMetadataTableConfiguration o utilizar el comando get-bucket-metadata-table-configuration de la AWS Command Line Interface (AWS CLI) en una configuración de tabla de metadatos V2, se produce un error HTTP 405 Method Not Allowed. Del mismo modo, llamar a la operación de la API DeleteBucketMetadataTableConfiguration V1 o utilizar el comando delete-bucket-metadata-table-configuration de la AWS CLI también provoca un error 405.

Puede utilizar la operación de la API GetBucketMetadataConfiguration V2 o el comando get-bucket-metadata-configuration de la AWS CLI con una configuración de tabla de metadatos V1 o V2. Del mismo modo, puede utilizar la operación de la API DeleteBucketMetadataConfiguration V2 o el comando delete-bucket-metadata-configuration de la AWS CLI con una configuración de tabla de metadatos V1 o V2.

Recomendamos actualizar los procesos para utilizar las nuevas operaciones de la API V2 (CreateBucketMetadataConfiguration, GetBucketMetadataConfiguraion y DeleteBucketMetadataConfiguration) en lugar de las operaciones de la API V1. Para obtener más información sobre la migración de la versión V1 de Metadatos de S3 a la V2, consulte Habilitación de las tablas de inventario en configuraciones de metadatos creadas antes del 15 de julio de 2025.

Para determinar si la configuración es V1 o V2, puede consultar el siguiente atributo de la respuesta de la API GetBucketMetadataConfiguration. Un tipo de bucket administrado de AWS ("aws") indica una configuración de V2 y un tipo de bucket administrado por el cliente ("customer") indica una configuración de V1.

"MetadataTableConfigurationResult": {
            "TableBucketType": ["aws" | "customer"]

Para obtener más información, consulte Visualización de las configuraciones de tabla de metadatos.