# macOS
<a name="odbc-v2-driver-getting-started-macos"></a>

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

## Requisitos do sistema macOS
<a name="odbc-v2-driver-getting-started-macos-macos-system-requirements"></a>

Cada computador macOS no qual você instale o driver deve atender aos seguintes requisitos.
+ Usar o macOS versão 14 ou superior.
+ Ter 100 MB de espaço em disco disponível.
+ Usar a versão 3.52.16 ou superior do [iODBC](https://www.iodbc.org/dataspace/doc/iodbc/wiki/iodbcWiki/WelcomeVisitors).

## Como instalar o conector de dados ODBC no macOS
<a name="odbc-v2-driver-getting-started-macos-installing-the-odbc-data-connector-on-macos"></a>

Siga o procedimento abaixo para baixar e instalar o driver ODBC do Amazon Athena para sistemas operacionais macOS.

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

1. Baixe o arquivo de pacote `.pkg`.

1. Clique duas vezes no arquivo `.pkg`.

1. Siga as etapas no assistente para instalar o driver.

1. Na página **Contrato de licença**, pressione **Continuar** e escolha **Concordar**.

1. Escolha **Instalar**.

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

1. Insira o seguinte comando para verificar se o driver está instalado:

   ```
   > pkgutil --pkgs | grep athena.odbc
   ```

   Se o driver tiver sido instalado com êxito, o resultado será semelhante ao mostrado a seguir.

   ```
   com.amazon.athena.odbc.Runtime
   com.amazon.athena.odbc.Documentation
   ```

## Configurar um nome de fonte de dados no macOS
<a name="odbc-v2-driver-getting-started-macos-configuring-a-data-source-name-on-macos"></a>

Após a instalação do driver, você poderá encontrar exemplos de arquivos `odbc.ini.example` e `odbcinst.ini.example` no seguinte local:
+ `/opt/amazon/athena-odbc/share/athena-odbc/`

Copie o exemplo de arquivos para um diretório de configuração e remova a extensão `.example`. Use esses arquivos como ponto inicial para configurar o driver ODBC e o nome da fonte de dados (DSN) do Amazon Athena.

```
sudo mkdir -p /opt/amazon/athena-odbc/etc/athena-odbc
sudo cp /opt/amazon/athena-odbc/share/athena-odbc/odbc.ini.example /opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini
sudo cp /opt/amazon/athena-odbc/share/athena-odbc/odbcinst.ini.example /opt/amazon/athena-odbc/etc/athena-odbc/odbcinst.ini
```

**nota**  
Por padrão, os gerenciadores de driver ODBC usam os versões ocultas dos arquivos de configuração `.odbc.ini` e `.odbcinst.ini`, localizadas no diretório inicial.

Para especificar o caminho dos arquivos `odbc.ini` e `odbcinst.ini` usando o gerenciador de drivers iODBC, execute as etapas a seguir.

**Para especificar localizações de arquivos `.ini` do ODBC usando o gerenciador de drivers iODBC**

1. Defina `ODBCINI` com o caminho completo e o nome de arquivo do arquivo `odbc.ini`, como no exemplo a seguir.

   ```
   export ODBCINI=/opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini
   ```

1. Defina `ODBCSYSINI` com o caminho completo do diretório que contém o arquivo `odbcinst.ini`, como no exemplo a seguir.

   ```
   export ODBCSYSINI=/opt/amazon/athena-odbc/etc/athena-odbc
   ```

1. Se quiser usar um nome da fonte de dados (DSN) para estabelecer conexão com seu armazenamento de dados, configure o arquivo `odbc.ini` para definir nomes de fonte de dados (DSNs). Defina as propriedades no arquivo `odbc.ini` para criar um DSN que especifique as informações de conexão para seu armazenamento de dados, como no exemplo a seguir.

   ```
   [ODBC Data Sources]
   athena_odbc_test=Amazon Athena ODBC (x64)
   
   [ATHENA_WIDE_SETTINGS] # Special DSN-name to signal driver about logging configuration.
   LogLevel=0             # set to 1 to enable ODBC driver logs
   UseAwsLogger=0         # set to 1 to enable AWS-SDK logs
   LogPath=/opt/amazon/athena-odbc/logs/ # Path to store the log files. Permissions to the location are required.
   
   [athena_odbc_test]
   Description=Amazon Athena ODBC (x64)
   Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.dylib
   AwsRegion=us-west-1
   Workgroup=primary
   Catalog=AwsDataCatalog
   Schema=default
   AuthenticationType=IAM Credentials
   UID=
   PWD=
   S3OutputLocation=s3://amzn-s3-demo-bucket/
   ```

1. Configure o arquivo `odbcinst.ini`, como no exemplo a seguir.

   ```
   [ODBC Drivers]
   Amazon Athena ODBC (x64)=Installed
   
   [Amazon Athena ODBC (x64)]
   Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.dylib
   Setup=/opt/amazon/athena-odbc/lib/libathenaodbc.dylib
   ```

1. Após instalar e configurar o driver ODBC do Amazon Athena, use a ferramenta de linha de comando `iodbctest` para verificar a conexão, como no exemplo a seguir.

   ```
   {{username}}@ % iodbctest
   iODBC Demonstration program
   This program shows an interactive SQL processor
   Driver Manager: 03.52.1623.0502 
   
   Enter ODBC connect string (? shows list): ? 
   
   DSN                              | Driver
   ------------------------------------------------------------------------------
   athena_odbc_test                 | Amazon Athena ODBC (x64) 
   
   Enter ODBC connect string (? shows list): DSN=athena_odbc_test;
   Driver: 2.x.y.z (Amazon Athena ODBC Driver) 
   
   SQL>
   ```