---
schema_version: "1"
id: 6b219c4a9c241d4f5b790cc0ca2f157533dab19e8f1a66e2f363b9f614495b24
title: 与 Bridge 的连接
collection: tableau
version: current
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/current/zh-cn/online/to_sync_local_data.md
canonical_url: https://help.tableau.com/current/online/zh-cn/to_sync_local_data.htm
source_site: help.tableau.com
content_type: documentation
content_hash: fc142c766db897db9506d2f6f219e8284421ccfbfecd14dda8d4b7ed9d98ad43
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-cn/to_bridge_client.htm#conn_extract)。

**实时连接**

Bridge 使用一种称为实时查询的功能，支持与私有网络数据进行实时连接的数据源或虚拟连接。如果内容所有者发布的数据源或虚拟连接使用实时连接来连接到 Tableau Cloud 检测到它无法直接访问的数据，则会自动使用实时查询。有关实时查询要求，请参见[针对实时连接的额外要求](https://help.tableau.com/current/online/zh-cn/to_bridge_client.htm#conn_live)。

- 对于某些云数据源，Bridge 不支持实时连接。其中包括 Google Cloud SQL、OData 和 Progress OpenEdge。使用数据提取连接来使数据保持最新。
- 对于某些基于私有云的数据源，Bridge 不支持实时连接。其中包括 Google Drive、Box、OneDrive、Dropbox 和 Azure Data Lake Storage Gen2。使用数据提取连接来使数据保持最新。
- 不支持与基于文件的数据（例如 CSV、文本、Excel、统计数据 (.sas7bdat)）的实时连接。

**虚拟连接**

Bridge 支持提供可共享的数据中央访问点的虚拟连接。

- 与虚拟连接一起使用时，不支持 Snowflake。
- 与 Tableau Bridge 一起使用时，不支持虚拟连接的 OAuth。

**文件数据**

最新版本的 Windows 客户端以及适用于容器的 Linux 版 Tableau Bridge 支持提取文件数据，包括 CSV、Excel、文本和统计 (.sas7bdat)、PDF 和空间文件。

- 支持已发布数据源文件的数据提取刷新。我们建议为文件数据连接使用 UNC 格式。如果您要连接到本地文件路径，则必须使用“默认”池。
- 支持嵌入式数据源文件的数据提取刷新。您必须对嵌入式数据源使用已配置的池，并且文件路径必须使用 UNC 格式。
- 不支持文件共享上的 Hyper 文件的数据提取刷新和实时查询。
- 直接从浏览器上载工作簿时，无法为连接到平面文件的数据源执行数据提取刷新。
- 不支持基于文件的数据的实时连接。
- 对于 Prep Conductor 流程，不支持使用 Bridge 刷新平面文件数据。若要成功刷新 Prep Conductor 流程，请将平面文件移动到 Tableau Cloud 可直接访问的位置（Google Drive、Box、Dropbox 等）。

**与基于多维数据集的数据的连接**

不支持基于多维数据集的数据。

**嵌入式数据源**

Tableau Bridge 支持嵌入工作簿中的数据源。

- 对于 CSV、文本、Excel、统计 (.sas7bdat) 等文件数据，不支持实时连接。
- 默认池不支持嵌入式数据源。您必须使用已配置的池。有关详细信息，请参见[配置 Bridge 客户端池](https://help.tableau.com/current/online/zh-cn/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-cn/to_enable_bridge_live_connections.htm)。

您可以使用 Tableau Bridge 客户端连接到 Tableau Cloud 中的数据并刷新数据。有关详细信息，请参见 [从 Tableau Prep Builder 发布流程](https://help.tableau.com/current/prep/zh-cn/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-cn/prep_connect.htm#connect-via-builtin-connectors-for-popular-data-types)中的“连接到 SAP HANA 数据”。

Bridge 不支持以下操作：

- 运行 Tableau Prep Conductor 来刷新连接到平面文件的 Tableau Prep 流程。
    
    若要成功刷新 Prep Conductor 流程，请将平面文件移动到 Tableau Cloud 可直接访问的位置（Google Drive、Box、Dropbox 等）。
- 使用 Bridge 为 Prep Conductor 流程[将输出数据写入外部数据库](https://help.tableau.com/current/prep/zh-cn/prep_save_share.htm#write_to_DB)。
- 连接到 Snowflake。

**用户属性函数**

Tableau Bridge 工作流中不支持[用户属性函数](https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html)。

## 连接器和数据类型

Bridge 支持 [Tableau Desktop](https://help.tableau.com/current/pro/desktop/zh-cn/exampleconnections_overview.htm) 和 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/to_connect_live_sql.htm#connectors) 支持的连接器组合。下面列出了不支持的连接器以及连接器和数据类型的限制。

**包括外部文件**

不支持“包括外部文件”。请参见下面的[连接到平面文件和基于文件的数据提取](#remote-share)。

**私有云数据**

大多数情况下，Tableau Cloud 会自动检测 Bridge 客户端。但是，在某些情况下，您可能需要手动配置连接，以确保使用 Bridge。有关详细信息，请参见[连接到私有云数据](https://help.tableau.com/current/online/zh-cn/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
- Altinity Connector for ClickHouse
- AtScale
- Clickhouse
- Couchbase Analytics
- Data Virtuality JDBC
- dbt Semantic Layer
- Denodo JDBC
- Dr.Sum JDBC
- Exasol JDBC
- Firebolt
- Guidanz BI 连接器
- Incorta
- Jethro ODBC
- Looker
- MongoDB SQL Interface
- 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-cn/examples_otherdatabases_jdbc.htm#tableau-support-for-other-databases-jdbc-connections)。
- Tableau 为使用 ODBC 的连接提供有限的客户支持。请参见 [Tableau 对“其他数据库 (ODBC)”连接的支持](https://help.tableau.com/current/pro/desktop/zh-cn/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-cn/examples_wdc_connector_sdk.htm)。
- 自 2023.1 版本起，Web 数据 2.0 已弃用。请参见 [Web 数据连接器 2.0](https://help.tableau.com/current/pro/desktop/zh-cn/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 编辑功能，站点管理员必须验证以下基准先决条件：

- 路由规则一致性：在所有情况下，必须在明确定义的 Bridge 命名池中主动注册目标数据库域或主机地址。
- 驱动程序可用性：对于数据库编辑方案，必须直接在运行活动 Bridge 客户端的物理主机上手动安装目标基础结构所需的匹配数据库驱动程序。
- 代理和网络规则：在专用或受限私有云配置中，您可能需要发布数据源。有关详细信息，请参见[连接到私有云数据](https://help.tableau.com/current/online/zh-cn/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 版 Bridg 不支持 Window 集成身份验证。
- Linux 版 Bridge 仅支持具有 Linux 驱动程序的 Exchange 连接器。

### 连接到平面文件和基于文件的数据提取

自 2025 年 2 月发布以来，您可以配置 Linux 版 Bridge 以连接到远程共享。

与有时以静态上载形式“包括外部文件”的工作簿不同，连接到平面文件的已发布数据源需要 Tableau Bridge 来进行所有刷新活动：

- Tableau Cloud 不支持在独立的已发布数据源中嵌入物理平面文件。
- 发布时，请确保数据源指向完整的 UNC 路径（例如，\\\\InternalServer\\Data\\file.xlsx）。如果在发布独立源期间选择了“包括外部文件”，可能会导致 Bridge 在不存在的临时云目录中查找该文件，从而导致刷新失败。

发布用于 Bridge 刷新的独立数据源时，请始终取消选中“包括外部文件”。

![](/tableau/current/zh-cn/online/zh-cn/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 Drive 和 OneDrive 的嵌入式数据源和已发布数据源的 OAuth。
- 将您自己的身份提供程序 (IdP) 与 Amazon Athena 连接器结合使用时，您必须设置 OAuth 客户端配置文件。请参见[将您自己的身份提供程序与 Amazon Athena 结合使用](https://help.tableau.com/current/pro/desktop/zh-cn/amazon_athena_idp.htm)。

**Windows 身份验证**

Windows 用户帐户必须是本地管理员组的成员，才能在服务模式下运行客户端。如果用户不是本地管理员，他们可以在应用程序模式下运行 Bridge 客户端，但他们必须保持登录到 Windows 计算机。

**Kerberos**

Windows 版 Bridge 通过“运行身份”帐户支持集成 Windows 身份验证，适用于文件和某些数据库。

## 此部分中的其他文章