# Linux
Se quiser usar um computador cliente com Linux para acessar o Amazon Athena, é necessário ter o driver ODBC do Amazon Athena.
## Requisitos do sistema Linux
Cada computador cliente Linux no qual você instale o driver deve atender aos seguintes requisitos.
+ Ter acesso root.
+ Usar umas das seguintes distribuições do Linux:
+ Red Hat Enterprise Linux (RHEL) 7 ou 8
+ CentOS 7 ou 8.
+ Ter 100 MB de espaço em disco disponível.
+ Usar a versão 2.3.1 ou superior do [unixODBC](https://www.unixodbc.org/).
+ Usar a versão 2.26 ou posterior da [GNU C Library](https://www.gnu.org/software/libc/) (glibc).
## Como instalar o conector de dados ODBC no Linux
Siga o procedimento abaixo para instalar o driver ODBC do Amazon Athena em um sistema operacional Linux.
**Para instalar o driver ODBC do Amazon Athena no Linux**
1. Insira um dos seguintes comandos:
```
sudo rpm -Uvh AmazonAthenaODBC-2.X.Y.Z.rpm
```
ou
```
sudo yum --nogpgcheck localinstall AmazonAthenaODBC-2.X.Y.Z.rpm
```
1. Após a conclusão da instalação, insira um dos seguintes comandos para verificar se o driver está instalado:
+
```
yum list | grep amazon-athena-odbc-driver
```
Resultado:
```
amazon-athena-odbc-driver.x86_64 2.0.2.1-1.amzn2int installed
```
+
```
rpm -qa | grep amazon
```
Resultado:
```
amazon-athena-odbc-driver-2.0.2.1-1.amzn2int.x86_64
```
## Configurar um nome de fonte de dados no Linux
Após a instalação do driver, você poderá encontrar exemplos de arquivos `.odbc.ini` e `.odbcinst.ini` no seguinte local:
+ `/opt/athena/odbc/ini/`.
Use os arquivos `.ini` nesse local como exemplos para configurar o driver ODBC e o nome da fonte de dados (DSN) do Amazon Athena.
**nota**
Por padrão, os gerenciadores de driver ODBC usam os versões ocultas dos arquivos de configuração `.odbc.ini` e `.odbcinst.ini`, localizadas no diretório inicial.
Para especificar o caminho dos arquivos `.odbc.ini` e `.odbcinst.ini` usando o unixODBC, execute as etapas a seguir.
**Para especificar localizações de arquivos `.ini` do ODBC usando unixODBC**
1. Defina `ODBCINI` com o caminho completo e o nome de arquivo do arquivo `odbc.ini`, como no exemplo a seguir.
```
export ODBCINI=/opt/athena/odbc/ini/odbc.ini
```
1. Defina `ODBCSYSINI` com o caminho completo do diretório que contém o arquivo `odbcinst.ini`, como no exemplo a seguir.
```
export ODBCSYSINI=/opt/athena/odbc/ini
```
1. Digite o comando a seguir para verificar se você está usando o gerenciador de drivers UnixODBC e os arquivos `odbc*.ini` corretos:
```
username % odbcinst -j
```
Exemplo de resultado
```
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. Se quiser usar um nome da fonte de dados (DSN) para estabelecer conexão com seu armazenamento de dados, 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 seu armazenamento de dados, como no exemplo a seguir.
```
[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 o arquivo `odbcinst.ini`, como no exemplo a seguir.
```
[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. Após instalar e configurar o driver ODBC do Amazon Athena, use a ferramenta de linha de comando `isql` do unixODBC para verificar a conexão, como no exemplo a seguir.
```
username % isql -v "athena_odbc_test"
+---------------------------------------+
| Connected! |
| |
| sql-statement |
| help [tablename] |
| quit |
| |
+---------------------------------------+
SQL>
```
## Verificar a assinatura do driver ODBC
**Importante**
Recomendamos verificar a assinatura RPM do driver ODBC do Athena antes de instalá-la em sua máquina.
Siga estas etapas para verificar a assinatura do pacote RPM do driver ODBC do Athena:
1. **Prepare os modelos**
Prepare os comandos com a chave pública apropriada, a assinatura RPM e o link de acesso correspondente aos scripts RPM hospedados nos buckets do Amazon S3. Você deve baixar o seguinte para o seu dispositivo.
+ [Driver ODBC do Athena](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/AmazonAthenaODBC-2.1.0.0.rpm)
+ [Chave pública](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/public_key.pem)
+ [Assinatura RPM do ODBC do Athena](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/signature.bin)
1. Baixe o driver ODBC do Athena, a chave pública e a assinatura RPM do ODBC do Athena para o seu dispositivo.
1. Execute o comando a seguir para verificar a assinatura do driver ODBC:
```
openssl dgst -sha256 -verify public_key.pem -signature signature.bin AmazonAthenaODBC-2.1.0.0.rpm
```
Caso a verificação seja aprovada, será exibida uma mensagem semelhante a `Verified OK`. Isso significa que agora você pode prosseguir com a instalação do driver ODBC do Athena.
Se for exibida a mensagem de falha `Verification Failure`, significa que a assinatura no RPM foi adulterada. Certifique-se de que todos os três arquivos mencionados na etapa 1 estejam presentes, que os caminhos estejam corretamente especificados e que os arquivos não tenham sido modificados desde o download e tente novamente o processo de verificação.