tabcmd

注: tabcmd コマンドラインユーティリティバージョン 2.0 は、Tableau tabcmd(新しいウィンドウでリンクが開く) で入手できます。この新バージョンでは、MacOS や Lunux で tabcmd コマンドを実行し、個人アクセストークン (PAT) を使って認証することができます。バージョン 2.0 は、Python ベースの Tableau Server クライアント (TSC) で使用可能なパブリックエンドポイントに基づいて構築されています。この最新バージョンでは、Tableau Server のサポートに制限があります。

Tableau では、Tableau Server サイトでのサイト管理タスクの自動化に使用できる tabcmd コマンドラインユーティリティを提供しています。サイトの管理タスクを自動で実行できます (ユーザー、プロジェクト、グループの作成や削除など)

注: Tableau バージョン 2024.1 より前では、tabcmd バージョン 1 は Viz のエクスポートには機能しません。

このユーティリティは Tableau Server に含まれ、サーバーノードに自動でインストールされています。このユーティリティは他のコンピューターから実行することもできます (Tableau Server のインストールに含まれていないコンピューターも含む)。ただし、これには Tableau の Web サイトから tabcmd インストーラーをダウンロードする必要があります。詳細については、tabcmd のインストールを参照してください。

tabcmd のインストール

注: これらの手順は、tabcmd 1.0 コマンドラインユーティリティをインストールするためのものです。tabcmd 2.0 コマンドラインユーティリティをインストールするには、Tableau tabcmd(新しいウィンドウでリンクが開く) (新しいウィンドウ) に移動します。

Tableau Server または Tableau Cloud を新しいバージョンにアップグレードする際に、更新後のバージョンの tabcmd が必要な場合は、Tableau Web サイトの Tableau Server リリースページからダウンロードできます。

Tableau Server の場合は、サーバーバージョンと一致するバージョンをダウンロードすることをお勧めします。Tableau Cloud の場合は、バージョンの不適合によって生じる問題を避けるために、常に最新バージョンをダウンロードすることをお勧めします。どちらの場合でも、古いバージョンの tabcmd を使用すると、エラーや予期しない結果を引き起こすことがあります。

Web ブラウザーを開き、Tableau Server リリース(新しいウィンドウでリンクが開く) ページに移動します。Tableau Online を使用している場合でも、このページに移動します。
次の製品を使用している場合:
- Tableau Cloud では、Tableau tabcmd 2.0(新しいウィンドウでリンクが開く) (新しいウィンドウ) を使用します。
- Tableau Server (Windows または Linux): お使いのサーバーバージョンと一致するリリースを選択してください。
どちらの場合でも、展開された情報にメンテナンスリリースが表示されていれば、最新のメンテナンスリリースまたはサーバーバージョンと一致するものを選択してください。
これによりリリースノートページ (解決済みの問題) が表示され、セキュリティ改善と解決した問題について読むことができます。
解決した問題の下にある [ファイルのダウンロード] セクションまでスクロールして、tabcmd コマンドを実行する予定のコンピューターと互換性のある tabcmd ダウンロードリンクを選択します。
残りの手順では、このコンピューターを "tabcmd コンピューター" と呼びます。
インストーラーを tabcmd コンピューターまたはそのコンピューターからアクセス可能な場所 (たとえば、マウントされたドライブ) に保存します。
tabcmd コンピューターのオペレーティングシステムで適切なインストール手順を完了します。
- Windows
  既定では、tabcmd は C:\Program Files\Tableau\Tableau Server\<version>\extras\Command Line Utility にインストールされています。これはインストール中に変更でき、C:\ドライブ (C:\tabcmd) の tabcmd という名前のフォルダーに tabcmd をインストールすることを推奨します。これにより、検索と実行が容易になり、Windows PATH に tabcmd ディレクトリを追加すると、Windows オペレーティングシステムに関するいくつかの制限に対応できます。
  注:tabcmd 設定プログラムは、tabcmdディレクトリを Windows PATH 変数に追加しません。手動で追加するか、呼び出すたびに tabcmd への完全パスを含めることができます。
  tabcmd は、Windows に次の 2 つの方法でインストールできます。
  - インストーラーをダブルクリックして、UI の手順に従います。
    使用許諾契約書に同意します。
    既定以外の場所にインストールする場合は、[カスタマイズ] をクリックし、tabcmd をインストールする場所を入力または参照します。
    [インストール] をクリックします。
    Windows Defender ファイアウォールまたはユーザーアカウントによるメッセージが表示される場合は、[アクセスを許可] をクリックします。
  - インストーラーをコマンドプロンプトから実行します。
    tabcmd コンピューターで管理者としてコマンドプロンプトを開きます。
    Tabcmd インストーラーをコピーしたディレクトリに移動します。
    tabcmd のインストール:
    tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1
    既定以外の場所へのインストール:
    tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="<path\to\install\directory>"
    例:
    tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="C:\tabcmd"
    tabcmd インストーラーで使用できるコマンドラインオプションの完全な一覧については、/?を指定してインストーラーを実行します。tabcmd インストーラーのコマンドラインオプションの詳細については、tabcmd 用のスイッチとプロパティのインストール (Windows)を参照してください。
  tabcmd のセットアッププログラムでは、tabcmd のインストールで問題が発生した場合に使用できるログが C:\Users\<user>\AppData\Local\Temp 内に作成されます。ログでは、Tableau_Server_Command_Line_Utility_(<version_code>)_##############.log という命名規則が使用されます。
- Linux
  注: Linux コンピューターで tabcmd を実行するには、Java 11 がインストールされている必要があります。RHEL ライクなシステムでは、これは tabcmd のインストール時に依存関係としてインストールされます。Ubuntu のようなシステムでは、Java 11 がまだインストールされていない場合は個別にインストールする必要があります。
  
  2022 年 7 月の時点で、Debian ディストリビューションはサポートされなくなりました。詳細については、Tableau コミュニティのこの投稿(新しいウィンドウでリンクが開く)を参照してください。
  1. sudo アクセスのあるユーザーで tabcmd コンピューターにログインします。
  2. ダウンロードした .rpm または .deb パッケージをコピーしたディレクトリに移動します。
    CentOS を含む RHEL ライクなディストリビューションで、次のコマンドを実行します。
    sudo yum install tableau-tabcmd-<version>.noarch.rpm
    Ubuntu で次のコマンドを実行します。
    sudo apt-get install ./tableau-tabcmd-<version>_all.deb
Linux PC から tabcmd をアンインストールするには、実行中の各種 Linux に関するドキュメントを参照してください。
(オプション) tabcmd がインストールされている完全修飾場所をお使いのシステムパスに追加すると、その場所へ変更したり、各コマンドで場所を指定したりせずに tabcmd コマンドを実行できます。この手順は、オペレーティングシステムの種類とバージョンによって異なります。詳細については、「PATH (変数)」を参照してください。

tabcmd の使用方法

tabcmd を使用する基本的な手順は次のとおりです。

管理者としてコマンドプロンプトを開きます。
注: Windows では、PowerShell を使用して tabcmd コマンドを実行しないでください。PowerShell を使用すると、予期しない動作が発生する可能性があります。
Windows コンピューターで、最初のノード以外のコンピューターに tabcmd をインストールした場合は、tabcmd をインストールしたディレクトリに変更します。
Linux コンピューターでは、インストールディレクトリに変更する必要はありません。
tabcmd コマンドを実行します。

tabcmd を使用する場合、認証されたサーバーセッションを確立する必要があります。セッションは、Tableau Server や Tableau Cloud サイト、およびセッションを実行しているユーザーを識別します。最初にセッションを開始してコマンドを指定するか、セッションの開始とコマンドの実行を一度に行うことができます。

重要: tabcmd を使用して複数のタスクを実行している場合、各タスクを同時に (並行して) ではなく、順番に (連続して) 実行する必要があります。

コマンド (login など) およびオプション ( -s、-u など) は大文字と小文字を区別しませんが、ユーザーが指定する値 (User@Example.com など) は大文字と小文字を区別します。

例

次のコマンドは、Tableau Serverでの tabserver.mycompany.com という名前のセッションの開始を示します。

tabcmd login -s http://tabserver.mycompany.com -u admin -p mypassword

次の例は、Sales_Workbookというワークブックを削除するコマンドを示します。

tabcmd delete "Sales_Workbook"

次に、1 つのコマンドで上記の手順すべてを達成する方法を示します。ここで login は必要ありません。

tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -u admin -p mypassword

Tableau Server では複数のサイトを実行できます。ワークブックがマルチサイトサーバーの既定サイトにある場合、既定を指定する必要はありません。上記のコマンドで十分です。ただし、コマンドが既定以外のサイトのものに適用されている場合、そのサイト用にサイト ID を指定する必要があります (loginを参照)。West Coast Sales サイト上にあるワークブックの場合の同じコマンドは、次のとおりです (サイト ID は wsales)。

tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -t wsales -u admin -p mypassword

オプションの -s、-t、-u、-p などは、tabcmd間のグローバル変数であるため、任意のコマンドと共に使用できます。

詳細については、tabcmd コマンドを参照してください。

ステータスメッセージおよびログ

コマンドが成功すると、tabcmdはステータスコード 0 を返します。0 以外のステータスコードの詳しいエラーメッセージは stderr に出力されます。また、情報提供や進捗状況のメッセージも stdout に出力されます。

デバッグ、進捗状況、エラーメッセージを含む tabcmd.log という名前の詳細ログが <home dir>/.tableau/tabcmd/ に書き込まれます。

このセクションの他の記事

一番上に戻る

フィードバックをお送りいただき、ありがとうございます。

フィードバックは正常に送信されました。ありがとうございます!

Tableau Server on Linux ヘルプ

tabcmd

tabcmd のインストール

tabcmd の使用方法

例

ステータス メッセージおよびログ

このセクションの他の記事

ステータスメッセージおよびログ