Tableau Desktop 和 Web 制作帮助

您可以使用 TDC 文件对连接进行自定义。

如果要自定义基于 JDBC 的连接，则还可以属性 文件中进行自定义。有关详细信息，请参见使用 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>（也包括类）部分。对于内置连接器，供应商名称和驱动程序名称必须与连接器的类名称匹配。通常，供应商名称与驱动程序名称匹配。“其他数据库”连接器使用两个通用类名称：

• 对于“其他数据库 (JDBC)”连接器，类名称为“genericjdbc”。
• 对于“其他数据库 (ODBC)”连接器，类名称为“genericjdbc”。

如果现有工作簿或数据源文件已启用自定义项部分，Tableau 将仅使用它定义的自定义项，而不是 TDC 文件中定义的任何自定义项。

有关详细信息，请参见 Tableau 知识库中的将 TDC 文件与 Tableau Server 配合使用(链接在新窗口中打开)。

重要信息：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：Tableau 忽略版本号。

下一部分至关重要，因为它标识此 TDC 文件的数据源的数据库提供程序的供应商名称和驱动程序名称。每个 TDC 文件只能绑定到一个数据源类型。对于我们的本机数据源，这些名称必须同时匹配数据源类名称；例如，对于我们的 Teradata 连接为“teradata”。对于 ODBC 数据源，TDC 文件的供应商名称和驱动程序名称必须与数据库和驱动程序向 Tableau 报告的内容匹配；例如，分别为“SQLite”和“SQLite3 ODBC Driver”。

最后一部分列出了实际的连接自定义项。

有关详细信息，请参见 Tableau JDBC 功能自定义项。

使用 PROPERTIES 文件来自定义 JDBC 连接

PROPERTIES 文件由 JDBC 使用，并直接传递到 JDBC 驱动程序。这些文件是具有“.properties”文件扩展名的纯文本文件。它们包含每个连接参数的键值对。

将 PROPERTIES 文件与 JDBC 连接结合使用类似于在 ODBC 连接的 TDC 文件中使用 odbc-connect-string-extras 参数。

注意：PROPERTIES 文件应采用 Latin-1 格式（请参见https://en.wikipedia.org/wiki/.properties(链接在新窗口中打开)）。但是，只要它仅包括 ASCII 字符，您就可以安全地以 UTF-8 格式保存文件，而无需 BOM（字节顺序标记）。

在文件中，将每个键值对放在其自己的行上，不带分隔符。为文件指定与相应连接器相同的名称，但具有“.properties””文件扩展名。例如，SAP HANA 连接器的 PROPERTIES 文件将是“saphana.properties”。

• 对于 Tableau Desktop，将 PROPRETIES 文件放在此目录中：

  My Tableau Repository/Datasources

• 若要为 Tableau Server 启用 属性 文件，请将其放在每个服务器节点的此目录中：

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

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

• 对于 Prep 流程，将 PROPRETIES 文件放在这些目录中：

  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

• 对于虚拟连接，将 PROPRETIES 文件放在此目录中：

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

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

将文件保存到正确的位置后，属性将应用于到同一数据源类型的所有 JDBC 连接。

使用基于 JDBC 的连接发布工作簿

若要通过基于 JDBC 的连接发布工作簿，必须在 Tableau Desktop 和 Tableau Server 计算机上都包括 PROPERTIES 文件的副本。

另请参见

为原生连接器自定义连接字符串(链接在新窗口中打开) – Tableau 社区中的本文介绍如何使用 odbc-connect-string-extras 自定义项来修改使用原生连接器进行的连接。

此部分中的其他文章