Registry / workflow / apache-airflow-providers-tableau

apache-airflow-providers-tableau

library5.6.1pypypi✓ verified 23d ago

The Apache Airflow Tableau Provider enables seamless integration between Apache Airflow and Tableau Server/Online. It offers operators and hooks to automate various Tableau-related tasks, such as refreshing data sources, publishing workbooks, and managing server content, directly within Airflow DAGs. The provider is actively maintained as part of the Apache Airflow project, with regular releases aligning with Airflow's provider release cycles, currently at version 5.3.4.

workflow data devops aws

pip install apache-airflow-providers-tableau

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · APACHE-AIRFLOW-PRO

apache-airflow-providers-tableau

workflowpythonv5.6.1

Install

24.4s avg

Import

5601ms

Disk

259MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v5.6.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 4.656s · 259.2MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 24.4s · import 4.306s · 257MB

259MB installed

● package 259MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TableauOperator

✓ from airflow.providers.tableau.operators.tableau import TableauOperator

TableauHook

✓ from airflow.providers.tableau.hooks.tableau import TableauHook

TableauJobStatusSensor

✓ from airflow.providers.tableau.sensors.tableau_job_status import TableauJobStatusSensor

This example DAG demonstrates how to use the `TableauOperator` to refresh a Tableau workbook. It shows a blocking refresh, meaning the task will wait until the refresh operation on Tableau Server/Online is completed. The `tableau_conn_id` parameter references an Airflow connection configured with Tableau credentials. The `site_id` should be provided if not using the default Tableau site, or an empty string ('') for the default site. Workbook ID can be passed via DAG params or environment variables.

import os from datetime import datetime from airflow import DAG from airflow.providers.tableau.operators.tableau import TableauOperator with DAG( dag_id='example_tableau_refresh_workbook', start_date=datetime(2023, 1, 1), schedule_interval=None, catchup=False, tags=['tableau', 'example'], params={'workbook_id': os.environ.get('AIRFLOW_WORKBOOK_ID', 'your_workbook_id')} ) as dag: refresh_workbook_blocking = TableauOperator( task_id='refresh_tableau_workbook_blocking', resource='workbooks', method='refresh', find="{{ params.workbook_id }}", site_id=os.environ.get('AIRFLOW_TABLEAU_SITE_ID', ''), # Use '' for default site blocking_refresh=True, # Waits until refresh is complete tableau_conn_id=os.environ.get('AIRFLOW_TABLEAU_CONN_ID', 'tableau_default') )

airflow --version

Debug

Known issues

deprecatedAuthentication by personal access token (PAT) is officially deprecated in provider version 2.1.0 and later due to concurrency issues. Tableau automatically invalidates PATs if multiple parallel connections use the same token, leading to job failures.

fix

Migrate to JSON Web Token (JWT) authentication for robust and scalable Airflow-Tableau integrations, especially in environments with parallel tasks.

affects: >=2.1.0

breakingProvider version 4.0.0 removed deprecated classes paths, specifically `tableau_job_status` and `tableau_refresh_workbook`.

fix

Update imports and usage to the current `TableauOperator` and `TableauJobStatusSensor` patterns, which now handle these functionalities directly.

affects: 4.0.0

breakingProvider version 3.0.0 requires Apache Airflow 2.2.0 or newer. Installing this provider version on older Airflow instances may automatically upgrade Airflow.

fix

Ensure your Apache Airflow instance is upgraded to at least version 2.2.0 (or newer for later provider versions) before installing or upgrading to `apache-airflow-providers-tableau` >= 3.0.0.

affects: 3.0.0

gotchaFailure to provide the correct `site_id` for Tableau Online or a non-default Tableau Server site can lead to `NotSignedInError: Missing site ID` errors, even if other credentials are correct.

fix

Always specify the `site_id` parameter in your Tableau connection or operator if you are not using the default Tableau Server site. For the default site, use an empty string (e.g., `site_id=''`).

affects: All versions

gotchaUsing self-signed SSL certificates can result in `SSLCertVerificationError` even if `openssl s_client` validates the certificate, indicating potential deeper issues with how `tableauserverclient` handles custom CA bundles within Airflow.

fix

Ensure the certificate chain is correctly configured and accessible by the Airflow worker. If possible, use publicly recognized certificates. For self-signed certificates, ensure the full chain is provided and consider alternative verification methods if the issue persists.

affects: All versions

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'airflow.providers.tableau'

This error occurs when the 'apache-airflow-providers-tableau' package is not installed in your environment.

fix

Install the package using pip: 'pip install apache-airflow-providers-tableau'.

ImportError: cannot import name 'TableauHook' from 'airflow.providers.tableau.hooks.tableau'

This error occurs when attempting to import 'TableauHook' from an incorrect module path.

fix

Ensure the correct import statement: 'from airflow.providers.tableau.hooks.tableau import TableauHook'.

AttributeError: module 'airflow.providers.tableau.hooks.tableau' has no attribute 'TableauHook'

This error occurs when the 'TableauHook' class is not found in the specified module, possibly due to version incompatibility.

fix

Verify that you have the correct version of 'apache-airflow-providers-tableau' installed and that 'TableauHook' is available in that version.

AirflowException: Resource not found! Available Resources: ['datasources', 'groups', 'projects', 'schedule', 'sites', 'subscriptions', 'tasks', 'users', 'workbooks']

This error occurs when an invalid resource name is provided to the 'TableauOperator'.

fix

Use one of the available resources listed in the error message when initializing the 'TableauOperator'.

AirflowException: Method not found! Available methods for workbooks: ['delete', 'refresh']

This error occurs when an invalid method is specified for a given resource in the 'TableauOperator'.

fix

Use one of the available methods listed in the error message for the specified resource.

Upgrade

Version history

5.6.1latest on PyPI · released Aug 23, 2026

Audit

Dependencies

apache-airflowrequiredCore dependency for Airflow providers; requires >=2.11.0 for provider version 5.x.

tableauserverclientrequiredUnderlying Python library for interacting with Tableau Server/Online REST API.

Agent activity

45 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/apache/airflow ↗

packagehttps://pypi.org/project/apache-airflow-providers-tableau/ ↗

homepagehttps://airflow.apache.org ↗

docshttps://airflow.apache.org/docs/apache-airflow-providers-tableau/5.4.0 ↗

changeloghttps://airflow.apache.org/docs/apache-airflow-providers-tableau/5.4.0/changelog.html ↗