Using Embedded Data Sources

Tableau Bridge supports embedded data sources (EDS) and published data sources. With EDS support, existing content requiring Bridge can be migrated as-is rather than converting embedded data sources to published data sources.

Considerations

  • Bridge can support up to 16 live queries per client. With embedded data sources support, there’s an additional count against the refreshed quota.
  • See Bridge Site Capacity for information about how Tableau Bridge can impact site capacity.
  • When data is embedded in the workbook it's exclusive to the workbook; it's not available for other Tableau Desktop users to connect to. You can set up extract refresh schedules as you do for data sources that are published.
  • Each embedded data source has a separate connection to the data. Performance can be affected when connecting to duplicate copies of data, for example when connecting to the same original data and each workbook has its own refresh schedule.
  • The Network type is determined by the pool mappings. Embedded data sources apply the Private network option.

Limitations

  • Bridge legacy schedules aren’t supported.
  • Default pools aren’t supported. With the support for embedded data sources, pool mappings are used to determine whether Bridge is used, therefore the data source must use named pools.
  • Live and extract connections for file data (such as .cvs and .xlsx) aren’t supported by Bridge when the connection is an embedded data source.

Embedded Data Source with a Live connection

  1. Set up pool mappings for the data source. For more information, see Configure the Bridge Client Pool.
  2. From Tableau Desktop set the data source connection to Live.
  3. From the worksheet, click Server Publish Workbook.
  4. To see the data sources embedded in the workbook, click Data Sources.
  5. Click Publish.
  6. After the workbook is published, the workbook is rendered with the data sources included in the workbook.

Embedded Data Source with an Extract connection

  1. Set up pool mappings for the data source. For more information, see Configure the Bridge Client Pool.
  2. From Tableau Desktop set the data source connection to Extract.
  3. Click the worksheet and in the Save Extract As form, provide a name for the extract data source.
  4. From the worksheet, click Server Publish Workbook.
  5. (Optional) In the Manage Data Sources menu, choose to allow refresh access.
  6. Click Publish.
  7. After the workbook is published, the workbook is rendered with the data sources included in the workbook.

Editing the data source

Optionally, after you publish the workbook, you can change the connection type from Live to Extract from the Data Sources tab or from the workbook. You can also change the connection type from Extract to Live from the workbook.

To change the connection type from Live to Extract from the Data Sources tab:

  1. Go to the Data Sources tab.
  2. From the Actions menu, select Extract.

To change the connection type from Live to Extract from the workbook:

  1. Go to the View tab.
  2. Click Edit Workbook.
  3. Click the Data Source tab in the lower left corner, and then click Extract in the upper right corner.
  4. Click Create Extract.
  5. When a workbook data source is changed to Extract, a job is automatically created.

To change the connection type from Extract to Live, change the connection from the workbook. Do not change the data source from Extract to Live from the Data Sources tab.

  1. Go to the View tab.
  2. Click Edit Workbook.
  3. Click the Data Source tab in the lower left corner, and then click Live in the upper right corner.
  4. Click Publish and refresh the workbook page.

Viewing refresh jobs

There are several Task Types available to view from the Jobs page.

For embedded data sources that use Bridge, the task type is Extract Refresh/Creation. For published data sources that use the Bridge client, the task type is Bridge Refresh.

Note: When changing the published workbook connection type from Live to Extract, a scheduled job is created. However, the Task type doesn’t indicate that the Bridge client was used for the data source for the scheduled job refresh or when running Refresh Now. The task type is listed as Extract Refresh/Creation.

Refreshing an Extract

You can refresh extracts of data hosted with most cloud data providers directly on Tableau Cloud.

  1. Sign in to the Tableau Cloud site to which the data source is published.
  2. On the Data Sources page, select the More actions icon (…) next to the data source you want to refresh, and then select Refresh Extracts or Refresh Extracts from the menu.
  3. Selecting Refresh Extract schedules the refresh, but doesn’t run the refresh immediately. To run the refresh, go to the Extract Refreshes tab, select the More actions icon () next to the data source, then click Run Now.

Thanks for your feedback!