# S3 Storage Lens 存储统计管理工具导出到 S3 表类数据存储服务的表命名
<a name="storage-lens-s3-tables-naming"></a>

将 S3 Storage Lens 存储统计管理工具指标导出到 S3 表类数据存储服务时，这些表将使用 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` 表存储桶，这是与 Amazon S3 相关的系统表的指定存储桶。

### 目录名称
<a name="storage-lens-s3-tables-naming-catalog"></a>

 **目录：**`s3tablescatalog/aws-s3`

S3 Storage Lens 存储统计管理工具表存储在 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 表类数据存储服务命名空间仅支持小写字母、数字、连字符 (`-`) 和下划线 (`_`)。当您的配置 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)