Consultar tabelas do Amazon S3 com o Amazon Athena

O Amazon Athena é um serviço de consultas interativas que você pode usar para analisar dados no Amazon S3 usando SQL padrão. Para obter mais informações, consulte O que é o Amazon Athena? no Guia do usuário do Amazon Athena.

Depois que os buckets de tabela são integrados aos serviços de analytics da AWS, é possível executar consultas Data Definition Language (DDL), Data Manipulation Language (DML) e Data Query Language (DQL) em tabelas do S3 usando o Athena. Consulte mais informações sobre como consultar tabelas em um bucket de tabela em Registrar catálogos de buckets de tabela do S3 no Guia do usuário do Amazon Athena.

Também é possível executar consultas no Athena pelo console do Amazon S3.

Usar o console do S3 e o Amazon Athena

O procedimento a seguir usa o console do Amazon S3 para acessar o editor de consultas do Athena e possibilitar que você consulte uma tabela com o Amazon Athena.

nota

Antes de realizar as etapas a seguir, integre os buckets de tabela aos serviços de analytics da AWS nessa região. Para ter mais informações, consulte Usar tabelas do Amazon S3 com serviços de analytics da AWS.

Como consultar uma tabela

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 tabela.

3. Na página Buckets de tabela, escolha o bucket que contém a tabela que você deseja consultar.

4. Na página de detalhes do bucket, escolha o botão de opção ao lado do nome da tabela que você deseja consultar.

5. Escolha Consultar tabela com o Athena.

6. O console do Amazon Athena é aberto e o editor de consultas do Athena aparece com uma amostra de consulta SELECT carregada para você. Modifique essa consulta conforme necessário para seu caso de uso.

   No editor de consultas, o campo Catálogo deve ser preenchido com s3tablescatalog/ seguido do nome do bucket de tabela; por exemplo, s3tablescatalog/amzn-s3-demo-bucket. O campo Banco de dados deve ser preenchido com o namespace em que a tabela está armazenada.

   nota

   Caso não veja esses valores nos campos Catálogo e Banco de dados, verifique se você integrou os buckets de tabela aos serviços de analytics da AWS nessa região. Para ter mais informações, consulte Usar tabelas do Amazon S3 com serviços de analytics da AWS.

7. Para executar a consulta, escolha Run (Executar).

   nota

   • Se você receber o erro “Insufficient permissions to execute the query. Principal does not have any privilege on specified resource” ao tentar executar uma consulta no Athena, você deverá receber as permissões necessárias do Lake Formation na tabela. Para ter mais informações, consulte Conceder permissão em uma tabela ou um banco de dados.

   • Se você receber o erro “Iceberg cannot access the requested resource” ao tentar executar a consulta, acesse o console do AWS Lake Formation e verifique se você se autoconcedeu permissões no catálogo do bucket de tabela e no banco de dados (namespace) que criou. Não especifique uma tabela ao conceder essas permissões. Para ter mais informações, consulte Conceder permissão em uma tabela ou um banco de dados.

Usar o console do S3 e o Amazon Athena

O procedimento a seguir usa o console do Amazon S3 para acessar o editor de consultas do Athena e possibilitar que você consulte uma tabela com o Amazon Athena.

nota

Antes de realizar as etapas a seguir, integre os buckets de tabela aos serviços de analytics da AWS nessa região. Para ter mais informações, consulte Usar tabelas do Amazon S3 com serviços de analytics da AWS.

Como consultar uma tabela

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 tabela.

3. Na página Buckets de tabela, escolha o bucket que contém a tabela que você deseja consultar.

4. Na página de detalhes do bucket, escolha o botão de opção ao lado do nome da tabela que você deseja consultar.

5. Escolha Consultar tabela com o Athena.

6. O console do Amazon Athena é aberto e o editor de consultas do Athena aparece com uma amostra de consulta SELECT carregada para você. Modifique essa consulta conforme necessário para seu caso de uso.

   No editor de consultas, o campo Catálogo deve ser preenchido com s3tablescatalog/ seguido do nome do bucket de tabela; por exemplo, s3tablescatalog/amzn-s3-demo-bucket. O campo Banco de dados deve ser preenchido com o namespace em que a tabela está armazenada.

   nota

   Caso não veja esses valores nos campos Catálogo e Banco de dados, verifique se você integrou os buckets de tabela aos serviços de analytics da AWS nessa região. Para ter mais informações, consulte Usar tabelas do Amazon S3 com serviços de analytics da AWS.

7. Para executar a consulta, escolha Run (Executar).

   nota

   • Se você receber o erro “Insufficient permissions to execute the query. Principal does not have any privilege on specified resource” ao tentar executar uma consulta no Athena, você deverá receber as permissões necessárias do Lake Formation na tabela. Para ter mais informações, consulte Conceder permissão em uma tabela ou um banco de dados.

   • Se você receber o erro “Iceberg cannot access the requested resource” ao tentar executar a consulta, acesse o console do AWS Lake Formation e verifique se você se autoconcedeu permissões no catálogo do bucket de tabela e no banco de dados (namespace) que criou. Não especifique uma tabela ao conceder essas permissões. Para ter mais informações, consulte Conceder permissão em uma tabela ou um banco de dados.