연결 사용자 지정 및 조정

TDC 파일을 사용하여 연결을 사용자 지정할 수 있습니다.

JDBC 기반 연결을 사용자 지정하는 경우 PROPERTY 파일도 사용자 지정할 수 있습니다. 자세한 내용은 PROPERTIES 파일을 사용하여 JDBC 연결 사용자 지정을 참조하십시오.

특수 문자 정보

특수 문자는 올바르게 이스케이프되어야 하며, 이스케이프가 필요한지 여부는 문자의 위치에 따라 달라질 수 있습니다. 예를 들어 등호 '='가 값에 포함된 경우 첫 번째 '=' 오른쪽 이후의 등호는 올바르게 이스케이프되어야 합니다.

예:

ServiceLocation=Region=east;Name=prod;

ServiceLocation=Region\=east;Name\=prod;와 같이 작성되어야 합니다.

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

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

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

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

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

자세한 내용은 Tableau 기술 자료에서 Tableau Server에서 TDC 파일 사용(링크가 새 창에서 열림)을 참조하십시오.

중요: Tableau는 TDC 파일을 테스트하거나 지원을 제공하지 않습니다. 이러한 파일은 데이터 연결을 탐색하거나 관련 문제를 해결하기 위한 도구로 사용해야 합니다. 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'/>
        ...
    </customizations>
</connection-customization>

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

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

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

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

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

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

자세한 내용은 Tableau JDBC 기능 사용자 지정을 참조하십시오.

PROPERTIES 파일을 사용하여 JDBC 연결 사용자 지정

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

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

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

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

  • Tableau Desktop의 경우 다음 디렉터리에 PROPERTIES 파일을 배치합니다.

    My Tableau Repository/Datasources

  • Tableau Server에서 PROPERTIES 파일을 사용하도록 설정하려면 각 Server 노드에서 다음 디렉터리에 파일을 배치합니다.

    Windows: ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources

    Linux: /var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/

  • Prep 흐름의 경우 다음 디렉터리에 PROPERTIES 파일을 배치합니다.

    Linux:

    /var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/

    /var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/

    Windows:

    ProgramData\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources

    ProgramData\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources

  • 가상 연결 경우 다음 디렉터리에 PROPERTIES 파일을 배치합니다.

    Linux: /var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/

    Windows: ProgramData\Tableau\Tableau Server\data\tabsvc\minerva\Datasources

파일을 올바른 위치에 저장하고 나면 동일한 데이터 원본 유형에 대한 모든 JDBC 연결에 속성이 적용됩니다.

JDBC 기반 연결을 사용하여 통합 문서 게시

JDBC 기반 연결에서 통합 문서를 게시하려면 PROPERTIES 파일 복사본을 Tableau Desktop과 Tableau Server 컴퓨터에 모두 포함해야 합니다.

참고 항목

기본 커넥터의 연결 문자열 사용자 지정(영문)(링크가 새 창에서 열림) – Tableau 커뮤니티의 이 문서에서는 odbc-connect-string-extras 사용자 지정을 사용하여 기본 커넥터로 수행된 연결을 수정하는 방법을 설명합니다.

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