# Nomenclatura de tabelas para exportação da Lente de Armazenamento para a funcionalidade Tabelas do S3 Ao exportar métricas da Lente de Armazenamento do S3 para a funcionalidade 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 localização completa da tabela segue este padrão: ``` s3tablescatalog/aws-s3// ``` ### Nome do bucket de tabela **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 **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 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 Para IDs de configuração da Lente de Armazenamento sem pontos (`.`): ``` lens__exp ``` **Exemplo:** se o ID da configuração for `my-lens-config`, o namespace será: ``` lens_my-lens-config_exp ``` ### Formato de namespace com tratamento de caracteres de ponto ou letras maiúsculas Os IDs de configuração da Lente de Armazenamento podem conter pontos (`.`) ou letras maiúsculas (`A-Z`), mas os namespaces da funcionalidade Tabelas 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, as letras maiúsculas são convertidas em letras minúsculas e um sufixo de hash é adicionado para fins de distinção: ``` lens__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. ## Exemplos completos 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/` 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/` ## Tipos de tabela A seguinte tabela mostra os diferentes tipos de tabela criados para exportações da Lente de Armazenamento do S3: | Catálogo | Namespace | Nome da tabela do S3 | Descrição | | --- | --- | --- | --- | | s3tablescatalog/aws-s3 | lens\_\_exp[\_] | default\_storage\_metrics | Esta tabela contém as métricas de armazenamento para a configuração da Lente de Armazenamento. | | s3tablescatalog/aws-s3 | lens\_\_exp[\_] | default\_activity\_metrics | Esta tabela contém as métricas de atividade da configuração da Lente de Armazenamento. | | s3tablescatalog/aws-s3 | lens\_\_exp[\_] | expanded\_prefixes\_storage\_metrics | Esta tabela contém as métricas de armazenamento de todos os prefixos na configuração da Lente de Armazenamento. | | s3tablescatalog/aws-s3 | lens\_\_exp[\_] | expanded\_prefixes\_activity\_metrics | Esta tabela contém as métricas de atividade de todos os prefixos na configuração da Lente de Armazenamento. | | s3tablescatalog/aws-s3 | lens\_\_exp[\_] | bucket\_property\_metrics | Esta tabela contém as métricas de propriedade de bucket de todos os buckets na configuração da Lente de Armazenamento. | ## Próximas etapas + Saiba mais sobre o [Noções básicas sobre esquemas de tabela da Lente de Armazenamento do S3](storage-lens-s3-tables-schemas.md) + Saiba mais sobre o [Permissões para tabelas da Lente de Armazenamento do S3](storage-lens-s3-tables-permissions.md)