Tableau Serverのユーザー一覧を取得する方法を試してみた
2025.11.04
こんにちは、業務効率化ソリューション部のikumiです。
今回は、Tableau Serverのユーザー一覧を取得する方法について試してみたので、その内容について記載いたします。
試した方法
今日時点では、Tableau Server WEB UIからユーザー一覧をcsvなどで取得する方法はないため、以下の2つのパターンでユーザー一覧を取得しました。
- リポジトリから取得
- Tableau REST API で取得
検証環境
- Tableau Server on Windows：2023.3.17
- Tableau Desktop：2025.1.0
今回の方法では、バージョンによる手順の違いはないはずですが、使用するAPIのバージョンは、お使いのTableau Serverバージョンによって異なりますので注意が必要です。
リポジトリから取得
リポジトリへのアクセスを許可している場合、こちらの方法が一番スムーズですので、基本的にはこちらの方法を推奨します。リポジトリへの接続設定については、以下のブログを参考にしてください。
- リポジトリアクセスの有効化ができた状態で、Tableau Desktopを開きます
- Tableau Desktopから新しいデータソースを作成し、
PostgresSQLを選択
- 接続情報として、以下の情報を入力します
| 項目 | 概要 |
|---|---|
| サーバー | ホスト名、IPアドレス等 |
| ポート | 8060（既定） |
| データベース | workgroup |
| ユーザー | readonly |
| パスワード | PASSWORD |
- リポジトリに接続できたら、参照可能なテーブル一覧が表示されますので、
_usersテーブルを配置します
- ワークシートに移動し、必要な列を配置すると、ユーザー一覧が取得可能です
- ここから、任意の形式でデータをエクスポートもできますので、任意の方法で保存してください
Tableau Server でのユーザーリストのエクスポート
Tableau REST API で取得
- 今回は、基本的にWindowsのコマンドプロンプトからAPIを実行しました
- まず、APIアクセスするユーザーの認証情報を、
credential.xmlとして保存します- この際、デフォルトサイトにアクセスする場合のsite contentUrlは、空白（""）とする必要があります
<tsRequest>
<credentials name="<username>" password="<password>">
<site contentUrl="<site-url>" />
</credentials>
</tsRequest>
- 次に、API呼び出しに必要なトークン情報を取得するために、以下のコマンドを実行します
- <your_site_url>は、ご自身の環境に応じて編集してください
curl "http://<your_site_url>/api/3.27/auth/signin" -X POST -H "Content-Type: application/xml" -d @credential.xml
- XMLでトークン情報が返却されるので、以下の情報を取得します
- site id
- credentials token
- 続いて、以下のコマンドでユーザー一覧を取得します
- <site id>と、<credentials token>は、先ほど取得したトークン情報を入力します
curl "http://<your_site_url>/api/3.21/sites/<site id>/users" -X GET -H "X-Tableau-Auth: <credentials token>" > userlist.xml
- そうするとxmlデータを取得できますので、必要に応じて加工などを行って内容を確認してください
以上となります。
さいごに
いかがでしたでしょうか。どなたかの参考になれば幸いです。
