# S3 元数据注释表架构
<a name="metadata-tables-annotation-schema"></a>

注释表跟踪有关通用存储桶中的对象的最新注释。每行表示一个关于特定对象版本的注释。您可以使用注释表，根据注释内容来发现和检索对象。例如，您可以查询注释表以查找具有特定注释的所有对象，根据对象大小或键前缀检索与谓词匹配的注释内容，或者关联对象间的注释。

当为元数据表配置启用注释表时，该表将经历一个称为*回填*的过程，在此过程中，Amazon S3 扫描通用存储桶，以检索所有对象的注释数据。根据存储桶中的对象数量，此过程可能需要若干分钟到几小时。完成回填后，状态将从**正在回填**更改为**活跃**。

**注意**  
您需要为回填注释表付费。有关更多信息，请参阅 [Amazon S3 定价](https://www.amazonaws.cn/s3/pricing/)。

注释表具有以下架构：


| 列名称 | 必填？ | 数据类型 | Description | 
| --- | --- | --- | --- | 
| `bucket` | 是 | 字符串 | 通用存储桶的名称。 | 
| `object_key` | 是 | 字符串 | 在存储桶中唯一地标识对象的对象键名称（或键）。 | 
| `object_version_id` | 否 | 字符串 | 对象的版本 ID。 | 
| `object_join_key` | 是 | 字符串 | 对象的唯一标识符，与每个新版本一起分配，或者在创建或覆盖空版本时分配。使用此列与清单表或日记表进行联接。 | 
| `name` | 是 | 字符串 | 注释名称。 | 
| `sequence_number` | 是 | 字符串 | 用于对注释修订进行排序的序数值。对于给定的存储桶 `object_key` 和 `object_version_id`，按字典顺序排列的较大 `sequence_number` 值意味着该记录是更近引入的。 | 
| `last_modified_date` | 否 | 时间戳 NTZ（无时区） | 上次修改注释的日期和时间。 | 
| `size` | 否 | 长整型 | 注释有效载荷的大小（以字节为单位）。 | 
| `e_tag` | 否 | 字符串 | 注释内容的 ETag。 | 
| `checksum_algorithm` | 否 | 字符串 | 用于注释的校验和算法。如果不存在校验和，则此值为 null。 | 
| `replication_status` | 否 | 字符串 | 注释的复制状态。`PENDING`、`COMPLETED` 和 `FAILED` 仅在复制源处可见。`REPLICA` 仅在复制目标处可见。如果没有适用的复制配置，则此值为 null。 | 
| `text_value` | 否 | 字符串 | 注释内容（UTF-8 文本）。 |