---
schema_version: "1"
id: f8bf11e27ebfd73640ca79deda77af3600a885977e12d4803fa912234d53d8a4
title: 自定义和调整连接
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/public/desktop/connect_customize.md
canonical_url: https://help.tableau.com/v0.0/public/desktop/zh-cn/connect_customize.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 2ab276c8f2f36497ccae55b7e9df94176a2a33020c5cdbcc3c17f19102a18c2d
description: Customize and tune ODBC and JDBC connections using TDC and properties files.
---
[跳转到主要内容](#main-content)

# 自定义和调整连接

您可以使用 TDC 文件自定义连接字符串的参数和连接的功能。这适用于 ODBC 和 JDBC 连接。

如果要自定义基于 JDBC 的连接，您也可以修改属性文件中的连接字符串参数。有关详细信息，请参见[使用属性文件来自定义 JDBC 连接](#Using)。

重要信息：TDC 文件可用于定制连接的功能或诊断和解决与连接数据相关的问题。Tableau 无法彻底测试您可能对这些文件进行的所有潜在修改。创建和使用 TDC 文件需要手动编辑，并且在将其部署到生产环境之前对其进行彻底测试至关重要。

## 使用 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](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 或属性文件保存到正确的位置并重新启动应用程序后，它们将应用于同一数据源类型的所有连接。

## 此部分中的其他文章