S3 ストレージレンズから S3 Tables へのエクスポートのテーブルの命名 - Amazon Simple Storage Service
概要テーブルの場所の構造名前空間の命名規則ストレージレンズ設定 ID の要件完全な例テーブルタイプ

S3 ストレージレンズから S3 Tables へのエクスポートのテーブルの命名

概要

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

テーブルの場所の構造

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

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

テーブルバケット名

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

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

カタログ名

カタログ: s3tablescatalog/aws-s3

ストレージレンズは 3 種類の S3 リソースに関するインサイトを提供するため、S3 ストレージレンズテーブルは S3 カタログに保存されます。

  • ストレージメトリクス

  • バケットのプロパティ

  • API 使用状況メトリクス

名前空間の命名規則

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

標準名前空間形式

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

lens_<configuration-id>_exp

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

lens_my-lens-config_exp

ドット文字処理を使用した名前空間形式

ストレージレンズ設定 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 文字です。

名前空間の命名規則

  • 長さ: 1-127 文字

  • 使用できる文字: 小文字 (a～z)、数字 (0～9)、ハイフン (-)、アンダースコア (_)

  • パターン: [a-z0-9_-]{1,127}

  • テーブルバケット内で一意である必要があります

ストレージレンズ設定 ID の要件

ストレージレンズ設定 ID は、次のルールに従う必要があります。

  • 長さ: 1～64 文字

  • 使用できる文字: 文字 (a～z、A～Z)、数字 (0～9)、ハイフン (-)、アンダースコア (_)、ドット (.)

  • パターン: [a-zA-Z0-9\-\_.]+

完全な例

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>

テーブルタイプ

次の表は、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 このテーブルには、ストレージレンズ設定内のすべてのバケットのバケットプロパティメトリクスが含まれています。
注記

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