---
schema_version: "1"
id: 70b9f228cc0db596a1370599a6a07a99ee4388109b8f9b47f8c58ff63775f918
title: 自訂和調整連線
collection: tableau
version: next
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/next/zh-tw/public/desktop/connect_customize.md
canonical_url: https://help.tableau.com/v0.0/public/desktop/zh-tw/connect_customize.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 52ec6140b4ac28085ac895f7ad52bfa9dbc21e310a199a07531f85823bad1be2
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 檔案。TDC 檔案用於自訂特定 Tableau 的設定。要建立以 ODBC 為基礎的連線，也可以使用 TDC 檔案來定義 ODBC 驅動程式支援的 ODBC 和 SQL 標準部分。

TDC 檔案包含廠商名稱、驅動程式名稱和 `<connection-customization>`（也包括類別）區段。對於內置連接器，供應商名稱和驅動程式名稱必須符合連接器的類別名稱。通常，供應商名稱與驅動程式名稱相符。「其他資料庫」連接器使用兩個通用的類別名稱：

- 對於其他資料庫 (JDBC) 連接器，類別名稱為「genericjdbc」。
- 對於其他資料庫 (ODBC) 連接器，類別名稱為「genericodbc」。

若現有工作簿或資料來源檔案已啟用自訂部分，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` 部分包括以下內容：

- **類別**：您要連線並自訂的資料來源。
- **已啟用**：指定是否套用 TDC 檔案連線自訂項。在 TDC 檔案中，一律設為「true」。
- **版本**：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 連線類似於將 TDC 檔案中的 `odbc-connect-string-extras` 參數用於 ODBC 連線。

**附註：**屬性檔案應採用 Latin-1 格式（請參閱 [https://zh.wikipedia.org/zh-tw/.properties](https://zh.wikipedia.org/zh-tw/.properties))。但是，只要它只包含 ASCII 字元，就可以安全地以 UTF-8 格式儲存檔案，而無需使用 BOM（位元組順序標記）。

在檔案中，將每個鍵-值放在個別的行，不使用分隔符號。為檔案指定與相應連接器相同的名稱，但使用「.properties」副檔名。例如，SAP HANA 連接器的屬性檔案為「saphana.properties」。

## 安裝 tdc 和屬性檔案

建立自訂檔案（TDC 或屬性）後，必須將其放置在特定的「資料來源」目錄中，以便 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**：
- 伺服器：`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**：
- 伺服器：`/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 或屬性檔案儲存到正確位置，並重新啟動應用程式後，它們將套用於相同資料來源類型的所有連線。

## 此區段的其他文章