Regras de nomenclatura de buckets de tabela, tabelas e namespaces do Amazon S3

Ao criar um bucket de tabela, escolha um nome de bucket e uma Região da AWS. O nome deve ser exclusivo dentro da conta na região escolhida. Depois de criar um bucket de tabela, você não poderá mais alterar o respectivo nome ou região. Os nomes dos buckets de tabela devem seguir regras de nomenclatura específicas. Para ter mais informações sobre as regras de nomenclatura para os buckets de tabela e para as tabelas e os namespaces dentro deles, consulte o tópico a seguir.

Regras de nomenclatura de buckets de tabela

Ao criar buckets de tabela do Amazon S3, especifique um nome de bucket de tabela. Como outros tipos de bucket, não é possível renomear os buckets de tabela. Ao contrário de outros tipos de bucket, os buckets de tabela não estão em um namespace global, então cada nome de bucket na conta só precisa ser exclusivo apenas na região da AWS atual.

Para conferir as regras de nomenclatura para buckets de uso geral, consulte Regras de nomenclatura de buckets de uso geral. Consulte as regras de nomenclatura de buckets de diretório em Regras de nomenclatura de buckets de diretório.

As regras de nomenclatura a seguir se aplicam aos buckets de tabela.

• Os nomes dos buckets devem ter entre 3 e 63 caracteres.

• Os nomes de bucket podem consistir apenas em letras minúsculas, números e hífenes (-).

• Os nomes dos buckets devem começar e terminar com uma letra ou um número.

• Os nomes de bucket não devem conter sublinhados (_) nem pontos (.).

• Os nomes de bucket não devem começar com os seguintes prefixos:

  • xn--

  • sthree-

  • amzn-s3-demo-

  • aws

• Os nomes de bucket não devem terminar com os seguintes prefixos:

  • -s3alias

  • --ol-s3

  • --x-s3

  • --table-s3

Regras de nomenclatura para tabelas e namespaces

As seguintes regras de nomenclatura se aplicam a tabelas e namespaces dentro de buckets de tabela:

• Os nomes devem ter entre 1 e 255 caracteres.

• Os nomes só podem consistir em letras minúsculas, números e sublinhados (_).

• Os nomes devem começar e terminar com uma letra ou um número.

• Os nomes não devem conter hifens (-) nem pontos (.).

• O nome da tabela deve ser único dentro de um namespace.

• Um namespace deve ser único dentro de um bucket de tabela.

• Os nomes de namespaces não devem começar com o prefixo reservado aws.

Importante

Ao criar tabelas, use apenas letras minúsculas nos nomes e nas definições das tabelas. Por exemplo, os nomes das colunas devem estar todos em minúsculas. Se o nome da tabela ou a definição da tabela contiver letras maiúsculas, a tabela não será compatível com o AWS Lake Formation ou o AWS Glue Data Catalog. Nesse caso, a tabela não estará visível para serviços de analytics da AWS, como o Amazon Athena, mesmo que os buckets de tabela estejam integrados aos serviços de analytics da AWS.

Se a definição da tabela contiver letras maiúsculas, você receberá a seguinte mensagem de erro ao executar uma consulta SELECT no Athena: “GENERIC_INTERNAL_ERROR: Get table request failed: com.amazonaws.services.glue.model.ValidationException: Unsupported Federation Resource - Invalid table or column names”.