Schéma des tables d’inventaire dynamiques de S3 Metadata - Amazon Simple Storage Service

Schéma des tables d’inventaire dynamiques de S3 Metadata

La table d’inventaire dynamique fournit un inventaire simple et interrogeable de tous les objets de votre compartiment et de leurs versions afin que vous puissiez déterminer l’état le plus récent de vos données. Les mises à jour apportées à vos objets sont généralement répercutées la table d’inventaire dans un délai d’une heure.

Vous pouvez utiliser cette table pour simplifier et accélérer les flux de travail et les tâches de big data en identifiant les objets que vous souhaitez traiter pour différentes charges de travail. Par exemple, vous pouvez interroger la table d’inventaire pour effectuer les opérations suivantes :

  • Rechercher tous les objets stockés dans la classe de stockage S3 Glacier Deep Archive.

  • Créer une distribution de balises d’objets ou rechercher des objets sans balises.

  • Rechercher tous les objets qui ne sont pas chiffrés côté serveur avec des clés AWS Key Management Service (AWS KMS) (SSE-KMS).

Quand vous activez la table d’inventaire pour la configuration de votre table de métadonnées, celle-ci est soumise à un processus appelé remplissage, au cours duquel Amazon S3 analyse votre compartiment à usage général afin de récupérer les métadonnées initiales de tous les objets qu’il contient. Selon le nombre d’objets contenus dans votre compartiment, ce processus peut prendre de quelques minutes (minimum 15 minutes) à quelques heures. Lorsque le processus de remplissage est terminé, le statut de votre table d’inventaire passe de Remplissage à Actif. Une fois le remplissage terminé, les mises à jour apportées à vos objets sont généralement répercutées la table d’inventaire dynamique dans un délai d’une heure.

Note

Le remplissage de votre table d’inventaire vous est facturé. Si votre compartiment à usage général contient plus d’un milliard d’objets, des frais mensuels vous sont également facturés pour votre table d’inventaire. Pour plus d’informations, consultez Tarification Amazon S3.

Les tables d’inventaire Amazon S3 Metadata contiennent des lignes et des colonnes. Chaque ligne représente l’état en cours d’un objet de votre compartiment à usage général. La table d’inventaire fournit un inventaire simple et interrogeable de tous les objets de votre compartiment afin que vous puissiez déterminer l’état en cours de vos données.

Voici un exemple de table d’inventaire d’un compartiment à usage général nommé amzn-s3-demo-bucket: 

bucket                key                        sequence_number                                                                                          version_id   is_delete_marker   size   last_modified_date   e_tag	                          storage_class   is_multipart   encryption_status   is_bucket_key_enabled   kms_key_arn                                                                   checksum_algorithm   object_tags   user_metadata	                                                                                                                  
amzn-s3-demo-bucket   Finance/statement1.pdf     80e737d8b4d82f776affffffffffffffff006737d8b4d82f776a00000000000000000000000000000000000000000000000072                FALSE              6223   11/15/2024 23:26     e131b86632dda753aac4018f72192b83    STANDARD	  FALSE          SSE-KMS             FALSE                   arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890df   SSECRC32             {}            {count -> Asia, customs -> false, family -> true, location -> Mary, name -> football, user -> United States}                      
amzn-s3-demo-bucket   s3-dg.pdf                  80e737d8b4e39f1dbdffffffffffffffff006737d8b4e39f1dbd00000000000000000000000000000000000000000000000072                FALSE              3554   11/15/2024 23:26     9bb49efc2d92c05558ddffbbde8636d5    STANDARD	  FALSE          DSSE-KMS            FALSE                   arn:aws:kms:us-east-1:936810216292:key/0dcebce6-49fd-4cae-b2e2-5512ad281afd   SSESHA1              {}            {}                                                                                                                                
amzn-s3-demo-bucket   Development/Projects.xls   80e737d8b4ed9ac5c6ffffffffffffffff006737d8b4ed9ac5c600000000000000000000000000000000000000000000000072                FALSE              7746   11/15/2024 23:26     729a6863e47fb9955b31bfabce984908    STANDARD	  FALSE          SSE-S3              FALSE                   NULL                                                                          SSECRC32             {}            {count -> Asia, customs -> Canada, family -> Billiards, filter -> true, location -> Europe, name -> Asia, user -> United States}

Les tables d’inventaire présentent le schéma suivant :

Nom de la colonne Obligatoire ? Type de données

bucket

 Oui Chaîne Nom du compartiment à usage général. Pour plus d’informations, consultez Règles de dénomination des compartiments à usage général.

key

 Oui Chaîne Nom de la clé d’objet (ou clé) qui identifie de manière unique l’objet dans le compartiment. Pour plus d’informations, consultez Attribution d’un nom aux objets Amazon S3.

sequence_number

 Oui Chaîne

Numéro de séquence, qui est un ordinal inclus dans les enregistrements d’un objet donné. Pour ordonner des enregistrements contenant le même compartiment et la même clé, vous pouvez effectuer un tri par sequence_number. Pour un compartiment et une clé donnés, une valeur sequence_number plus élevée du point de vue lexicographique signifie que l’enregistrement a été introduit dans le compartiment plus récemment.

version_id

 Non Chaîne

ID de version de l’objet. Lorsque vous activez la gestion des versions sur un compartiment, Amazon S3 attribue un numéro de version aux objets qui sont ajoutés au compartiment. Pour plus d’informations, consultez Conservation de plusieurs versions d’objets grâce à la gestion des versions S3.

Les objets qui sont stockés dans le compartiment avant que vous définissiez l’état de la gestion des versions ont un ID de version nul.

is_delete_marker

 Non Booléen

Statut du marqueur de suppression de l’objet. Si l’objet est un marqueur de suppression, cette valeur est True. Sinon, la valeur est définie comme False. Pour plus d’informations, consultez Utilisation des marqueurs de suppression.

Note

Les lignes ajoutées pour les marqueurs de suppression ont une valeur record_type correspondant à DELETE, pas à UPDATE_METADATA. Si le marqueur de suppression est créé à la suite de l’expiration du cycle de vie S3, la valeur requester est s3.amazonaws.com.

size

 Non Long

Taille de l’objet en octets, à l’exclusion de la taille des chargements partitionnés incomplets, ou des métadonnées de l’objet. Si is_delete_marker correspond à True, la taille est 0. Pour plus d’informations, consultez Métadonnées d’objet définies par le système.

last_modified_date

 Non Horodatage NTZ (sans fuseau horaire)

Date de création ou de dernière modification, la plus récente des deux. Pour les chargements partitionnés, la date de création de l’objet correspond à la date de lancement du chargement partitionné. Pour plus d’informations, consultez Métadonnées d’objet définies par le système.

e_tag

 Non Chaîne

Balise d’entité, qui est un hachage de l’objet. ETag reflète les modifications uniquement appliquées au contenu d’un objet, pas à ses métadonnées. ETag peut être une valeur de hachage MD5 des données de l’objet. La façon dont l’objet a été créé et la manière dont il est chiffré déterminent si la balise d’entité est un condensé d’octets MD5 ou non. Pour plus d’informations, consultez Object dans la Référence des API Amazon S3.

storage_class

 Non Chaîne

Classe de stockage utilisée pour stocker l’objet. STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, ou GLACIER_IR. Pour plus d’informations, consultez Bien comprendre et gérer les classes de stockage Amazon S3.

is_multipart

 Non Booléen

Type de chargement de l’objet. Si l’objet a été chargé dans un chargement partitionné, cette valeur est True. Sinon, la valeur est définie comme False. Pour plus d’informations, consultez Chargement et copie d’objets à l’aide du chargement partitionné dans Amazon S3.

encryption_status

 Non Chaîne

Statut du chiffrement côté serveur de l’objet, en fonction du type de clé de chiffrement utilisé : chiffrement côté serveur avec les clés gérées par Amazon S3 (SSE-S3), chiffrement côté serveur avec les clés AWS Key Management Service (AWS KMS) (SSE-KMS), chiffrement double couche côté serveur avec AWS KMS keys (DSSE-KMS) ou chiffrement côté serveur avec les clés fournies par le client (SSE-C). Si l’objet n’est pas chiffré, la valeur est nulle. Les valeurs possibles sont SSE-S3, SSE-KMS, DSSE-KMS, SSE-C ou « null ». Pour plus d’informations, consultez Protection des données à l’aide du chiffrement.

is_bucket_key_enabled

 Non Booléen

Statut d’activation de la clé de compartiment S3 de l’objet. Si l’objet utilise une clé de compartiment S3 pour SSE-KMS, cette valeur est True. Sinon, la valeur est définie comme False. Pour plus d’informations, consultez Configuration d’une clé de compartiment S3 au niveau d’un objet.

kms_key_arn

 Non Chaîne

Amazon Resource Name (ARN) de la clé KMS avec laquelle l’objet est chiffré, pour les lignes où encryption_status correspond à SSE-KMS ou DSSE-KMS. Si l’objet n’est pas chiffré avec SSE-KMS ou DSSE-KMS, la valeur est nulle. Pour plus d’informations, consultez Utilisation du chiffrement côté serveur avec des clés AWS KMS (SSE-KMS) et Utilisation du chiffrement double couche côté serveur avec des clés AWS KMS (DSSE-KMS).

Note

Si une ligne représente une version d’objet qui n’existait plus au moment du traitement d’un événement de suppression ou de remplacement, kms_key_arn contient une valeur nulle, même si la valeur de la colonne encryption_status indique SSE-KMS ou DSSE-KMS.

checksum_algorithm

 Non Chaîne

Algorithme utilisé pour créer la somme de contrôle pour l’objet : CRC64-NVME, CRC32, CRC32C, SHA1 ou SHA256. Si aucune somme de contrôle n’est présente, cette valeur est nulle. Pour plus d’informations, consultez Utilisation des algorithmes de somme de contrôle pris en charge.

object_tags

 Non Map <String, String>

Balises associées à l’objet. Les balises d’objets sont stockées sous forme de mappage de paires clé-valeur. Si un objet ne possède aucune balise, un mappage vide ({}) est stocké. Pour plus d’informations, consultez Catégorisation de vos objets à l’aide de balises.

Note

Si la valeur record_type indique DELETE, la colonne object_tags contient une valeur nulle. Si la valeur record_type indique CREATE ou UPDATE_METADATA, les lignes représentant des versions d’objets qui n’existaient plus au moment du traitement d’un événement de suppression ou de remplacement contiennent une valeur nulle dans la colonne object_tags.

user_metadata

 Non Map <String, String>

Métadonnées utilisateur associées à l’objet. Les métadonnées utilisateur sont stockées sous forme de mappage de paires clé-valeur. Si un objet ne possède aucune métadonnée utilisateur, un mappage vide ({}) est stocké. Pour plus d’informations, consultez Métadonnées d’objet définies par l’utilisateur.

Note

Si la valeur record_type indique DELETE, la colonne user_metadata contient une valeur nulle. Si la valeur record_type indique CREATE ou UPDATE_METADATA, les lignes représentant des versions d’objets qui n’existaient plus au moment du traitement d’un événement de suppression ou de remplacement contiennent une valeur nulle dans la colonne user_metadata.