Tableau 및 JDBC

적용 대상: Tableau Desktop, Tableau Server

Tableau는 여러 커넥터에 대해 JDBC(Java Database Connectivity) 드라이버를 지원합니다. 여기에는 Athena와 같은 공식적인 명명된 커넥터와 기타 데이터베이스(JDBC)라고 하는 다른 JDBC 기반 드라이버와 함께 사용하기 위한 범용 커넥터가 모두 포함됩니다.

JDBC에는 플랫폼 독립적인 Java가 필요합니다. 2020.2 버전부터 모든 Tableau 응용 프로그램에는 Java 런타임이 번들로 제공되므로 별도로 설치할 필요가 없습니다.

참고: 2020.2 이전 버전의 Tableau Desktop을 사용하는 경우 Java 설치에 대한 지침은 드라이버 다운로드(링크가 새 창에서 열림) 페이지를 참조하십시오.

JDBC 커넥터 성능 조정

Tableau는 JDBC 데이터 연결을 사용자 지정하여 연결 성능을 개선할 수 있는 기능을 지원합니다. 자세한 내용은 연결 사용자 지정 및 조정을 참조하십시오.

JDBC 연결에 대한 Tableau 지원

Tableau는 특정 JDBC 드라이버 또는 데이터베이스에서 기타 데이터베이스(JDBC) 커넥터를 사용하는 경우 데이터에 연결하고 쿼리할 수 있다는 어떠한 보장 또는 보증도 하지 않습니다. 일부 JDBC 드라이버는 Tableau 대화형 환경을 완벽하게 지원하지만 일부 드라이버는 추출을 만들 때만 작동합니다. 일부 JDBC 드라이버는 Tableau에서 작동하지 않을 수 있습니다.

참고: Tableau에서는 JDBC 드라이버 연결 문제 해결을 위한 합리적인 수준의 고객 지원을 제공하지만 특정 JDBC 드라이버에 사용할 수 있는 커넥터를 만들거나 사용자 지정할 수는 없습니다.

자주 묻는 질문

다음은 몇 가지 일반적인 문제 및 해결 단계에 대한 목록입니다.

"Java 없음" 메시지가 표시됩니다. 어떻게 해야 하나요?

2020.2 이전 버전의 Tableau를 사용하거나 Windows에서 Kerberos를 사용하는 경우 때때로 이 문제가 발생합니다. 커넥터에 맞는 Java 버전을 설치하는 방법에 대한 지침은 드라이버 다운로드(링크가 새 창에서 열림) 페이지를 참조하십시오.

2020.2 버전부터 모든 Tableau 응용 프로그램에는 Java 런타임이 번들로 제공되므로 이 오류가 발생하지 않습니다.

"드라이버 없음" 메시지가 표시됩니다. 어떻게 해야 합니까?

다음 경로 중 하나에 드라이버와 드라이버가 종속된 모든 라이브러리를 설치합니다.

  • Windows: C:\Program Files\Tableau\Drivers
  • Mac: /Library/JDBC 또는 ~/Library/JDBC
  • Linux: /opt/tableau/tableau_driver/jdbc

Tableau를 실행하는 사용자 또는 Tableau Service 사용자가 드라이버를 읽을 수 있는지 확인하십시오.

Tableau용 JDBC 드라이버가 여러 개 설치되어 있지만 연결하는 데 문제가 있습니다. 어떻게 해야 합니까?

Tableau용 JDBC 드라이버가 여러 개 설치되어 있는 경우 동일한 타사 라이브러리의 다른 버전을 사용할 수 있습니다. 이로 인해 예측할 수 없는 방식으로 문제가 발생할 수 있습니다. 연결하는 동안 이상한 오류가 발생하고 JDBC 드라이버 폴더에 여러 JDBC 드라이버가 설치되어 있는 경우 다음 단계를 따라 드라이버를 분리할 수 있습니다.

JDBC 폴더에 다음 라이브러리가 설치되어 있다고 가정합니다.

  • athena-driver.jar
  • athena-dependency.jar
  • athena-dependency.so
  • postgres-driver.jar

Athena 드라이버를 Postgres 드라이버에서 분리하려면 별도의 하위 디렉터리에 설치합니다.

  • Athena/athena-driver.jar
  • Athena/athena-dependency.jar
  • Athena/athena-dependency.dll
  • Postgres/postgres-driver.jar

드라이버를 이동한 후 Tableau를 다시 시작합니다.

“ClassNotFoundException”(또는 유사한) 메시지가 표시됩니다. 어떻게 해야 합니까?

Java 11과 호환되지 않는 JDBC 드라이버를 실행하는 경우 Tableau를 실행할 때 문제가 발생할 수 있습니다.

Java 11로 인해 문제가 발생했다고 생각하는 경우:

  1. AdoptOpenJDK에서 Java 64비트 JRE(Java Runtime Environment) 또는 JDK(Java Development Kit)를 다운로드합니다.
    1. https://adoptopenjdk.net/releases.html로 이동합니다.
    2. OpenJDK 11을 선택하고 Hotspot을 선택합니다.
    3. Other Platforms(기타 플랫폼)를 선택하여 전체 옵션 목록을 표시합니다.
    4. 사용 중인 운영 체제에 대한 JRE 또는 JDK를 다운로드합니다.
  2. Tableau를 실행하는 컴퓨터에서 다음 중 하나와 같은 환경 변수를 설정합니다.

    TABLEAU_JAVA_HOME=C:\Program Files\AdoptOpenJDK\jre-8.0.232.09-hotspot

    또는

    TABLEAU_JAVA_HOME=C:\Program Files\AdoptOpenJDK\jdk-8.0.252.09-hotspot

프록시 문제를 어떻게 해결합니까?

버전 2019.4부터 Tableau가 Windows에서 실행될 때 Java에 대해 useSystemProxies 옵션을 사용하도록 설정하여 프록시 설정을 읽습니다.

때때로 이로 인해 문제가 발생할 수 있습니다. 예를 들어 "Use the same proxy server for all protocols(모든 프로토콜에 동일한 프록시 서버 사용)"을 선택하면 Java 가상 컴퓨터가 SOCKS 프록시를 사용하려고 합니다.

이 문제를 해결하기 위한 지침을 찾으려면 Tableau 기술 자료 문서인 오류 코드 37CE01A3과 함께 Tableau가 프록시를 통해 Amazon Athena에 연결하지 못함(영문)을 참조하십시오. 이 문서는 Athena를 구체적으로 언급하지만 모든 JDBC 커넥터에 적용될 수 있습니다.

SSL로 서버에 연결하는 데 문제가 있습니다. 무엇을 시도할 수 있습니까?

"Couldn’t find SSL verification path(SSL 확인 경로를 찾을 수 없음)"와 같은 오류 메시지가 표시되면 인증서 또는 개인 키를 구성해야 할 수 있습니다.

인증서 사용에 대한 지침은 JDBC 연결을 위한 단방향 SSL을 참조하십시오. Oracle JDBC 드라이버를 사용하는 경우 적절한 인증서 및/또는 키를 사용하여 연결하는 방법에 대한 자세한 내용은 SSL을 사용한 Oracle JDBC 연결을 참조하십시오.

Postgres JDBC 드라이버와 함께 기타 데이터베이스(JDBC) 커넥터를 사용하면 추출 생성 시도가 실패하는 경우가 있습니다. 무엇을 시도할 수 있습니까?

Postgres 드라이버 가져오기 크기가 설정되어 있지 않고 자동 커밋이 사용되도록 설정된 경우 오류가 발생할 수 있습니다. 드라이버에서 한 번에 너무 많은 데이터를 처리하려고 시도하지만 처리할 수 없습니다.

다음을 시도하십시오.

  1. defaultRowFetchSize를 사용하여 데이터에 대한 가져오기 크기를 설정합니다.

    자세한 내용은 PostgreSQL 사이트의 JDBC 드라이버(영문)(링크가 새 창에서 열림) 페이지를 참조하십시오.

  2. TDC 파일을 생성(또는 기존 파일 편집)하여 자동 커밋을 사용하지 않도록 설정합니다. TDC 파일에 다음을 포함합니다.

    <?xml version='1.0' encoding='utf-8' ?>
    <connection-customization class="genericjdbc" enabled="true" version="10">
    <vendor name="genericjdbc"/>
    <driver name="postgresql"/>
    <customizations>
    <customization name="CAP_JDBC_QUERY_DISABLE_AUTO_COMMIT" value="yes"/>
    </customizations>
    </connection-customization>

    참고: 이 단계는 기타 데이터베이스(JDBC) 커넥터를 사용할 경우 필요하지만 명명된 Tableau 커넥터의 경우 기본적으로 자동 커밋이 이미 설정되어 있으므로 이 단계가 필요하지 않습니다.

    JDBC 연결에서 TDC 파일을 사용하는 방법에 대한 자세한 내용은 연결 사용자 지정 및 조정을 참조하십시오.

참고 항목

기타 데이터베이스(JDBC) – 범용 JDBC 커넥터를 사용하여 데이터에 연결하는 방법을 설명합니다.

연결 사용자 지정 및 조정 - TDC 및 PROPERTIES 파일을 사용하여 연결을 사용자 지정하는 방법을 설명합니다.

JDBC 연결을 위한 단방향 SSL – SSL을 사용하여 서버에 액세스하기 위해 JDBC 드라이버와 함께 인증서를 사용하는 방법에 대한 지침을 제공합니다.

Tableau JDBC 기능 사용자 지정 참조 – 데이터 원본에서 지원하는 Tableau 기능을 정의하는 데 사용할 수 있는 사용자 지정이 나와 있습니다.

맨 위로 이동
피드백을 제공해 주셔서 감사합니다!귀하의 피드백이 제출되었습니다. 감사합니다!