Troubleshoot Refresh Issues

When Tableau Cloud is unable to complete a scheduled refresh, an alert appears to indicate that the refresh has failed. If a scheduled refresh fails five consecutive times, Tableau Cloud suspends the refresh. When a refresh is suspended, Tableau Cloud does not try to run it again until you take an action that attempts to correct the cause of the failure.

To display an alert that describes the reason the refresh failed, select the notification icon () in the upper-right corner of the browser window.

Resolve errors and resume suspended refreshes

To help resolve refresh issues, you can take any of these actions, based on the cause indicated in the alert:

  • Errors related to access token validation or user credentials

    To correct these issues, click the Connection Details link in the alert to go to the Connection tab on the data source page for the data source whose scheduled failed. On the Connections tab, select the check box next to the data connection, and click Edit Connection so you can update a user name or password, or select a different access token. After you update the connection information, Tableau Cloud restarts the refresh schedule.

    If you originally embedded the credentials or other data connection information when you published the workbook or data source from Tableau Desktop, you can also republish the workbook or data source. As part of the publishing process, you can choose to set a new refresh schedule. Otherwise, Tableau Cloud restarts the existing schedule.

  • Errors that indicate the database was unreachable

    Confirm that the underlying database is online and that you can sign in to access its data. You can use the Try again link in the alert to restart the refresh schedule.

  • Errors related to Tableau Bridge

    To troubleshoot errors related to Bridge, see Troubleshoot Issues with Bridge.

Thanks for your feedback!Your feedback has been successfully submitted. Thank you!