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

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

### カタログ名
<a name="storage-lens-s3-tables-naming-catalog"></a>

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

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

## 名前空間の命名規則
<a name="storage-lens-s3-tables-naming-namespace"></a>

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

### 標準名前空間形式
<a name="storage-lens-s3-tables-naming-namespace-standard"></a>

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

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

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

```
lens_my-lens-config_exp
```

### ドット文字処理または大文字処理を含む名前空間形式
<a name="storage-lens-s3-tables-naming-namespace-dots"></a>

ストレージレンズ設定 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` のストレージレンズ設定の場合: 
+  **テーブルバケット:** `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-s3-tables-naming-types"></a>

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


| カタログ | 名前空間 | S3 テーブル名 | 説明 | 
| --- | --- | --- | --- | 
| s3tablescatalog/aws-s3 | lens\_<conf\_name>\_exp[\_<hash>] | default\_storage\_metrics | この表には、ストレージレンズ設定のストレージメトリクスが含まれています。 | 
| s3tablescatalog/aws-s3 | lens\_<conf\_name>\_exp[\_<hash>] | default\_activity\_metrics | この表には、ストレージレンズ設定のアクティビティメトリクスが含まれています。 | 
| s3tablescatalog/aws-s3 | lens\_<conf\_name>\_exp[\_<hash>] | expanded\_prefixes\_storage\_metrics | このテーブルには、ストレージレンズ設定のすべてのプレフィックスのストレージメトリクスが含まれています。 | 
| s3tablescatalog/aws-s3 | lens\_<conf\_name>\_exp[\_<hash>] | expanded\_prefixes\_activity\_metrics | このテーブルには、ストレージレンズ設定のすべてのプレフィックスのアクティビティメトリクスが含まれています。 | 
| s3tablescatalog/aws-s3 | lens\_<conf\_name>\_exp[\_<hash>] | bucket\_property\_metrics | このテーブルには、ストレージレンズ設定内のすべてのバケットのバケットプロパティメトリクスが含まれています。 | 

## 次のステップ
<a name="storage-lens-s3-tables-naming-next-steps"></a>
+ [S3 ストレージレンズのテーブルスキーマを理解する](storage-lens-s3-tables-schemas.md) について説明します 
+ [S3 ストレージレンズテーブルのアクセス許可](storage-lens-s3-tables-permissions.md) について説明します