

# Esquema de tablas de diario de Metadatos de S3
<a name="metadata-tables-schema"></a>

En la tabla de diario se registran los cambios realizados en los datos casi en tiempo real, lo que lo ayuda a identificar los nuevos datos cargados en el bucket, realizar un seguimiento de los objetos eliminados recientemente, supervisar las transiciones del ciclo de vida y mucho más. La tabla de diario registra los objetos nuevos y las actualizaciones de los objetos y los metadatos (las actualizaciones que requieren una operación `PUT` o `DELETE`). Como esta tabla se puede consultar, puede auditar los cambios del bucket mediante simples consultas SQL. 

Puede utilizar la tabla de diario para casos de uso de seguridad, auditoría y cumplimiento a fin de realizar un seguimiento de los objetos cargados, eliminados y modificados en el bucket. Por ejemplo, puede consultar la tabla de diario para responder preguntas como las siguientes: 
+ ¿Qué objetos ha eliminado S3 Lifecycle en las últimas 24 horas?
+ ¿De qué direcciones IP procedían las solicitudes `PUT` más recientes?
+ ¿Qué claves de AWS Key Management Service (AWS KMS) se han utilizado para las solicitudes `PUT` en los últimos siete días?
+ ¿Qué objetos del bucket ha creado Amazon Bedrock en los últimos cinco días?

Las tablas de diario 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 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 las transiciones de clase de almacenamiento. 

Las tablas de diario de Metadatos de S3 tienen coherencia final con los cambios que se han producido en el bucket de uso general. En algunos casos, cuando se notifica 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. En estos casos, los objetos ya no se pueden recuperar y algunas columnas pueden mostrar un valor NULL para indicar que falta el esquema de metadatos.

A continuación, se muestra un ejemplo de una tabla de diario para un bucket de uso general denominado `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 diario tienen el siguiente esquema:


| Nombre de la columna | ¿Obligatorio? | Tipo de datos |   | 
| --- | --- | --- | --- | 
| `bucket` | Sí | Cadena | El nombre de bucket de uso general. Para obtener más información, consulte [Reglas de nomenclatura de buckets de uso general](bucketnamingrules.md). | 
| `key` | Sí | 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](object-keys.md). | 
| `sequence_number` | Sí | 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` | Sí | 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. Se desambiguan aún más consultando la columna `is_delete_marker` opcional. Para obtener más información, consulte [Eliminar versiones de objetos de un bucket con control de versiones habilitado](DeletingObjectVersions.md).  Una eliminación permanente incluye `NULL`s en todas las columnas, *excepto en* `bucket`, `key`, `sequence_number`, `record_type`, `record_timestamp` y `version_id` (es decir, las columnas marcadas como obligatorias).  | 
| `record_timestamp` | Sí | 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](Versioning.md). 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. Para los registros DELETE que son marcadores de eliminación, este valor es `TRUE`. Para las eliminaciones permanentes, se omite este valor (`NULL`). Otros tipos de registros (CREATE y UPDATE\$1METADATA) tienen un valor `FALSE`. Para obtener más información, consulte [Trabajar con marcadores de eliminación](DeleteMarker.md).  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](UsingMetadata.md#SysMetadata). | 
| `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](UsingMetadata.md#SysMetadata). | 
| `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 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_Object.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_Object.html) 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](storage-class-intro.md). | 
| `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](mpuoverview.md). | 
| `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](UsingEncryption.md). | 
| `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](configuring-bucket-key-object.md). | 
| `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)](UsingKMSEncryption.md) y [Uso del cifrado del servidor de doble capa con claves de AWS KMS (DSSE-KMS)](UsingDSSEncryption.md).  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](checking-object-integrity-upload.md#using-additional-checksums). | 
| `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 de los objetos mediante etiquetas](object-tagging.md).  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](UsingMetadata.md#UserMetadata).   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. Por ejemplo, si el solicitante es S3 Lifecycle, este valor es `s3.amazonaws.com`.  | 
| `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. | 