自訂原生連接器的連線字串

套用到： Tableau Desktop

有時您可能會想要修改使用原生連接器建立的連線。可以透過建立 TDC（Tableau 資料來源自訂）檔案來執行此操作，該檔案會使用 odbc-connect-string-extras 作為自訂將設定變更傳遞到連線。

本文適用於使用 ODBC 驅動程式的連接器。

重要資訊：TDC 檔案可用於自訂連線的功能或診斷和解決與連線資料相關的問題。Tableau 無法徹底測試可能對這些檔案進行的每項潛在修改。建立和使用 TDC 檔案需要手動編輯，並且在將它們部署到實際執行環境之前對其進行徹底測試至關重要。

修改連線字串

Tableau 使用 ODBC 驅動程式進行連線時，它會建立連線字串，並將其傳遞給驅動程式管理員。連線字串可識別驅動程式，並包含驅動程式的所有參數。

這是一個連線字串範例：

DRIVER=BagelDB Driver;SERVER=bageldb.lan;UID=creamcheese;PWD=bagel;

假設您想要使用 BagelDB 驅動程式 2.0 覆寫 BagelDB 驅動程式的 DRIVER 值，並新增連接埠號碼。傳遞給驅動程式管理員的連線字串將修改為：

DRIVER=BagelDB Driver 2.0;SERVER=bageldb.lan;UID=creamcheese;PWD=bagel;PORT=54321

可以使用 TDC 和 odbc-connect-string-extras 標記修改連線字串參數。一般來說，唯一可以被覆寫的參數是 DRIVER。其他參數會附加到連線字串的末尾。請參閱下面的「使用 TDC 檔案」。

附註：由於安全性限制，Tableau Online 上對 odbc-connect-string-extras 自訂的支援有限。某些參數可能不受支援。

使用允許清單來降低安全性風險

重要提示：下列程序需要由 Tableau Server 管理員在 Tableau Server 上完成，並且應由您的 IT 部門評估是否符合組織的安全性準則。

odbc-connect-string-extras 自訂可能會帶來安全性風險。Tableau Server 管理員可以透過在允許清單（也稱為安全性清單）中指定已核准的參數清單來管理此風險：

  • odbc-connect-string-extras 指定的任何不在清單中的參數都會被篩選掉。
  • 若清單中沒有指定參數，則允許使用所有參數。

允許清單為逗號分隔清單，中間沒有空格。

例如，要將參數 UseDeclareFetch 和 App 新增至允許清單，請執行下列命令：

tsm configuration set -k native_api.ODBCConnectStringSecurityList -v UseDeclareFetch,App --force-keys
tsm pending-changes apply

有關執行 tsm 命令的資訊，請參閱 Tableau Server 說明中的 tsm 命令列參考(連結在新視窗開啟)。

使用 TDC 檔案

TDC 檔案是一個 XML 檔案，其中包含廠商名稱、驅動程式名稱和 <connection-customization> 區段，該區段可以包含多種類型的自訂（連線字串和連線功能）。對於原生連接器，廠商名稱和驅動程式名稱必須符合連接器的類別名稱。有關值，請參閱下面的「原生連接器類別清單」。任何已啟用自訂區段的現有工作簿或資料來源檔案將僅使用內嵌自訂，而不是 TDC 檔案。

建立 TDC 檔案後，必須將其儲存到 Datasources 資料夾中，以便連線可以使用。若建立要發佈到 Tableau Server 的工作簿，或使用 Tableau Prep 或 Tableau Bridge，則也需要將 TDC 檔案儲存到這些產品的 Datasources 目錄中。有關更多資訊，請參閱安裝 tdc 和屬性檔案。

附註：若使用自訂 odbc-extras 建立資料來源或工作簿，則該資訊會內嵌到連線屬性中。因此，可以將工作簿或資料來源發佈到 Tableau Server，而無需在 Tableau Server 上安裝 TDC 檔案。

在 TDC 檔案中，可以使用 odbc-connect-string-extras 自訂來附加屬性或將 DRIVER 屬性覆寫到連線字串。

建立 TDC 檔案

  1. 開啟純文字編輯器，例如記事本或記事本++。
  2. 複製下面提供的範例中的資訊，將其貼上到文字檔案中，然後指定類別、廠商名稱和驅動程式名稱值。對於原生 Tableau 連接器，請對類別、廠商名稱和驅動程式名稱使用相同的值。
  3. 將具有 .tdc 副檔名的檔案（例如 mybagel.tdc）儲存到每個 Tableau 產品的 Datasources 資料夾中。有關更多資訊，請參閱安裝 tdc 和屬性檔案。
  4. 輸入想要對連線進行的自訂。

 

<connection-customization class='bagelDB' enabled='true' version='19.1'>
<vendor name='bagelDB' />
<driver name='bagelDB' />
 <customizations>
   <customization name='odbc-connect-string-extras' value='DRIVER=BagelDB Driver 2.0;PORT=54321' />
 </customizations>
</connection-customization>

原生連接器類別清單

在下面的清單中找到您的連接器（以 <連接器>:<類別> 格式列出），以取得自訂 TDC 檔案所需的類別值。

  • Actian Matrix: paraccel
  • Actian Vector: vectorwise
  • Amazon Aurora: aurora
  • Amazon EMR (Hive): awshadoophive
  • Amazon Redshift: redshift
  • Spark SQL: spark
  • Aster Database: asterncluster
  • Azure SQL Data Warehouse: azure_sql_dw
  • Cloudera Hadoop: hadoophive
  • Denodo: denodo
  • Exasol : exasolution
  • Firebird : firebird
  • Google Cloud SQL: googlecloudsql
  • Hortonworks Hadoop Hive: hortonworkshadoophive
  • IBM: BigInsights bigsql
  • IBM DB2: db2
  • IBM PDA (Netezza): netezza
  • Kognitio: kognitio
  • MapR Hadoop Hive: maprhadoophive
  • MariaDB: mariadb
  • MarkLogic: marklogic
  • MemSQL: memsql
  • Microsoft SQL Server: sqlserver
  • MonetDB: monetdb
  • MongoDB BI Connector: mongodb
  • MySQL: mysql
  • Oracle Essbase: essbase
  • Other Databases (ODBC): genericodbc
  • Pivotal Greenplum Database: greenplum
  • PostgreSQL: postgres
  • Presto: presto
  • Progress OpenEdge: progressopenedge
  • SAP HANA: saphana
  • SAP Sybase ASE: sybasease
  • SAP Sybase IQ: sybaseiq
  • Snowflake: snowflake
  • Splunk: splunk
  • Teradata: teradata
  • Tibco Data Virtualization: composite
  • Vertica: vertica

另請參閱

其他資料庫 (ODBC) – 描述如何使用 ODBC 連接器連線到資料。

範例：自訂 ODBC 連線 - 逐步流程，顯示如何完成功能和 ODBC 連線字串的自訂。

Tableau 和 ODBC – 提供有關 ODBC 的背景資訊，描述 Tableau 如何確定 ODBC 驅動程式的功能，並列出常見問題。

Tableau 功能自訂參考 - 列出可用於定義資料來源支援的 Tableau 功能的自訂項。

ODBC/SQL 自訂項參考 - 列出自訂項，這些自訂項表示 ODBC 驅動程式報告支援的部分 ODBC 和 SQL 標準。

返回頂端
感謝您的意見反應！已成功提交您的意見回饋。謝謝！