macOS

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

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.

Como instalar o conector de dados ODBC no macOS

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.

2. Clique duas vezes no arquivo .pkg.

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

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

5. Escolha Instalar.

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

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

   > pkgutil --pkgs | grep athenaodbc

   Dependendo do seu sistema, a saída poderá ser semelhante à uma das seguintes opções.

   com.amazon.athenaodbc-x86_64.Config
   com.amazon.athenaodbc-x86_64.Driver

   ou

   com.amazon.athenaodbc-arm64.Config
   com.amazon.athenaodbc-arm64.Driver

Configurar um nome de fonte de dados no macOS

Após a instalação do driver, você poderá encontrar exemplos de arquivos .odbc.ini e .odbcinst.ini nos seguintes locais:

• Computadores com processador Intel: /opt/athena/odbc/x86_64/ini/

• Computadores com processador ARM: /opt/athena/odbc/arm64/ini/

Use os arquivos .ini nesse local como exemplos para configurar o driver ODBC e o nome da fonte de dados (DSN) do Amazon Athena.

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 para o caminho completo e o nome de arquivo do arquivo odbc.ini.

   • Para computadores macOS com processadores Intel, aplique a sintaxe a seguir.

     export ODBCINI=/opt/athena/odbc/x86_64/ini/odbc.ini

   • Para computadores macOS com processadores ARM, aplique a sintaxe a seguir.

     export ODBCINI=/opt/athena/odbc/arm64/ini/odbc.ini

2. Defina ODBCSYSINI para o caminho completo e o nome de arquivo do arquivo odbcinst.ini.

   • Para computadores macOS com processadores Intel, aplique a sintaxe a seguir.

     export ODBCSYSINI=/opt/athena/odbc/x86_64/ini/odbcinst.ini

   • Para computadores macOS com processadores ARM, aplique a sintaxe a seguir.

     export ODBCSYSINI=/opt/athena/odbc/arm64/ini/odbcinst.ini

3. 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/athena/odbc/logs/ # Path to store the log files. Permissions to the location are required. 
   
   [athena_odbc_test]
   Description=Amazon Athena ODBC (x64)
   # For ARM:
   Driver=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib
   # For Intel:
   # Driver=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib
   AwsRegion=us-west-1
   Workgroup=primary
   Catalog=AwsDataCatalog
   Schema=default
   AuthenticationType=IAM Credentials
   UID=
   PWD=
   S3OutputLocation=s3://amzn-s3-demo-bucket/

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

   [ODBC Drivers]
   Amazon Athena ODBC (x64)=Installed 
   
   [Amazon Athena ODBC (x64)]
   # For ARM:
   Driver=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib
   Setup=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib
   # For Intel:
   # Driver=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib
   # Setup=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib

5. 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.0.2.1 (Amazon Athena ODBC Driver) 
   
   SQL>