# S3 ストレージレンズから S3 Tables へのエクスポートのテーブルの命名
<a name="storage_lens_s3_tables_naming"></a>

## 概要
<a name="storage_lens_s3_tables_overview"></a>

S3 ストレージレンズメトリクスを S3 Tables にエクスポートする場合、テーブルは、互換性と整理を確保するために、特定の命名パターンを持つ Apache Iceberg カタログ規則を使用して編成されます。

## テーブルの場所の構造
<a name="storage_lens_table_location_structure"></a>

完全なテーブルの場所は次のパターンに従います。

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

### テーブルバケット名
<a name="storage_lens_table_bucket_name"></a>

**テーブルバケット:** `aws-s3`

S3 ストレージレンズエクスポートでは、AWS S3 関連のシステムテーブル用に指定されたバケットである `aws-s3` テーブルバケットを使用します。

### カタログ名
<a name="storage_lens_catalog_name"></a>

**カタログ:** `s3tablescatalog/aws-s3`

ストレージレンズは 3 種類の S3 リソースに関するインサイトを提供するため、S3 ストレージレンズテーブルは S3 カタログに保存されます。
+ ストレージメトリクス
+ バケットのプロパティ
+ API 使用状況メトリクス

## 名前空間の命名規則
<a name="storage_lens_namespace_naming"></a>

名前空間は、カタログ内のテーブルを整理します。S3 ストレージレンズの場合、名前空間はストレージレンズ設定 ID から取得されます。

### 標準名前空間形式
<a name="storage_lens_standard_namespace"></a>

ドット (`.`) なしのストレージレンズ設定 ID の場合:

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

**例:** 設定 ID が `my-lens-config` の場合、名前空間は次のようになります。

```
lens_my-lens-config_exp
```

### ドット文字処理を使用した名前空間形式
<a name="storage_lens_namespace_dot_handling"></a>

ストレージレンズ設定 ID にはドット (`.`) を含めることができますが、S3 Tables 名前空間は小文字、数字、ハイフン (`-`)、アンダースコア (`_`) のみをサポートします。設定 ID にドットが含まれている場合、それらはハイフンに変換され、一意性のためにハッシュサフィックスが追加されます。

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

**例:** 設定 ID が `my.lens.config` の場合、名前空間は次のようになります。

```
lens_my-lens-config_exp_a1b2c3d
```

ここで、`a1b2c3d` は元の設定 ID の SHA-1 ハッシュの最初の 7 文字です。

### 名前空間の命名規則
<a name="storage_lens_namespace_rules"></a>
+ 長さ: 1-127 文字
+ 使用できる文字: 小文字 (a～z)、数字 (0～9)、ハイフン (-)、アンダースコア (\$1)
+ パターン: `[a-z0-9_-]{1,127}`
+ テーブルバケット内で一意である必要があります

## ストレージレンズ設定 ID の要件
<a name="storage_lens_config_id_requirements"></a>

ストレージレンズ設定 ID は、次のルールに従う必要があります。
+ 長さ: 1～64 文字
+ 使用できる文字: 文字 (a～z、A～Z)、数字 (0～9)、ハイフン (-)、アンダースコア (\$1)、ドット (.)
+ パターン: `[a-zA-Z0-9\-\_.]+`

## 完全な例
<a name="storage_lens_complete_examples"></a>

ID が `production-metrics` のストレージレンズ設定の場合:
+ **テーブルバケット:** `aws-s3`
+ **カタログ:** `s3tablescatalog/aws-s3`
+ **名前空間:** `lens_production-metrics_exp`
+ **フルパス:** `s3tablescatalog/aws-s3/lens_production-metrics_exp/<table-name>`

ID が `prod.us.east.metrics` のストレージレンズ設定の場合:
+ **テーブルバケット:** `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_table_types"></a>

次の表は、S3 ストレージレンズエクスポート用に作成されたさまざまなタイプのテーブルを示しています。


| バケット名　 | 名前空間 | S3 テーブル名 | 説明 | 
| --- | --- | --- | --- | 
| s3tablescatalog/aws-s3 | lens\$1<conf\$1name>\$1exp[\$1<hash>] | default\$1storage\$1metrics | この表には、ストレージレンズ設定のストレージメトリクスが含まれています。 | 
| s3tablescatalog/aws-s3 | lens\$1<conf\$1name>\$1exp[\$1<hash>] | default\$1activity\$1metrics | この表には、ストレージレンズ設定のアクティビティメトリクスが含まれています。 | 
| s3tablescatalog/aws-s3 | lens\$1<conf\$1name>\$1exp[\$1<hash>] | expanded\$1prefixes\$1storage\$1metrics | このテーブルには、ストレージレンズ設定のすべてのプレフィックスのストレージメトリクスが含まれています。 | 
| s3tablescatalog/aws-s3 | lens\$1<conf\$1name>\$1exp[\$1<hash>] | expanded\$1prefixes\$1activity\$1metrics | このテーブルには、ストレージレンズ設定のすべてのプレフィックスのアクティビティメトリクスが含まれています。 | 
| s3tablescatalog/aws-s3 | lens\$1<conf\$1name>\$1exp[\$1<hash>] | bucket\$1property\$1metrics | このテーブルには、ストレージレンズ設定内のすべてのバケットのバケットプロパティメトリクスが含まれています。 | 

**注記**  
S3 ストレージレンズメトリクスを AWS マネージド S3 Tables バケットにエクスポートする場合、追加料金はかかりません。テーブルバケットのテーブルストレージと管理には、通常の料金がかかります。Amazon S3 コンソール、Amazon S3 API、AWS CLI、または AWS SDK を使用して、S3 Tables へのエクスポートを有効または無効にすることができます。