Change the Tableau Bridge Application Settings or Computer
This topic describes how to change the way Tableau Bridge runs, or change the computer or site a Tableau Bridge client is associated with.
In this article
You can set Tableau Bridge to run as a Windows service, so it can keep running your refresh schedules even after you log off Windows. You can do this if the user account that runs Tableau Bridge is a local administrator on the computer.
Note: Running Bridge as a service is required for maintaining live connections to on-premises data.
Open the Windows system tray, and select the Tableau Bridge icon to open Tableau Bridge.
Near the bottom of the window, for Mode, select Service.
A sign-in window appears, prompting you to enter Windows credentials. For example, enter your own credentials if you are a local administrator on your computer.
In your list of Windows services, Bridge appears as Tableau Online sync service. You can see this in the Windows Services console or on the Services tab in the Task Manager.
To stop Tableau Bridge from running as a service:
Near the bottom of the window, for Mode, select Application.
When Bridge is running as an application, it can only refresh extracts (cannot maintain live connections), and only when the user is logged on to Windows. For more information, see How Tableau Bridge works.
You can change the Tableau Bridge client used to perform the scheduled extract refresh of a data source. You can only assign the extract refresh schedule of a data source to a client that you own, that is a client that you are signed in to.
Sign in to Tableau Online and click the Data Sources tab.
Click the name of the data source and click the Refresh Schedules tab.
On the right side of the page, click the button next to Refresh this extract on.
In the Change Refresh Schedule dialog box, select a different computer (that is the client) that you want to perform the scheduled extract refresh, and then click Save.
Note: If the data source requires a user name and password to access the underlying data, open the client on the new computer, and edit the connection information to embed the database credentials. You can use the Test Connection option in the client to check whether the data source can access the underlying data.
Sign in to Tableau Online as an administrator, go to the site’s Settings page, and click the Bridge tab.
In the Type column of the table that lists registered Bridge clients, select Extract and Live next to the name of the new client.
The data sources that contain live connections and are managed by Tableau Bridge are assigned to the new client.
As an administrator, you can perform extract refreshes for data sources using a centrally-managed client. To designate a central client, reassign the extract refresh schedule of multiple data sources to a single client.
Follow the steps in Change the Tableau Bridge client that performs the scheduled extract refresh to assign the extract refresh schedule of a data source to a central client.
Note: Tableau recommends that you do not use the same central client to handle both scheduled extract refreshes and load balancing of live queries. In other words, do not use a client that has been designated to handle extract refreshes to also load balance live queries. Instead, designate a central client to handle extract refreshes and designate separate clients to handle the load balancing of live queries.
When you want a Tableau Bridge client to refresh data published to a different Tableau Online site, you unlink the existing client and sign in to the new site.
Open the Tableau Bridge client icon in the Windows system tray, and select Unlink.
This removes the list of data sources, schedules, and connection information from the client.
In Tableau Desktop, select Server > Start Tableau Bridge Client, and sign in to the new site.
If this client refreshes extracts, configure its data sources and refresh schedules.
If you want this client to maintain live connections, you need to have administrator access to the Tableau Online site. On the site Settings page on the Bridge tab, you select Extract and Live for this client in the Clients Status table.
When you unlink a Tableau Bridge client, a site administrator might also need to remove the refresh schedules it was associated with on Tableau Online. For more information, see Effects of exit and unlink in the topic Stop Tableau Bridge Refreshes.
On a computer that remains powered on at all times, Tableau Bridge by default restarts itself every 24 hours. You can change the amount of time between auto restarts, for example, if the timing conflicts with your refresh schedules.
Select Start menu > All Programs > Accessories > Command Prompt.
Change to the Tableau bin directory, for example:
cd C:\Program Files\Tableau\Tableau 2018.1\bin
Type the following command:
tabonlinesyncclientcmd.exe SetDataSyncRestartInterval --restartInterval=<value in seconds>
restartIntervalargument is in seconds, so the value 3600, for example, would set the client to restart every hour.
One hour is the minimum interval at which Tableau Bridge will restart. If you type a value less than 3600, Tableau Bridge will still restart every hour.