Nomenclatura de tabelas para exportação da Lente de Armazenamento para tabelas do S3 - Amazon Simple Storage Service
Visão geralEstrutura do local da tabelaConvenção de nomenclatura de namespaceRequisitos do ID de configuração da Lente de ArmazenamentoExemplos completosTipos de tabela

Nomenclatura de tabelas para exportação da Lente de Armazenamento para tabelas do S3

Visão geral

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 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 manipulação de caracteres de ponto

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

  • Extensão: 1-127 caracteres.

  • Caracteres permitidos: letras minúsculas (a-z), números (0-9), hifens (-), sublinhados (_).

  • 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

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 (_) e pontos (.).

  • Padrão: [a-zA-Z0-9\-\_.]+.

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:

Nome do bucket 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.
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.