---
schema_version: "1"
id: d6a08ceb6eac667617abb5bbbd4981abc4a61b5790aa8c74a4d49957d4054b02
title: Tableau 및 JDBC
collection: tableau
version: current
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/current/ko-kr/pro/desktop/jdbc_tableau.md
canonical_url: https://help.tableau.com/current/pro/desktop/ko-kr/jdbc_tableau.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 786a372ce9e31d6a13f767b25f7ed405672ae90570786ff63335812fb33cef8f
description: Understand how Tableau uses JDBC drivers and how to tune their performance.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# Tableau 및 JDBC

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

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

**참고:** 2020.2 이전 버전의 Tableau Desktop을 사용하는 경우 Java 설치에 대한 지침은 [드라이버 다운로드](https://www.tableau.com/ko-kr/support/drivers) 페이지를 참조하십시오.

## JDBC 커넥터 성능 조정

Tableau는 JDBC 데이터 연결을 사용자 지정하여 연결 성능을 개선할 수 있는 기능을 지원합니다. 자세한 내용은 [연결 사용자 지정 및 조정](https://help.tableau.com/current/pro/desktop/ko-kr/connect_customize.htm)을 참조하십시오.

## JDBC 연결에 대한 Tableau 지원

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

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

## 자주 묻는 질문

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

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

2020.2 이전 버전의 Tableau를 사용하거나 Windows에서 Kerberos를 사용하는 경우 때때로 이 문제가 발생합니다. 커넥터에 맞는 Java 버전을 설치하는 방법에 대한 지침은 [드라이버 다운로드](https://www.tableau.com/ko-kr/support/drivers) 페이지를 참조하십시오.

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](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](https://docs.oracle.com/javase/8/docs/technotes/guides/net/proxies.html)에 대해 `useSystemProxies` 옵션을 사용하도록 설정하여 프록시 설정을 읽습니다.

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

이 문제를 해결하기 위한 지침을 찾으려면 Tableau 기술 자료 문서인 [오류 코드 37CE01A3과 함께 Tableau가 프록시를 통해 Amazon Athena에 연결하지 못함(영문)](https://kb.tableau.com/articles/issue/tableau-desktop-fails-to-connect-to-amazon-athena-through-proxy-with-error-code-37ce01a3?lang=ko-kr)을 참조하십시오. 이 문서는 Athena를 구체적으로 언급하지만 모든 JDBC 커넥터에 적용될 수 있습니다.

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

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

인증서 사용에 대한 지침은 [JDBC 연결을 위한 단방향 SSL](https://help.tableau.com/current/pro/desktop/ko-kr/jdbc_ssl_config.htm)을 참조하십시오. Oracle JDBC 드라이버를 사용하는 경우 적절한 인증서 및/또는 키를 사용하여 연결하는 방법에 대한 자세한 내용은 [SSL을 사용한 Oracle JDBC 연결](https://help.tableau.com/current/pro/desktop/ko-kr/jdbc_oracle_ssl_config.htm)을 참조하십시오.

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

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

다음을 시도하십시오.

1. defaultRowFetchSize를 사용하여 데이터에 대한 가져오기 크기를 설정합니다.
    
    자세한 내용은 PostgreSQL 사이트의 [JDBC 드라이버(영문)](https://jdbc.postgresql.org/documentation/head/connect.html) 페이지를 참조하십시오.
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 파일을 사용하는 방법에 대한 자세한 내용은 [연결 사용자 지정 및 조정](https://help.tableau.com/current/pro/desktop/ko-kr/connect_customize.htm)을 참조하십시오.

### 참고 항목

[기타 데이터베이스(JDBC)](https://help.tableau.com/current/pro/desktop/ko-kr/examples_otherdatabases_jdbc.htm) – 범용 JDBC 커넥터를 사용하여 데이터에 연결하는 방법을 설명합니다.

[연결 사용자 지정 및 조정](https://help.tableau.com/current/pro/desktop/ko-kr/connect_customize.htm) - TDC 및 .properties 파일을 사용하여 연결을 사용자 지정하는 방법을 설명합니다.

[JDBC 연결을 위한 단방향 SSL](https://help.tableau.com/current/pro/desktop/ko-kr/jdbc_ssl_config.htm) – SSL을 사용하여 서버에 액세스하기 위해 JDBC 드라이버와 함께 인증서를 사용하는 방법에 대한 지침을 제공합니다.

[Tableau JDBC 기능 사용자 지정 참조](https://help.tableau.com/current/pro/desktop/ko-kr/jdbc_capabilities.htm) – 데이터 원본에서 지원하는 Tableau 기능을 정의하는 데 사용할 수 있는 사용자 지정이 나와 있습니다.