Schéma des tables d'inventaire en temps réel des métadonnées S3 - Amazon Simple Storage Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Schéma des tables d'inventaire en temps réel des métadonnées S3

Le tableau d'inventaire en temps réel fournit un inventaire simple et interrogeable de tous les objets et de leurs versions dans votre compartiment afin que vous puissiez déterminer l'état le plus récent de vos données. Les mises à jour de vos objets sont généralement reflétées dans le tableau d'inventaire dans un délai d'une heure.

Vous pouvez utiliser ce tableau pour simplifier et accélérer les flux de travail métier et les tâches liées au 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 :

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

  • Créez une distribution de balises d'objets ou recherchez des objets sans balises.

  • Trouvez tous les objets qui ne sont pas chiffrés à l'aide du chiffrement côté serveur avec des clés AWS Key Management Service (AWS KMS) (SSE-KMS).

Lorsque vous activez la table d'inventaire pour la configuration de votre table de métadonnées, la table est soumise à un processus appelé backfilling, au cours duquel Amazon S3 analyse votre compartiment à usage général pour récupérer les métadonnées initiales de tous les objets du compartiment. Selon le nombre d'objets contenus dans votre compartiment, ce processus peut prendre de quelques minutes (minimum 15 minutes) à plusieurs heures. Lorsque le processus de remblayage est terminé, le statut de votre tableau d'inventaire passe de Remblayage à Actif. Une fois le remblayage terminé, les mises à jour de vos objets sont généralement reflétées dans le tableau d'inventaire en moins d'une heure.

Note

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

Les tables d'inventaire des métadonnées Amazon S3 contiennent des lignes et des colonnes. Chaque ligne représente l'état actuel d'un objet dans votre compartiment à usage général. Le tableau d'inventaire fournit un inventaire simple et interrogeable de tous les objets de votre compartiment afin que vous puissiez déterminer l'état actuel de vos données.

Voici un exemple de table d'inventaire pour 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 de plus amples informations, veuillez consulter 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 de plus amples informations, veuillez consulter 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 de plus amples informations, veuillez consulter 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 de plus amples informations, veuillez consulter 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 de plus amples informations, veuillez consulter Métadonnées d’objet définies par le système.

last_modified_date

Non Horodatage NTZ (sans fuseau horaire)

La 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 de plus amples informations, veuillez consulter Métadonnées d’objet définies par le système.

e_tag

Non Chaîne

La balise d'entité (ETag), qui est un hachage de l'objet. Le ETag reflète les modifications apportées uniquement au contenu d'un objet, et non à ses métadonnées. Il ETag peut s'agir d'un MD5 condensé des données de l'objet. La question de savoir s'il s' ETag agit d'un MD5 condensé dépend de la manière dont l'objet a été créé et de son cryptage. Pour plus d’informations, consultez Object dans la Référence d’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 de plus amples informations, veuillez consulter 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 de plus amples informations, veuillez consulter 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 de plus amples informations, veuillez consulter 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 de plus amples informations, veuillez consulter 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 AWS KMS clés (SSE-KMS) et Utilisation du chiffrement double couche côté serveur avec AWS KMS clés (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 de plus amples informations, veuillez consulter Utilisation des algorithmes de total 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 de plus amples informations, veuillez consulter 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 de plus amples informations, veuillez consulter 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.