S3 Metadata 주석 테이블 스키마
S3 Metadata 주석 테이블 스키마 (S3 Metadata annotation table schema)
주석 테이블은 범용 버킷 객체에 대한 최신 주석을 추적해요. 각 행은 특정 객체 버전에 대한 주석 하나를 나타내요. 주석 테이블을 사용해 주석 콘텐츠를 기준으로 객체를 발견하고 검색할 수 있어요. 예를 들어 주석 테이블을 조회해 특정 주석이 있는 모든 객체를 찾거나, 객체 크기나 키 접두사를 기준으로 조건에 맞는 주석 콘텐츠를 검색하거나, 객체 간 주석을 연관시킬 수 있어요.
출처: 문서
본문
메타데이터 테이블 구성을 위해 주석 테이블을 활성화하면 테이블은 *백필링(backfilling)*이라는 과정을 거치게 돼요. 이 과정에서 Amazon S3가 범용 버킷을 스캔해 모든 객체의 주석 데이터를 검색해요. 버킷의 객체 수에 따라 이 과정은 수 분에서 수 시간이 걸릴 수 있어요. 백필링이 끝나면 상태가 **백필링(Backfilling)**에서 **활성(Active)**으로 바뀌어요.
참고 주석 테이블 백필링에는 요금이 부과돼요. 자세한 내용은 Amazon S3 요금을 참고하세요.
주석 테이블은 다음과 같은 스키마를 가져요.
| 열 이름 | 필수? | 데이터 타입 | 설명 |
|---|---|---|---|
| bucket | 예 | String | 범용 버킷 이름. |
| object_key | 예 | String | 버킷에서 객체를 고유하게 식별하는 객체 키 이름(또는 키). |
| object_version_id | 아니요 | String | 객체의 버전 ID. |
| object_join_key | 예 | String | 새 버전마다 또는 null 버전이 생성되거나 덮어써질 때 할당되는 객체의 고유 식별자. 이 열을 사용해 인벤토리 또는 저널 테이블과 조인해요. |
| name | 예 | String | 주석 이름. |
| sequence_number | 예 | String | 주석 개정을 정렬하기 위한 서수 값. 주어진 bucket, 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 텍스트). |