Tableau Desktop 和 Web 製作說明

可以使用 TDC 檔案對連線字串的參數和連線的功能進行自訂。這適用於 ODBC 和 JDBC 連線。

要自訂基於 JDBC 的連線，也可以修改屬性檔案中的連線字串參數。有關詳細資訊，請參閱使用屬性檔案自訂 JDBC 連線。

重要資訊：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>

有關可用自訂的更多資訊，請參閱：

• Tableau JDBC 功能自訂

• Tableau 功能自訂參考

• ODBC/SQL 自訂項參考

使用屬性檔案自訂 JDBC 連線

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

將屬性檔案用於 JDBC 連線類似於將 TDC 檔案中的 odbc-connect-string-extras 參數用於 ODBC 連線。

附註：屬性檔案應採用 Latin-1 格式（請參閱 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 或屬性檔案儲存到正確位置，並重新啟動應用程式後，它們將套用於相同資料來源類型的所有連線。

此區段的其他文章