Instalar e configurar o driver ODBC do Amazon Redshift no Linux

Requisitos do sistema

Você deve instalar o driver ODBC do Amazon Redshift em computadores clientes que tenham acesso um data warehouse do Amazon Redshift. Para cada computador onde o driver é instalado, os seguintes requisitos mínimos do sistema devem ser atendidos:

• Acesso root na máquina.

• Uma das distribuições seguintes:

  • Red Hat® Enterprise Linux® (RHEL) 8 ou posterior

  • CentOS 8 ou posterior

• 150 MB de espaço em disco disponível.

• unixODBC 2.2.14 ou posterior.

• glibc 2.26 ou posterior.

Instalar o driver ODBC do Amazon Redshift

Para baixar e instalar o driver ODBC do Amazon Redshift versão 2.x para Linux:

1. Baixe o seguinte driver: Driver RPM de 64 bits versão 2.1.3.0

   nota

   Os drivers ODBC de 32 bits foram descontinuados. Outras atualizações não serão lançadas, exceto para patches de segurança urgentes.

2. Navegue até o local onde você salvou o download do pacote e execute um dos comandos a seguir. Use o comando que corresponde a sua distribuição do Linux.

   Em sistemas operacionais RHEL e CentOS, execute o seguinte comando:

   yum --nogpgcheck localinstall RPMFileName

   Substitua RPMFileName pelo nome do arquivo de pacote do RPM. Por exemplo, o comando a seguir demonstra a instalação do driver de 64 bits:

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

Utilização de um gerenciador de driver ODBC para configurar o driver ODBC no Linux

No Linux, utilize o gerenciador de driver ODBC para configurar as definições de conexão ODBC. Os gerenciadores de driver ODBC usam arquivos de configuração para definir e configurar as fontes de dados e os drivers ODBC. O gerenciador de driver ODBC a ser usado dependerá do sistema operacional em uso.

Configuração do driver ODBC usando o gerenciador de driver unixODBC

Os arquivos a seguir são necessários para configurar o driver ODBC do Amazon Redshift:

• amazon.redshiftodbc.ini

• odbc.ini

• odbcinst.ini

Se você fez a instalação no local padrão, o arquivo de configuração do amazon.redshiftodbc.ini estará localizado em /opt/amazon/redshiftodbcx64.

Além disso, em /opt/amazon/redshiftodbcx64, é possível encontrar exemplos de arquivos odbc.ini e odbcinst.ini. Você pode usar esses arquivos como exemplos para configurar o driver ODBC do Amazon Redshift e o nome da origem dos dados (DSN).

Não é recomendado o uso do diretório de instalação do driver ODBC do Amazon Redshift para os arquivos de configuração. Os arquivos de exemplo do diretório instalado devem ser usados somente para servir de modelo. Se você reinstalar o driver ODBC do Amazon Redshift posteriormente ou atualizar para uma versão mais recente, o diretório de instalação será substituído. Você perderá todas as alterações feitas nos arquivos do diretório de instalação.

Para evitar isso, copie o arquivo amazon.redshiftodbc.ini para um diretório diferente do diretório de instalação. Se você copiar esse arquivo no diretório base do usuário, adicione um ponto (.) ao início do nome do arquivo para torná-lo um arquivo oculto.

Para os arquivos odbc.ini e odbcinst.ini, use os arquivos de configuração do diretório inicial do usuário ou crie versões em um outro diretório. Por padrão, os sistemas operacionais Linux devem ter um arquivo odbc.ini e um odbcinst.ini no diretório inicial do usuário (/home/$USER ou ~/.). Esses arquivos padrão são arquivos ocultos, o que é indicado pelo ponto (.) na frente do nome de cada arquivo. Esses arquivos são exibidos somente ao usar o sinalizador -a para listar o conteúdo do diretório.

Qualquer que seja a opção escolhida para os arquivos odbc.ini e odbcinst.ini, modifique os arquivos para adicionar as informações do driver e da configuração de DSN. Se você criar arquivos, também precisará definir as variáveis do ambiente para especificar onde esses arquivos de configuração estão localizados.

Por padrão, os gerenciadores de driver ODBC são configurados para usar versões ocultas dos arquivos de configuração odbc.ini e odbcinst.ini (chamados .odbc.ini e .odbcinst.ini) localizadas no diretório inicial. Eles também são configurados para usar o arquivo amazon.redshiftodbc.ini do diretório de instalação do driver. Se você armazenar esses arquivos de configuração em outro lugar, defina as variáveis de ambiente descritas a seguir para que o gerenciador de driver possa localizar os arquivos.

Se você estiver usando o unixODBC, faça o seguinte:

• Defina ODBCINI para o caminho completo e o nome de arquivo do arquivo odbc.ini.

• Defina ODBCSYSINI para o caminho completo do diretório que contém o arquivo odbcinst.ini.

• Defina AMAZONREDSHIFTODBCINI para o caminho completo e o nome de arquivo do arquivo amazon.redshiftodbc.ini.

Veja a seguir um exemplo de definição das variáveis acima:

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

Configuração de uma conexão usando um nome de fonte de dados (DSN) no Linux

Ao conectar-se ao datastore usando um nome da fonte de dados (DSN), configure o arquivo odbc.ini para definir nomes de fonte de dados (DSNs). Defina as propriedades no arquivo odbc.ini para criar um DSN que especifique as informações de conexão para o armazenamento de dados.

Use o seguinte formato nos sistemas operacionais Linux:

[ODBC Data Sources]
driver_name=dsn_name

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

O exemplo a seguir mostra a configuração do odbc.ini com driver ODBC de 64 bits em sistemas operacionais 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                    
                

Configurar uma conexão sem um DSN no Linux

Para se conectar ao armazenamento de dados por meio de uma conexão que não tenha um DSN, defina o driver no arquivo odbcinst.ini. Depois, forneça uma string de conexão sem DSN no aplicativo.

Use o seguinte formato nos sistemas operacionais Linux:

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

O exemplo a seguir mostra a configuração do odbcinst.ini com driver ODBC de 64 bits em sistemas operacionais 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