Tableau Serverで出来る事のまとめ(コマンドラインツール＆API編)

しんや

2015.01.08

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

Tableau製品では日々の作業やタスクについて様々なオペレーションが存在しますが、それらのオペレーションについては各種コマンドラインツールやAPIで実行を代替する事が可能だったりします。つまり、何かしらのスクリプトやプログラミング言語で処理を実装し、スケジューラ等に噛ませておく事で自動化機構に組み込む事も可能な訳です。当エントリではその足掛かりとなる情報について、Tableau公式で展開されているものをひと通りまとめてみたいと思います。(以前投稿した以下エントリの姉妹編的な位置付け、という感じです)

Tableau Serverで出来る事のまとめ｜ Developers.IO

ツール	Tableau Desktop	Tableau Server
tabadminコマンド	ー	◯
tabcmdコマンド	ー	◯
Tableauデータ抽出コマンドラインユーティリティ	◯	ー
Tableauデータ抽出API	◯	◯
REST API	◯	◯
JavaScript API	◯	◯

コマンド名	説明
＜ライセンス周りの管理＞
tabadmin activate	Tableau Serverライセンスのアクティブ化・非アクティブ化
tabadmin licenses	Tableau Server 用のライセンス情報を表示
tabadmin validate	対象環境がTableau Server導入最小要件を満たすかチェック
＜ユーザー権限周りの管理＞
tabadmin administrator	システム管理者機能を、指名されたユーザーに許可or削除
tabadmin assetkeys	外部データベースのクレデンシャルなどの機密情報を暗号化
＜アクセス権限周りの管理＞
tabadmin dbpass	Tableau の PostgreSQL データベース (リポジトリ) への外部アクセスを制御
tabadmin passwd	Tableau Server アカウントのパスワードをリセット
＜Tableau Serverの挙動に関する管理＞
tabadmin status	Tableau Serverのステータス確認
tabadmin start	Tablaeu Serverの起動
tabadmin stop	Tableau Serverの停止
tabadmin restart	Tableau Serverの再起動
tabadmin autostart	Tableau Server をシステム開始時刻に起動(default: on)
tabadmin warmup	各 VizQL サーバープロセスを vizql DLL ファイルに読み込むように設定(サーバの暖機運転)
＜Tableau Serverの構成に関する設定＞
tabadmin configure	Tableau Server の構成を更新
tabadmin customize	Tableau Serverで使う名前及びロゴのカスタマイズ
tabadmin set	Tableau Server の構成オプションの値の変更を許可
＜コンテンツに関する設定＞
tabadmin exportsite	サイトのエクスポート実行
tabadmin importsite	サイトのインポート実行
tabadmin importsite_verified	サイトのインポート実行
tabadmin sitestate	サイトインポート失敗のためのサイトステータス制御
＜バックアップ・リストアに関する作成＞
tabadmin backup	Tableau Server によって管理されるデータのバックアップを作成
tabadmin restore	Tableau Server バックアップファイル (.tsbak) を Tableau Server インストール環境に復元
tabadmin ziplogs	Tableau Serverのログファイル作成
tabadmin cleanup	Tableau Server によって消費される全体のディスク容量を削減(お掃除コマンド)
tabadmin failoverprimary	プライマリ Tableau Server の二次インストールに関する設定

tabcmdコマンド

Tableau Server導入時に一緒に入ってくるコマンドラインツールその2。tabadminは管理系のコマンド全般な感じですが、こちらのtabcmdはそれ以外の一般的な作業で使えるようなコマンドが用意されている感じです。Tableau Server導入時に入ってくるツールをそのまま使うか、またはTableau Server導入時に配備されるインストーラを用いて別途デスクトップ環境等にコマンド実行環境を用意する事も出来るようです。

tabcmd

用途別のコマンド一覧は以下の通り。

コマンド名	説明
＜ユーザーに関する操作＞
tabcmd addusers group-name	--users 引数のリストに含まれているユーザーを、指定した group-name のグループに追加。
tabcmd createsiteusers filename.csv	ユーザーをサイトに追加。
tabcmd createusers filename.csv	指定したコンマ区切り値 (CSV) ファイルに含まれているユーザーを作成。
tabcmd deleteusers filename.csv	指定したコンマ区切り (CSV) ファイルに含まれているユーザーを削除。
tabcmd removeusers group-name	指定された group-name を持つグループから、--users 引数でリストされているユーザーを削除。
＜グループに関する操作＞
tabcmd creategroup group-name	指定されたグループ名を使用してグループを作成。
tabcmd deletegroup group-name	指定した group-name のグループをサーバーから削除。
＜プロジェクトに関する操作＞
tabcmd createproject project-name	指定されたプロジェクト名を使用してプロジェクトを作成。
tabcmd deleteproject project-name	指定した project-name のプロジェクトをサーバーから削除。
＜サイトに関する操作＞
tabcmd createsite site-name	指定されたサイト名を使用してサイトを作成。
tabcmd deletesite site-name	指定したサイト名のサイトをサーバーから削除。
tabcmd editsite site-name	サイトまたはその Web フォルダー名を変更。
tabcmd listsites	ログインしたユーザーが属しているサイトのリストを返す。
＜ワークブック・データソースに関する操作＞
tabcmd delete workbook-name または tabcmd delete datasource-name	指定のワークブックまたはデータソースをサーバーから削除。
tabcmd export	Tableau Server からビューまたはワークブックをエクスポートして、ファイルに保存。
tabcmd publish filename.twb(x) または tabcmd publish filename.tds(x) または tabcmd publish filename.tde	指定したワークブック (.twb(x))、データソース (.tds(x))、またはデータ抽出 (.tde) を Tableau Server にパブリッシュ。
tabcmd refreshextracts workbook-name または tabcmd refreshextracts datasource-name	指定されたワークブックまたはデータソースに属する抽出の完全更新または増分更新を実行。
＜その他操作＞
tabcmd get url	パラメーターの 1 つに URL 文字列を使用する事でTableau Serverの HTTP GET 要求を作成。
tabcmd login	Tableau Server ユーザーでログイン。
tabcmd logout	サーバーからログアウト。
tabcmd runschedule schedule-name	指定されたスケジュールを実行。
tabcmd set setting	サーバー上の指定された設定を有効化。
tabcmd syncgroup group-name	指定された group-name を持つグループと Active Directory を同期化。
tabcmd version	tabcmd ユーティリティの現在のインストールのバージョン情報を出力。

Tableauデータ抽出コマンドラインユーティリティ

Tableau Desktop導入時に併せて入ってくるツール。前述の2つとは異なり、こちらのツールはTableau Desktop(Windows)限定で利用出来るツールとなっている様です。

Tableau データ抽出コマンドラインユーティリティ

コマンド名	説明
tableau refreshextract	Tableau Server または Tableau Online の抽出を更新。
tableau addfiletoextract	Tableau Server または Tableau Online へパブリッシュされた抽出にファイルの内容を追加。

Tableauデータ抽出API

Tableau データ抽出 API

Tableauでは、データにアクセスして処理するプログラムを作成する事が可能な『Tableau データ抽出 API(Tableau Data Extract API)』が利用出来ます。Java/C/C++/Pythonのいずれかの環境を導入・利用する事が可能です。

データ抽出 API – Python – 32 ビット
データ抽出 API – Python – 64 ビット
データ抽出 API - C/C++/Java – 32 ビット
データ抽出 API - C/C++/Java – 64 ビット

Tableauページにログイン(要ユーザー登録／無料)後、以下ページにアクセスし、『DOWNLOAD THE EXTRACT API NOW』をクリック。

Get the Data Extract API | Tableau Software

別ウインドウが起動するので、チェックボックスを選択して『DOWNLOAD NOW』を押下。

各種APIのダウンロード画面に遷移します。Linux系、Windows系双方で展開されている事が確認出来ます。

Linux用Python版64bitのものをダウンロード＆展開してみたもののスクリーンショットです。

APIドキュメントやサンプルについても充実している様です。実際の内容や挙動についてはこの辺りを御覧頂けますと幸いです。

チュートリアル動画
- Getting Started | Tableau Software
API紹介動画等
その他関連リンク
- Tableau データ抽出 API
- Group: Tableau Developer Community | Tableau Support Community

REST API

下記チュートリアルのページに『Enabling the REST API with Tabadmin』という項目がある事から、こちらはtabadmin互換のAPIという位置付けになるのでしょうか。

APIリファレンスの内容を確認する感じですと、以下のような操作が行えるようです。

サインイン
サインアウト
クエリデータソース(指定サイトのデータソースのリストを返す)
クエリデータソース(特定データソースのメタデータを返す)
プロジェクトの作成
プロジェクトの削除
プロジェクトの更新
ワークブックにタグを追加
ワークブックからタグを削除
ワークブックをクエリ(指定ワークブックのメタデータを返す)
ワークブックをお気に入りに追加
ワークブックをお気に入りから削除
プレビューイメージのあるビューをクエリ
ワークブック用のビューをクエリ
ワークブックのプレビューイメージをクエリ
ユーザー用のワークブックをクエリ
サイトにユーザーを追加
サイトのユーザーを取得
サイトからユーザーを削除
サイトの作成
サイトの更新
サイトをクエリ(サーバー上の全てのサイトのリストを返す)
サイトをクエリ(指定サイトのメタデータを返す)
サイトを削除

JavaScript API

Tableau ServerやTableau Publicのコンテンツを、その環境以外からブラウザ経由で表示・制御する際に利用出来るAPI。以下URL『Getting Started with the Tableau Javascript API - Bryan's BI Blog』が分かり易くまとまっている感じになっています。

Javascript APIのリファレンスは以下。

API リファレンス

また、以下オンラインチュートリアルでは、実コードと実行サンプルを交えてAPIの挙動を確かめる事が出来ます。

JavaScript API Tutorial

まとめ

以上、コマンドラインベースでの『Tableau Serverで出来る事のまとめ』でした。一旦作成したコンテンツを定期的に更新・管理するような場合はこれらの仕組みを使う事で作業の効率化を図る事が出来ますので、是非有効活用頂けますと幸いです。こちらからは以上です。

Tableau Serverで出来る事のまとめ(コマンドラインツール＆API編)

目次

コマンドラインツール＆API一覧