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

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

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

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](https://www.iodbc.org/dataspace/doc/iodbc/wiki/iodbcWiki/WelcomeVisitors).

## Instalación del conector de datos ODBC en macOS
<a name="odbc-v2-driver-getting-started-macos-installing-the-odbc-data-connector-on-macos"></a>

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

1. Haga doble clic en el archivo `.pkg`.

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

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

1. Elija **Instalar**.

1. Cuando finalice la instalación, elija **Finalizar**.

1. 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
<a name="odbc-v2-driver-getting-started-macos-configuring-a-data-source-name-on-macos"></a>

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
     ```

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

1. 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://amzn-s3-demo-bucket/
   ```

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

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