How to Use Tableau Bridge

Keeping your Tableau Cloud dashboards current with data behind a company firewall can feel like a complex challenge. That's where Tableau Bridge comes in - it acts as a secure link between your on-premises data and the cloud. This guide will walk you through how to set up, use, and manage Tableau Bridge to ensure your data stays fresh and accessible.

Graphed

Build AI Agents for Marketing

Build virtual employees that run your go to market. Connect your data sources, deploy autonomous agents, and grow your company.

Build Your First Agent

What Exactly is Tableau Bridge?

Tableau Bridge is a client software that you install on a computer within your private network. Its primary job is to create a secure, outbound connection to Tableau Cloud, allowing it to communicate with data sources that aren't directly accessible from the public internet. Think of it as a trusted courier that can safely go behind your company's firewall, pick up the latest data, and deliver it securely to your cloud dashboards.

You don't need Bridge for cloud-based data warehouses like Snowflake, Redshift, or Google BigQuery, as Tableau Cloud can connect to those directly. Bridge is specifically designed for data living on local servers, such as Microsoft SQL Server, Oracle, or even simple CSV and Excel files stored on an internal network drive.

It enables two critical functions:

• Extract Refreshes: Automating the process of updating published data extracts on a set schedule.
• Live Connections: Allowing dashboards to directly query your on-premises data sources in real-time for up-to-the-minute analysis.

Before You Get Started: Key Prerequisites

Before installing, make sure you have everything in order to avoid any setup snags. A little preparation now will save you time troubleshooting later.

AI Agents for Marketing

Crash Course

Graphed

Free PDF · the crash course

AI Agents for Marketing Crash Course

Learn how to deploy AI marketing agents across your go-to-market — the best tools, prompts, and workflows to turn your data into autonomous execution without writing code.

Download the PDF

System and Access Requirements

Here’s a quick checklist of what you'll need:

• Operating System: Tableau Bridge runs on Windows only. This can be Windows 10, 11, or a Windows Server version (2016 or newer is recommended).
• Administrator Permissions: You’ll need administrator rights on the machine where you plan to install the Bridge client.
• Tableau Cloud Role: You must be a Creator or a Site Administrator on your Tableau Cloud site to link the client.
• Data Source Access: The computer running Bridge must have the necessary drivers for your data source and be able to connect to it. For example, if you're connecting to a SQL Server, the Bridge machine needs network access to that server.
• Internet Connectivity: The computer must have a stable, outbound internet connection to reach Tableau Cloud (*.online.tableau.com).

Step-by-Step Installation and Setup

Getting Tableau Bridge up and running is a straightforward process. The client is a small application that sits on a machine inside your network.

Step 1: Download the Bridge Installer

First, you need to download the client software. You can find the latest version directly from your Tableau Cloud site:

1. Log into your Tableau Cloud site.
2. In the top right corner, click your profile icon and select My Account Settings.
3. Under the "Bridge Clients" section, click the Download Now button. You can also find it on the official Tableau downloads page.

Step 2: Run the Installation Wizard

Once the installer is downloaded, run it on the computer you’ve designated for Bridge. This machine should ideally be an "always-on" server or dedicated machine to ensure your data refreshes don't fail because someone’s laptop went to sleep.

Follow the on-screen prompts. The installation is quick and requires minimal configuration.

Step 3: Authenticate the Client

After installation, the Tableau Bridge client will automatically launch and prompt you to sign in to your Tableau Cloud site. Enter the same credentials you use to log into Tableau Cloud. You'll need to name this specific client instance - for example, "Marketing-DB-Server-Bridge" or "Main-Office-SQL-Client." This helps you identify which machine is handling which refreshes, which is especially useful if you run multiple clients.

And that's it! Once you've signed in and named the client, it will run in the system tray and quietly await instructions from Tableau Cloud.

Graphed

Build AI Agents for Marketing

Build virtual employees that run your go to market. Connect your data sources, deploy autonomous agents, and grow your company.

Build Your First Agent

Understanding Bridge Connection Modes: Live vs. Extract

Tableau Bridge gives you two options for connecting to your on-premises data. The one you choose depends on how current your data needs to be and your performance requirements.

Using Bridge for Extract Refreshes

An "extract" is a snapshot of your data that is stored and optimized within Tableau. When you publish a workbook that uses an extract, you’re publishing it with that saved snapshot. Extracts are fantastic for performance because all a user’s dashboard interactions query the highly optimized extract on Tableau Cloud, not the original, sometimes slower, database.

The role of Bridge here is to keep that snapshot fresh. You can create schedules in Tableau Cloud (e.g., "refresh every morning at 7 AM" or "refresh every hour") and assign them to your data sources. When a scheduled refresh time arrives, Tableau Cloud sends a request to your Bridge client. The client then queries your local database, creates the updated extract, and securely transmits it back to Tableau Cloud to replace the old one.

This is the most common use case for Tableau Bridge. It is efficient, minimizes the load on your internal databases, and delivers great dashboard performance.

To set this up:

1. In Tableau Desktop, connect to your on-premises data source.
2. Select the Extract connection option at the top right of the Data Source screen.
3. Create your vizzes and publish the dashboard or data source to Tableau Cloud.
4. During the publishing process, you’ll be prompted to schedule a refresh. Here, you will see an option to refresh via your configured Bridge client. Select it and choose your desired schedule.

AI Agents for Marketing

Crash Course

Graphed

Free PDF · the crash course

AI Agents for Marketing Crash Course

Learn how to deploy AI marketing agents across your go-to-market — the best tools, prompts, and workflows to turn your data into autonomous execution without writing code.

Download the PDF

Using Bridge for Live Connections

Sometimes, your data needs to be absolutely, positively up-to-the-second. For these scenarios, you can use Bridge to facilitate a live connection. With a live connection, there's no data snapshot, every filter, click, or interaction on a dashboard sends a query back through Tableau Bridge to your local database for processing.

The Bridge client acts as a secure proxy, forwarding queries from Tableau Cloud to your internal database and then sending the results back up to the dashboard. This is great for real-time monitoring dashboards, but be mindful of performance. The responsiveness of your dashboard will depend on the speed of your local database, your network bandwidth, and the complexity of the query.

To configure a live connection via Bridge:

1. In Tableau Desktop, connect to your on-premises data source, leaving the Live option selected.
2. Create your vizzes.
3. When you publish the data source, Tableau Cloud will detect that it’s an on-premises source and automatically list it as requiring Tableau Bridge to maintain the connection.

Managing and Monitoring Your Bridge Clients

Once you’ve set everything up, you can manage your clients directly from Tableau Cloud. This gives you a centralized view of the health and status of all your data connections.

• Viewing Client Status: Go to Settings > Bridge in your Tableau Cloud site. Here, you'll see a list of all connected clients, their status (e.g., Connected, Disconnected), and the last time they were seen.
• Understanding Pools: Bridge clients can be grouped into "pools." By default, all clients are in one pool. A pool ensures high availability. If you have two clients in a pool and one of them goes offline (perhaps the machine is rebooted), the other client will automatically pick up any scheduled extract refreshes. This is a best practice for business-critical data.
• Email Alerts: As a site administrator, you can configure Bridge to send email notifications if a refresh fails. This is crucial for proactively catching issues before business users notice them. Find this under Settings > Bridge as well.

Best Practices and Common Troubleshooting Tips

To ensure a smooth, reliable data refresh experience, keep these tips in mind:

• Use a Dedicated Machine: Don't install Bridge on your personal laptop. Use a server or virtual machine that is always on and has a stable network connection. If your laptop is turned off or asleep, your refreshes will fail.
• Organize Clients into Pools: For load balancing and failover, add multiple Bridge clients to a pool. If one client goes offline, the others will take over.
• Check Connection Times: Schedule large extract refreshes during off-peak hours to minimize the performance impact on your source database.
• Monitor the Refresh Queue: From the Bridge section in Tableau Cloud, you can view jobs that are pending, in progress, or have failed. A common cause for failure is a password change to the source database account. Make a habit of checking this page if you rely on timely data.
• Ensure Correct Drivers: The machine running Bridge needs the same database drivers as your Tableau Desktop user. If a refresh fails, double-check that the driver is up to date and correctly installed.

Final Thoughts

Tableau Bridge is a powerful tool for bridging the gap between your on-premises data sources and your cloud dashboards. With proper setup and management, it ensures that your data is current and accessible without compromising security. By following best practices, you can optimize its use and troubleshoot common issues effectively.