# S3 Storage Lens를 S3 Tables로 내보내기 위한 테이블 이름 지정
<a name="storage-lens-s3-tables-naming"></a>

S3 Storage Lens 지표를 S3 Tables로 내보내면 테이블은 호환성과 구성을 보장하기 위해 특정 이름 지정 패턴이 있는 Apache Iceberg 카탈로그 규칙을 사용하여 구성됩니다.

## 테이블 위치 구조
<a name="storage-lens-s3-tables-naming-location"></a>

전체 테이블 위치는 다음 패턴을 따릅니다.

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

### 테이블 버킷 이름
<a name="storage-lens-s3-tables-naming-bucket"></a>

 **테이블 버킷:** `aws-s3` 

S3 Storage Lens 내보내기는 AWS S3 관련 시스템 테이블의 지정된 버킷인 `aws-s3` 테이블 버킷을 사용합니다.

### 카탈로그 이름
<a name="storage-lens-s3-tables-naming-catalog"></a>

 **카탈로그:** `s3tablescatalog/aws-s3` 

Storage Lens는 다음과 같은 세 가지 유형의 S3 리소스에 대한 인사이트를 제공하므로 S3 Storage Lens 테이블은 S3 카탈로그에 저장됩니다.
+ 스토리지 지표
+ 버킷 속성
+ API 사용량 지표

## 네임스페이스 이름 지정 규칙
<a name="storage-lens-s3-tables-naming-namespace"></a>

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

### 표준 네임스페이스 형식
<a name="storage-lens-s3-tables-naming-namespace-standard"></a>

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

```
lens_<configuration-id>_exp
```

 **예:** 구성 ID가 `my-lens-config`인 경우 네임스페이스는 다음과 같습니다.

```
lens_my-lens-config_exp
```

### 점 문자 또는 대문자 처리를 포함한 네임스페이스 형식
<a name="storage-lens-s3-tables-naming-namespace-dots"></a>

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자입니다.

## 전체 예제
<a name="storage-lens-s3-tables-naming-examples"></a>

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>` 

## 테이블 유형
<a name="storage-lens-s3-tables-naming-types"></a>

다음 테이블에는 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 구성의 모든 버킷에 대한 버킷 속성 지표가 있습니다. | 

## 다음 단계
<a name="storage-lens-s3-tables-naming-next-steps"></a>
+ [S3 Storage Lens 테이블 스키마 이해](storage-lens-s3-tables-schemas.md)에 대해 알아봅니다.
+ [S3 Storage Lens 테이블에 대한 권한](storage-lens-s3-tables-permissions.md)에 대해 알아봅니다.