# Introducción al controlador ODBC 2.x
Utilice la información de esta sección para empezar a usar el controlador ODBC 2.x de Amazon Athena. El controlador es compatible con los sistemas operativos de Windows, Linux y macOS.
**Topics**
+ [Windows](odbc-v2-driver-getting-started-windows.md)
+ [Linux](odbc-v2-driver-getting-started-linux.md)
+ [macOS](odbc-v2-driver-getting-started-macos.md)
# Windows
Si desea utilizar un equipo cliente con Windows para acceder a Amazon Athena, necesitará el controlador ODBC de Amazon Athena.
## Requisitos del sistema Windows
Instale el controlador ODBC de Amazon Athena en los equipos cliente que accederán directamente a las bases de datos de Amazon Athena en lugar de utilizar un navegador web.
El sistema Windows utilizado debe cumplir con los siguientes requisitos:
+ Tener derechos de administrador disponibles.
+ Uno de los sistemas operativos siguientes:
+ Windows 11, 10 u 8.1
+ Windows Server 2019, 2016 o 2012
+ Arquitectura de procesador compatible: x86\$164 (64 bits)
+ Contar con al menos 100 MB de espacio disponible en el disco.
+ Tener [Microsoft Visual C\$1\$1 Redistributable for Visual Studio](https://visualstudio.microsoft.com/downloads/#microsoft-visual-c-redistributable-for-visual-studio-2022) para Windows de 64 bits instalado.
## Instalación del controlador ODBC de Amazon Athena
**Para descargar e instalar el controlador ODBC de Amazon Athena para Windows**
1. [Descargue](odbc-v2-driver.md#odbc-v2-driver-download) el archivo de instalación `AmazonAthenaODBC-2.x.x.x.msi`.
1. Inicie el archivo de instalación y, a continuación, seleccione **Siguiente**.
1. Para aceptar los términos del contrato de licencia, seleccione la casilla de verificación y, a continuación, elija **Siguiente**.
1. Para cambiar la ubicación de instalación, seleccione **Examinar**, busque la carpeta deseada y luego elija **Aceptar**.
1. Para aceptar la ubicación de instalación, seleccione **Siguiente**.
1. Elija **Instalar**.
1. Cuando finalice la instalación, elija **Finalizar**.
## Formas de configurar las opciones de ajuste del controlador
Para controlar el comportamiento del controlador ODBC de Amazon Athena en Windows, puede configurar las opciones de ajuste del controlador de las siguientes maneras:
+ En el programa **Administrador de orígenes de datos ODBC**, al configurar un nombre de origen de datos (DSN).
+ Al agregar o cambiar las claves de registro de Windows en la siguiente ubicación:
```
HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\YOUR_DSN_NAME
```
+ Al configurar las opciones del controlador en la cadena de conexión cuando se conecta mediante programación.
## Configuración del nombre de origen de datos en Windows
Después de descargar e instalar el controlador ODBC, debe agregar una entrada de nombre de origen de datos (DSN) al equipo cliente o a la instancia de Amazon EC2. Las herramientas de cliente SQL utilizan este origen de datos para conectarse a Amazon Athena y hacer consultas.
**Pasos para crear una entrada de sistema DSN**
1. En el menú **Inicio** de Windows, haga clic con el botón derecho en **Orígenes de datos ODBC (64 bits)** y, a continuación, seleccione **Más**, **Ejecutar como administrador**.
1. En el **Administrador de orígenes de datos ODBC**, elija la pestaña **Controladores**.
1. En la columna **Nombre**, compruebe que **Amazon Athena ODBC (x64)** esté presente.
1. Realice una de las siguientes acciones:
+ A fin de configurar el controlador para todos los usuarios del equipo, seleccione la pestaña **DSN del sistema**. Como es posible que las aplicaciones que utilizan una cuenta diferente para cargar datos no puedan detectar los DSN de usuario de otra cuenta, se recomienda la opción de configuración de DSN del sistema.
**nota**
El uso de la opción **DSN del sistema** requiere privilegios administrativos.
+ A fin de configurar el controlador únicamente para su cuenta de usuario, seleccione la pestaña **DSN de usuario**.
1. Elija **Add** (Agregar). Se abrirá el cuadro de diálogo **Crear nuevo origen de datos**.
1. Elija **Amazon Athena ODBC (x64)** y, a continuación, elija **Finalizar**.
1. En el cuadro de diálogo **Configuración de ODBC de Amazon Athena**, introduzca la siguiente información. Para obtener información detallada sobre estas opciones, consulte [Parámetros de conexión ODBC 2.x principales](odbc-v2-driver-main-connection-parameters.md).
+ En **Nombre de origen de datos**, introduzca un nombre que desee utilizar para identificar el origen de datos.
+ En **Descripción**, escriba una descripción que lo ayude a identificar el origen de datos.
+ En **Región**, escriba el nombre de la Región de AWS en la que usará Athena (por ejemplo, ** us-west-1**).
+ En **Catálogo**, escriba el nombre del catálogo de Amazon Athena. El valor predeterminado es **AwsDataCatalog**, que es el que AWS Glue utiliza.
+ En **Base de datos**, introduzca el nombre de la base de datos de Amazon Athena. El valor predeterminado es **predeterminada**.
+ En **Grupo de trabajo**, introduzca el nombre del grupo de trabajo de Amazon Athena. El valor predeterminado es **primario**.
+ En la **ubicación de salida de S3**, ingrese la ubicación en Amazon S3 donde se almacenarán los resultados de la consulta (por ejemplo, **s3://amzn-s3-demo-bucket/**).
+ (Opcional) En **Opciones de cifrado**, elija una opción de cifrado. El valor predeterminado es `NOT_SET`.
+ (Opcional) En **Clave de KMS**, elija una clave de KMS de cifrado si es necesaria.
1. A fin de especificar las opciones de configuración para la autenticación de IAM, elija **Opciones de autenticación**.
1. Introduzca la información siguiente:
+ En **Tipo de autenticación**, elija **Credenciales de IAM.** Esta es la opción predeterminada. Para obtener más información acerca de los tipos de autenticación disponibles, consulte [Opciones de autenticación](odbc-v2-driver-authentication-options.md).
+ En **Nombre de usuario**, introduzca un nombre de usuario.
+ En **Contraseña**, introduzca una contraseña.
+ En **Token de sesión**, introduzca un token de sesión si desea usar credenciales de AWS temporales. Para obtener información acerca de las credenciales temporales, consulte [Uso de credenciales temporales con recursos de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) en la *Guía del usuario de IAM*.
1. Seleccione **Aceptar**.
1. En la parte inferior del cuadro de diálogo **Configuración de ODBC de Amazon Athena**, elija **Prueba**. Si el equipo cliente se conecta correctamente a Amazon Athena, el cuadro **Prueba de conexión** indica **Conexión correcta**. De lo contrario, el cuadro indica **Error de conexión** con la información de error correspondiente.
1. Para cerrar la prueba de conexión, elija **Aceptar**. El origen de datos que ha creado ahora aparece en la lista de nombres de orígenes de datos.
## Uso de una conexión sin DSN en Windows
Puede usar una conexión sin DSN para conectarse a una base de datos sin un nombre de origen de datos (DSN). En el siguiente ejemplo, se muestra una cadena de conexión para el controlador ODBC (x64) de Amazon Athena que se conecta a 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;
```
# Linux
Si desea utilizar un equipo cliente con Linux para acceder a Amazon Athena, necesitará el controlador ODBC de Amazon Athena.
## Requisitos del sistema Linux
Cada equipo cliente con Linux en el que instala el controlador debe cumplir con los siguientes requisitos:
+ Tiene acceso raíz.
+ Utilice una de las siguientes distribuciones de Linux:
+ Red Hat Enterprise Linux (RHEL) 7 u 8
+ CentOS 7 u 8.
+ Tenga 100 MB de espacio disponible en el disco.
+ Utilice la versión 2.3.1 o posterior de [unixODBC](https://www.unixodbc.org/).
+ Utilice la versión 2.26 o posterior de la [Biblioteca C de GNU](https://www.gnu.org/software/libc/) (glibc).
## Instalación del conector de datos ODBC en Linux
Utilice el siguiente procedimiento para instalar el controlador ODBC de Amazon Athena en un sistema operativo Linux.
**Para instalar del controlador ODBC de Amazon Athena en Linux**
1. Especifique uno de los siguientes comandos:
```
sudo rpm -Uvh AmazonAthenaODBC-2.X.Y.Z.rpm
```
o
```
sudo yum --nogpgcheck localinstall AmazonAthenaODBC-2.X.Y.Z.rpm
```
1. Una vez finalizada la instalación, introduzca uno de los siguientes comandos para comprobar que el controlador esté instalado:
+
```
yum list | grep amazon-athena-odbc-driver
```
Salida:
```
amazon-athena-odbc-driver.x86_64 2.0.2.1-1.amzn2int installed
```
+
```
rpm -qa | grep amazon
```
Salida:
```
amazon-athena-odbc-driver-2.0.2.1-1.amzn2int.x86_64
```
## Configuración del nombre de origen de datos en Linux
Una vez instalado el controlador, encontrará los archivos de ejemplo `.odbc.ini` y `.odbcinst.ini` en la siguiente ubicación:
+ `/opt/athena/odbc/ini/`.
Utilice los archivos `.ini` en 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 unixODBC, realice los siguientes pasos.
**Para especificar las ubicaciones de los archivos `.ini` ODBC mediante unixODBC**
1. Configure `ODBCINI` en la ruta completa y el nombre del archivo `odbc.ini`, como en el siguiente ejemplo:
```
export ODBCINI=/opt/athena/odbc/ini/odbc.ini
```
1. Configure `ODBCSYSINI` en la ruta completa del directorio que contiene el archivo `odbcinst.ini`, como en el siguiente ejemplo:
```
export ODBCSYSINI=/opt/athena/odbc/ini
```
1. Introduzca el siguiente comando para comprobar que está utilizando el administrador de controladores unixODBC y los archivos `odbc*.ini` correctos:
```
username % odbcinst -j
```
Resultados de ejemplo
```
unixODBC 2.3.1
DRIVERS............: /opt/athena/odbc/ini/odbcinst.ini
SYSTEM DATA SOURCES: /opt/athena/odbc/ini/odbc.ini
FILE DATA SOURCES..: /opt/athena/odbc/ini/ODBCDataSources
USER DATA SOURCES..: /opt/athena/odbc/ini/odbc.ini
SQLULEN Size.......: 8
SQLLEN Size........: 8
SQLSETPOSIROW Size.: 8
```
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 # To enable ODBC driver logs, set this to 1.
UseAwsLogger=0 # To enable AWS-SDK logs, set this to 1.
LogPath=/opt/athena/odbc/logs/ # Path to store the log files. Permissions to the location are required.
[athena_odbc_test]
Driver=/opt/athena/odbc/lib/libathena-odbc.so
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)]
Driver=/opt/athena/odbc/lib/libathena-odbc.so
Setup=/opt/athena/odbc/lib/libathena-odbc.so
```
1. Después de instalar y configurar el controlador ODBC de Amazon Athena, utilice la herramienta de línea de comandos `isql` de unixODBC para comprobar la conexión, como se muestra en el siguiente ejemplo.
```
username % isql -v "athena_odbc_test"
+---------------------------------------+
| Connected! |
| |
| sql-statement |
| help [tablename] |
| quit |
| |
+---------------------------------------+
SQL>
```
## Verificar la firma del controlador ODBC
**importante**
Recomendamos que se verifique la firma RPM del controlador ODBC de Athena antes de instalarlo en la máquina.
Siga estos pasos para verificar la firma del paquete RPM del controlador ODBC de Athena:
1. **Prepare las plantillas**
Prepare los comandos con la clave pública adecuada, la firma del RPM y el enlace de acceso correspondiente a los scripts RPM alojados en buckets de Amazon S3. Se debe descargar lo siguiente en el dispositivo.
+ [Controlador ODBC de Athena](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/AmazonAthenaODBC-2.1.0.0.rpm)
+ [Clave pública](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/public_key.pem)
+ [Firma del RPM del ODBC de Athena](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/signature.bin)
1. Descargue el controlador ODBC de Athena, la clave pública y la firma del RPM del ODBC de Athena en el dispositivo.
1. Ejecute el siguiente comando para verificar la firma del controlador ODBC:
```
openssl dgst -sha256 -verify public_key.pem -signature signature.bin AmazonAthenaODBC-2.1.0.0.rpm
```
Si se aprueba la verificación, aparecerá un mensaje similar al `Verified OK`. Esto significa que ahora se puede instalar el controlador ODBC de Athena.
Si falla con un mensaje de `Verification Failure`, significa que la firma en el RPM ha sido manipulada. Debe asegurarse de que los tres archivos mencionados en el paso 1 estén presentes, que las rutas estén correctamente especificadas y que los archivos no se hayan modificado desde la descarga y, a continuación, vuelva a intentar el proceso de verificación.
# 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](https://www.iodbc.org/dataspace/doc/iodbc/wiki/iodbcWiki/WelcomeVisitors).
## 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`.
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
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>
```