Tableau® コネクターを使用すると、チェーンでコマンド を使用して Tableau と対話することができます。例えば、このコネクターを使えば、次のことができる:
- ユーザーをTableauグループまたはサイトに追加する
- Tableauデータおよびハイパーエクストラクトの構築
- Tableauでの権限の一括削除・更新
- Tableauプロジェクト、グループ、サイトの作成と管理
- Tableauデータソースとビューの管理
メモ: このコネクターはWorkivaによって構築され、サードパーティのシステムに接続する。Workivaサポートチームは、お客様のワークスペース内でこのコネクターの構成をヘルプすることはできますが、Workivaプラットフォーム外で発生した問題のトラブルシューティングやその他のサポートを行うことはできません。
前提条件
接続を有効にするには、コネクターは基本的なユーザー名とパスワード認証で保護された Tableau REST API を使用します。コネクターの設定には、以下のものが必要だ:
- コネクター用にTableauで設定された統合ユーザー
- 統合ユーザーの認証情報
- 接続する Tableau インスタンスの URL。たとえば、Tableau Online の場合は
https://[region].online.tableau.comのようになります。 - Tableauインスタンス内の接続先サイト
-
Tableauインスタンスが使用するAPIバージョン、または接続するTableauのバージョン
ヒント Tableau バージ ョ ンの検索方法については、Tableau のナレッジ ベース を参照して く ださい。
コネクターのBuild Hyper Extract またはBuild TDE Extract コマンドを GroundRunner で使用するには、そのサーバーに Tableau Extract API をインストールし、そのダイナミック リンク ライブラリ(DLL)ファイルをC:㊦WindowsSystem32 などのレジストリが使用するフォルダに移動します。Tableau Extract API の イ ン ス ト ール方法については、Tableau Extract API ドキュメントを参照して く ださい。
対応バージョン
- 8.3
- 9.x
- 10.x
- 2018.x
- 2019.x
- 2020.1および2020.2
- Tableauオンライン
メモ: Tableau の四半期ごとのアップデートにより、新しい API バージョンがコネクターのオプションとして表示されない場合がありますが、後方互換性により引き続きサポートされています。
サイトコンテンツURL名称の決定
Tableau の各インスタンスにはデフォルトのサイトがデプロイされますが、組織によっては追加のサイトをデプロイすることもできます。コネクターのサイトコンテンツ URL 名称 プロパティは、接続先のサイトを示します。Site コンテンツ URL 名称 の値を決定するには、接続先の Tableau コンテンツの URL を確認します:
- デフォルト・サイトのURLは、
https://our.tableau.online.hostname/#/workbooksの書式設定に従っている。デフォルトサイトに接続するには、DefaultにSite content URL nameと入力します。 - 追加サイトのURLは、
https://our.tableau.online.hostname/#site/[site ID]/workbooksの書式設定に従う。追加サイトに接続するには、サイトコンテンツURL名称の[サイトID] の部分に値を入力します、
メモ: サイトコンテンツURL名称 プロパティは大文字と小文字を区別する。
Tableauコネクターの設定
注: 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。
- チェーンビルダー から、接続 をクリックし、右上の作成 をクリックします。
-
Connector Connection の下で、Tableau とデフォルトの CloudRunner を選択します。
- [基本情報]で、接続の識別に役立つ一意の名前と説明を入力します。
-
プロパティ で、コネクターの詳細を入力します:
プロパティ 詳細 ユーザー名 コネクターの Tableau 統合ユーザー名を入力します。 パスワード ユーザー名 プロパティのパスワードを入力します。 Tableau URL Tableau Online の場合は https://us-east-1.online.tableau.comのように、接続する Tableau インスタンスのベース URL を入力します。サイトコンテンツURL名称 Tableauインスタンス内で接続するサイトのIDを入力します:
- 組織のデフォルト Tableau サイトに接続するには、
Defaultと入力します。 - 組織が配備した追加サイトに接続するには、コンテンツのURLに
/#site/の後に表示されるIDを入力する。
メモ: サイトコンテンツのURL名称 は大文字と小文字を区別する。
バージョン Tableau のバージョンに基づいて、Tableau インスタンスが使用する API バージョンを選択します。
メモ: バージョンがオプションにない場合は、最新のAPIバージョンを選択してください。
注:機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準(AES)-256暗号化で保存されます。
- 組織のデフォルト Tableau サイトに接続するには、
- 接続に使用する環境を選択し、保存します。
- 接続をテストするには、 コネクターのサイト取得 コマンド でチェーン を作成・実行し、有効な出力を返すことを確認する。
トラブルシューティング
Tableauへの接続に失敗した場合:
- 統合ユーザーの認証情報を確認します。
- 接続先のTableauインスタンスとサイトのベースURLとサイトIDを確認します。
- コネクターに選択した API バージョンが、Tableau インスタンスのバージョンと一致することを確認します。
コマンドがSuccessの終了コードを返したが出力がない場合は、コネクターのサイトコンテンツURL名称 に入力されたサイトIDを確認してください:
- 組織のデフォルト Tableau サイトに接続するには、
Defaultと入力します。 - 組織が配備した追加サイトに接続するには、コンテンツのURLに
/#site/の後に表示されるIDを入力する。