Bridge クライアントの設定の変更

Bridge クライアントでは、サイト管理者がクライアントの実行方法を変更するために構成できるいくつかの設定があります。データ ソースの所有者が Bridge (レガシー) スケジュールを実行するために自分のクライアントを保持している場合は、このトピックで説明するタスクの一部を担当することがあります。

Bridge を Windows サービスとして実行する

クライアントをプールに含めるには、クライアントを Windows サービス (サービス モード) として実行する必要があります。既定では、クライアントは Windows サービスとして実行するように設定されているため、専用のユーザーがマシンにログインしなくても、バックグラウンドでライブ クエリと更新を負荷分散できます。クライアントを Windows サービスとして実行するには、クライアントを実行する Windows ユーザー アカウントがマシンのローカル管理者グループのメンバーである必要があります。

注: データ ソースの所有者で、クライアントを自分で管理している場合、そのクライアントはプールに含まれません。ただし、マシンにログオンしていない場合でも、Bridge (レガシー) のスケジュールをバックグラウンドで実行する場合は、クライアントを Windows サービス (サービスモード) として実行している必要があります。

  1. Windows システム トレイを開き Bridge アイコンをクリックしてクライアントを開きます。

  2. [モード] のドロップダウン メニューから、[サービス] を選択します。サインイン ウィンドウが表示されます。

    Tableau Bridge を Windows サービスとして継続的に実行します。

  3. ローカル管理者の認証資格情報を入力します。

    Windows サービスのリストでは、Bridge が「Tableau Bridge service」と表示されます。これは、Windows の [サービス] コンソールまたはタスク マネージャーの [サービス] タブで確認できます。

Windows サービスとして実行する Bridge を停止する

クライアントをサービスとして実行しないようにするには、そのモードを変更します。

  1. Windows システム トレイを開き Bridge アイコンをクリックしてクライアントを開きます。

  2. [モード] のドロップダウン メニューから、[アプリケーション] を選択します。

    Tableau Bridge をサービスではなくアプリケーションとして実行します。

クライアントをアプリケーション モードで実行している場合、ライブ クエリおよびスケジュールされた更新は、クライアントを実行しているマシンでユーザーが Windows ユーザー アカウントにログインしている場合にのみ実行できます。

クライアントが関連付けられているサイトの切り替え

クライアントを使用して、別の Tableau Online サイトにパブリッシュされたデータ ソースを最新の状態に保つ必要がある場合は、、既存のクライアントのリンクを解除し、クライアントから新しいサイトに対して認証を行います。

  1. Windows システム トレイを開き Bridge アイコンをクリックしてクライアントを開きます。
  2. ドロップダウン メニューから、[リンク解除] を選択します。

    リンク解除によりすべてのデータ情報を削除し、Tableau Online への更新の送信を停止する

    リンク解除により、クライアントからデータ ソース、スケジュール、および接続情報のリストが削除されます。

  3. Windows システム トレイを開き Bridge アイコンをクリックしてクライアントを開きます。

  4. プロンプトが表示されたら、サイト管理者の認証資格情報を使用して新しいサイトにサインインします。

  5. クライアントを構成するには、次のいずれかまたは両方を実行します。

    • このクライアントがファイルベースのデータ ソースを更新する場合は、データ ソースの所有者に、データ ソースを再構成してスケジュールを更新するように依頼してください。

    • このクライアントでライブ接続を実行したり、推奨スケジュールを使用する接続を抽出したりする必要がある場合は、この新しいクライアントがプールの一部であることを確認します。詳細については、Bridge クライアントのプールの構成と管理を参照してください。

クライアントのリンクを解除する場合は、クライアントが更新していたデータ ソースの Bridge (レガシー) スケジュールも削除する必要があります。他のデータ ソースでは、データの鮮度に関するタスクが、プール内の他の登録済みクライアントによって引き続き実行されます。

詳細については、終了とリンク解除の影響を参照してください。

更新のタイムアウト制限の構成

抽出または更新の誤用を制御するには、クライアントが実行する更新の時間制限 (タイムアウト制限とも呼ばれます) を適用できます。タイムアウト制限は、単一の抽出がクライアントによりキャンセルされるまでに更新を完了させることができる最長許容時間です。抽出更新がタイムアウト制限によりキャンセルされると、クライアントにメッセージが表示され、データ ソース の所有者にメール アラートが送信されます。

クライアントのタイムアウト制限は、既定で 24 時間に設定されています。クライアントのタイムアウト制限は、Bridge の構成ファイルで変更できます。

注: 構成ファイルに加えた変更を有効にするには、クライアントを再起動する必要があります。

  1. クライアントをインストールしているマシンで、My Tableau Bridge Repository の Configuration フォルダーに移動します。

    構成フォルダーの既定の場所は C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration です。

  2. TabBridgeClientConfiguration.txt ファイルを開きます。

  3. extractRefreshTimeout の横で、更新タスクの完了までに許可された時間を変更します。

    注: 構成ファイルにパラメーターが表示されない場合は、以下の例のように "extractRefreshTimeout" : 08:00:00"dataSourceRefreshSettings 設定に追加できます。

  4. ファイルを保存して閉じます。

  5. 変更を有効にするには、クライアントを終了して再起動します。クライアントを再起動する方法は、クライアントをアプリケーション モードで実行しているか、サービス モードで実行しているかによって変わります。

    • アプリケーション モードの場合、クライアント メニューより [終了] を選択します。

    • サービス モードの場合、[モード] ドロップダウン メニューより [アプリケーション] を選択し、クライアント メニューから [終了] を選択します。

Bridge ログ ファイルの管理

クライアントは、正常動作の一環としてアクティビティのログを作成します。Bridge の問題をトラブルシューティングする場合、または Tableau サポートが問題を解決するためにログを要求する場合に、これらのログの使用が必要になることがあります。

Bridge ログ ファイルのサイズを管理したり、TabBridgeClientConfiguration.txt ファイルでログ ファイルが削除されるまでの時間を長くしたりすることができます。

構成可能なオプション

  • maxLogFileSizeInMB: 既定では、Bridge ログで許容される最大ファイル サイズは 25 MB です。ログ ファイルがそのサイズ制限を超過する場合、新しいログ ファイルが作成されます。

  • maxBackupLogFileCount: 許可される Bridge ログ ファイルの既定の最大値は 40 です。ログ ファイルの数が制限を超えると、最も古いログ ファイルが削除されます。

  • remoteRequestLogFileLifeSpan: クライアントに送信される Bridge 更新ジョブごとに、次の新しいログ ファイルのセットが作成されます。tabbridgeclijob_<process_id>jprotocolserver_<process_id>stdout_jprotocolserver_<process_id>既定では、ログ ファイルの数が maxBackupLogFileCount を超過した場合、ログ ファイルが削除される前に Logs フォルダーに残る最大時間は 8 時間です。それ以外の場合、これらのログ ファイルは無期限に残りますが、ログ ファイルの数は maxBackupLogFileCount より少ないか、同じになります。

    注: ここでは <process_id> は Windows プロセス ID を表します。

注:tabprotosrv* という名前のログ ファイルは、他の Bridge ログ ファイルとは異なります。ログ ファイルの最大サイズは 1 MB で、許可される最大数は 8,192 です。また、これらの値は構成できません。

  1. クライアントをインストールしているマシンで、My Tableau Bridge Repository の Configuration フォルダーに移動します。

    構成フォルダーの既定の場所は C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration です。

  2. TabBridgeClientConfiguration.txt ファイルを開きます。

  3. loggerSettings の隣にある以下のパラメーターの値を変更することができます。

    "maxLogFileSizeInMB" : 25

    "maxBackupLogFileCount" : 40

    "remoteRequestLogFileLifeSpan" : "08:00:00"

  4. ファイルを保存して閉じます。

  5. 変更を有効にするには、クライアントを終了してから再起動します。クライアントを再起動する方法は、クライアントをアプリケーション モードで実行しているか、サービス モードで実行しているかによって変わります。

    • アプリケーション モードの場合、クライアント メニューより [終了] を選択します。

    • サービス モードの場合、[モード] ドロップダウン メニューより [アプリケーション] を選択し、クライアント メニューから [終了] を選択します。

    Bridge プールのサイズの管理

    既定では、プール内の各クライアントは、一度に最大 10 個の更新ジョブを負荷分散できます。特定の時間に実行されている更新ジョブの数がクライアント プールの容量を超えた場合、またはその超過に対応するハードウェア リソースがある場合は、各クライアントの容量を増やすことを検討してください。

    クライアントのプーリング容量は、TabBridgeClientConfiguration.txt ファイルで管理できます。

    構成可能なオプション

    • ConnectionPool: これは、クライアントが許可する同時更新ジョブの絶対最大数です。既定値は 10、最小許容値は 1、最大許容値は 100 です。この値を変更するには、クライアントのリンクを解除する必要があります。

    • maxRemoteJobConcurrency: これは、クライアントが許可する同時更新ジョブの最大数です。ConnectionPool の絶対値を変更せずに、これを使用してクライアントのパフォーマンスの問題を調整またはトラブルシューティングできます。既定値は 10 です。この値は、ConnnectionPool に指定された値と同じかそれより小さくなければなりません。この値を変更する場合、クライアントのリンクを解除する必要はありません。

    ConnectionPool を変更するには

    重要: 以下に説明する手順では、クライアントのリンクを解除する必要があります。リンクを解除すると、サイトとクライアントとの関連付けが解除されます。つまり、Bridge (レガシー) スケジュールを使用して更新されるデータ ソースでは、クライアントのリンクを解除すると、それらのデータ ソース、そのスケジュール、およびクライアントからの接続情報への関連付けが解除されます。Bridge プールのサイズを変更する際は、再スケジュール プロセス (ステップ 10) を円滑に行えるように、Windows システム トレイの Bridge アイコンをクリックして、一覧表示されているデータ ソース (ステップ 5) を確認することをお勧めします。

    1. クライアントをインストールしているマシンで、My Tableau Bridge Repository の Configuration フォルダーに移動します。

      Configuration フォルダーの既定の場所は、C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration です。

    2. TabBridgeClientConfiguration.txt ファイルを開きます。

    3. ConnectionPool の横にある値を編集します。

    4. ファイルを保存して閉じます。

    5. (オプション) Windows システム トレイの Bridge アイコンをクリックし、一覧表示されているデータ ソースとそれらのデータ ソースに対して構成されている更新スケジュールを確認します。
    6. Windows システム トレイで Bridge アイコンを右クリックし、[リンク解除] を選択します。

      リンク解除オプションの詳細については、終了とリンク解除の影響を参照してください。

    7. 変更を有効にするには、クライアントを終了します。クライアントの終了方法は、クライアントをアプリケーション モードで実行しているか、サービス モードで実行しているかによって変わります。

      • アプリケーション モードの場合、クライアント メニューより [終了] を選択します。

      • サービス モードの場合、クライアント メニューから [終了] を選択します。ダイアログ ボックスで、[Exit client and stop activities (クライアントを終了してアクティビティを停止する)] チェック ボックスをオンにし、[閉じる] をクリックします。

    8. Bridge を再起動します。

    9. プロンプトが表示されたら、サイト管理者の認証資格情報を使用して Tableau Online にサインインします。

    10. (オプション) Bridge (レガシー) スケジュールを使用するデータ ソースのステップ 5 を実行した場合は、新しい Bridge (レガシー) スケジュールの追加または既存の Bridge (レガシー) スケジュールの更新で説明されている手順に従って、更新を再スケジュールし、データ ソースとクライアントとをもう一度効果的に関連付けます。

maxRemoteJobConcurrency を変更するには

  1. クライアントをインストールしているマシンで、My Tableau Bridge Repository の Configuration フォルダーに移動します。

    Configuration フォルダーの既定の場所は、C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration です。

  2. TabBridgeClientConfiguration.txt ファイルを開きます。

  3. maxRemoteJobConcurrency の横にある値を編集します。

  4. ファイルを保存して閉じます。

  5. 変更を有効にするには、クライアントを終了します。クライアントの終了方法は、クライアントをアプリケーション モードで実行しているか、サービス モードで実行しているかによって変わります。

    • アプリケーション モードの場合、クライアント メニューより [終了] を選択します。

    • サービス モードの場合、クライアント メニューから [終了] を選択します。ダイアログ ボックスで、[Exit client and stop activities (クライアントを終了してアクティビティを停止する)] チェック ボックスをオンにし、[閉じる] をクリックします。

  6. Bridge を再起動します。

  7. プロンプトが表示されたら、サイト管理者の認証資格情報を使用して Tableau Online にサインインします。

  8. (オプション) Bridge (レガシー) スケジュールを使用するデータ ソースのステップ 5 を実行した場合は、新しい Bridge (レガシー) スケジュールの追加または既存の Bridge (レガシー) スケジュールの更新で説明されている手順に従って、更新を再スケジュールし、データ ソースとクライアントとをもう一度効果的に関連付けます。
ありがとうございます!