View a markdown version of this page

Nomenclatura de tabelas para exportação da Lente de Armazenamento para a funcionalidade Tabelas do S3 - Amazon Simple Storage Service
Estrutura do local da tabelaConvenção de nomenclatura de namespaceExemplos completosTipos de tabelaPróximas etapas

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/<namespace>/<table-name>

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_<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 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_<configuration-id-with-dots-or-uppercase-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.

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/<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 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_<conf_name>_exp[_<hash>] default_storage_metrics Esta tabela contém as métricas de armazenamento para a configuração da Lente de Armazenamento.
s3tablescatalog/aws-s3 lens_<conf_name>_exp[_<hash>] default_activity_metrics Esta tabela contém as métricas de atividade da configuração da Lente de Armazenamento.
s3tablescatalog/aws-s3 lens_<conf_name>_exp[_<hash>] 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_<conf_name>_exp[_<hash>] 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_<conf_name>_exp[_<hash>] 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