# S3 メタデータ注釈テーブルのスキーマ
<a name="metadata-tables-annotation-schema"></a>

注釈テーブルは、汎用バケット内のオブジェクトの最新の注釈を追跡します。各行は、特定のオブジェクトバージョンで 1 つの注釈を表します。注釈テーブルを使用し、注釈コンテンツに基づいてオブジェクトを検出および取得できます。例えば、注釈テーブルをクエリして、特定の注釈を持つすべてのオブジェクトの検索、オブジェクトサイズやキープレフィックスに基づく、述語に一致する注釈コンテンツの取得、オブジェクト間での注釈の関連付けなどができます。

メタデータテーブル設定の注釈テーブルを有効にすると、テーブルは*バックフィル*と呼ばれるプロセスを実行し、そのプロセス中に Amazon S3 は汎用バケットをスキャンして、すべてのオブジェクトの注釈データを取得します。バケット内のオブジェクトの数によっては、このプロセスに数分から数時間かかる場合があります。バックフィルが完了すると、ステータスが **[バックフィル]** から **[アクティブ]** に変わります。

**注記**  
注釈テーブルのバックフィルには料金がかかります。詳細については、[Amazon S3 の料金](https://aws.amazon.com/s3/pricing/) を参照してください。

注釈テーブルには次のスキーマがあります。


| 列名 | 必須? | データ型 | [Description] (説明) | 
| --- | --- | --- | --- | 
| `bucket` | はい | String | 汎用バケットの名前。 | 
| `object_key` | はい | String | バケット内のオブジェクトを一意に識別するオブジェクトのキー名 (またはキー)。 | 
| `object_version_id` | いいえ | String | オブジェクトのバージョン ID。 | 
| `object_join_key` | はい | String | オブジェクトの一意の識別子。新しいバージョンごとに、または null バージョンが作成あるいは上書きされたときに割り当てられます。この列を使用して、インベントリテーブルまたはジャーナルテーブルと結合します。 | 
| `name` | はい | String | 注釈名。 | 
| `sequence_number` | はい | String | 注釈の改訂をソートするための序数。特定のバケット `object_key` と `object_version_id` について、`sequence_number` が辞書順で大きいほど、レコードがより最近に導入されたことを意味します。 | 
| `last_modified_date` | いいえ | Timestamp NTZ (タイムゾーンなし) | 注釈が最後に変更された日時。 | 
| `size` | いいえ | Long | 注釈ペイロードのサイズ (バイト単位)。 | 
| `e_tag` | いいえ | String | 注釈コンテンツの ETag。 | 
| `checksum_algorithm` | いいえ | String | 注釈に使用されるチェックサムアルゴリズム。チェックサムが存在しない場合、この値は null です。 | 
| `replication_status` | いいえ | String | 注釈のレプリケーションステータス。`PENDING`、`COMPLETED`、および `FAILED` はレプリケーションソースでのみ表示されます。`REPLICA` はレプリケーションターゲットでのみ表示されます。該当するレプリケーション設定がない場合、この値は null になります。 | 
| `text_value` | いいえ | String | 注釈コンテンツ (UTF-8 テキスト)。 |