# Nomenclatura de tabelas para exportação da Lente de Armazenamento para tabelas do S3
<a name="storage_lens_s3_tables_naming"></a>

## Visão geral
<a name="storage_lens_s3_tables_overview"></a>

Ao exportar métricas da Lente de Armazenamento do S3 para tabelas do S3, as tabelas são organizadas usando as convenções do catálogo do Apache Iceberg com padrões de nomenclatura específicos para garantir compatibilidade e organização.

## Estrutura do local da tabela
<a name="storage_lens_table_location_structure"></a>

A localização completa da tabela segue este padrão:

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

### Nome do bucket de tabela
<a name="storage_lens_table_bucket_name"></a>

**Bucket de tabela:** `aws-s3`

A exportação da Lente de Armazenamento do S3 usa o bucket de tabela `aws-s3`, que é o bucket designado para tabelas de sistema da AWS relacionadas ao S3.

### Nome do catálogo
<a name="storage_lens_catalog_name"></a>

**Catálogo:** `s3tablescatalog/aws-s3`

As tabelas da Lente de Armazenamento do S3 são armazenadas no catálogo do S3 porque a Lente de Armazenamento fornece informações sobre três tipos de recurso do S3:
+ Métricas de armazenamento
+ Propriedades do bucket
+ Métricas de uso da API

## Convenção de nomenclatura de namespace
<a name="storage_lens_namespace_naming"></a>

Os namespaces organizam as tabelas dentro do catálogo. Para a Lente de Armazenamento do S3, o namespace é derivado do ID de configuração da Lente de Armazenamento.

### Formato de namespace padrão
<a name="storage_lens_standard_namespace"></a>

Para IDs de configuração da Lente de Armazenamento sem pontos (`.`):

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

**Exemplo:** se o ID da configuração for `my-lens-config`, o namespace será:

```
lens_my-lens-config_exp
```

### Formato de namespace com manipulação de caracteres de ponto
<a name="storage_lens_namespace_dot_handling"></a>

Os IDs de configuração da Lente de Armazenamento podem conter pontos (`.`), mas os namespaces de tabela do S3 só permitem letras minúsculas, números, hifens (`-`) e sublinhados (`_`). Quando o ID de configuração contém pontos, ele é convertido em hífen e um sufixo de hash é adicionado para fins de exclusividade:

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

**Exemplo:** se o ID da configuração for `my.lens.config`, o namespace será:

```
lens_my-lens-config_exp_a1b2c3d
```

Em que `a1b2c3d` são os primeiros sete caracteres do hash SHA-1 do ID de configuração original.

### Regras de nomenclatura de namespace
<a name="storage_lens_namespace_rules"></a>
+ Extensão: 1-127 caracteres.
+ Caracteres permitidos: letras minúsculas (a-z), números (0-9), hifens (-), sublinhados (\$1).
+ Número do padrão: `[a-z0-9_-]{1,127}`
+ O nome deve ser exclusivo dentro do bucket de tabela.

## Requisitos do ID de configuração da Lente de Armazenamento
<a name="storage_lens_config_id_requirements"></a>

O ID de configuração da Lente de Armazenamento deve seguir estas regras:
+ Extensão: 1-64 caracteres.
+ Caracteres permitidos: letras minúsculas (a-z, A-Z), números (0-9), hifens (-), sublinhados (\$1) e pontos (.).
+ Número do padrão: `[a-zA-Z0-9\-\_.]+`

## Exemplos completos
<a name="storage_lens_complete_examples"></a>

Para uma configuração da Lente de Armazenamento com o ID `production-metrics`:
+ **Bucket de tabela:** `aws-s3`
+ **Catálogo:** `s3tablescatalog/aws-s3`
+ **Namespace:** `lens_production-metrics_exp`
+ **Caminho completo:** `s3tablescatalog/aws-s3/lens_production-metrics_exp/<table-name>`

Para uma configuração da Lente de Armazenamento com o ID `prod.us.east.metrics`:
+ **Bucket de tabela:** `aws-s3`
+ **Catálogo:** `s3tablescatalog/aws-s3`
+ **Namespace:** `lens_prod-us-east-metrics_exp_f8e9a1b` (com hash)
+ **Caminho completo:** `s3tablescatalog/aws-s3/lens_prod-us-east-metrics_exp_f8e9a1b/<table-name>`

## Tipos de tabela
<a name="storage_lens_table_types"></a>

A seguinte tabela mostra os diferentes tipos de tabela criados para exportações da Lente de Armazenamento do S3:


| Nome do bucket | Namespace | Nome da tabela do S3 | Descrição | 
| --- | --- | --- | --- | 
| s3tablescatalog/aws-s3 | lens\$1<conf\$1name>\$1exp[\$1<hash>] | default\$1storage\$1metrics | Esta tabela contém as métricas de armazenamento para a configuração da Lente de Armazenamento. | 
| s3tablescatalog/aws-s3 | lens\$1<conf\$1name>\$1exp[\$1<hash>] | default\$1activity\$1metrics | Esta tabela contém as métricas de atividade da configuração da Lente de Armazenamento. | 
| s3tablescatalog/aws-s3 | lens\$1<conf\$1name>\$1exp[\$1<hash>] | expanded\$1prefixes\$1storage\$1metrics | Esta tabela contém as métricas de armazenamento de todos os prefixos na configuração da Lente de Armazenamento. | 
| s3tablescatalog/aws-s3 | lens\$1<conf\$1name>\$1exp[\$1<hash>] | expanded\$1prefixes\$1activity\$1metrics | Esta tabela contém as métricas de atividade de todos os prefixos na configuração da Lente de Armazenamento. | 
| s3tablescatalog/aws-s3 | lens\$1<conf\$1name>\$1exp[\$1<hash>] | bucket\$1property\$1metrics | Esta tabela contém as métricas de propriedade de bucket de todos os buckets na configuração da Lente de Armazenamento. | 

**nota**  
Não há custo adicional para exportar métricas da Lente de Armazenamento do S3 para um bucket de tabela do S3 gerenciado pela AWS. Você paga as taxas usuais de armazenamento e gerenciamento de tabelas no bucket de tabela. Você pode habilitar ou desabilitar a exportação para a funcionalidade Tabelas do S3 usando o console do Amazon S3, a API do Amazon S3, a AWS CLI ou SDKs da AWS.