연결 사용자 지정 및 조정

적용 대상: Tableau Desktop

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

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

중요: 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(링크가 새 창에서 열림) 참조). 그러나 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 또는 속성 파일을 올바른 위치에 저장하고 응용 프로그램을 다시 시작하면 동일한 데이터 원본 유형에 대한 모든 연결에 적용됩니다.

맨 위로 이동