Um namespace de tabela é um constructo lógico que serve para agrupar tabelas em um bucket de tabela do Amazon S3. Cada tabela pertence a um único namespace. Antes de criar uma tabela em um bucket de tabela, é necessário criar um namespace para agrupá-las. É possível criar um namespace usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3, os SDKs da AWS ou mecanismos de consulta integrados.
Nomes do namespace
As seguintes regras de nomenclatura se aplicam aos namespaces:
-
Os nomes devem ter entre 1 e 255 caracteres.
-
Os nomes só podem consistir em letras minúsculas, números e sublinhados (
_). Sublinhados não são permitidos no início dos nomes de namespace. -
Os nomes devem começar e terminar com uma letra ou um número.
-
Os nomes não devem conter hifens (
-) nem pontos (.).
Consulte mais informações sobre nomes válidos de namespace em Regras de nomenclatura para tabelas e namespaces.
O procedimento a seguir usa o fluxo de trabalho Criar tabela com o Athena para criar um namespace no console do Amazon S3. Se não quiser usar o Amazon Athena também para criar uma tabela no namespace, você poderá cancelar o fluxo de trabalho depois de criar o namespace.
Para criar um namespace
Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/
. -
No painel de navegação à esquerda, escolha Buckets de tabela.
-
Na página Buckets de tabela, escolha o bucket no qual você deseja criar um namespace.
-
Na página de detalhes do bucket, escolha Criar tabela com o Athena.
-
Na caixa de diálogo Criar tabela com o Athena, escolha Criar um namespace e, depois, Criar namespace.
-
Insira um nome no campo Nome do namespace. Os nomes de namespace devem ter de 1 a 255 caracteres e ser exclusivos no bucket de tabela. Os caracteres válidos são a–z, 0–9 e sublinhado (
_). Sublinhados não são permitidos no início dos nomes de namespace. -
Escolha Create namespace (Criar namespace).
-
Se você também quiser criar uma tabela, escolha Criar tabela com o Athena. Consulte mais informações sobre como criar uma tabela com o Athena em Usar o console do S3 e o Amazon Athena. Se não quiser criar uma tabela no momento, escolha Cancelar.
Esse exemplo mostra como criar um namespace de tabelas usando a AWS CLI. Para usar esse exemplo, substitua os user input placeholders
aws s3tables create-namespace \ --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-bucket1\ --namespaceexample_namespace
Você pode criar um namespace em uma sessão do Apache Spark conectada aos buckets de tabela do Amazon S3.
Esse exemplo mostra como criar uma tabela usando instruções CREATE em um mecanismo de consulta integrado à funcionalidade Tabelas do S3. Para usar esse exemplo, substitua os espaços reservados para entrada do usuário por suas próprias informações.
spark.sql("CREATE NAMESPACE IF NOT EXISTS s3tablesbucket.my_namespace")
