自訂和調整連線
可以使用 TDC 檔案對連線字串的參數和連線的功能進行自訂。這適用於 ODBC 和 JDBC 連線。
要自訂基於 JDBC 的連線,也可以修改屬性檔案中的連線字串參數。有關詳細資訊,請參閱使用屬性檔案自訂 JDBC 連線。
使用 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(連結在新視窗開啟))。但是,只要它只包含 ASCII 字元,就可以安全地以 UTF-8 格式儲存檔案,而無需使用 BOM(位元組順序標記)。
在檔案中,將每個鍵-值放在個別的行,不使用分隔符號。為檔案指定與相應連接器相同的名稱,但使用「.properties」副檔名。例如,SAP HANA 連接器的屬性檔案為「saphana.properties」。
安裝 tdc 和屬性檔案
建立自訂檔案(TDC 或屬性)後,必須將其放置在特定的 Datasources
目錄中,以便 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 或屬性檔案儲存到正確位置,並重新啟動應用程式後,它們將套用於相同資料來源類型的所有連線。