Tableau Desktop 和 Web 製作說明

您可以使用 TDC 檔案自訂連線。

若要自訂基於 JDBC 的連線，還可以在 PROPERTY 檔案中進行自訂。有關詳細資訊，請參見使用 PROPERTIE 檔案來自訂 JDBC 連線。

關於特殊字元

必須正確逸出特殊字元，是否有必要要看字元的具體位置。例如，如果該值中包含一個等號「=」，則在等號「=」右側必須逸出。

範例：

ServiceLocation=Region=east;Name=prod;

應寫為： ServiceLocation=Region\=east;Name\=prod;

使用 TDC 檔案來自訂連線

TDC（Tableau 資料來源自訂）檔案是帶有副檔名「.tdc」的 XML 檔案。TDC 檔案用於自訂特定 Tableau 的設定。要建立以 ODBC 為基礎的連線，也可以使用 TDC 檔案來定義 ODBC 驅動程式支援的 ODBC 和 SQL 標準部分。

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

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

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

• 類別 您要連線並自訂的資料來源。
• 已啟用 指定是否套用 TDC 檔案連線自訂項。在 TDC 檔案中，一律設為「true」。
• 版本 Tableau 會忽略版本號。

下一節非常重要，因為它可針對此 TDC 檔案資料來源，識別其資料庫提供者的供應商名稱和驅動程式名稱。每個 TDC 檔案只能繫結至一個資料來源類型。對於原生資料來源，這些名稱必須同時符合資料來源類別名稱；例如，Teradata 連線的名稱為「teradata」。對於 ODBC 資料來源，TDC 檔案的供應商名稱和驅動程式名稱必須與資料庫和驅動程式向 Tableau 報告的名稱相符；例如，分別為「SQLite」和「SQLite3 ODBC Driver」。

最後一個部分列出了實際的連線自訂項。

有關詳情，請參閱 Tableau JDBC 能力自訂項。

使用 PROPERTIES 檔案自訂 JDBC 連線

屬性檔由 JDBC 使用，並直接傳送到 JDBC 驅動程式。這些是有「.properties」副檔名的純文字檔案。它們包含每個連線參數的機碼值組。

使用具有 JDBC 連線的 PROPERTIES 檔案類似將 TDC 檔案的 odbc-connect-string-extras 參數用於 ODBC 連線。

附註：PROPERTIES 檔案應使用 Latin-1 格式（請參閱 https://en.wikipedia.org/wiki/.properties(連結在新視窗開啟))。但是，只要它只包含 ASCII 字元，就可以安全地以 UTF-8 格式儲存檔案，而無需使用 BOM（位元組順序標記）。

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

• 對於 Tableau Desktop，將 PROPERTIES 檔案放在此目錄中：

  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/

• 如果是 Prep 流程，請在這些目錄中放入「PROPERTIES」檔案：

  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

• 如果是虛擬連線，請在此目錄中放入「PROPERTIES」檔案：

  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 自訂項來修改透過原生連接器建立的連線。

此區段的其他文章