自訂和調整連線

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

如果要自訂一個以 JDBC 為基礎的連線,也可以在 PROPERTY 檔案中自行定義。有關詳細資訊,請參見使用 PROPERTIE 檔案來自訂 JDBC 連線

使用 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/

將檔案儲存到正確位置後,檔案中的屬性會套用到所有相同資料來源類型的 JDBC 連線。

使用以 JDBC 為基礎的連線發佈工作簿

要從 JDBC 基礎連線發布工作簿,Tableau Desktop 和 Tableau Server 電腦都必須包含 PROPERTIES 檔案副本。

另請參閱

自訂原生連接器的連線字串(連結在新視窗開啟) – 這篇 Tableau 社群的文章會說明如何使用 odbc-connect-string-extras 自訂項來修改透過原生連接器建立的連線。

此區段的其他文章

感謝您的意見回饋!