Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Criar configurações de tabelas de metadados

Modo de foco
Criar configurações de tabelas de metadados - Amazon Simple Storage Service

Para gerar e armazenar o Amazon S3 Metadata em uma tabela de metadados do Apache Iceberg totalmente gerenciada, crie uma configuração de tabelas de metadados para o bucket de uso geral. O Amazon S3 foi projetado para atualizar continuamente a tabela de metadados a fim de refletir as alterações mais recentes nos dados, desde que a configuração esteja ativa no bucket. Além disso, o Amazon S3 otimiza continuamente a tabela de metadados para ajudar a reduzir os custos de armazenamento e melhorar a performance das consultas de analytics.

As tabelas de metadados têm o seguinte formato de nome do recurso da Amazon (ARN):

arn:aws:s3tables:region-code:account-id:bucket/table-bucket-name/table/metadata_table_name

As tabelas de metadados totalmente gerenciadas pelo Amazon S3 são armazenadas no namespace aws_s3_metadata do bucket de tabela. Para ter mais informações sobre os namespaces em buckets de tabela, consulte Table namespaces.

Você pode criar uma configuração de tabelas de metadados usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), os AWS SDKs ou a API REST do Amazon S3.

Pré-requisitos

Para criar uma configuração de tabelas de metadados, primeiro é necessário fazer o seguinte:

  • Garanta que você tenha as permissões do AWS Identity and Access Management (IAM) necessárias para criar e gerenciar tabelas de metadados. Para obter mais informações, consulte Definir permissões para configurar tabelas de metadados.

  • Crie um bucket de tabela do S3 para armazenar a tabela de metadados. Esse bucket de tabela deve estar na mesma Região da AWS e Conta da AWS que o bucket de uso geral. Para ter mais informações sobre como criar buckets de tabela, consulte Creating table buckets. Se estiver usando o console do Amazon S3 para criar a configuração, você poderá executar essa etapa como parte desse processo.

  • Integre o bucket de tabela ao AWS Glue Data Catalog para que você possa consultar diretamente as tabelas de metadados com mecanismos de consulta, como Amazon Athena, Amazon EMR, Amazon Redshift, Apache Spark, Apache Trino e qualquer outra aplicação compatível com o formato Apache Iceberg. Para obter mais informações, consulte Consultar tabelas de metadados com serviços de analytics da AWS.

Criar uma configuração de tabelas de metadados

Como criar uma configuração de tabelas de metadados

Antes de criar uma configuração de tabelas de metadados, revise e cumpra os pré-requisitos e revise Limitações e restrições das tabelas de metadados.

  1. Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. No painel de navegação à esquerda, escolha Buckets de uso geral.

  3. Escolha o bucket de uso geral para o qual você deseja criar uma configuração de tabelas de metadados.

    nota

    Garanta que esse bucket de uso geral esteja em uma Região da AWS onde os buckets de tabela estejam disponíveis. Os buckets de tabela só estão disponíveis nas regiões Leste dos EUA (Norte da Virgínia), Leste dos EUA (Ohio) e Oeste dos EUA (Oregon).

  4. Na página de detalhes dos buckets, escolha a guia Metadados.

  5. Na guia Metadados, escolha Criar configuração de metadados.

  6. Na página Criar configuração de metadados, em Bucket de tabela de destino, especifique um bucket de tabela para armazenar a tabela de metadados. O bucket de tabela deve estar na mesma Conta da AWS e Região da AWS que o bucket de uso geral.

    Se você ainda não tiver um bucket de tabela, escolha Criar bucket de tabela. Os nomes de buckets de tabela devem ter entre 3 e 63 caracteres e ser exclusivos dentro da Conta da AWS na Região da AWS escolhida. Os caracteres válidos são a–z, 0–9 e hifens (-). Para ter mais informações sobre como criar um bucket de tabela, consulte Creating table buckets.

    Ao criar o bucket de tabela, integre-o ao AWS Glue Data Catalog. Para obter mais informações, consulte Consultar tabelas de metadados com serviços de analytics da AWS.

  7. Em Nome da tabela de metadados, especifique o nome que você deseja que a tabela tenha. O nome da tabela de metadados deve ter entre 1 e 255 caracteres e ser exclusivo no namespace aws_s3_metadata do bucket de tabela. Os caracteres válidos são letras minúsculas, números e sublinhados (_).

  8. Escolha Criar configuração de tabelas de metadados.

Se a configuração de tabelas de metadados for bem-sucedida, o ARN da tabela de metadados será exibido na guia Metadados com o bucket de tabela especificado e o nome da tabela de metadados.

Para monitorar as atualizações na configuração de tabelas de metadados, você pode usar o AWS CloudTrail. Para obter mais informações, consulte Ações de buckets do Amazon S3 rastreadas pelo registro em log do CloudTrail.

Como criar uma configuração de tabelas de metadados

Antes de criar uma configuração de tabelas de metadados, revise e cumpra os pré-requisitos e revise Limitações e restrições das tabelas de metadados.

  1. Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. No painel de navegação à esquerda, escolha Buckets de uso geral.

  3. Escolha o bucket de uso geral para o qual você deseja criar uma configuração de tabelas de metadados.

    nota

    Garanta que esse bucket de uso geral esteja em uma Região da AWS onde os buckets de tabela estejam disponíveis. Os buckets de tabela só estão disponíveis nas regiões Leste dos EUA (Norte da Virgínia), Leste dos EUA (Ohio) e Oeste dos EUA (Oregon).

  4. Na página de detalhes dos buckets, escolha a guia Metadados.

  5. Na guia Metadados, escolha Criar configuração de metadados.

  6. Na página Criar configuração de metadados, em Bucket de tabela de destino, especifique um bucket de tabela para armazenar a tabela de metadados. O bucket de tabela deve estar na mesma Conta da AWS e Região da AWS que o bucket de uso geral.

    Se você ainda não tiver um bucket de tabela, escolha Criar bucket de tabela. Os nomes de buckets de tabela devem ter entre 3 e 63 caracteres e ser exclusivos dentro da Conta da AWS na Região da AWS escolhida. Os caracteres válidos são a–z, 0–9 e hifens (-). Para ter mais informações sobre como criar um bucket de tabela, consulte Creating table buckets.

    Ao criar o bucket de tabela, integre-o ao AWS Glue Data Catalog. Para obter mais informações, consulte Consultar tabelas de metadados com serviços de analytics da AWS.

  7. Em Nome da tabela de metadados, especifique o nome que você deseja que a tabela tenha. O nome da tabela de metadados deve ter entre 1 e 255 caracteres e ser exclusivo no namespace aws_s3_metadata do bucket de tabela. Os caracteres válidos são letras minúsculas, números e sublinhados (_).

  8. Escolha Criar configuração de tabelas de metadados.

Se a configuração de tabelas de metadados for bem-sucedida, o ARN da tabela de metadados será exibido na guia Metadados com o bucket de tabela especificado e o nome da tabela de metadados.

Para monitorar as atualizações na configuração de tabelas de metadados, você pode usar o AWS CloudTrail. Para obter mais informações, consulte Ações de buckets do Amazon S3 rastreadas pelo registro em log do CloudTrail.

Para executar os comandos a seguir, você deve ter a AWS CLI instalada e configurada. Se ainda não tiver a AWS CLI instalada, consulte Instalar ou atualizar a versão mais recente da AWS CLI no Guia do usuário da AWS Command Line Interface.

Também é possível executar comandos da AWS CLI pelo console usando o AWS CloudShell. O AWS CloudShell é um shell pré-autenticado e baseado em navegador que você pode iniciar diretamente do AWS Management Console. Para ter mais informações, consulte What is CloudShell? e Getting started with AWS CloudShell no Guia do usuário do AWS CloudShell.

Como criar uma configuração de tabelas de metadados usando a AWS CLI

Antes de criar uma configuração de tabelas de metadados, revise e cumpra os pré-requisitos e revise Limitações e restrições das tabelas de metadados.

Para usar os comandos a seguir, substitua os user input placeholders por suas próprias informações.

  1. Se você ainda não tiver um bucket de tabela, use o comando a seguir para criar um bucket de tabela a fim de armazenar a tabela de metadados. Garanta que o bucket de tabela esteja na mesma Região da AWS que o bucket de uso geral para o qual você deseja criar uma configuração de tabelas de metadados.

    aws s3tables create-table-bucket --name amzn-s3-demo-bucket --region us-east-2
  2. Para verificar se o bucket de tabela foi criado, use o seguinte comando:

    aws s3tables list-table-buckets --region us-east-2
  3. Crie um arquivo JSON que contenha a configuração de tabelas de metadados e salve-o (por exemplo, metadata-config.json). Veja a seguir uma configuração de amostra.

    Os nomes de buckets de tabela devem ter entre 3 e 63 caracteres e ser exclusivos dentro da Conta da AWS na Região da AWS escolhida. Os caracteres válidos são a–z, 0–9 e hifens (-). Para ter mais informações sobre como criar um bucket de tabela, consulte Creating table buckets.

    O nome da tabela de metadados deve ter entre 1 e 255 caracteres e ser exclusivo no namespace aws_s3_metadata do bucket de tabela. Os caracteres válidos são letras minúsculas, números e sublinhados (_).

    { "S3TablesDestination": { "TableBucketArn": "arn:aws:s3tables:us-east-2:111122223333:bucket/amzn-s3-demo-bucket", "TableName": "test_metadata_table" } }
  4. Use o comando a seguir para aplicar a configuração de tabelas de metadados ao bucket de uso geral (por exemplo, amzn-s3-demo-source-bucket):

    aws s3api create-bucket-metadata-table-configuration \ --bucket amzn-s3-demo-source-bucket \ --metadata-table-configuration file://./metadata-config.json \ --region us-east-2
  5. Para verificar se a configuração foi criada, execute o seguinte comando:

    aws s3api get-bucket-metadata-table-configuration \ --bucket amzn-s3-demo-source-bucket \ --region us-east-2

Para monitorar as atualizações na configuração de tabelas de metadados, você pode usar o AWS CloudTrail. Para obter mais informações, consulte Ações de buckets do Amazon S3 rastreadas pelo registro em log do CloudTrail.

Para executar os comandos a seguir, você deve ter a AWS CLI instalada e configurada. Se ainda não tiver a AWS CLI instalada, consulte Instalar ou atualizar a versão mais recente da AWS CLI no Guia do usuário da AWS Command Line Interface.

Também é possível executar comandos da AWS CLI pelo console usando o AWS CloudShell. O AWS CloudShell é um shell pré-autenticado e baseado em navegador que você pode iniciar diretamente do AWS Management Console. Para ter mais informações, consulte What is CloudShell? e Getting started with AWS CloudShell no Guia do usuário do AWS CloudShell.

Como criar uma configuração de tabelas de metadados usando a AWS CLI

Antes de criar uma configuração de tabelas de metadados, revise e cumpra os pré-requisitos e revise Limitações e restrições das tabelas de metadados.

Para usar os comandos a seguir, substitua os user input placeholders por suas próprias informações.

  1. Se você ainda não tiver um bucket de tabela, use o comando a seguir para criar um bucket de tabela a fim de armazenar a tabela de metadados. Garanta que o bucket de tabela esteja na mesma Região da AWS que o bucket de uso geral para o qual você deseja criar uma configuração de tabelas de metadados.

    aws s3tables create-table-bucket --name amzn-s3-demo-bucket --region us-east-2
  2. Para verificar se o bucket de tabela foi criado, use o seguinte comando:

    aws s3tables list-table-buckets --region us-east-2
  3. Crie um arquivo JSON que contenha a configuração de tabelas de metadados e salve-o (por exemplo, metadata-config.json). Veja a seguir uma configuração de amostra.

    Os nomes de buckets de tabela devem ter entre 3 e 63 caracteres e ser exclusivos dentro da Conta da AWS na Região da AWS escolhida. Os caracteres válidos são a–z, 0–9 e hifens (-). Para ter mais informações sobre como criar um bucket de tabela, consulte Creating table buckets.

    O nome da tabela de metadados deve ter entre 1 e 255 caracteres e ser exclusivo no namespace aws_s3_metadata do bucket de tabela. Os caracteres válidos são letras minúsculas, números e sublinhados (_).

    { "S3TablesDestination": { "TableBucketArn": "arn:aws:s3tables:us-east-2:111122223333:bucket/amzn-s3-demo-bucket", "TableName": "test_metadata_table" } }
  4. Use o comando a seguir para aplicar a configuração de tabelas de metadados ao bucket de uso geral (por exemplo, amzn-s3-demo-source-bucket):

    aws s3api create-bucket-metadata-table-configuration \ --bucket amzn-s3-demo-source-bucket \ --metadata-table-configuration file://./metadata-config.json \ --region us-east-2
  5. Para verificar se a configuração foi criada, execute o seguinte comando:

    aws s3api get-bucket-metadata-table-configuration \ --bucket amzn-s3-demo-source-bucket \ --region us-east-2

Para monitorar as atualizações na configuração de tabelas de metadados, você pode usar o AWS CloudTrail. Para obter mais informações, consulte Ações de buckets do Amazon S3 rastreadas pelo registro em log do CloudTrail.

Você pode enviar solicitações REST para criar uma configuração de tabelas de metadados. Para obter mais informações, consulte CreateBucketMetadataTableConfiguration na Referência da API do Amazon S3.

Você pode enviar solicitações REST para criar uma configuração de tabelas de metadados. Para obter mais informações, consulte CreateBucketMetadataTableConfiguration na Referência da API do Amazon S3.

Você pode usar os AWS SDKs para criar uma configuração de tabelas de metadados no Amazon S3. Para ter mais informações, consulte a lista de SDKs compatíveis na Referência de API do Amazon S3.

Você pode usar os AWS SDKs para criar uma configuração de tabelas de metadados no Amazon S3. Para ter mais informações, consulte a lista de SDKs compatíveis na Referência de API do Amazon S3.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.