Como faço para habilitar logs de depuração no meu driver JDBC/ODBC do Athena?

Resolução

Importante: ative os logs de depuração somente pelo tempo necessário para capturar um problema. O registro em log diminui a performance e pode ocupar uma grande quantidade de espaço em disco.

Drivers JDBC

Você pode usar as versões 2.x e 3.x do driver JDBC para se conectar ao Athena. Para obter informações sobre os diferentes parâmetros para as versões 2.x e 3.x do JDBC, consulte Nível de log.

Ativar logs de depuração para o JDBC Athena versão 2.x

Para ativar os logs de depuração, configure as seguintes propriedades em seu driver JDBC Athena 2.x:

• Em LogLevel, selecione 5.
• Em UseAwsLogger, selecione 1.
  Observação: com essa propriedade, o driver JDBC também registra informações de chamadas de API da AWS.
• Em LogPath, insira um local na sua máquina host em que você deseja que os logs do driver sejam capturados.

Observação: você também pode configurar opções semelhantes em sua ferramenta de business intelligence para ativar os logs de depuração.

Certifique-se de reiniciar a aplicação JDBC e reconectar-se ao servidor.

Para obter mais informações sobre os arquivos de log que estão ativados, consulte Configuring logging no site da insightsoftware.

Ativar logs de depuração para o JDBC Athena versão 3.x

Para ativar os logs de depuração, configure as seguintes propriedades em seu driver JDBC Athena 3.x:

• Em LogLevel, selecione DEBUG.
• Em LogPath, insira um local na sua máquina host em que você deseja que os logs do driver sejam capturados.

Observação: você também pode configurar opções semelhantes em sua ferramenta de business intelligence para ativar os logs de depuração.

Para garantir que as novas configurações entrem em vigor, reinicie a aplicação JDBC e reconecte-se ao servidor.

O driver JDBC Athena 3.x gera arquivos de log no local especificado na propriedade LogPath.

Drivers ODBC

Você pode usar as versões 1.x e 2.x do driver ODBC para se conectar ao Athena. Para obter mais informações e baixar drivers ODBC, consulte Conectar-se ao Amazon Athena com ODBC.

Ativar logs de depuração para o driver ODBC 1.x do Athena

Baixe o driver ODBC 1.x do Athena para Windows, Linux ou macOS para sua máquina.

Para ativar os logs de depuração para sua máquina Windows, conclua as seguintes etapas:

1. No menu Iniciar do Windows, escolha Fontes de dados ODBC.
2. No Administrador de fontes de dados ODBC, escolha a guia DSN do sistema.
3. Escolha Adicionar.
4. Na lista de drivers, escolha Simba Athena ODBC Driver.
5. Escolha Concluir.
   Observação: É aberto um novo assistente no qual você pode adicionar informações, como região da AWS, esquema, grupo de trabalho e local de saída do Amazon Simple Storage Service (Amazon S3) e chave do AWS Key Management Service (AWS KMS).
6. Escolha Opções de registro em log.
   Em Nível de log, selecione INFO.
   Em Caminho do log, selecione um caminho na sua máquina Windows.
   Escolha OK.

Os logs do driver ODBC são gerados no caminho do log que você selecionou.

Para ativar os logs de depuração no driver da sua máquina Linux ou macOS, conclua as seguintes tarefas:

Linux: edite o arquivo /opt/simba/athenaodbc/lib/64/simba.athenaodbc.ini e configure as seguintes propriedades:

• Em LogLevel, selecione 5.
• Em LogPath, insira um caminho para seu host.

macOS: edite o arquivo /Library/simba/athenaodbc/lib/simba.athenaodbc.ini e configure as seguintes propriedades:

• Em LogLevel, selecione 5.
• Em LogPath, insira um caminho para seu host.

Certifique-se de reiniciar a aplicação ODBC e reconectar-se ao servidor.

Para obter mais informações sobre os arquivos de log que estão ativados, consulte Configuring logging options no site da insightsoftware.

Ativar logs de depuração para o driver ODBC 2.x do Athena

Baixe o driver ODBC 2.x do Athena para sua máquina Windows, Linux ou macOS. Em seguida, crie uma fonte de dados para seu sistema operacional (SO).

Para ativar os logs de depuração para sua máquina Windows, conclua as seguintes etapas:

1. No menu Iniciar do Windows, escolha Fontes de dados ODBC.
2. No Administrador da fonte de dados ODBC, escolha o nome da fonte de dados.
3. Escolha Configurar e, em seguida, escolha Opções de registro em log.
4. Atualize os parâmetros a seguir:
   Em Nível de log, escolha nível de nível de log: 1.
   Em Caminho do log, selecione um caminho na sua máquina Windows.
   (Opcional) Para ativar os logs do AWS SDK, escolha Habilitar AWS Logger.
5. Escolha OK.

Para ativar os logs de depuração em sua máquina macOS, conclua as seguintes etapas:

1. Instale o conector de dados ODBC no macOS.
2. Abra odbc.ini no seguinte local para seu processador:
   Processador Intel: /opt/athena/odbc/x86_64/ini/
   Processador ARM: /opt/athena/odbc/arm64/ini/
3. Atualize os parâmetros a seguir:
   Em LogLevel, selecione 1.
   (Opcional) Em UseAwsLogger, selecione 1.
   Em LogPath, insira um caminho para seu host.
4. Use a ferramenta de linha de comando iodbctest para verificar a conexão.

Para ativar os logs de depuração para máquinas Linux, conclua as seguintes etapas:

1. Instale o conector de dados ODBC no Linux.
2. Abra o arquivo /opt/athena/odbc/ini/odbc.ini.
3. Atualize os parâmetros a seguir:
   Em LogLevel, selecione 1.
   (Opcional) Em UseAwsLogger, selecione 1.
   Em LogPath, insira um caminho para seu host.
4. Use a ferramenta de linha de comando unixODBC isql para verificar a conexão.

Os logs do driver ODBC são gerados no caminho do log que você selecionou.

Informações relacionadas

Conectar-se ao Amazon Athena com drivers ODBC e JDBC

Athena ODBC & JDBC driver no site da insightsoftware