S3 Tables로의 S3 Storage Lens 내보내기 테이블 명명

S3 Tables로의 S3 Storage Lens 내보내기 테이블 명명

S3 Storage Lens 지표를 S3 Tables로 내보낼 때 테이블은 특정 명명 패턴을 사용해 Apache Iceberg 카탈로그 규칙에 따라 구성되어 호환성과 체계성을 보장해요.

출처: Table naming for S3 Storage Lens export to S3 Tables

본문

테이블 위치 구조

전체 테이블 위치는 다음 패턴을 따라요.

s3tablescatalog/aws-s3/<namespace>/<table-name>

테이블 버킷 이름

테이블 버킷: aws-s3

S3 Storage Lens 내보내기는 AWS S3 관련 시스템 테이블용으로 지정된 aws-s3 테이블 버킷을 사용해요.

카탈로그 이름

카탈로그: s3tablescatalog/aws-s3

S3 Storage Lens 테이블은 S3 카탈로그에 저장돼요. Storage Lens가 세 가지 유형의 S3 리소스에 대한 인사이트를 제공하기 때문이에요.

  • 스토리지 지표
  • 버킷 속성
  • API 사용량 지표

네임스페이스 명명 규칙

네임스페이스는 카탈로그 내에서 테이블을 구성해요. S3 Storage Lens의 경우 네임스페이스는 Storage Lens 구성 ID에서 파생돼요.

표준 네임스페이스 형식

점(.)이 없는 Storage Lens 구성 ID의 경우:

lens_<configuration-id>_exp

예: 구성 ID가 my-lens-config이면 네임스페이스는 다음과 같아요.

lens_my-lens-config_exp

점 문자 또는 대문자가 있는 네임스페이스 형식

Storage Lens 구성 ID는 점(.)이나 대문자(A-Z)를 포함할 수 있지만, S3 Tables 네임스페이스는 소문자, 숫자, 하이픈(-), 밑줄(_)만 지원해요. 구성 ID에 점이 포함되면 하이픈으로 변환되고, 대문자는 소문자로 변환되며, 고유성을 위해 해시 접미사가 추가돼요.

lens_<configuration-id-with-dots-or-uppercase-replaced>_exp_<7-char-hash>

예: 구성 ID가 my.LENS.config이면 네임스페이스는 다음과 같아요.

lens_my-lens-config_exp_a1b2c3d

여기서 a1b2c3d는 원래 구성 ID의 SHA-1 해시의 처음 7자예요.

전체 예시

ID가 production-metrics인 Storage Lens 구성의 경우:

  • 테이블 버킷: aws-s3
  • 카탈로그: s3tablescatalog/aws-s3
  • 네임스페이스: lens_production-metrics_exp
  • 전체 경로: s3tablescatalog/aws-s3/lens_production-metrics_exp/<table-name>

ID가 prod.us.east.metrics인 Storage Lens 구성의 경우:

  • 테이블 버킷: aws-s3
  • 카탈로그: s3tablescatalog/aws-s3
  • 네임스페이스: lens_prod-us-east-metrics_exp_f8e9a1b(해시 포함)
  • 전체 경로: s3tablescatalog/aws-s3/lens_prod-us-east-metrics_exp_f8e9a1b/<table-name>

테이블 유형

다음 표는 S3 Storage Lens 내보내기에 대해 생성되는 다양한 테이블 유형을 보여줘요.

카탈로그 네임스페이스 S3 테이블 이름 설명
s3tablescatalog/aws-s3 lens_<conf_name>exp[<hash>] default_storage_metrics Storage Lens 구성의 스토리지 지표를 포함하는 테이블
s3tablescatalog/aws-s3 lens_<conf_name>exp[<hash>] default_activity_metrics Storage Lens 구성의 활동 지표를 포함하는 테이블
s3tablescatalog/aws-s3 lens_<conf_name>exp[<hash>] expanded_prefixes_storage_metrics Storage Lens 구성의 모든 프리픽스에 대한 스토리지 지표를 포함하는 테이블
s3tablescatalog/aws-s3 lens_<conf_name>exp[<hash>] expanded_prefixes_activity_metrics Storage Lens 구성의 모든 프리픽스에 대한 활동 지표를 포함하는 테이블
s3tablescatalog/aws-s3 lens_<conf_name>exp[<hash>] bucket_property_metrics Storage Lens 구성의 모든 버킷에 대한 버킷 속성 지표를 포함하는 테이블

다음 단계

더 알아보기 (Learn more)