内容:

自定义和调整连接

  • 版本 :2022.1 及更高版本

适用于: Tableau Desktop

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

如果要自定义基于 JDBC 的连接,则还可以在 PROPERTY 文件中进行自定义。有关详细信息,请参见使用 PROPERTIES 文件来自定义 JDBC 连接

使用 TDC 文件来自定义连接

TDC(Tableau 数据源自定义)文件是带有文件扩展名“.tdc”的 XML 文件。这些文件用于自定义特定于 Tableau 的设置。对于基于 ODBC 的连接,您还可以使用 TDC 文件来定义 ODBC 驱动程序支持的 ODBC 和 SQL 标准部分。

TDC 文件包含供应商名称、驱动程序名称和 部分。对于内置连接器,供应商名称和驱动程序名称必须与连接器的类名称匹配。在大多数情况下,供应商名称与驱动程序名称匹配。“其他数据库”连接器使用两个通用供应商名称:

  • 对于“其他数据库 (JDBC)”连接器,所需的供应商名称为“genericjdbc”。

  • 对于“其他数据库 (ODBC)”连接器,所需的供应商名称为“genericjdbc”。

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

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

重要信息:Tableau 不测试也不支持 TDC 文件。这些文件应用作研究数据连接或临时解决数据连接问题的工具。创建和维护 TDC 文件需要手动进行仔细的编辑,而且不会为共享这些文件提供支持。

TDC 文件的结构

每个 TDC 文件都采用以下基本结构:

                                 ...      

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 启用 PROPERTIES 文件,请将其放在每个服务器节点的此文件夹中:

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

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

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

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

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