

# Windows
<a name="odbc-v2-driver-getting-started-windows"></a>

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
<a name="odbc-v2-driver-system-requirements-windows"></a>

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
  + Arquitetura de processador compatível: x86\$164 (64 bits)
+ Pelo menos 100 MB de espaço em disco disponível
+ O [Microsoft Visual C\$1\$1 redistribuível para Visual Studio](https://visualstudio.microsoft.com/downloads/#microsoft-visual-c-redistributable-for-visual-studio-2022) para Windows de 64 bits está instalado.

## Instalar o driver ODBC do Amazon Athena
<a name="odbc-v2-driver-installing"></a>

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

1. [Baixe](odbc-v2-driver.md#odbc-v2-driver-download) o arquivo de instalação `AmazonAthenaODBC-2.x.x.x.msi`.

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

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

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

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

1. Escolha **Instalar**.

1. Quando a instalação terminar, escolha **Concluir**.

## Modos de definir as opções de configuração do driver
<a name="odbc-v2-driver-ways-to-set-options"></a>

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
<a name="odbc-v2-driver-configuring-dsn-on-windows"></a>

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

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

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

1. 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**.

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

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

1. 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](odbc-v2-driver-main-connection-parameters.md).
   + 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://amzn-s3-demo-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.

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

1. 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](odbc-v2-driver-authentication-options.md).
   + 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) no *Guia do usuário do IAM*.

1. Escolha **OK**.

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

1. 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
<a name="odbc-v2-driver-dsn-less-connection"></a>

É 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://amzn-s3-demo-bucket/;AuthenticationType=IAM Credentials;UID=YOUR_UID;PWD=YOUR_PWD;
```