---
schema_version: "1"
id: 9b8187bf6987e1559b9c5771c7f0c6a4d1dfa2ccba27a02c9c3fde704703cb4c
title: 연결 사용자 지정 및 조정
collection: tableau
version: next
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/next/ko-kr/public/desktop/connect_customize.md
canonical_url: https://help.tableau.com/v0.0/public/desktop/ko-kr/connect_customize.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 96bbff5f8d91815b39bae1fb174e146ddf034f7cb4c72d0d80d0a4bff4baf397
description: Customize and tune ODBC and JDBC connections using TDC and properties files.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# 연결 사용자 지정 및 조정

TDC 파일을 사용하여 연결 문자열의 매개 변수와 연결 기능을 사용자 지정할 수 있습니다. 이는 ODBC와 JDBC 연결 모두에 해당됩니다.

JDBC 기반 연결을 사용자 지정하는 경우 속성 파일의 연결 문자열 매개 변수도 수정할 수 있습니다. 자세한 내용은 [속성 파일을 사용하여 JDBC 연결 사용자 지정](#Using)을 참조하십시오.

중요: TDC 파일은 연결 기능을 사용자 지정하거나 데이터 연결과 관련된 문제를 진단하고 해결하는 데 활용할 수 있습니다. Tableau는 사용자가 이러한 파일을 수정할 수 있는 모든 가능성을 철저히 테스트할 수 없습니다. TDC 파일을 만들어 사용하려면 수동 편집이 필요하며, 프로덕션 환경에 배포하기 전에 철저히 테스트하는 것이 중요합니다.

## TDC 파일을 사용하여 연결 사용자 지정

**참고**: 커넥터당 하나의 TDC 파일만 지정할 수 있습니다. 동일한 커넥터를 참조하는 TDC 파일이 여러 개 있는 경우 하나만 적용됩니다.

TDC(Tableau 데이터 원본 사용자 지정) 파일은 파일 확장명이 “.tdc”인 XML 파일입니다. 이러한 파일은 Tableau 관련 설정을 사용자 지정하는 데 사용됩니다. ODBC 기반 연결의 경우 TDC 파일을 사용하여 ODBC 드라이버가 지원하는 ODBC 및 SQL 표준을 정의할 수도 있습니다.

TDC 파일에는 공급업체 이름, 드라이버 이름 및 `<connection-customization>`(클래스도 포함) 섹션이 포함됩니다. 기본 제공 커넥터의 경우 공급업체 이름 및 드라이버 이름이 커넥터의 클래스 이름과 일치해야 합니다. 일반적으로 공급업체 이름은 드라이버 이름과 일치합니다. 기타 데이터베이스 커넥터에는 2개의 일반 클래스 이름이 사용됩니다.

- 기타 데이터베이스(JDBC) 커넥터의 경우 클래스 이름은 "genericjdbc"입니다.
- 기타 데이터베이스(ODBC) 커넥터의 경우 클래스 이름은 "genericodbc"입니다.

기존 통합 문서나 데이터 원본 파일에 사용자 지정 섹션이 이미 설정되어 있는 경우에는 TDC 파일이 아닌 해당 파일에 정의된 사용자 지정만 사용됩니다.

### TDC 파일의 구조

각 TDC 파일은 다음과 같은 기본 구조를 따릅니다.

<connection-customization class=DSCLASS enabled='true' version='10.0'>
    <vendor name=VENDOR />
    <driver name=DRIVER />
    <customizations>
        <customization name='CAP\_FAST\_METADATA' value='yes'/>
        <customization name='CAP\_SOMETHING\_ELSE' value='yes'/>
        ...
    </customizations>
</connection-customization>

TDC 파일에는 세 가지 기본 섹션이 있습니다.

- 연결 사용자 지정 변수
- 공급업체 및 드라이버 이름
- 사용자 지정 자체

`connection-customization` 섹션은 다음을 포함합니다.

- **class**: 연결하여 사용자 지정하려는 데이터 원본입니다.
- **enabled**: TDC 파일 연결 사용자 지정이 적용되는지 여부를 지정합니다. TDC 파일에서 항상 “true”로 설정합니다.
- **version**: Tableau에서 버전 번호는 무시됩니다.

다음 섹션은 이 TDC 파일의 데이터 원본에 대한 데이터베이스 공급자의 공급업체 이름 및 드라이버 이름을 식별하므로 매우 중요합니다. 각 TDC 파일은 하나의 데이터 원본 유형에만 바인딩할 수 있습니다. 네이티브 데이터 원본인 경우 두 이름 모두 데이터 원본 클래스 이름과 일치해야 합니다. 예를 들어 “teradata”는 Teradata 연결을 위한 것입니다. ODBC 데이터 원본의 경우 TDC 파일의 공급업체 이름 및 드라이버 이름이 데이터베이스 및 드라이버가 Tableau에 보고하는 이름과 일치해야 합니다. 예를 들어 “SQLite” 및 “SQLite3 ODBC 드라이버”여야 합니다.

마지막 섹션에는 실제 연결 사용자 지정이 나열됩니다.

다음은 두 가지 예제 TDC 파일입니다. 첫째는 일반 ODBC 연결이고 둘째는 기본 Salesforce 연결에 대한 수정입니다. 참고로, 나열된 사용자 지정은 예시로만 제공되며 특정 목표를 달성하기 위해 선택된 것이 아닙니다.

<?xml version='1.0' encoding='utf-8' ?>  
<connection-customization class='genericodbc' enabled='true' version='8.10'>  
  <vendor name='Gen\_ODBC\_Vendor'/>  
  <driver name='Gen\_Driver'/>  
  <customizations>  
    <customization name='CAP\_FAST\_METADATA' value='yes' />  
    <customization name='CAP\_ODBC\_BIND\_FORCE\_MAX\_STRING\_BUFFERS' value='yes' />  
    <customization name='CAP\_ODBC\_BIND\_PRESERVE\_BOM' value='yes' />  
  </customizations>  
</connection-customization>

<?xml version='1.0' encoding='utf-8' ?>
<connection-customization class='salesforce' enabled='true' version='8.10'>
  <vendor name='salesforce'/> 
  <driver name='salesforce'/>
  <customizations>
    <customization name='CAP\_ODBC\_EXPORT\_CONTINUE\_ON\_ERROR' value='yes' />
    <customization name='CAP\_ODBC\_EXPORT\_FORCE\_SINGLE\_ROW\_BINDING' value='yes' />
    <customization name='CAP\_ODBC\_EXPORT\_SUPPRESS\_STRING\_WIDTH\_VALIDATION' value='no' />
  </customizations>
</connection-customization>

## 속성 파일을 사용하여 JDBC 연결 사용자 지정

속성 파일은 JDBC에서 사용되며 JDBC 드라이버로 직접 전달됩니다. 이러한 파일은 파일 확장명이 ".properties"인 일반 텍스트 파일입니다. 이 파일은 각 연결 매개 변수에 대한 키-값 쌍을 포함합니다.

JDBC 연결과 함께 속성 파일을 사용하는 것은 ODBC 연결을 위해 TDC 파일에서 `odbc-connect-string-extras` 매개 변수를 사용하는 것과 유사합니다.

**참고:** 속성 파일은 라틴어-1 형식이어야 합니다([https://en.wikipedia.org/wiki/.properties](https://en.wikipedia.org/wiki/.properties) 참조). 그러나 ASCII 문자만 포함하는 한 BOM(바이트 순서 표시) 없이 UTF-8 형식으로 파일을 안전하게 저장할 수 있습니다.

파일에서 각 키-값 쌍을 구분 기호 없이 한 줄에 입력합니다. 파일에 해당 커넥터와 동일한 이름을 지정하되 파일 확장명을 ".properties"로 합니다. 예를 들어 SAP HANA 커넥터의 속성 파일은 'saphana.properties'입니다.

## tdc 및 속성 파일 설치

사용자 지정 파일(TDC 또는 속성)이 만들어지면 특정 '데이터 원본' 디렉터리에 배치해야 Tableau 제품에서 해당 파일을 검색하고 사용할 수 있습니다. 예를 들어 사용자가 Tableau Desktop에서 Tableau Server로 콘텐츠를 게시할 경우 사용자 지정 파일을 두 제품 디렉터리에 모두 복사해야 합니다.

파일을 적절한 디렉터리에 복사한 후 변경 사항을 인식하려면 Tableau를 다시 시작해야 합니다(Tableau Server를 사용하는 경우 모든 노드 포함). 기본 설치의 디렉터리 경로는 아래를 참조하십시오.

#### Tableau Desktop 응용 프로그램 경로

- Desktop/Windows: `C:\Users\myuser\My Tableau Repository\Datasources`
- Desktop/Mac: `~/Documents/My Tableau Repository/Datasources`
- Prep Builder/Windows: `C:\Users\myuser\Documents\My Tableau Prep Repository\Datasource`
- Prep Builder/Mac: `~/Documents/My Tableau Prep Repository/Datasources`
- Bridge/Windows: `C:\Users\myuser\Documents\My Tableau Bridge Repository\Datasources`
- Bridge/Linux: `/root/Documents/My_Tableau_Bridge_Repository/Datasources/`

#### Tableau Server 경로

**참고:** 사용자 지정 파일은 사용 중인 모든 서버 노드의 적절한 디렉터리에 복사해야 합니다.

- **Windows**:
- Server: `C:\Program Files\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources   C:\Program Files\Tableau\Tableau Server\packages\bin.<build number>`
- 가상 연결: `C:\Program Files\Tableau\Tableau Server\data\tabsvc\minerva\Datasources`
- Prep 흐름: `C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources`
- Prep 웹 작성: `C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources`
- **Linux**:
- Server: `/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/`
- 가상 연결: `/var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/`
- Prep 흐름: `/var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/`
- Prep 웹 작성: `/var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/`

사용자 지정 TDC 또는 속성 파일을 올바른 위치에 저장하고 응용 프로그램을 다시 시작하면 동일한 데이터 원본 유형에 대한 모든 연결에 적용됩니다.

## 이 섹션의 다른 문서