Windows

Se quiser usar um computador cliente com Windows para acessar o Amazon Athena, é necessário ter o driver ODBC do Amazon Athena.

Requisitos do sistema Windows

Instale o driver ODBC do Amazon Athena em computadores clientes que acessarão os bancos de dados do Amazon Athena diretamente em vez de usar um navegador da Web.

O sistema Windows que você usa deve atender aos seguintes requisitos:

• Você tem direitos de administrador

• Um dos seguintes sistemas operacionais:

  • Windows 11, 10 ou 8.1

  • Windows Server 2019, 2016 ou 2012

• Pelo menos 100 MB de espaço em disco disponível

• O Microsoft Visual C++ redistribuível para Visual Studio para Windows de 64 bits está instalado.

Instalar o driver ODBC do Amazon Athena

Para baixar e instalar o driver ODBC do Amazon Athena para Windows

1. Baixe o arquivo de instalação AmazonAthenaODBC-2.x.x.x.msi.

2. Inicie o arquivo de instalação e escolha Próximo.

3. Para aceitar os termos do contrato de licença, marque a caixa de seleção e escolha Próximo.

4. Para alterar o local da instalação, escolha Procurar, navegue até a pasta desejada e escolha OK.

5. Para aceitar o local da instalação, escolha Próximo.

6. Escolha Instalar.

7. Quando a instalação terminar, escolha Concluir.

Modos de definir as opções de configuração do driver

Para controlar o comportamento do driver ODBC do Amazon Athena no Windows, é possível definir as opções de configuração do driver destes modos:

• No programa Administrador de Fonte de Dados ODBC, ao configurar um nome de fonte de dados (DSN).

• Adicionando ou alterando as chaves de registro do Windows no seguinte local:

  HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\YOUR_DSN_NAME

• Definindo as opções do driver na string de conexão quando você se conecta de maneira programática.

Configurar um nome de fonte de dados no Windows

Depois de baixar e instalar o driver ODBC, é necessário adicionar uma entrada de nome de fonte de dados (DSN) ao computador cliente ou instância do Amazon EC2. As ferramentas de cliente SQL usam essa fonte de dados para se conectar ao banco de dados do Amazon Athena.

Para criar uma entrada de DSN do sistema

1. No menu Iniciar do Windows, clique com o botão direito do mouse em Fontes de dados ODBC (64 bits) e escolha Mais, Executar como administrador.

2. No Administrador de fonte de dados ODBC, escolha a guia Drivers.

3. Na coluna Nome, verifique se o ODBC do Amazon Athena (x64) está presente.

4. Execute um destes procedimentos:

   • Para configurar o driver para todos os usuários do computador, escolha a guia DSN do sistema. Como as aplicações que usam uma conta diferente para carregar dados podem não conseguir detectar DSNs de usuários de outra conta, é recomendável usar a opção de configuração de DSN do sistema.

     nota

     Usar a opção DSN do sistema requer privilégios administrativos.

   • Para configurar o driver somente para sua conta de usuário, escolha a guia DSN do usuário.

5. Escolha Adicionar. A caixa de diálogo Criar nova fonte de dados é exibida.

6. Escolha o ODBC do Amazon Athena (x64) e depois Concluir.

7. Na caixa de diálogo Configuração do ODBC do Amazon Athena, insira as informações a seguir. Para obter informações detalhadas sobre essas opções, consulte Principais parâmetros de conexão do ODBC 2.x.

   • Em Nome da fonte de dados, insira o nome que você deseja usar para identificar a fonte de dados.

   • Em Descrição, insira uma descrição que ajude a identificar a fonte de dados.

   • Em Região, insira o nome da Região da AWS em que você usará o Athena (por exemplo,  us-west-1).

   • Em Catálogo, insira o nome do catálogo do Amazon Athena. O padrão é AWSDataCatalog, que é usado pelo AWS Glue.

   • Em Banco de dados, insira o nome do banco de dados do Amazon Athena. O padrão é padrão.

   • Em Grupo de trabalho, insira o nome do grupo de trabalho do Amazon Athena. O padrão é primário.

   • Em Local de saída do S3, insira o local do Amazon S3 em que os resultados da consulta serão armazenados (por exemplo, s3://DOC-EXAMPLE-BUCKET/).

   • (Opcional) Em Opções de criptografia, escolha uma opção de criptografia. O padrão é NOT_SET.

   • (Opcional) Em Chave do KMS, escolha uma chave de criptografia do KMS, se necessário.

8. Para especificar as opções de configuração para autenticação do IAM, escolha Opções de autenticação.

9. Insira as seguintes informações:

   • Em Tipo de autenticação, escolha Credenciais do IAM. Esse é o padrão. Para obter mais informações sobre os tipos de autenticação disponíveis, consulte Opções de autenticação.

   • Em Nome de usuário, insira um nome de usuário.

   • Em Senha, insira uma senha.

   • Em Token de sessão, insira um token de sessão se quiser usar credenciais temporárias da AWS. Para obter informações sobre credenciais temporárias, consulte Uso de credenciais temporárias com recursos da AWS no Guia do usuário do IAM.

10. Escolha OK.

11. Na parte inferior da caixa de diálogo Configuração do ODBC do Amazon Athena, escolha Testar. Se o computador cliente se conectar com êxito ao Amazon Athena, a caixa Teste de conexão informará Conexão com êxito. Caso contrário, a caixa informará Falha na conexão com as informações de erro correspondentes.

12. Escolha OK para fechar o teste de conexão. A fonte de dados que você criou já aparece na lista de nomes de fontes de dados.

Usar uma conexão sem DSN no Windows

É possível usar uma conexão sem DSN para se conectar a um banco de dados sem um nome de fonte de dados (DSN). O exemplo a seguir mostra uma string de conexão para o driver ODBC do Amazon Athena (x64) que se conecta ao Amazon Athena.

DRIVER={Amazon Athena ODBC (x64)};Catalog=AwsDataCatalog;AwsRegion=us-west-1;Schema=test_schema;S3OutputLocation=
s3://DOC-EXAMPLE-BUCKET/;AuthenticationType=IAM Credentials;UID=YOUR_UID;PWD=YOUR_PWD;