지정 커넥터에 대한 연결 문자열 사용자 지정

지정 커넥터를 사용하여 수행된 연결을 수정하려는 경우가 있을 수 있습니다. 이 작업은 odbc-connect-string-extras 사용자 지정을 사용하여 구성 변경 사항을 연결에 전달하는 TDC(Tableau 데이터 원본 사용자 지정) 파일을 만들어 수행할 수 있습니다.

이 문서의 내용은 ODBC 드라이버를 사용하는 커넥터에 적용됩니다.

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

연결 문자열 수정

Tableau가 ODBC 드라이버를 사용하여 연결할 때 연결 문자열을 만들어 드라이버 관리자에게 전달합니다. 연결 문자열은 드라이버를 식별하고 드라이버에 대한 모든 매개 변수를 포함합니다.

다음은 연결 문자열의 예입니다.

DRIVER=BagelDB Driver;SERVER=bageldb.lan;UID=creamcheese;PWD=bagel;

BagelDB 드라이버의 DRIVER 값을 BagelDB Driver 2.0으로 재정의하고 포트 번호를 추가한다고 가정해 보겠습니다. 드라이버 관리자에게 전달된 연결 문자열은 다음과 같이 수정됩니다.

DRIVER=BagelDB Driver 2.0;SERVER=bageldb.lan;UID=creamcheese;PWD=bagel;PORT=54321

TDC 및 odbc-connect-string-extras 태그를 사용하여 연결 문자열 매개 변수를 수정할 수 있습니다. 일반적으로 재정의할 수 있는 유일한 매개 변수는 DRIVER입니다. 다른 매개 변수는 연결 문자열의 끝에 추가됩니다. 아래에서 'TDC 파일 사용' 방법을 참조하십시오.

참고: 보안 제한으로 인해 Tableau Online에서는 odbc-connect-string-extras 사용자 지정에 대한 지원이 제한됩니다. 일부 매개 변수는 지원되지 않을 수 있습니다.

허용 목록을 사용하여 보안 위험 줄이기

중요: 다음 절차는 Tableau Server 관리자가 Tableau Server에서 수행해야 하며 조직의 보안 지침을 준수하는지는 여러분의 IT 부서에서 평가해야 합니다.

odbc-connect-string-extras 사용자 지정은 보안 위험을 초래할 수 있습니다. Tableau Server 관리자는 허용 목록(보안 목록이라고도 함)에 승인된 매개 변수 목록을 지정하여 이 위험을 관리할 수 있습니다.

  • odbc-connect-string-extras에 지정된 매개 변수 중 목록에 없는 매개 변수는 필터링되어 제외됩니다.
  • 목록에 지정된 매개 변수가 없는 경우 모든 매개 변수가 허용됩니다.

허용 목록은 공백 없이 쉼표로 구분된 목록입니다.

예를 들어 UseDeclareFetchApp 매개 변수를 허용 목록에 추가하려면 다음 명령을 실행합니다.

tsm configuration set -k native_api.ODBCConnectStringSecurityList -v UseDeclareFetch,App --force-keys
tsm pending-changes apply

tsm 명령 실행에 대한 자세한 내용은 Tableau Server 도움말에서 tsm 명령줄 참조(링크가 새 창에서 열림)를 참조하십시오.

TDC 파일 사용

TDC 파일은 공급업체 이름, 드라이버 이름 및 <connection-customization> 섹션을 포함하는 XML 파일로, 여기에는 여러 유형의 사용자 지정(연결 문자열 및 연결 기능 모두에 대한 사용자 지정)이 포함될 수 있습니다. 지정 커넥터의 경우 공급업체 이름 및 드라이버 이름이 커넥터의 클래스 이름과 일치해야 합니다. 값은 아래의 '지정 커넥터 클래스 목록'을 참조하십시오. 기존 통합 문서나 데이터 원본 파일에 사용자 지정 섹션이 이미 설정되어 있는 경우에는 TDC 파일이 아닌, 내장된 사용자 지정만 사용됩니다.

TDC 파일을 만들면 파일을 Datasources 폴더에 저장해야 연결에 사용할 수 있습니다. Tableau Server에 게시할 통합 문서를 만드는 경우 또는 Tableau Prep 또는 Tableau Bridge를 사용하는 경우 TDC 파일을 해당 제품의 Datasources 디렉터리에도 저장해야 합니다. 자세한 내용은 tdc 및 속성 파일 설치를 참조하십시오.

참고: 사용자 지정된 odbc-extras를 사용하여 데이터 원본 또는 통합 문서를 만드는 경우 정보가 연결 특성에 내장됩니다. 따라서 Tableau Server에 TDC 파일을 설치하지 않고도 통합 문서 또는 데이터 원본을 Tableau Server에 게시할 수 있습니다.

TDC 파일에서 odbc-connect-string-extras 사용자 지정을 사용하여 특성을 추가하거나 연결 문자열에 DRIVER 특성을 재정의할 수 있습니다.

TDC 파일 만들기

  1. 메모장 또는 Notepad++와 같은 일반 텍스트 편집기를 엽니다.
  2. 아래에 제공된 샘플의 정보를 복사하여 텍스트 파일에 붙여 넣은 다음 클래스, 공급업체 이름 및 드라이버 이름 값을 지정합니다. 기본 Tableau 커넥터의 경우 클래스, 공급업체 이름 및 드라이버 이름에 동일한 값을 사용합니다.
  3. .tdc 확장명을 사용하여(예: mybagel.tdc) 각 Tableau 제품의 Datasources 폴더에 파일을 저장합니다. 자세한 내용은 tdc 및 속성 파일 설치를 참조하십시오.
  4. 연결하려는 사용자 지정을 입력합니다.

 

<connection-customization class='bagelDB' enabled='true' version='19.1'>
<vendor name='bagelDB' />
<driver name='bagelDB' />
<customizations>
<customization name='odbc-connect-string-extras' value='DRIVER=BagelDB Driver 2.0;PORT=54321' />
</customizations>
</connection-customization>

지정 커넥터 클래스 목록

TDC 파일을 사용자 지정하는 데 필요한 클래스 값을 얻으려면 아래 목록에서 커넥터를 찾으십시오(<커넥터>:<클래스> 형식으로 나열됨).

  • Actian Matrix: paraccel
  • Actian Vector: vectorwise
  • Amazon Aurora: aurora
  • Amazon EMR(Hive): awshadoophive
  • Amazon Redshift: redshift
  • Spark SQL: spark
  • Aster Database: asterncluster
  • Azure SQL Data Warehouse: azure_sql_dw
  • Cloudera Hadoop: hadoophive
  • Denodo: denodo
  • Exasol : exasolution
  • Firebird : firebird
  • Google Cloud SQL: googlecloudsql
  • Hortonworks Hadoop Hive: hortonworkshadoophive
  • IBM: BigInsights bigsql
  • IBM DB2: db2
  • IBM PDA(Netezza): netezza
  • Kognitio: kognitio
  • MapR Hadoop Hive: maprhadoophive
  • MariaDB: mariadb
  • MarkLogic: marklogic
  • MemSQL: memsql
  • Microsoft SQL Server: sqlserver
  • MonetDB: monetdb
  • MongoDB BI Connector: mongodb
  • MySQL: mysql
  • Oracle Essbase: essbase
  • 기타 데이터베이스(ODBC): genericodbc
  • Pivotal Greenplum Database: greenplum
  • PostgreSQL: postgres
  • Presto: presto
  • Progress OpenEdge: progressopenedge
  • SAP HANA: saphana
  • SAP Sybase ASE: sybasease
  • SAP Sybase IQ: sybaseiq
  • Snowflake: snowflake
  • Splunk: splunk
  • Teradata: teradata
  • Tibco 데이터 가상화: composite
  • Vertica: vertica

참고 항목

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

예: ODBC 연결 사용자 지정 - 기능 및 ODBC 연결 문자열에 대한 사용자 지정이 어떻게 이루어지는지 보여주는 단계별 프로세스입니다.

Tableau 및 ODBC – ODBC에 대한 배경 정보를 제공하고, Tableau가 ODBC 드라이버의 기능을 확인하는 방법을 설명하고, 자주 묻는 질문이 나와 있습니다.

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

ODBC/SQL 사용자 지정 참조 – ODBC 드라이버가 지원하는 것으로 보고하는 ODBC 및 SQL 표준 부분을 나타내는 사용자 지정을 나열합니다.

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