Résolution des problèmes liés à S3 Metadata
Utilisez les informations suivantes pour identifier et résoudre les problèmes courants que vous pouvez rencontrer lorsque vous utilisez Amazon S3 Metadata.
Je ne parviens pas à supprimer mon compartiment de table géré par AWS et mes tables de métadonnées
Avant de supprimer un 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 plus d’informations, consultez Suppression de configurations de table de métadonnées.
Avant de supprimer votre compartiment de table géré par AWS, 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 table 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 géré par AWS.
Lors de la création de la configuration de votre table de métadonnées, vous pouvez chiffrer votre table de journal gérée par AWS côté serveur à l’aide de clés AWS Key Management Service (AWS KMS) (SSE-KMS). Si vous choisissez d’utiliser le chiffrement SSE-KMS, vous devez fournir une clé KMS gérée par le client dans la même région que votre compartiment à 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 gérée par AWS est créée, vous ne pouvez plus modifier ses paramètres de chiffrement. Pour spécifier le chiffrement SSE-KMS pour vos tables de métadonnées, vous devez disposer de certaines autorisations. Pour plus d’informations, consultez Autorisations pour SSE-KMS.
Le paramètre de chiffrement d’une table de métadonnées prévaut sur le paramètre de chiffrement par défaut du compartiment. Si vous ne spécifiez pas de chiffrement pour une table, celle-ci hérite du paramètre de chiffrement par défaut du compartiment.
Par défaut, les compartiments de table gérés par AWS sont chiffrés avec un chiffrement côté serveur à l’aide de clés gérées par 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 du compartiment de table géré par AWS de manière à utiliser le chiffrement côté serveur avec des clés AWS Key Management Service (AWS KMS) (SSE-KMS). Pour plus d’informations, consultez Chiffrement des compartiments de table gérés par AWS et Spécification du chiffrement côté serveur avec des clés AWS KMS (SSE-KMS) dans les 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 compartiment de table géré par AWS et vos tables de métadonnées sont conservés, même si vous supprimez la configuration de la table de métadonnées.
Si vous supprimez la configuration de votre table de métadonnées et souhaitez en créer une nouvelle 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 table géré par AWS. Sinon, la création de la nouvelle configuration de table de métadonnées échouera, car ces tables existent déjà.
Pour supprimer vos tables de métadonnées, consultez Suppression des tables de métadonnées.
Je ne parviens pas à activer une table d’inventaire dans ma configuration
Si vous avez créé votre configuration S3 Metadata avant le 15 juillet 2025, vous ne pouvez pas activer de table d’inventaire sur cette configuration. Nous vous recommandons de supprimer votre configuration et d’en créer une nouvelle pour pouvoir créer une table d’inventaire et faire expirer les enregistrements de votre table de journal. Pour plus d’informations, consultez Activation des tables d’inventaire sur des configurations de métadonnées créées avant le 15 juillet 2025.
Je ne parviens pas à activer l’expiration des enregistrements de table de journal dans ma configuration
Si vous avez créé votre configuration S3 Metadata avant le 15 juillet 2025, vous ne pouvez pas activer l’expiration des enregistrements de la table de journal de cette configuration. Nous vous recommandons de supprimer votre configuration et d’en créer une nouvelle pour pouvoir faire expirer les enregistrements de la table de journal et créer une table d’inventaire. Pour plus d’informations, consultez Activation des tables d’inventaire sur des 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 accents graves (`), sinon la requête risque de ne pas fonctionner. -
Lorsque vous utilisez Apache Spark sur Amazon EMR ou d’autres moteurs tiers pour interroger vos tables de métadonnées, nous vous recommandons d’utiliser le point de terminaison REST Iceberg d’Amazon S3 Tables. Votre requête risque de ne pas s’exécuter correctement si vous n’utilisez pas ce point de terminaison. Pour plus d’informations, consultez Accès aux tables à l’aide du point de terminaison Iceberg REST d’Amazon S3 Tables.
-
Veillez à disposer des autorisations AWS Identity and Access Management (IAM) appropriées pour interroger des tables de métadonnées. Pour plus d’informations, consultez Autorisations d’interrogation des tables de métadonnées.
-
Si vous utilisez Amazon Athena et que vous recevez des messages d’erreur 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 ne dispose d’aucun privilège sur la ressource spécifiée. »lorsque vous essayez d’exécuter une requête dans Athena, vous devez disposer des autorisations Lake Formation nécessaires sur la table. Pour plus d’informations, consultez 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 console AWS Lake Formation et assurez-vous que vous vous êtes accordé les autorisations nécessaires sur le catalogue de compartiments de table 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 plus d’informations, consultez Octroi de l’autorisation Lake Formation sur une table ou une base de données.
-
Je reçois un message d’erreur 405 lorsque j’essaie d’utiliser certaines commandes AWS CLI de S3 Metadata et certaines opérations d’API
L’appel de l’opération d’API GetBucketMetadataTableConfiguration 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 un message d’erreur HTTP 405 Method Not Allowed. L’appel de l’opération d’API DeleteBucketMetadataTableConfiguration V1 ou l’utilisation de la commande delete-bucket-metadata-table-configuration AWS CLI provoque également une erreur 405.
Vous pouvez utiliser l’opération d’API GetBucketMetadataConfiguration V2 ou la commande get-bucket-metadata-configuration AWS CLI pour configurer une table de métadonnées V1 ou V2. De même, vous pouvez utiliser l’opération d’API DeleteBucketMetadataConfiguration V2 ou la commande delete-bucket-metadata-configuration AWS CLI pour configurer une table de métadonnées V1 ou V2.
Nous vous recommandons de mettre à jour vos processus afin qu’ils utilisent les nouvelles opérations d’API (CreateBucketMetadataConfiguration, GetBucketMetadataConfiguraion et DeleteBucketMetadataConfiguration) V2 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, consultez Activation des tables d’inventaire sur des configurations de métadonnées créées avant le 15 juillet 2025.
Pour déterminer si vous disposez de la configuration V1 ou V2, vous pouvez consulter l’attribut suivant de votre réponse d’API GetBucketMetadataConfiguration. Un type de compartiment géré par AWS ("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 plus d’informations, consultez Affichage de la configuration d’une table de métadonnées.
