自定义和调整连接
您可以使用 TDC 文件自定义连接字符串的参数和连接的功能。这适用于 ODBC 和 JDBC 连接。
如果要自定义基于 JDBC 的连接，您也可以修改属性文件中的连接字符串参数。有关详细信息，请参见使用属性文件来自定义 JDBC 连接。
使用 TDC 文件来自定义连接
注意：每个连接器只能有一个 TDC 文件。如果有多个 TDC 文件引用同一个连接器，则只会应用一个。
TDC（Tableau 数据源自定义）文件是带有文件扩展名“.tdc”的 XML 文件。这些文件用于自定义特定于 Tableau 的设置。对于基于 ODBC 的连接，您还可以使用 TDC 文件来定义 ODBC 驱动程序支持的 ODBC 和 SQL 标准部分。
TDC 文件包含供应商名称、驱动程序名称和 <connection-customization>（也包括类）部分。对于内置连接器，供应商名称和驱动程序名称必须与连接器的类名称匹配。通常，供应商名称与驱动程序名称匹配。“其他数据库”连接器使用两个通用类名称：
- 对于“其他数据库 (JDBC)”连接器，类名称为“genericjdbc”。
- 对于“其他数据库 (ODBC)”连接器，类名称为“genericjdbc”。
如果现有工作簿或数据源文件已启用自定义项部分，Tableau 将仅使用它定义的自定义项，而不是 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 Driver”。
最后一部分列出了实际的连接自定义项。
这里有两个示例 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 参数。
注意：属性文件应采用 Latin-1 格式（请参见https://en.wikipedia.org/wiki/.properties(链接在新窗口中打开)）。但是，只要它仅包括 ASCII 字符，您就可以安全地以 UTF-8 格式保存文件，而无需 BOM（字节顺序标记）。
在文件中，将每个键值对放在其自己的行上，不带分隔符。为文件指定与相应连接器相同的名称，但具有“.properties””文件扩展名。例如，SAP HANA 连接器的属性文件将是“saphana.properties”。
安装 tdc 和属性文件
一旦创建了自定义文件（TDC 或属性），必须将其放置在特定的“Datasource”目录，以便 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 Web 制作：
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 Web 制作：
/var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/
将自定义 TDC 或属性文件保存到正确的位置并重新启动应用程序后，它们将应用于同一数据源类型的所有连接。