Esquema de tablas de Metadatos de S3 - Amazon Simple Storage Service

Esquema de tablas de Metadatos de S3

Las tablas de metadatos de Amazon S3 contienen filas y columnas. Cada fila representa un evento de mutación que ha creado, actualizado o eliminado un objeto en el bucket de uso general. La mayoría de estos eventos son el resultado de diversas acciones del usuario, pero algunos de ellos son el resultado de acciones realizadas por Amazon S3 en su nombre, como la caducidad de S3 Lifecycle o transiciones de clase de almacenamiento.

Metadatos de S3 es una canalización de procesamiento de eventos diseñada para mantener la tabla de metadatos en coherencia con los cambios que se han producido en el bucket de uso general. Tenga en cuenta que, para cuando se notifique a Metadatos de S3 que se ha creado o actualizado un objeto, es posible que ese objeto ya se haya sobrescrito o eliminado en el bucket. De forma predeterminada, se crea una fila de tabla para cada operación de bucket de S3. No obstante, si se eliminan o sobrescriben metadatos de objetos, o si ya no se pueden recuperar objetos, algunas columnas pueden mostrar un valor NULL para indicar cualquier esquema de metadatos que falte.

A continuación, se muestra un ejemplo de una tabla de metadatos para un bucket de uso general llamado amzn-s3-demo-bucket:

bucket key sequence_number record_type record_timestamp 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 requester source_ip_address request_id amzn-s3-demo-bucket Finance/statement1.pdf 80e737d8b4d82f776affffffffffffffff006737d8b4d82f776a00000000000000000000000000000000000000000000000072 CREATE 2024-11-15 23:26:44.899 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} 111122223333 192.0.2.1 CVK8FWYRW0M9JW65 amzn-s3-demo-bucket s3-dg.pdf 80e737d8b4e39f1dbdffffffffffffffff006737d8b4e39f1dbd00000000000000000000000000000000000000000000000072 CREATE 2024-11-15 23:26:44.942 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 {} {} 111122223333 192.0.2.1 CVKAQDRAZEG7KXAY amzn-s3-demo-bucket Development/Projects.xls 80e737d8b4ed9ac5c6ffffffffffffffff006737d8b4ed9ac5c600000000000000000000000000000000000000000000000072 CREATE 2024-11-15 23:26:44.966 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} 111122223333 192.0.2.1 CVK7Z6XQTQ90BSRV

Las tablas de metadatos tienen el siguiente esquema:

Nombre de la columna ¿Obligatorio? Tipo de datos:

bucket

Cadena El nombre de bucket de uso general. Para obtener más información, consulte Reglas de nomenclatura de buckets de uso general.

key

Cadena El nombre de la clave de objeto (o clave) que identifica unívocamente el objeto del bucket. Para obtener más información, consulte Denominación de objetos de Amazon S3.

sequence_number

Cadena

El número de secuencia, que es un ordinal que se incluye en los registros de un objeto determinado. Para ordenar los registros del mismo bucket y clave, puede ordenarlos por sequence_number. Para un bucket y una clave dados, un valor de sequence_number lexicográficamente mayor implica que el registro se incorporó al bucket más recientemente.

record_type

Cadena

El tipo de este registro, uno de CREATE, UPDATE_METADATA o DELETE.

Los registros CREATE indican que se escribió un nuevo objeto (o una nueva versión del objeto) en el bucket.

Los registros UPDATE_METADATA capturan cambios en metadatos mutables para un objeto existente, como la clase de almacenamiento o las etiquetas.

Los registros DELETE indican que este objeto (o esta versión del objeto) se ha eliminado. Cuando se habilita el control de versiones, los registros DELETE representan un marcador de eliminación o una eliminación permanente. Los marcadores de eliminación tienen un valor record_type de DELETE y un valor is_delete_marker de True. Los registros de eliminación permanente tienen valores nulos en todas las demás columnas excepto bucket, key, sequence_number, record_type, record_timestamp y version_id. Para obtener más información, consulte Eliminar versiones de objetos de un bucket con control de versiones habilitado.

record_timestamp

Marca temporal NTZ (sin zona horaria)

La marca temporal asociada a este registro.

version_id

No Cadena

El ID de versión del objeto. Si activa el control de versiones en un bucket, Amazon S3 asigna un número de versión a los objetos que agregue a dicho bucket. Para obtener más información, consulte Retención de varias versiones de objetos con Control de versiones de S3.

Los objetos que se almacenan en un bucket antes de establecer el estado del control de versiones tienen el ID de versión nulo.

is_delete_marker

No Booleano

El estado del marcador de eliminación del objeto. Si el objeto es un marcador de eliminación, este valor es True. De lo contrario, es False. Para obtener más información, consulte Trabajar con marcadores de eliminación.

nota

Las filas que se agregan para los marcadores de eliminación tienen un valor record_type de DELETE, no UPDATE_METADATA. Si el marcador de eliminación se crea como resultado de una caducidad de S3 Lifecycle, el valor requester es s3.amazonaws.com.

size

No Largo

El tamaño del objeto en bytes, sin incluir el tamaño de las cargas multiparte incompletas o los metadatos del objeto. Si is_delete_marker es True, el tamaño es 0. Para obtener más información, consulte Metadatos de objetos definidos por el sistema.

last_modified_date

No Marca temporal NTZ (sin zona horaria)

Fecha de creación del objeto o última fecha de modificación, la que sea posterior. Para las cargas multiparte, la fecha de creación del objeto es la fecha en que se inicia la carga multiparte. Para obtener más información, consulte Metadatos de objetos definidos por el sistema.

e_tag

No Cadena

La etiqueta de entidad (ETag), que es un hash del objeto. La ETag solo refleja los cambios en el contenido de un objeto, no en sus metadatos. La ETag puede ser un resumen MD5 de los datos del objeto. Si la ETag es un resumen MD5, depende de cómo se creó el objeto y cómo se cifró. Para obtener más información, consulte Object en la Referencia de la API de Amazon S3.

storage_class

No Cadena

La clase de almacenamiento que se utiliza para almacenar el objeto. Puede ser uno de los siguientes: STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE o GLACIER_IR. Para obtener más información, consulte Descripción y administración de clases de almacenamiento de Amazon S3.

is_multipart

No Booleano

El tipo de carga del objeto. Si el objeto se ha cargado como una carga multiparte, este valor es True. De lo contrario, es False. Para obtener más información, consulte Carga y copia de objetos con la carga multiparte en Amazon S3.

encryption_status

No Cadena

El estado de cifrado del servidor del objeto, dependiendo del tipo de clave de cifrado que se utilice: cifrado del servidor con claves administradas por Amazon S3 (SSE-S3), cifrado del servidor con claves AWS Key Management Service (AWS KMS) (SSE-KMS), cifrado del servidor de doble capa con AWS KMS keys (DSSE-KMS) o cifrado del servidor con claves proporcionadas por el cliente (SSE-C). Si el objeto no está cifrado, este valor es nulo. Los valores posibles son SSE-S3, SSE-KMS, DSSE-KMS, SSE-C o nulo. Para obtener más información, consulte Protección de los datos mediante el cifrado.

is_bucket_key_enabled

No Booleano

Estado de habilitación de la clave de bucket de S3 del objeto. Si el objeto utiliza una clave de bucket de S3 para SSE-KMS, este valor es True. De lo contrario, es False. Para obtener más información, consulte Configuración de una clave de bucket de S3 en el nivel de objeto.

kms_key_arn

No Cadena

El nombre de recurso de Amazon (ARN) para la clave de KMS con la que se cifra el objeto, para filas en las que encryption_status es SSE-KMS o DSSE-KMS. Si el objeto no está cifrado con SSE-KMS o DSSE-KMS, el valor es nulo. Para obtener más información, consulte Uso del cifrado del servidor con claves de AWS KMS (SSE-KMS) y Uso del cifrado del servidor de doble capa con claves de AWS KMS (DSSE-KMS).

nota

Si una fila representa una versión de objeto que ya no existía en el momento en que se procesó un evento de eliminación o sobrescritura, kms_key_arn contiene un valor nulo, incluso si el valor de columna encryption_status es SSE-KMS o DSSE-KMS.

checksum_algorithm

No Cadena

El algoritmo que se utiliza para crear la suma de comprobación del objeto, uno de CRC64NVME, CRC32, CRC32C, SHA1 o SHA256. Si no hay suma de comprobación, este valor es nulo. Para obtener más información, consulte Uso de algoritmos de suma de comprobación admitidos.

object_tags

No Asignar <Cadena, Cadena>

Las etiquetas de objeto que están asociadas con el objeto. Las etiquetas de objeto se almacenan como un mapa de pares clave-valor. Si un objeto no tiene etiquetas de objeto, se almacena un mapa ({}) vacío. Para obtener más información, consulte Categorización del almacenamiento mediante etiquetas

nota

Si el valor record_type es DELETE, la columna object_tags contiene un valor nulo. Si el valor record_type es CREATE o UPDATE_METADATA, las filas que representan versiones de objeto que ya no existían en el momento en que se procesó un evento de eliminación o sobrescritura contendrán un valor nulo en la columna object_tags.

user_metadata

No Asignar <Cadena, Cadena>

Los metadatos de usuario asociados al objeto. Los metadatos del usuario se almacenan como un mapa de pares clave-valor. Si un objeto no tiene metadatos de usuario, se almacena un mapa vacío ({}). Para obtener más información, consulte Metadatos de objetos definidos por el usuario.

nota

Si el valor record_type es DELETE, la columna user_metadata contiene un valor nulo. Si el valor record_type es CREATE o UPDATE_METADATA, las filas que representan versiones de objeto que ya no existían en el momento en que se procesó un evento de eliminación o sobrescritura contendrán un valor nulo en la columna user_metadata.

requester

No Cadena

El ID de la Cuenta de AWS del solicitante o de la entidad principal del Servicio de AWS que realizó la solicitud.

source_ip_address

No Cadena

La dirección IP de origen de la solicitud. Para los registros que se generan por una solicitud de usuario, esta columna contiene la dirección IP de origen de la solicitud. Para las acciones realizadas por Amazon S3 u otro Servicio de AWS en nombre del usuario, esta columna contiene un valor nulo.

request_id

No Cadena

El ID de solicitud asociado a la solicitud.