Résolution des problèmes liés aux métadonnées S3

Utilisez les informations suivantes pour vous aider à diagnostiquer et à résoudre les problèmes courants que vous pouvez rencontrer lors de l'utilisation des métadonnées Amazon S3.

Je ne parviens pas à supprimer mon bucket de tables AWS géré et mes tables de métadonnées

Avant de supprimer une table de métadonnées, vous devez commencer par supprimer la configuration de table de métadonnées associée dans votre compartiment à usage général. Pour de plus amples informations, veuillez consulter Suppression de configurations de tables de métadonnées.

Avant de pouvoir supprimer votre compartiment de table AWS géré, vous devez supprimer toutes les configurations de table de métadonnées associées à ce compartiment ainsi que toutes les tables de métadonnées qu'il contient. Pour plus d’informations, consultez Suppression de configurations de tables de métadonnées et Suppression des tables de métadonnées.

Je ne parviens pas à définir ou à modifier les paramètres de chiffrement pour ma table de métadonnées AWS gérées

Lorsque vous créez la configuration de votre table de métadonnées, vous pouvez choisir de chiffrer vos tables de métadonnées AWS gérées avec un chiffrement côté serveur à l'aide de clés AWS Key Management Service (AWS KMS) (SSE-KMS). Si vous choisissez d'utiliser SSE-KMS, vous devez fournir une clé KMS gérée par le client dans la même région que votre bucket à usage général. Vous pouvez définir le type de chiffrement de vos tables uniquement lors de leur création. Une fois qu'une table AWS gérée est créée, vous ne pouvez pas modifier ses paramètres de chiffrement. Pour spécifier SSE-KMS pour vos tables de métadonnées, vous devez disposer de certaines autorisations. Pour plus d'informations, consultez la section Autorisations pour SSE-KMS.

Le paramètre de chiffrement d'une table de métadonnées a priorité sur le paramètre de chiffrement par défaut au niveau du compartiment. Si vous ne spécifiez pas de chiffrement pour une table, celle-ci héritera du paramètre de chiffrement par défaut du compartiment.

Par défaut, les compartiments de tables AWS gérés sont chiffrés par chiffrement côté serveur à l'aide de clés gérées Amazon S3 (SSE-S3). Après avoir créé votre première configuration de métadonnées, vous pouvez définir le paramètre de chiffrement par défaut pour le compartiment de table AWS géré afin d'utiliser le chiffrement côté serveur avec des clés AWS Key Management Service (AWS KMS) (SSE-KMS). Pour plus d'informations, consultez les sections Chiffrement pour les compartiments de tables AWS gérés etSpécification du chiffrement côté serveur à l'aide de AWS KMS clés (SSE-KMS) dans des compartiments de table.

Lorsque j'essaie de recréer la configuration de ma table de métadonnées, un message d'erreur s'affiche

La suppression d'une configuration de table de métadonnées entraîne uniquement la suppression de la configuration. Le bucket de table AWS géré et vos tables de métadonnées existent toujours, même si vous supprimez la configuration des tables de métadonnées.

Si vous supprimez la configuration de votre table de métadonnées et souhaitez recréer une configuration pour le même compartiment à usage général, vous devez d'abord supprimer manuellement les anciennes tables de journal et d'inventaire de votre compartiment de tables AWS géré. Dans le cas contraire, la création de la nouvelle configuration de table de métadonnées échoue car ces tables existent déjà.

Pour supprimer vos tables de métadonnées, consultezSuppression des tables de métadonnées.

Je ne parviens pas à activer une table d'inventaire dans ma configuration

Si vous avez créé votre configuration de métadonnées S3 avant le 15 juillet 2025, vous ne pouvez pas activer de table d'inventaire sur cette configuration. Nous vous recommandons de supprimer et de recréer votre configuration afin de pouvoir créer une table d'inventaire et faire expirer les enregistrements des tables de journal. Pour de plus amples informations, veuillez consulter Activation des tables d'inventaire sur les configurations de métadonnées créées avant le 15 juillet 2025.

Je ne parviens pas à activer l'expiration des enregistrements de la table de journal dans ma configuration

Si vous avez créé votre configuration de métadonnées S3 avant le 15 juillet 2025, vous ne pouvez pas activer l'expiration des enregistrements de la table de journal sur cette configuration. Nous vous recommandons de supprimer et de recréer votre configuration afin de pouvoir faire expirer les enregistrements des tables de journal et créer une table d'inventaire. Pour de plus amples informations, veuillez consulter Activation des tables d'inventaire sur les configurations de métadonnées créées avant le 15 juillet 2025.

Je ne parviens pas à interroger mes tables de métadonnées

Si vous ne parvenez pas à interroger vos tables de métadonnées, vérifiez les points suivants :

• Lorsque vous utilisez Amazon Athena ou Amazon Redshift pour interroger vos tables de métadonnées, vous devez placer les noms des espaces de noms de vos tables de métadonnées entre guillemets " () ou backticks ` (), sinon la requête risque de ne pas fonctionner.

• Lorsque vous utilisez Apache Spark Amazon EMR ou d'autres moteurs tiers pour interroger vos tables de métadonnées, nous vous recommandons d'utiliser le point de terminaison Iceberg REST Amazon S3 Tables. Votre requête risque de ne pas s'exécuter correctement si vous n'utilisez pas ce point de terminaison. Pour de plus amples informations, veuillez consulter Accès aux tables à l'aide des tables Amazon S3 Iceberg REST point de terminaison.

• Assurez-vous que vous disposez des autorisations AWS Identity and Access Management (IAM) appropriées pour interroger les tables de métadonnées. Pour de plus amples informations, veuillez consulter Autorisations pour interroger les tables de métadonnées.

• Si vous utilisez Amazon Athena et que vous recevez des erreurs lorsque vous essayez d'exécuter vos requêtes, procédez comme suit :

  • Si vous recevez le message d'erreur « Autorisations insuffisantes pour exécuter la requête. Le principal n'a aucun privilège sur la ressource spécifiée. » Lorsque vous essayez d'exécuter une requête dans Athena, vous devez obtenir les autorisations Lake Formation nécessaires sur la table. Pour de plus amples informations, veuillez consulter Octroi de l'autorisation Lake Formation sur une table ou une base de données.

  • Si le message d'erreur « Iceberg ne peut pas accéder à la ressource demandée » s'affiche lorsque vous essayez d'exécuter la requête, accédez à la AWS Lake Formation console et assurez-vous que vous vous êtes accordé des autorisations sur le catalogue de compartiments de tables et la base de données (espace de noms) que vous avez créés. Ne spécifiez pas de table lorsque vous accordez ces autorisations. Pour de plus amples informations, veuillez consulter Octroi de l'autorisation Lake Formation sur une table ou une base de données.

Je reçois 405 erreurs lorsque j'essaie d'utiliser certaines AWS CLI commandes de métadonnées S3 et certaines opérations d'API

L'appel de l'opération GetBucketMetadataTableConfiguration API V1 ou l'utilisation de la commande get-bucket-metadata-table-configuration AWS Command Line Interface (AWS CLI) dans le cadre d'une configuration de table de métadonnées V2 entraîne une 405 Method Not Allowed erreur HTTP. De même, l'appel de l'opération DeleteBucketMetadataTableConfiguration API V1 ou l'utilisation de la delete-bucket-metadata-table-configuration AWS CLI commande provoque également une erreur 405.

Vous pouvez utiliser l'opération ou la get-bucket-metadata-configuration AWS CLI commande de l'GetBucketMetadataConfigurationAPI V2 par rapport à une configuration de table de métadonnées V1 ou V2. De même, vous pouvez utiliser l'opération ou la delete-bucket-metadata-configuration AWS CLI commande de l'DeleteBucketMetadataConfigurationAPI V2 par rapport à une configuration de table de métadonnées V1 ou V2.

Nous vous recommandons de mettre à jour vos processus pour utiliser les nouvelles opérations d'API V2 (CreateBucketMetadataConfigurationGetBucketMetadataConfiguraion,, etDeleteBucketMetadataConfiguration) au lieu des opérations d'API V1. Pour plus d'informations sur la migration de la version V1 de S3 Metadata vers la version V2, consultezActivation des tables d'inventaire sur les configurations de métadonnées créées avant le 15 juillet 2025.

Pour déterminer si votre configuration est V1 ou V2, vous pouvez consulter l'attribut suivant de votre réponse d'GetBucketMetadataConfigurationAPI. Un type de compartiment AWS géré ("aws") indique une configuration V2, et un type de compartiment géré par le client ("customer") indique une configuration V1.

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

Pour de plus amples informations, veuillez consulter Afficher les configurations des tables de métadonnées.