macOS - Amazon Athena
Requisitos del sistema macOSInstalación del conector de datos ODBC en macOSConfiguración del nombre de origen de datos en macOS

macOS

Si desea utilizar un equipo cliente con macOS para acceder a Amazon Athena, necesitará el controlador ODBC de Amazon Athena.

Requisitos del sistema macOS

Cada equipo con macOS en el que instala el controlador debe cumplir con los siguientes requisitos.

  • Versión 14 de macOS o posterior.

  • 100 MB de espacio disponible en el disco.

  • Versión 3.52.16 o posterior de iODBC.

Instalación del conector de datos ODBC en macOS

Utilice el siguiente procedimiento para descargar e instalar el controlador ODBC de Amazon Athena para los sistemas operativos macOS.

Cómo descargar e instalar el controlador ODBC de Amazon Athena para macOS

  1. Descargue el archivo de paquete .pkg.

  2. Haga doble clic en el archivo .pkg.

  3. Siga las instrucciones del asistente para instalar el controlador.

  4. En la página del Contrato de licencia, pulse Continuar y, a continuación, seleccione Acepto.

  5. Elija Instalar.

  6. Cuando finalice la instalación, elija Finalizar.

  7. Ejecute el siguiente comando para comprobar que se haya instalado el controlador:

    > pkgutil --pkgs | grep athenaodbc

    En función del sistema, es posible que el resultado tenga un aspecto similar al siguiente.

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

    o

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

Configuración del nombre de origen de datos en macOS

Una vez instalado el controlador, encontrará los archivos de ejemplo .odbc.ini y .odbcinst.ini en las siguientes ubicaciones:

  • Equipos con procesador Intel: /opt/athena/odbc/x86_64/ini/

  • Equipos con procesador ARM: /opt/athena/odbc/arm64/ini/

Utilice los archivos .ini de esta ubicación como ejemplos para configurar el controlador ODBC de Amazon Athena y el nombre de origen de datos (DSN).

nota

De manera predeterminada, los administradores de los controladores ODBC utilizan la versión oculta de los archivos de configuración .odbc.ini y .odbcinst.ini, que están ubicados en el directorio de inicio.

Para especificar la ruta a los archivos .odbc.ini y .odbcinst.ini mediante el administrador de controladores iODBC, realice los siguientes pasos.

Cómo especificar las ubicaciones de los archivos .ini de OBCD mediante el administrador de controladores iODBC

  1. Configure ODBCINI en la ruta completa y el nombre del archivo odbc.ini.

    • Para equipos con macOS que tienen procesadores Intel, utilice la siguiente sintaxis.

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

    • Para equipos con macOS que tienen procesadores ARM, utilice la siguiente sintaxis.

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

  2. Configure ODBCSYSINI en la ruta completa y el nombre del archivo odbcinst.ini.

    • Para equipos con macOS que tienen procesadores Intel, utilice la siguiente sintaxis.

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

    • Para equipos con macOS que tienen procesadores ARM, utilice la siguiente sintaxis.

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

  3. Si desea utilizar un nombre de origen de datos (DSN) para conectar su almacenamiento de datos, configure el archivo odbc.ini para definir los nombres de origen de datos (DSN). Establezca las propiedades del archivo odbc.ini para crear un DSN que especifique la información de conexión para el almacén de datos, como se observa en el siguiente ejemplo.

    [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://DOC-EXAMPLE-BUCKET/

  4. Configure el archivo odbcinst.ini, como en el siguiente ejemplo.

    [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. Después de instalar y configurar el controlador ODBC de Amazon Athena, utilice la herramienta de línea de comandos iodbctest para comprobar la conexión, como se muestra en el siguiente ejemplo.

    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>