Athena 드라이버를 사용하여 Tableau 연결 문제를 어떻게 해결합니까?

해결 방법

드라이버 관련 문제 해결

드라이버 관련 문제가 발생하면 다음과 비슷한 오류 메시지가 표시됩니다.

‘The drivers required to connect to the data source are not installed. No Suitable driver Installed. Error code: AA76601F’

이 오류는 적합한 Athena JDBC 드라이버를 사용하지 않거나 올바른 위치로 다운로드하지 않을 때 발생합니다.

이 문제를 해결하려면 다음 단계를 완료하십시오.

1. AWS SDK가 번들로 함께 제공되는 Athena JDBC 드라이버 JAR의 최신 버전을 다운로드합니다.
2. Athena JDBC 드라이버를 올바른 Tableau 드라이버 위치에 저장합니다.
   Windows의 경우 Athena JDBC .jar 파일을 C:\Program Files\Tableau\Drivers 폴더에 저장하십시오.
   macOS의 경우 Athena JDBC .jar 파일을 ~/Library/Tableau/Drivers 폴더에 저장하십시오.
   참고: .jar 파일을 여러 개 추가하지 마십시오. .jar 파일을 여러 개 추가하면 드라이버 관련 문제가 발생할 수 있습니다.
3. Tableau를 다시 시작한 다음, Athena에 연결합니다.

연결 제한 시간 초과 해결

연결 제한 시간이 초과되면 다음과 비슷한 오류 메시지가 표시됩니다.

‘com/amazonaws/ClientConfiguration Unable to connect to the Amazon Athena server athena.us-east-1.amazonaws.com. Check that the server is running and that you have access privileges to the requested database.’

이 오류는 설치된 호스트의 드라이버와 Athena가 연결되어 있지 않을 때 발생합니다.

참고: 다음 명령에서 aa-example-1을 AWS 리전으로 바꾸십시오. Amazon Virtual Private Cloud(Amazon VPC) 엔드포인트 명령의 경우 1234567890abcdef0을 VPC 엔드포인트 ID로 바꾸십시오.

이 문제를 해결하려면 다음 작업을 수행하십시오.

• 포트 443 및 444를 엽니다. Athena는 포트 443을 사용하여 호스트에 연결하고 Athena의 스트리밍 API는 포트 444를 사용하여 쿼리 결과를 스트리밍합니다.

• 운영 체제(OS)에 대해 다음 명령을 실행하여 드라이버의 호스트 머신에서 포트 443과 444에 대한 엔드포인트 연결을 테스트합니다.
  Windows:

  telnet athena.aa-example-1.amazonaws.com 443
  
  telnet athena.aa-example-1.amazonaws.com 444

  macOS:

  nc -v athena.aa-example-1.amazonaws.com 443
  
  nc -v athena.aa-example-1.amazonaws.com 444

  프라이빗 DNS 서버에 Amazon VPC 엔드포인트를 사용하는 경우 엔드포인트의 시작 부분에 VPC 엔드포인트 ID를 추가하십시오. 그런 다음 vpce 하위 도메인을 추가합니다.
  Windows의 VPC 엔드포인트:

  telnet vpce-1234567890abcdef0.athena.aa-example-1.vpce.amazonaws.com 443
  
  telnet vpce-1234567890abcdef0.athena.aa-example-1.vpce.amazonaws.com 444

  macOS의 VPC 엔드포인트:

  nc -v vpce-1234567890abcdef0.athena.aa-example-1.vpce.amazonaws.com 443
  
  nc -v vpce-1234567890abcdef0.athena.aa-example-1.vpce.amazonaws.com 444

• 올바른 AWS Identity and Access Management(IAM) 사용자 액세스 키 ID와 시크릿 액세스 키를 사용하십시오. 또한 Amazon Simple Storage Service(Amazon S3), Athena 및 AWS Glue에 필요한 권한을 추가하십시오.

쿼리 및 연결 관련 문제 디버깅

Tableau용 Athena JDBC 드라이버 로그를 활성화하려면 다음 단계를 완료하십시오.

1. OS의 다음 Datasources 폴더에 athena.properties 파일을 만듭니다.
   Windows의 경우 C:\Users\[YourUsername]\Documents\My Tableau Repository\Datasources 폴더를 사용합니다.
   macOS의 경우 ~/Documents/My Tableau Repository/Datasources 폴더를 사용합니다.

2. 속성 파일을 연 후 다음을 추가합니다.

   LogLevel=6
   LogPath=D:\test\
   UseAwsLogger=1

3. 파일을 저장한 후 Tableau를 닫습니다.

4. Athena에 연결합니다.

AthenaJDBC_connection 및 AthenaJDBC_Driver 로그 파일이 이제 Datasources 폴더에 생성됩니다.