Skip to main content

Tableau

Tableauコネクタを使用すると、DesignerでTableauに接続できます。

Tableauは、データ入力ツールとデータ出力ツールのデータソースとして、またスタンドアロンのTableau入力ツールとTableau出力ツールとして使用できます。

Designerの新しいコネクタバージョン

Tableauコネクタは、Alteryx Oneコネクタエクスペリエンスの一部になりました。このページの情報をよく確認して、適切なツールを正しく使用していることを確認してください。

DesignerワークフローでTableauコネクタを更新する場合は、ワークフロー移行ユーティリティを使用できます。

Tableauコネクタの詳細

Tableauは、データ入力ツールとデータ出力ツールのデータソースとして、Designer 2025.1のパッチ5以降および2025.2のパッチ3以降で使用できます。ファイルの種類のオプションについて詳しくは、[links]を参照してください。

Prerequisites

Ensure you have completed the following prerequisites before proceeding:

Requirement

Detail

Designer version

Designer 2026.1+ (required for unified connector and also required specifically for Output options like Hyper file version and database schema selection)

Tableau Server version

Tableau Server 2023.3+, using Tableau REST API 3.21

AMP

Must be enabled

DCM

You must enable DCM in Designer. Go to Options > Advanced Settings > DCM to enable it

Tableau deployment type

Tableau Server (self-hosted, on-prem or private cloud) using your server URL

Install the Connector

You can easily install the latest version of the Tableau connector from Designer via the Add-Ons. This is the recommended installation method that allows you to browse, install, and update connectors without leaving Designer or visiting the Alteryx Marketplace.

To install the connector...

  1. In Designer, go to Add-Ons > Manage Marketplace Add-Ons. You will see a list of available connectors.

  2. Select Tableau Tools and select Install. Designer downloads and installs the package. Designer might require a restart to complete the installation.

  3. After installation and setup are complete, the Tableau connector is available from the Input Data and Output Data tools.

Set Up a Connection

To connect to Tableau using DCM...DCM - Designer

  1. Drag the Input Data or Output Data tool to the canvas, and select Connect to Data.

  2. In the Connector Setup, select Create or Browse a Data Connection.

    If you've created a Tableau connection before, you can select the connection from the Recents tab.

  3. Select + New. From the list of technologies, select Tableau.

  4. Select Setup Connection. The Connections window opens.

  5. Select +New.

  6. Specify the connection name, data source name, and the server URL.

  7. In the Credentials section, select your authentication method, and enter the credential name. For more information, see Authentication Methods.

  8. Select Save.

  9. Select Connect. Tableau may request authentication.

  10. Select the file to read from or write to in the file browser window.

  11. Select the read or write configuration in the Options window.

  12. Select Confirm to create a connection to the file. You can continue building your workflow.

Input and Output Tools

The Tableau Input and Output tools are used to read from and write to Tableau.

Tableau Input

Tableau Input reads data from a published Tableau data source.

  • Authenticate through a DCM Tableau connection.

  • Browse sites and projects in a tree, with pagination and fuzzy search, or enter a path.

  • Select a single-table datasource to read.

  • Columns are returned as typed data (for example, Date and DateTime are read as date and datetime types).

Tableau Output

Tableau Output writes data to Tableau and publishes it as a datasource (a Hyper extract). This tool supersedes the older Publish to Tableau Server tool.

  • Authenticate through a DCM Tableau connection.

  • Choose or define the destination: browse to a project and datasource, or enter the project path and datasource name (including dynamic paths driven by fields or parameters).

  • Write to a single table with a name of your choice.

  • Choose the action when the datasource already exists: create a new datasource, rename and create, overwrite the existing datasource (preserves the datasource ID and creates a new version), or append rows to the existing datasource. Append and Overwrite are performed through the Tableau API.

  • Select the Hyper file version (V1 through V4) and the database schema (for example, public or Extract). These options require Designer 2026.1+.

Object Model

Understanding the Tableau hierarchy helps you configure the tools correctly:

  • Site: Organizations often use separate sites per business unit or environment. Each site has its own users, projects, workbooks, and datasources.

  • Project: Used to organize content. Projects can be nested.

  • Workbook: Contains one or more sheets (visualizations, dashboards, stories) and uses datasources for its underlying data.

  • Datasource: The connection to data that workbooks use. It can be a live connection or an extract. A datasource exposes one or more tables.

  • Table: A structured dataset inside a datasource. When Alteryx publishes to Tableau, it writes into a table within a datasource, stored as a .hyper extract.

Authentication Methods

The unified connector authenticates through DCM. Tableau supports three authentication methods. Use the table below to choose the right one for your use case.

Method

Desktop

Cloud (Alteryx One)

Personal Access Token (PAT)

Yes

No

Tableau Server username and password

Yes

No

Tableau Connection Manager (TCM)

No

No

注記

  • Tableau Server (self-hosted, on-premises, or private cloud) connects using your server URL, and supports either a Personal Access Token (PAT) or a Tableau Server username and password as credentials.

  • Tableau Cloud (SaaS, hosted by Tableau) uses a site-specific URL of the form https://<site>.online.tableau.com. Tableau Cloud support for the unified connector is in progress and not yet available.

Migration to Unified Tableau

If you already use the Tableau connector in Alteryx, read the section below. It walks through what has been changed in the unified version.

Parameter

Legacy Connector (Python SDK)

Unified Connector

Platforms and Tools

Desktop (Input and Output)

Desktop (Input and Output) at GA

Cloud in progress

Framework

Python SDK

Unified connector framework

Communication / API

Legacy Tableau REST API

Tableau REST API 3.21 (requires Tableau Server 2023.3+)

Authentication

Legacy authentication

Personal Access Token (PAT) or Tableau Server username and password

Connection model

Tool-level / non-DCM

DCM

Existing workflows can be migrated using the Alteryx Workflow Migration Utility in Designer 2025.1 Patch 5 or later. However, it is only available on desktop. For more information, see workflow migration utility.

Limitations

  • Date and DateTime values now show trailing zeros on read (extra microsecond digits). To restore the previous formatting, add a Select or Sample tool downstream to trim the extra zeros.

  • Tableau Output cannot publish a datasource from a fixed-decimal field that was read from a local .hyper file. Convert the field to a Double (for example with a Select tool) before the Tableau Output tool. This also helps avoid conflicts during later Append or Overwrite operations on the same datasource.

  • Update, Upsert, and Upload Hyper File operations are no longer supported. If your workflow relies on Update or Upsert, redesign it to use Overwrite (to replace a datasource) or Append (to add rows).

  • The connector now supports only single-table datasources. You write to a single table with a name of your choice, and .tds file support has been removed as a result. If your workflow uses multi-table datasources, redesign it to publish to a single-table datasource instead.

  • You can't create new or nested projects directly from the connector. Create the project in Tableau first, then browse to it or enter its path in the tool.

  • The tool does not list the tables inside a datasource for you to pick from. Enter the table name manually instead.

  • Non-DCM connection methods have been removed, so all connections must be created through DCM, authenticated with a PAT or a Tableau Server username and password.

  • Tableau Connection Manager (TCM) is not supported on either Input or Output. Use a PAT or a Tableau Server username and password instead.

  • The Attach Metadata and Enable Dry Run options aren't available for Tableau Input on the unified-connector framework, on Desktop.

  • The connector requires Designer 2026.1+ and Tableau Server 2023.3+ (Tableau REST API 3.21) for both Input and Output. Advanced options like Hyper file version and database schema selection also require Designer 2026.1+.

  • Currently, the connector is available on Desktop (Flagship) only, for both Input and Output. Cloud support is in progress with no confirmed date. Once Cloud ships, expect the migration utility to remain unavailable there, local download to stay Desktop-only, the connection-creation flow to differ (built-in connection creation will not be available), and supported formats and produced datatypes to potentially differ from Desktop.

Tableauコネクタのリリースノート

Connector Release Version 2.1.0

Version

Description

v2.1.0

  • Available in Designer 2026.1+, Tableau Server 2023.3+ (Tableau REST API 3.21). Requires AMP and DCM.

  • Input reads a single-table datasource with typed columns.

  • Output supports Hyper file versions V1 through V4, multiple database schemas, Write to a single table with a name of your choice. Append and Overwrite are API-based.

  • Fixed an issue where migration did not perform an incorrect credential refresh when no OAuth token was present (Tableau uses PAT or username and password).

v2.0.1

  • Input and Output (single table).

  • Output added API-based Append, manual and dynamic project paths, Hyper V2, fuzzy search for projects and datasources, and automatic chunking of large writes.

  • Fixed an issue where large writes failed with an error.

  • Fixed an issue where ew datasources were not created with a timestamp appended to the name.

  • Fixed project and datasource browsing pagination, search, and navigation issues.

Tableauスタンドアロンコネクタバージョン1.5.4以前

接続タイプ

Alteryxツール。最新のバージョンは、Alteryx Marketplaceから入手できます。

サポートのタイプ

読み取り/書き込み/公開

検証済み

Tableau SDK 10.3 (空間サポート)

リリースノート

バージョン

説明

v1.5.4

  • Alteryx DesignerおよびServer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineが必要です。

  • Alteryx Serverでワークフローを実行するにはDCMに保存された資格情報が必要です。

  • Tableauコネクタでは、末尾に余分なゼロが表示されないように、既定で時刻と日付/時刻の精度がミリ秒に設定されている一方で、必要なワークフローではナノ秒の解像度にも対応します。

  • DCM接続が次のエラーを返す問題を修正しました。

    • 'NoneType' object has no attribute 'get' (TPM-4831)

    • 選択されたデータソース<DATASOURCE>を処理できませんでした(TPM-4824)

    • Failed to sign in to Tableau (TPM-4732)

    • serverUrl (TPM-4732)

  • HYPERファイルのアップロード時に<class 'KeyError'>: '#1'および「リストインデックスが範囲外です」エラーで失敗する問題を修正しました。(TPM-4708)

  • Tableauツールで「temp_table」エラーが返される問題を修正しました。(TPM-4609)

既知の問題

  • プロキシパスワードに特殊文字が含まれている場合、プロキシサーバーの手動セットアップでエラーが発生する。

  • PACファイルでgetIpAddress()を使用すると、PyPACでローカルIPアドレスが返される。(TPM-4515)

v1.5.3

  • Alteryx DesignerおよびServer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineが必要です。

  • Alteryx Serverでワークフローを実行するにはDCMに保存された資格情報が必要です。

  • DCMの使用時に、結果ウィンドウに接続IDが表示されるようになりました。

  • お気に入りでフィルタリングした際に、Tableauツールが誤ったプロジェクトIDにデータを公開してしまう問題を修正しました。(TPM-4600)

  • DCM接続処理ルールがTableauツールに適用されない問題を修正しました。(TPM-4550)

  • [プロジェクトを選択]設定に親プロジェクト名が表示されない問題を修正しました。(TPM-4451)

  • Tableau出力がSpatialObjデータを正しく書き込まない問題を修正しました。(TPM-4378)

  • HTTP_PROXY変数またはHTTPS_PROXY変数が使用されている場合に、TableauツールがNO_PROXY変数を無視する問題を修正しました。(TPM-4347)

  • Tableau出力がLAN設定のプロキシ例外に準拠しない問題を修正しました。(TPM-4345)

既知の問題

  • Tableau出力がTableau Cloudにデータを書き込めない。Designerが「unknown table 'temp_table' Context: 0xfa6b0e2f.」というエラーメッセージを返す。(TPM-4609)

v1.5.2

  • Alteryx DesignerおよびServer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineが必要です。

  • Alteryx Serverでワークフローを実行するにはDCMに保存された資格情報が必要です。

  • Tableauツールで、「リストインデックスが範囲外です」というエラーが返される問題を修正しました。(TPM-4356)

  • Tableau入力で、「許容範囲外です」というエラーが返される問題を修正しました。(TPM-4325)

  • Tableau出力で、バイト、日付、時刻、または日付/時刻の列が空の場合にエラーが返される問題を修正しました。(TPM-4317)

  • Tableauツールで、「Mismatched column definitions」というエラーが返される問題を修正しました。(TPM-4315、TPM-4299、TPM-4047)

  • Tableau出力で、結果ウィンドウにデータが表示されない問題を修正しました。(TPM-4297)

  • Tableau出力で、データソースが正しく表示されない問題を修正しました。(TPM-4260)

  • Tableau入力で、データが全く読み取られず、エラーも表示されない問題を修正しました。(TPM-4247)

  • Tableau出力で、同じ名前のデータソースが別のプロジェクトにある場合、データソースにデータが書き込まれない問題を修正しました。(TPM-4225)

  • Tableau出力で、相対パスで定義されたファイルにデータが書き込まれない問題を修正しました。(TPM-3712)

  • マクロのTableau出力で期待どおりに機能しない問題を修正しました。(TPM-3502)

V1.5.1

  • Alteryx DesignerおよびServer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineが必要です。

  • Alteryx Serverでワークフローを実行するにはDCMに保存された資格情報が必要です。

  • 設定がすべての行をフィルタリングで除外したときにTableau出力がエラーを返す問題を修正しました。(TPM-4146)

  • データが列のデータ型と一致しなかったときにTableau出力がエラーを返す問題を修正しました。(TPM-4084)

  • Tableauツールが所有者でフィルタリングできない問題を修正しました。(TPM-4076)

  • 必須フィールドが選択されていないときにTableau出力がエラーを返す問題を修正しました。(TPM-3555)

v1.5.0

  • Alteryx DesignerおよびServer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineが必要です。

  • Alteryx Serverでワークフローを実行するにはDCMに保存された資格情報が必要です。

  • HYPERファイルをアップロードするオプションが追加されました。

  • Tableau出力ツール以外の手段で作成されたソースからデータを読み込む機能が追加されました。

v1.4.3

  • Alteryx DesignerおよびServer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineが必要です。

  • Alteryx Serverでワークフローを実行するにはDCMに保存された資格情報が必要です。

  • テーブルにデータを追加するときにTableau出力がレコードを複製する問題を修正しました。(TPM-3890)

  • 列が空で、データ型が日付/時刻に設定されている場合に、Tableau出力がエラーを返す問題を修正しました。(TPM-3862)

  • ワークフローに複数のTableau入力ツールが含まれている場合に、Tableau出力が不完全なレコードを書き込む問題を修正しました。(TDCE-533)

  • サイト名が空の場合にTableauツールがエラーを返す問題を修正しました。(TDCE-464)

v1.4.2

  • Alteryx DesignerおよびServer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineが必要です。

  • Alteryx Serverでワークフローを実行するにはDCMに保存された資格情報が必要です。

  • ワークフローに複数のTableauツールが含まれている場合、Tableau出力がデータを適切に更新またはアップサートしない問題を修正しました。(TPM-3725)

  • Tableau出力が日付/時刻値を正しく書き込むことができない問題を修正しました。(TPM-3715)

  • Tableau入力でデータが重複し、列が上書きされる問題を修正しました。(TPM-3524)

  • Tableau出力のパフォーマンスが向上しました。(TPM-3455)

  • Tableauツールがプロキシ設定を無視する問題を修正しました。(TPM-3353)

  • TableauツールがBlobデータを正しく読み込み、または書き込みできない問題を修正しました。(TPM-2649)

v1.4.1

  • Alteryx DesignerおよびServer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineが必要です。

  • Alteryx Serverでワークフローを実行するにはDCMに保存された資格情報が必要です。

  • .shivフォルダーの使用を削除しました。

  • 将来の年の日付フィールドを書き込む際に、Tableau出力で「NoneType' object has no attribute 'dtypes」というエラーが返される問題を修正しました。(TPM-3246)

  • マクロまたは分析アプリでインターフェースツールにマップされる際に、Tableau出力で[プロジェクト名]フィールドが正しく更新されない問題を修正しました。(TPM-3245)

  • 複数のデータ型が存在する場合に、Tableau出力で「Got an invalid value」というエラーが返される問題を修正しました。(TPM-2968)

  • 挿入する新しい行が含まれていない場合、Tableau出力がデータのアップサートに失敗する問題を修正しました。(TPM-2531)

  • ユーザーのTableauインスタンスにデータソースが含まれていない場合に、Tableau出力で空白の設定パネルが表示される問題を修正しました。(TFLN-1881)

  • Tableau出力の「Must pass at least one table」というエラーを修正しました。(TDCE-302)

  • 日付または日付/時刻データ型を読み取る際に、Tableau入力で「'NoneType' object has no attribute ‘year’」というエラーが返される問題を修正しました。(TDCE-293)

  • Tableau出力で、特定のサイズを超えるTDSXファイルの作成に失敗する問題を修正しました。(TDCE-186)

v1.4.0

  • Alteryx DesignerおよびServer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineが必要です。

  • Alteryx Serverでワークフローを実行するにはDCMに保存された資格情報が必要です。

  • Tableau出力の書き込みパフォーマンスが向上しました。

  • プロジェクトブラウザとデータソースブラウザの更新ボタンが機能しない問題を修正しました。(TFLN-1436)

  • 3GBを超えるデータセットをアップロードするとTableau出力が不安定になる問題を修正しました。(TPM-2121)

v1.3.1

  • Alteryx DesignerおよびServer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineが必要です。

  • Alteryx Serverでワークフローを実行するにはDCMに保存された資格情報が必要です。

  • Tableau出力でfloatデータ型のNull値が「nan」として書き込まれる問題を修正しました。(TPM-2210)

既知の問題

  • 3GBを超えるデータセットをアップロードすると、ツールが不安定になる。(TPM-2121)

  • 更新ボタンが、Tableau出力ツールでもTableau入力ツールでも機能しない。(TFLN-1436)

v1.3.0

  • Alteryx DesignerおよびServer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • HYPERデータソースからデータを読み取るための新しいTableau入力ツールを追加しました。

    • ライブデータソースはサポートされていません。

    • Tableau出力ツールで作成されたデータソースのみ読み取りがサポートされます。

  • AMP Engineが必要です。

  • Alteryx Serverでワークフローを実行するにはDCMに保存された資格情報が必要です。

  • Null数値が0に変換される問題を修正しました。(TPM-1546)

    • Tableauのダッシュボード上でNull数値が既定で0として表示される。

  • Null文字列値が空の文字列に変換される問題を修正しました。(TPM-1528)

  • 日付が文字列に変換される問題を修正しました。(TPM-2138)

  • DCMを使用したときにDesignerが際限なく実行されるか、クラッシュする問題を修正しました。(TPM-1986)

  • キャンバスで複数のTableau出力ツールを使用したときに、「The system could not find the path specified」というエラーが発生する問題を修正しました。(TPM-1915)

既知の問題

  • 3GBを超えるデータセットをアップロードすると、ツールが不安定になる。(TPM-2121)

  • 更新ボタンが、Tableau出力ツールでもTableau入力ツールでも機能しない。(TFLN-1436)

v1.2.0

  • Alteryx DesignerおよびServer 2021.4.2パッチ4、2022.1パッチ2以降と互換性があります。

  • AMP Engineが必要です。

  • DCMのサポートを追加しました。

    • このコネクタをAlteryx Serverで実行するには、DCMが必要です。

  • SpatialObjのサポートが追加されました。

  • Windows証明書ストアに対して、SSL/TLS検証が実行されるようになりました。

  • FIPS対応。

既知の問題

  • Alteryx Server には、SDKアクセスモード設定の AllowAll 値が必要です。

  • Null値が0に変換されます。

v1.1.1

  • ブール値フィールドと日付時刻フィールドの変換に関する問題を修正しました。

v1.1.0

  • Tableau Serverオンプレミスのサポートが追加されました(Tableau Server 2019.2以降が必要)。

v1.0.1

  • Alteryx Designerバージョン2021.3以降と互換性があります。

  • 初回リリース。

  • サポートされている認証方法は、ユーザー名とパスワード、および個人のアクセストークンです。

  • データセット内の複数のテーブルを作成、上書き、追加、更新、またはアップサートします。

  • Post SQLのサポート。

  • プロキシのサポート。

  • WKTから空間オブジェクトへの変換のサポート。

既知の制限

  • v1.0.1はTableau Serverオンプレミスをサポートしていません。

  • 複数のテーブルを操作する場合は、.tdsファイルを提供する必要があります(Tableau Desktopから入手できます)。

接続に使用するAlteryxツール

Input Data Tool Icon データ入力ツール

Output Data Tool Icon データ出力ツールOutput Data Tool Icon データ出力ツール

Tableau Output Tool Tableau入力ツール

Tableau Output Tool Tableau出力ツール

Publish to Tableau Server Tool Icon Tableau Serverにパブリッシュツール

重要

  • データ入力ツール は、データをTableau Hyperデータ抽出(HYPER)ファイルとして読み取ります。このツールはローカルファイルのみをサポートします。

  • データ出力ツール は、Tableau Hyperデータ抽出(HYPER)ファイルとしてデータを保存します。このツールはローカルファイルのみをサポートします。

  • Tableau出力ツール はTableau Hyperデータセットを作成してTableauサーバーにアップロードするか、Tableau Hyperデータ抽出(HYPER)ファイルとしてローカルに保存します。

  • Tableau Serverにパブリッシュツール を廃止しました。機能はTableau出力ツールに置き換えられました。

データ接続マネージャー

Tableauツールバージョン1.2.0以降では、資格情報をより簡単かつ安全に保存できるように データ接続マネージャー がサポートされています。Tableauへの接続を作成し、Tableauツールを含むワークフローで保存された資格情報を簡単に再利用できます。Alteryx Serverで公開されたワークフローを正常に実行するには、保存された資格情報が必要です。

AMP Engineを有効にする

Tableauツールバージョン1.2.0以降を含むワークフローで AMP Engine が有効になっていることを確認します。

APIアクセス

Tableauツールには、TableauインスタンスへのAPIアクセスが必要です。Tableauツールを正常に動作させるためには、Tableau管理者に問い合わせて、インスタンスでCORSが有効になっていることと、許可されたホストにfile://の値が追加されていることを確認してください。

制限事項

ログインオプション

Tableauはシングルサインオンや多要素認証をサポートしていません。ユーザー名とパスワード、または個人のアクセストークンを使用したサインインのみがサポートされています。個人のアクセストークンは、永続的な認証トークンであり、ハードコードされた資格情報や対話型ログインを必要とせずにTableau REST APIを使用して自動化を実行できます。

Tableau出力ツール検索

検索は完全な名前でのみ実行されるため、単なる「名前」ではなく「データソース名」を指定する必要があります。

最大サイズのV_WStringとして読み取られるテキストフィールド

Designerバージョン2021.2以降、.hyperファイルから読み込むテキストフィールドは、データ損失を避けるために、最大サイズの V_WString として読み込みます。この問題を回避するには、データを他の形式に書き込む前に、[オートフィールド] または [セレクトツール] を使用します。

個人のアクセストークンを使用したTableauツールの使用制限

Tableauには、複数ユーザーが1つの個人アクセストークンを使用して、同時にTableau Serverセッションを要求できないという制限があるため、同一の個人アクセストークンを使用して複数のTableauツールを同時に実行することはできません。同一の個人アクセストークンを使用して同時セッションにサインインしようとすると、前のセッションが終了し、認証エラーが発生する可能性があります。詳細については、個人アクセストークンに関するTableauのヘルプドキュメントを参照してください。

このセクションの内容: