Tableau Server での Web データ コネクタ

Web データ コネクタ (WDCs) とは、Tableau 内でコネクタをまだ持たないデータ ソースに対して HTTP 経由でアクセス可能なデータ接続を提供する Web ページです。WDC を使用すると、ユーザーは Web 上でアクセス可能なほぼすべてのデータに接続し、ワークブック用に抽出を作成できます。WDC 用のデータ ソースには、内部 Web サービス、JSON データ、REST API、HTTP または HTTPS 経由で利用可能な他のソースを含めることができます。ユーザーは独自の WDC を作成するか、他のユーザーが作成したコネクタを使用できます。

Tableau Desktop での WDC の使用方法の詳細については、Tableau Desktop ドキュメントの「Web データ コネクタ」を参照してください。

WDC の作成方法の詳細については、Github の「Web データ コネクタのドキュメント」を参照してください。

Tableau Server でコネクターを実行する前に

このトピックで説明しているように、セキュリティ対策として、コネクタを承認しない限り、Tableau Server は WDC を実行しません。

: WDC の Tableau Server の使用は、サーバー管理者が承認する必要があります。

WDC には実行可能コードが含まれており、通常、サードパーティの Web サイトへの要求を行うため、管理者による承認が必要です。ユーザーがTableau Serverとともに WDC を使用する前に、コネクタが使用するドメインとポートのいずれかをセーフ リスト (ホワイトリスト) に追加し、コネクタがリクエストを送受信できるドメインを 2 番目のセーフ リスト (2 番目のホワイトリスト) に含める必要があります。これを行う前に、コネクターの挙動およびどのようなサイトに接続するかについて理解できるようにコネクターを入念に検査し、テストすることをお勧めします。詳細については、Web データ コネクタのテストおよび入念な検査を参照してください。

コネクターをセーフ リスト (ホワイトリスト) に追加する場合は、コネクターがホストされている特定の URL への接続およびコネクターが照会できる URL からの接続を許可するよう Tableau Server を構成します。これが、Tableau Server で WDC の実行を許可する唯一の方法です。その後、コネクターは組織のファイアウォール内にあるサーバー上か、外部ドメインにあるサーバー上でホストできます。Tableau Server では、WDC のインポートはサポートされていません。

セーフリスト内のコネクタの管理

WDC をセーフ リストに追加するには、tsm data-access web-data-connectors add コマンドを使用します。以下に説明されている、このコマンドと関連コマンドを使用すると、以下のタスクを実行できます。

  • WDC をセーフ リストおよび 2 番目のセーフリストに追加します。

  • すべての WDC、または WDC 更新を許可または却下します。

  • セーフ リストから 1 つ以上のコネクタを削除します。

  • セーフ リストおよび 2 番目のセーフ リストにあるすべての WDC をリストします。

WDC セーフ リストの更新にはサーバーの再起動が必要

WDC に変更を加えるすべてのコマンドの実行後、tsm pending-changes apply コマンドを使用して保留中の変更を適用する必要があります。

pending-changes apply コマンドは、Tableau Server が実行中の場合にはそれが再起動することを知らせるプロンプトを表示します。このプロンプトはサーバーが停止しても表示されますが、その場合には再起動は行われません。--ignore-prompt オプションを使用してメッセージが表示されないようにできますが、そのようにしても再起動に関する動作が変わることはありません。詳細については、tsm pending-changes applyを参照してください。

コネクタをセーフリストおよび二番目のセーフリストに追加する

コネクタをセーフ リストおよび 2 番目のセーフ リストに追加するには、tsm data-access web-data-connectors add コマンドを使用し、名前、セーフ リストの URL、2 番目のセーフ リストの URL を指定します。web-data-connector-settings エンティティ を使用して WDC を管理することもできます。このコマンドを実行した後、tsm pending-changes apply コマンドを使用して保留中の変更を適用する必要があります。

tsm data-access web-data-connectors add --name 'WTA WDC' --url https://dtreskunov.github.io:80/wta-wdc/ --secondary https://dtreskunov.github.io/(.*)

書式設定のための注

  • カールした引用符や「スマート」引用符ではなく、必ず直線の引用符 (" および ') を使用して WDC の名前を囲ってください。
  • 多くの WDC では --url オプションで指定されているポートは 443 または 80 ですが、Tableau Server のデータソースの詳細を確認することで、コネクタの値を確認することができます。
  • WDC が複数ドメインとの間でリクエスト送信とデータ受信を行う場合、--secondary オプションで URL のコンマ区切りリストを使用します。
  • 2 番目のセーフ リストにドメイン全体を追加するには、ドメイン URL の末尾をワイルドカードの式にします。ドメイン全体を示すには、ワイルドカードとして (.*) を使用します。式の一部として丸括弧 () を含めるようにしてください。

WDC または WDC 抽出更新の許可または却下

WDC または WDC 抽出更新を許可または却下するには、tsm pending-changes apply の実行前に以下のコマンドを使用します。

tsm data-access web-data-connectors allow

セーフ リストから 1 つ以上の WDC を削除します。

セーフ リストから 1 つ以上の WDC を削除するには、tsm pending-changes apply の実行前に以下のコマンドを使用します。

tsm data-access web-data-connectors delete

セーフ リストにあるすべての WDC のリスト

セーフ リストにあるすべての WDC をリストするには、以下のコマンドを使用します。

tsm data-access web-data-connectors list

コネクターの抽出の更新

ユーザーが WDC を使用するワークブックを作成すると、Tableau Server はそのコネクタが返すデータから抽出を作成します。その後、ユーザーがワークブックをパブリッシュすると、パブリッシュのプロセスがサーバーにワークブックとデータ抽出を送信します。

Tableau は、他の抽出を更新できるのと同様に、WDC によって作成された抽出を更新できます。Web ベースのデータ ソースにサインインするためにコネクタが認証資格情報を必要とする場合は、認証資格情報がデータ ソースに埋め込まれており、WDC がサーバーのセーフ リストに含まれていることを確認する必要があります。コネクタが認証資格情報を必要とし、それらがデータ ソースに埋め込まれていない場合、Tableau Server は抽出を更新できません。これは、スケジュールまたは他のバックグラウンド状況で更新が発生する可能性があり、サーバーは認証資格情報を求めるプロンプトを表示できないためです。

現在、Tableau Server から直接データ ソースを再認証する方法はありません。データ ソースが期限切れの認証資格情報を保持している、または認証資格情報が埋め込まれずにパブリッシュされた場合は、ワークブックとデータ抽出を新しい埋め込み認証資格情報とともに、再度パブリッシュする必要があります。

更新操作を実行するバックグラウンド プロセスが失敗した場合、この問題を示すアラートとログ エントリが作成されます。ユーザーには、抽出のタイムスタンプが変更されないことがわかります。

すべての WDC で更新を無効にするには、tsm data-access web-data-connectors allow -r false コマンドを使用します。

トラブルシューティング

コネクタをセーフ リストに追加する際にサーバーに問題が発生した場合は、ログ ファイルを調べることができます。初期サーバー ノードおよびゲートウェイ プロセスを実行しているその他のノードのログ ファイルを必ず確認してください。ログ ファイルの詳細については、サーバー ログ ファイルの場所を参照してください。

WDC によって作成された抽出を Tableau Server が更新できない問題が発生している場合は、webdataconnector.refresh.enabled 構成設定が true に設定されていることを確認してください。false に設定されている場合は、以下のコマンドを実行し、サーバー上のすべての WDC で抽出更新を許可してください。

tsm data-access web-data-connectors allow -r true

: セーフ リストは、Tableau Serverで Web データ コネクタの実行を許可する唯一の方法です。Web データ コネクタのインポートは、バージョン 10.5 以降では廃止されています。

ご意見をお寄せくださりありがとうございます。 ご意見の送信中にエラーが発生しました。もう一度実行するか、当社にメッセージを送信してください