Linux - Amazon Athena
Requisitos del sistema LinuxInstalación del conector de datos ODBC en LinuxConfiguración del nombre de origen de datos en LinuxVerificar la firma del controlador ODBC

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.

  • Utilice la versión 2.26 o posterior de la Biblioteca C de GNU (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

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

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

  3. Introduzca el siguiente comando para comprobar que está utilizando el administrador de controladores unixODBC y los archivos odbc*.ini correctos:

    username % odbcinst -j

    Resultado 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

  4. 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/

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

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

  2. Descargue el controlador ODBC de Athena, la clave pública y la firma del RPM del ODBC de Athena en el dispositivo.

  3. Ejecute el siguiente comando para verificar la firma del controlador ODBC:

    openssl dgst -sha256 -verify public_key.pem -signature signature.bin AmazonAthenaODBC-2.0.4.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.