---
schema_version: "1"
id: d5a7cce61b0b0cd728200476ea8cfdc4d4e1a830843f193d36731953e2f021b6
title: 與 Bridge 的連線
collection: tableau
version: next
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/next/zh-tw/online/to_sync_local_data.md
canonical_url: https://help.tableau.com/v0.0/online/zh-tw/to_sync_local_data.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 53f727e55767e0eb72d9b50f07fe9ec5046b2da478df1fca9769b8ac4ac113d5
description: Understand Tableau Bridge connectivity with private network data.
---
[跳至主要內容](#main-content)

# 與 Bridge 的連線

資料來源或虛擬連線連線到 Tableau Cloud 無法直接存取的私人網路資料時，Tableau Bridge 可用於加速連線。

## 連線類型

Tableau Bridge 支援內部部署資料或防火牆後面的虛擬雲端中的資料。資料的範圍可以是私人網路上的 CSV 檔案或資料倉儲中儲存的資料。

對於 Tableau Cloud 可以直接存取的雲端資料，直接使用 Tableau Cloud 設定重新整理排程幾乎始終是更好的選擇。例如，您可能能夠連線至雲端平台上託管的 MySQL 資料庫。在這種情況下，您可以為直接透過 Tableau Cloud 連線至此類資料的擷取設定重新整理排程。

**擷取重新整理**

資料來源或虛擬連線使用擷取連線到私人網路資料時，Bridge 可用於執行這些擷取的排程重新整理。在大多數情況下，作為發佈流程的一部分，內容擁有者可以排程重新整理。有關擷取重新整理要求，請參閱[擷取連線的其他要求](https://help.tableau.com/current/online/zh-tw/to_bridge_client.htm#conn_extract)。

**即時連線**

Bridge 使用稱為即時查詢的功能支援資料來源或虛擬連線與私人網路資料的即時連線。若內容擁有者發佈的資料來源或虛擬連線使用即時連線來連線至 Tableau Cloud 偵測到其無法直接存取的資料，則會自動使用即時查詢。有關即時查詢要求，請參閱[即時連線的其他要求](https://help.tableau.com/current/online/zh-tw/to_bridge_client.htm#conn_live)。

- Bridge 不支援某些雲端資料來源的即時連線。其中包括 Google Cloud SQL、OData 和 Progress OpenEdge。使用擷取連線將資料保持為最新狀態。
- Bridge 不支援某些基於私人雲端資料來源的即時連線。其中包括 Google 雲端硬碟、Box、OneDrive、Dropbox 和 Azure Data Lake Storage Gen2。使用擷取連線將資料保持為最新狀態。
- 不支援與基於檔案資料的即時連線，例如 CSV、文字、Excel、統計 (.sas7bdat) 檔案。

**虛擬連線**

Bridge 支援虛擬連線，提供可共用的資料集中存取點。

- 不支援 Snowflake 用於虛擬連線。
- 與 Tableau Bridge 一起使用時，不支援虛擬連線的 OAuth。

**檔案資料**

Windows 用戶端與 Bridge for Linux for Containers 支援檔案資料的最新版本，包括 CSV、Excel、文字和統計 (.sas7bdat)、PDF 與空間檔案。

- 支援已發佈資料來源檔案的資料擷取重新整理。我們建議使用 UNC 格式進行檔案資料連線。如果要連線至本機檔案路徑，則必須使用預設集區。
- 支援嵌入式資料來源檔案的資料擷取重新整理。必須使用已設定的嵌入式資料來源集區，且檔案路徑必須使用 UNC 格式。
- 不支援檔案共用上 Hyper 檔案的資料擷取重新整理和即時查詢。
- 直接從瀏覽器上傳工作簿時，連線到一般檔案的資料來源無法進行擷取重新整理。
- 不支援與基於檔案資料的即時連線。
- Prep Conductor 流程不支援使用 Bridge 重新整理平面檔案資料。若要成功重新整理 Prep Conductor 流程，請將一般檔案移動至 Tableau Cloud 可直接存取的位置（Google 雲端硬碟、Box、Dropbox 等）。

**與基於多維資料集資料的連線**

不支援基於多維資料集資料。

**內嵌資料來源**

Tableau Bridge 支援工作簿中內嵌的資料來源。

- 不支援 CSV、文字、Excel、統計 (.sas7bdat) 檔案等檔案資料的即時連線。
- 預設集區不支援嵌入的資料來源。必須使用已設定的集區。有關詳情，請參閱[設定 Bridge 用戶端集區](https://help.tableau.com/current/online/zh-tw/to_enable_bridge_live_connections.htm)。

**已發佈資料來源**

已發佈資料來源的排程擷取不支援多個集區。

**Tableau Prep Builder**

從版本 2025.1 開始不支援透過 Tableau Bridge 進行 Tableau Prep 的私人網路連線。Tableau Bridge 用戶端必須設定為使用 Bridge 用戶端集區（而非預設集區）。有關詳情，請參閱[設定 Bridge 用戶端集區](https://help.tableau.com/current/online/zh-tw/to_enable_bridge_live_connections.htm)。

可以使用 Tableau Bridge 用戶端連線到 Tableau Cloud 中的資料並重新整理資料。有關詳細資訊，請參閱 [從 Tableau Prep Builder 發佈流程](https://help.tableau.com/current/prep/zh-tw/prep_conductor_publish_flow.htm#publish-a-flow-from-tableau-prep-builder)的 Tableau Cloud 部分中的「資料庫」。

從版本 2026.2 開始，在 Tableau Cloud 上編輯 Tableau Prep 流程時，可透過 Tableau Bridge 連線至內部部署且含有變數與參數的 SAP HANA 資料來源。有關詳細資訊，請參閱[連線到資料](https://help.tableau.com/current/prep/zh-tw/prep_connect.htm#connect-via-builtin-connectors-for-popular-data-types)中的「連線到 SAP HANA 資料」。

Bridge 不支援以下功能：

- 執行 Tableau Prep Conductor 來重新整理連線到一般檔案的 Tableau Prep 流程。
    
    若要成功重新整理 Prep Conductor 流程，請將一般檔案移動至 Tableau Cloud 可直接存取的位置（Google 雲端硬碟、Box、Dropbox 等）。
- 使用適用於 Prep Conductor 的 Bridge [將輸出資料寫入外部資料庫](https://help.tableau.com/current/prep/zh-tw/prep_save_share.htm#write_to_DB) 。
- 連線到 Snowflake。

**使用者屬性函數**

Tableau Bridge 工作流程不支援[使用者屬性函數](https://help.tableau.com/current/api/embedding_api/zh-tw/docs/embedding_api_user_attributes.html)。

## 連接器和資料類型

Bridge 支援 [Tableau Desktop](https://help.tableau.com/current/pro/desktop/zh-tw/exampleconnections_overview.htm) 和 [Tableau Cloud](https://help.tableau.com/current/online/zh-tw/to_connect_live_sql.htm#connectors) 支援的連接器組合。下面列出了不支援的連接器以及連接器和資料類型的限制。

**包含外部檔案**

不支援包含外部檔案。請參閱下方的[連線至一般檔案和基於檔案的擷取](#remote-share)。

**私人雲端資料**

在大多數情況下，Tableau Cloud 會自動偵測 Bridge 用戶端。在某些情況下，可能需要手動設定連線，以確保使用 Bridge。有關詳情，請參閱[連線到私人雲端資料](https://help.tableau.com/v0.0/online/zh-tw/to_bridge_vpc.htm)。

**不支援的連接器**

- 不支援由不在 Tableau Exchange 上的第三方所建置的連接器。
- 不支援某些 Exchange 連接器。請參閱下面的部分。
- AWS S3
- Microsoft Analysis Services。
- Microsoft PowerPivot。
- Oracle Essbase。
- SAP NetWeaver Business Warehouse。

**Exchange 連接器**

Tableau Bridge 可用於使用 [Tableau Exchange 連接器頁面](https://exchange.tableau.com/connectors)中可用的選擇連接器來查詢資料 。支援的 Exchange 連接器如下所示：

- Actian JDBC
- Actian ODBC
- 適用於 ClickHouse 的 Altinity 連接器
- AtScale
- Clickhouse
- Couchbase Analytics
- Data Virtuality JDBC
- dbt 語意層
- Denodo JDBC
- Dr.Sum JDBC
- Exasol JDBC
- Firebolt
- Guidanz BI 連接器
- Incorta
- Jethro ODBC
- Looker
- MongoDB SQL 介面
- MotherDuck/DuckDB
- Oracle NetSuite
- Palantir Foundry
- REST API 連接器
- Salesforce Commerce Cloud Intelligence
- Salesforce Marketing Cloud
- SAP SuccessFactors
- ServiceNow
- SharePoint 清單 (JDBC)
- SingleStoreDB JDBC
- StarRocks
- Starburst
- Stratio Crossdata

Actian JDBC、Altinity Connector for ClickHouse、Guidanz BI Connector、Couchbase Analytics、Stratio Crossdata、Data Virtuality JDBC、Jethro ODBC、Oracle NetSuite、SAP SuccessFactors、ServiceNow 與 SingleStoreDB JDBC。

要將 Exchange 連接器與 Tableau Bridge 結合使用，請針對集區中將存取目標資料來源的每個 Exchange 連接器和每個 Bridge 用戶端執行下列步驟。

1. 從 [Tableau Exchange 連接器頁面](https://exchange.tableau.com/connectors)中下載 .taco 文件 。
2. 將 .taco 檔案新增至 Tableau 連接器資料夾：
    
    - 在 Windows 上：`C:\Users[Windows User]\Documents\My Tableau Bridge Repository\Connectors`
    - 在 Linux 上：`/root/Documents/My_Tableau_Bridge_Repository/Connectors`
    - 如果是資料連線，執行以下命令在基礎映像中建立 Connector 目錄： `mkdir -p /home/tableau/Documents/My_Tableau_Bridge_Repository/Connectors`
3. 請按照 Tableau Exchange 上您連接器的說明下載所需的驅動程式。
4. 在 Bridge 用戶端上安裝驅動程式。
5. 重啟 Bridge 用戶端。

**不支援即時連線的連接器**

- Google Cloud SQL
- OData
- Progress OpenEdge
- 一般檔案

**SAP HANA**

支援標準設定。

**Snowflake**

不支援 Snowflake 用於虛擬連線。

**多連線資料來源中使用的資料**

Tableau Bridge 可用於重新整理跨資料庫聯結的資料來源。工作簿或資料來源中定義的資料庫連線決定了在 Tableau Cloud 上發佈資料並使資料保持最新的方法。只要所有單獨的資料連線都是 Tableau Bridge 可以重新整理的類型，就可以重新整理跨資料庫聯結的資料來源。

**其他資料庫**

- Tableau 為使用 JDBC 的連線提供有限的客戶支援。請參閱 [Tableau 對其他資料庫 (JDBC) 連線的支援](https://help.tableau.com/current/pro/desktop/zh-tw/examples_otherdatabases_jdbc.htm#tableau-support-for-other-databases-jdbc-connections)。
- Tableau 為使用 ODBC 的連線提供有限的客戶支援。請參閱 [Tableau 對其他資料庫 (ODBC) 連線的支援](https://help.tableau.com/current/pro/desktop/zh-tw/examples_otherdatabases.htm#tableau-support-for-other-databases-odbc-connections)。

**Web 資料連接器**

- Bridge 無法連線到 Web 資料連接器 3.0 中的資料。有關詳細資料，請參閱[使用 Web 資料連接器 3.0 SDK 建置的連接器](https://help.tableau.com/current/pro/desktop/zh-tw/examples_wdc_connector_sdk.htm)。
- 從 2023.1 版本開始，Web 資料連接器 2.0 已棄用。請參閱 [Web 資料連接器 2.0](https://help.tableau.com/current/pro/desktop/zh-tw/examples_web_data_connector.htm)。
- Tableau 不支援寫入到 WDC API 介面的連接器或其他程式。

## 使用 Tableau Bridge 進行 Web 製作

在 Tableau Cloud 內製作資料檢視或直接在 Web 上工作時，Tableau Bridge 可為各種資料庫和雲端資料環境提供完整的查詢支援：

- **具名連接器**：可以在 Web 製作工作階段期間直接為 Tableau Cloud 連線窗格中公開的任何受支援的具名連接器建立全新的資料連線。
- **非命名/一般連接器**：修改已指向功能正常、預先存在的 Bridge 支援架構的內容時，Web 製作與某些非命名資料庫連接器完全相容。這包含：
    
    - 「編輯資料來源」選項可能不適用於所有未命名的連接器。
    - 在現有且正常運作的雲端工作簿中編輯內嵌資料來源。

Tableau 並非在所有方案中都支援透過 Web 製作編輯已發布資料來源。限制如下：

- **「編輯資料來源」**選項可能無法用於使用未命名（通用）連接器的已發佈資料來源。該按鈕顯示為灰色。
- 目前不支援編輯包含與 Bridge 資料來源的多個連線的即時已發布資料來源，並將導致錯誤。

### Bridge 智慧體要求

必須連線使用中的 Bridge 用戶端並將其指派到集區，Web 製作工作階段才能正常工作。如果智慧體不可用，Tableau Cloud 可能會嘗試直接連線到資料庫。

此後援行為可以：

- 觸發掩蓋真正原因（Bridge 智慧體遺失或離線）的一般連線錯誤。
- 導致要求所有流量都透過 Bridge 路由以確保私人網路安全的組織出現意外故障。

為防止出現意外錯誤，請在開始 Web 製作工作階段之前驗證至少有一個 Bridge 用戶端在線並集區。

### 作業先決條件

為確保無縫的 Web 編輯功能，網站管理員必須驗證以下基準先決條件：

- 路由規則對齊：無論何種使用情境，目標資料庫網域或主機位址，都必須已正式註冊至明確建立的 Tableau Bridge 具名集區中。
- 驅動程式適用性：如果是資料庫的編輯作業，須在執行中 Bridge 用戶端的實體主機上，手動安裝目標基礎架構對應的資料庫驅動程式。
- Proxy 和網路規則：在專用或受限的私有雲端設定中，可能需要發佈資料來源。有關詳細資訊，請參閱[連線到私人雲端資料](https://help.tableau.com/v0.0/online/zh-tw/to_bridge_vpc.htm) 。
- 工作階段逾時限制：Web 上的所有 Web 製作互動、資料查詢工作階段和大量分析修改仍受標準 Tableau Cloud 作業護欄的約束，包括 2 小時的處理逾時。

### 使用 Bridge 進行 Web 製作期間出現錯誤

Web 製作失敗期間顯示的錯誤訊息可能無法明確指出與 Bridge 相關的問題。常見情況如下：

- 網路或登入逾時錯誤（例如，「發生了與網路相關或特定於執行個體的錯誤」或「登入逾時」）可能表示 Tableau Cloud 退回到直接連線嘗試，而不是透過 Bridge 路由。請驗證 Bridge 用戶端是否已連線並指派到正確的集區。
- **NO\_POOLED\_AGENTS\_ASSIGNED\_NAMED\_POOL** 錯誤表示沒有 Bridge 代理程式指派給為站台設定的命名集區。請指派一個使用中 Bridge 用戶端，以解決此問題。
- 若**「編輯資料來源」**按鈕顯示為灰色，則表示資料來源使用未命名連接器，目前不支援透過 Web 製作進行編輯。

## 針對 Linux 的 Bridge

Tableau Bridge 支援專為容器工作負載設計的基於 Linux 的作業系統。限制與差異包括：

- 適用於 Linux 的 Bridge 不支援舊版排程。
- 在背景中執行的適用於 Linux 的 Bridge，這相當於 Windows 上 Tableau Bridge 中的服務模式。
- 要儲存記錄檔，請在 docker 容器和本機檔案系統之間複製檔案或資料夾。
- 目前，針對 Linux 的 Bridge 透過使用 Docker 可執行檔在正在執行的容器中執行命令來安裝。
- 適用於 Linux 的 Bridge 不支援 Window 整合驗證。
- 適用於 Linux 的 Bridge 僅支援具有 Linux 驅動程式的 Exchange 連接器。

### 連線至一般檔案和基於檔案的擷取

自 2025 年 2 月發行本開始，可以設定 Bridge for Linux 以連線到遠端共用。

與有時可以「包含外部檔案」作為靜態上傳的工作簿不同，連線到一般檔案的已發佈資料來源需要 Tableau Bridge 執行所有重新整理活動：

- Tableau Cloud 不支援在獨立的已發佈資料來源中內嵌一般實體檔案。
- 發佈時，請確保資料來源指向完整 UNC 路徑（例如，\\\\InternalServer\\Data\\file.xlsx）。若在發佈獨立來源時選取「包括外部檔案」，可能會導致 Bridge 在不存在的臨時雲端目錄中尋找該檔案，從而導致重新整理失敗。

發佈用於 Bridge 重新整理的獨立資料來源時，請務必取消核取「包含外部檔案」。

![](/tableau/next/zh-tw/online/zh-tw/Img/to_bridge_liinux_map_drive_557x470.png "為")

#### 設定遠端共用

1. 建立並設定遠端共用的存取權限。例如，`SharedWB_1`。該計算機 host1 的最終 UNC 路徑為 `//host1/SharedWB_1`。
2. 在執行 Bridge 用戶端的主機上，將遠端共用掛載到本機檔案系統上。例如，`/mnt/remotes/H1_WB`。
3. 在文字檔案中，使用以下格式建立 UNC 對應： `//<remote UNC>:/<local mount>`。例如，`//host1/SharedWB_1:/mnt/remotes/H1_WB`。
4. 透過在 Docker 檔案中包含以下內容來配置 Docker 包含的遠端共用。下面的範例遠端共享配置與上圖相對應。
    
    dnf install -y cifs-utils
    export CRED=/mnt/remotes/creds/
    mkdir -p $CRED && chmod 700 $CRED
    
    # Prepare credential files for host\_1 ($CRED/.h1) and host\_2 ($CRED/.h2)
    #    credential file format should be:
    #          username=...
    #          password=...
    chmod 600 $CRED/.h1
    chmod 600 $CRED/.h2
    
    # Add these CIFS entries to /etc/fstab (this will be automatically mounted on
    # reboot)
    cat >> /etc/fstab << EOE
    //host\_1/SharedWB\_1    /mnt/remotes/H1\_WB    cifs    credentials=/mnt/remotes/creds/.h1    0    0
    //host\_1/SharedDS\_1    /mnt/remotes/H1\_DS    cifs    credentials=/mnt/remotes/creds/.h1    0    0
    //host\_2/SharedWB\_1    /mnt/remotes/H2\_WB    cifs    credentials=/mnt/remotes/creds/.h2    0    0
    //host\_2/SharedDS\_1    /mnt/remotes/H2\_DS    cifs    credentials=/mnt/remotes/creds/.h2    0    0
    EOE
    
    # and mount fstab entries
    mount /mnt/remotes/H1\_WB
    mount /mnt/remotes/H1\_DS
    mount /mnt/remotes/H2\_WB
    mount /mnt/remotes/H2\_DS
    
    # Create the UNC map file
    cat > /mnt/remotes/uncmap << EOM
    //host\_1/SharedWB\_1:/mnt/remotes/H1\_WB
    //host\_1/SharedDS\_1:/mnt/remotes/H1\_DS
    //host\_2/SharedWB\_1:/mnt/remotes/H2\_WB
    //host\_2/SharedDS\_1:/mnt/remotes/H2\_DS
    EOM
    						
    
    Bridge 用戶端會定期讀取 UNC 映射檔來檢查是否有變更。為了避免 Bridge 在變更後重新啟動，請將掛載目錄和 UNC 對應檔案的位置儲存在相同目錄中。
5. 執行以下內容完成設定：
    
    docker container run \\
    ...
    -e TABLEAU\_BRIDGE\_UNC\_MAP\_OVERRIDE='/mnt/remotes/uncmap' \\
    --mount type=bind,source="/mnt/remotes",target=/mnt/remotes \\
    ...

## 驗證

必須為該站台啟用已連線的用戶端選項，以便 Bridge 用戶端可以執行無人作業，且若已啟用，還支援使用 Tableau 驗證的多重要素驗證。若已停用該站台的已連線用戶端，Bridge 僅能支援 Tableau 使用者名稱和密碼驗證。

**OAuth**

- Windows 版 Tableau Bridge 和 Linux 版 Bridge 不支援針對 Azure SQL、Azure Synapse 和 Dremio 的 OAuth。
- 支援針對 Google 雲端硬碟和 OneDrive 的具有內嵌資料來源和已發佈資料來源的 OAuth。
- 將自己的身分提供程式 (IdP) 與 Amazon Athena 連接器結合使用時，必須設定 OAuth 用戶端設定檔。請參閱[將您自己的身分提供程式與 Amazon Athena 結合使用](https://help.tableau.com/current/pro/desktop/zh-tw/amazon_athena_idp.htm)。

**Windows 驗證**

要求 Windows 使用者帳戶必須是電腦上本機管理員群組的成員才能在服務模式執行用戶端。如果使用者不是本機管理員，他們可以在應用程序模式下執行 Bridge 用戶端，但他們必須保持登入到 Windows 計算機。

**Kerberos**

Windows 中的 Bridge 透過「run-as」帳戶支援整合的 Windows 驗證，適用於檔案與某些資料庫。

## 此區段的其他文章