Instalación y configuración del controlador ODBC de Amazon Redshift en Linux

Requisitos del sistema

Debe instalar el controlador ODBC de Amazon Redshift en los equipos cliente que tienen acceso a un almacenamiento de datos de Amazon Redshift. Cada equipo en el que instala el controlador debe cumplir con los siguientes requisitos mínimos:

• Acceso raíz en la máquina.

• Una de las siguientes distribuciones:

  • Red Hat® Enterprise Linux® (RHEL) 8 o versiones posteriores

  • CentOS 8 o versiones posteriores.

• 150 MB de espacio disponible en el disco.

• unixODBC 2.2.14 o posterior.

• glibc 2.26 o posterior.

Instalación del controlador ODBC de Amazon Redshift

Para descargar e instalar el controlador ODBC versión 2.x de Amazon Redshift para Linux:

1. Descargue el siguiente controlador: controlador RPM de 64 bits versión 2.1.3.0

   nota

   Los controladores ODBC de 32 bits se suspenden. No se publicarán más actualizaciones, excepto las revisiones de seguridad urgentes.

2. Vaya a la ubicación en la que descargó el paquete y, a continuación, ejecute alguno de los siguientes comandos. Utilice el comando que corresponda a su distribución Linux.

   En los sistemas operativos RHEL y CentOS, ejecute el siguiente comando:

   yum --nogpgcheck localinstall RPMFileName

   Reemplace RPMFileName por el nombre de archivo del paquete RPM. Por ejemplo, el siguiente comando demuestra cómo instalar el controlador de 64 bits:

   
   yum --nogpgcheck localinstall AmazonRedshiftODBC-64-bit-2.x.xx.xxxx.x86_64.rpm
                       

Uso de un administrador de controladores ODBC para configurar el controlador ODBC en Linux

En Linux, debe utilizar un administrador de controlador ODBC para configurar la conexión ODBC. Los administradores del controlador ODBC usan archivos de configuración para definir y configurar los controladores y el origen de datos de ODBC. El administrador del controlador ODBC que utiliza depende del sistema operativo que utiliza.

Configuración del controlador ODBC mediante el administrador de controladores UnixODBC

Para configurar el controlador ODBC de Amazon Redshift, se requieren los siguientes archivos:

• amazon.redshiftodbc.ini

• odbc.ini

• odbcinst.ini

Si instaló el controlador en la ubicación predeterminada, el archivo de configuración amazon.redshiftodbc.ini se encuentra en /opt/amazon/redshiftodbcx64.

Además, en /opt/amazon/redshiftodbcx64, puede encontrar archivos odbc.ini y odbcinst.ini de muestra. Puede utilizar estos archivos como ejemplos para configurar el controlador ODBC de Amazon Redshift y el nombre del origen de datos (DSN).

No le recomendamos utilizar el directorio de instalación del controlador ODBC de Amazon Redshift para los archivos de configuración. Los archivos de muestra del directorio instalados se presentan únicamente como ejemplo. Si vuelve a instalar el controlador ODBC de Amazon Redshift más adelante o actualiza a una versión más reciente, se sobrescribe el directorio de instalación. Perderá los cambios que haya realizado en los archivos del directorio de instalación.

Para evitarlo, copie el archivo amazon.redshiftodbc.ini en un directorio distinto al directorio de instalación. Si copia este archivo en el directorio principal del usuario, agregue un punto (.) al principio del nombre del archivo para convertirlo en un archivo oculto.

Para los archivos odbc.ini y odbcinst.ini, utilice los archivos de configuración en el directorio principal del usuario o cree nuevas versiones en otro directorio. De manera predeterminada, su sistema operativo Linux debe tener un archivo odbc.ini y un archivo odbcinst.ini en el directorio de inicio del usuario (/home/$USER o ~/.). Estos archivos predeterminados son archivos ocultos, que se indica con el punto (.) delante de cada nombre de archivo. Estos archivos solo se muestran cuando se utiliza el indicador -a para enumerar el contenido del directorio.

Cualquiera que sea la opción que elija para los archivos odbc.ini y odbcinst.ini, modifique los archivos para agregar información de configuración del controlador y DSN. Si selecciona crear archivos nuevos, también deberá configurar variables de entorno para especificar la ubicación de estos archivos de configuración.

De manera predeterminada, los administradores de controladores ODBC están configurados para utilizar versiones ocultas de los archivos de configuración odbc.ini y odbcinst.ini (denominados .odbc.ini y .odbcinst.ini) ubicados en el directorio de inicio. También están configurados para utilizar el archivo amazon.redshiftodbc.ini en el directorio de instalación del controlador. Si almacena estos archivos de configuración en otro lugar, establezca las variables de entorno que se describen a continuación para que el administrador de controladores pueda localizar los archivos.

Si utiliza UnixODBC, haga lo siguiente:

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

• Configure ODBCSYSINI en la ruta completa del directorio que contiene el archivo odbcinst.ini.

• Configure AMAZONREDSHIFTODBCINI en la ruta completa y el nombre del archivo amazon.redshiftodbc.ini.

A continuación, se muestra un ejemplo de cómo configurar los valores anteriores:

export ODBCINI=/usr/local/odbc/odbc.ini 
export ODBCSYSINI=/usr/local/odbc 
export AMAZONREDSHIFTODBCINI=/etc/amazon.redshiftodbc.ini 

Configuración de una conexión mediante un nombre de origen de datos (DSN) en Linux

Cuando se conecte al almacenamiento de datos mediante un nombre de origen de datos (DSN), 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.

En los sistemas operativos Linux, utilice el siguiente formato:

[ODBC Data Sources]
driver_name=dsn_name

[dsn_name]
Driver=path/driver_file
Host=cluster_endpoint
Port=port_number
Database=database_name
locale=locale
                

En el siguiente ejemplo, se muestra la configuración del archivo odbc.ini con el controlador ODBC de 64 bits para sistemas operativos Linux.

[ODBC Data Sources]
Amazon_Redshift_x64=Amazon Redshift ODBC Driver (x64)

[Amazon_Redshift_x64]
Driver=/opt/amazon/redshiftodbcx64/librsodbc64.so
Host=examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com
Port=5932Database=dev
locale=en-US                    
                

Configuración de una conexión sin un DSN en Linux

Para conectarse al almacén de datos a través de una conexión que no tenga DSN, defina el controlador en el archivo odbcinst.ini. A continuación, proporcione una cadena de conexión sin DSN en su aplicación.

En los sistemas operativos Linux, utilice el siguiente formato:

[ODBC Drivers]
driver_name=Installed
...
                            
[driver_name]
Description=driver_description
Driver=path/driver_file
    
...                    
                

En el siguiente ejemplo, se muestra la configuración del archivo odbcinst.ini con el controlador ODBC de 64 bits para sistemas operativos Linux.

[ODBC Drivers]
Amazon Redshift ODBC Driver (x64)=Installed

[Amazon Redshift ODBC Driver (x64)]
Description=Amazon Redshift ODBC Driver (64-bit)
Driver=/opt/amazon/redshiftodbcx64/librsodbc64.so