Tableau コレクターを実行する準備をします

コレクターを実行する前に、API アクセス、認証、および権限を設定します。

始める前に

必要なロール：admin

このタスクについて

コレクターは Tableau メタデータ API を使用してメタデータを収集します。API (Tableau Server の場合) を有効にし、ユーザー権限を設定し、認証方法を選択する必要があります。必要に応じて、データベースエイリアスのホスト名マッピングを構成します。

手順

1. Tableau サーバーでメタデータ API を有効にします。

   「Tableau メタデータ API を有効にする」を参照してください。

   注:

   Tableau Cloud では、メタデータ API がデフォルトで有効になっています。この手順は Tableau Server にのみ適用されます。
2. ユーザー権限を設定し、個人用アクセストークンを作成します。

   「Tableau ユーザー権限の設定」を参照してください。

3. オプション: 接続済みアプリを使用して JWT 認証を構成します。

   「Tableau JWT 認証の構成」を参照してください。

4. オプション: データベースエイリアスのホスト名マッピングを設定します。

   「ホスト名マッピング用の YAML ファイルの設定」を参照してください。

Tableau メタデータ API を有効にする

Tableau Server でメタデータ API を有効にして、メタデータ収集を許可します。

始める前に

必要なロール：admin

次のものが必要です。

• Tableau Server 2019.3 以降
• Tableau Server でサーバーアドミニストレーターロールを持つアカウント
• REST API が有効 (無効になっていない)

注:

Tableau Cloud では、メタデータ API がデフォルトで有効になっています。この手順は Tableau Server にのみ適用されます。

このタスクについて

Tableau コレクターは、メタデータ API を使用して Tableau Server からメタデータを収集します。デフォルトでは、この API は Tableau Server で無効になっており、Tableau Services Manager (TSM) コマンドラインインターフェイスを使用して有効にする必要があります。

手順

1. クラスター内に Tableau Services Manager (TSM) がインストールされている最初のノードで、アドミンとしてコマンドプロンプトを開きます。
2. 次のコマンドを実行して、メタデータ API を有効にします。

   tsm maintenance metadata-services enable

3. データ管理ライセンスがない場合は、派生権限を有効にします。

   派生権限を使用すると、関連する外部資産を表示できます。詳細な手順については、 Tableau のドキュメントを参照してください。

タスクの結果

これで、メタデータ API が Tableau Server で有効になり、メタデータ収集の準備が整いました。

Tableau ユーザー権限の設定

アドミン権限を持つ Tableau ユーザーを作成し、個人用アクセストークンを生成します。

始める前に

必要なロール：admin

Tableau Server または Tableau Cloud でユーザーを作成し、ロールをアサインする権限が必要です。

このタスクについて

Tableau コレクターには、メタデータにアクセスして収集するための管理者権限を持つユーザーアカウントが必要です。専用のユーザーアカウントを作成し、認証用の個人用アクセストークン (PAT) を生成します。

手順

1. アドミン権限を持つ新しいユーザーを Tableau で作成します。
   • Tableau Server の場合は、サーバーアドミニストレーターロールをアサインします。詳細については、 Tableau のドキュメント を参照してください
   • Tableau Cloud の場合は、サイト管理者ロールをアサインします。詳細については、 Tableau のドキュメント を参照してください
2. ユーザーの個人用アクセストークン (PAT) を作成します。

   PAT の作成手順の詳細については、 Tableau のドキュメントを参照してください。

3. 個人用アクセストークンを安全に保存します。

   このトークンは、Tableau メタデータコレクターを構成するときに必要になります。

Tableau JWT 認証の構成

JWT 認証用の Tableau での接続済みアプリの設定

始める前に

必要なロール：admin

Tableau で接続済みアプリを作成および管理するには、権限が必要です。

重要:

ワークブックのリビジョンとデータソースのリビジョンをフェッチする API は、JWT 認証ではサポートされていません。

このタスクについて

Tableau コレクターで JWT (JSON Web トークン) 認証を使用するように接続済みアプリを構成します。接続済みアプリは、JWT トークンの生成に必要なクライアント ID、シークレット ID、およびシークレット値を提供します。

手順

1. Tableau インスタンスにログインします。
2. [設定]に移動します。
3. 接続済みアプリを作成します。

   詳細な手順については、 Tableau のドキュメントを参照してください。

4. 接続済みアプリを有効にします。
5. 接続済みアプリでシークレットを生成します。
6. 接続済みアプリの認証情報を保存します。

   Tableau コレクターを構成するときに使用するために、次の値を記録します。

   • クライアント ID
   • シークレット ID
   • シークレット値

   これらの認証情報は、認証用の JWT トークンを生成するために使用されます。

ホスト名マッピング用の YAML ファイルの設定

データベースホスト名エイリアスを正規名にマップする YAML ファイルを作成します。

始める前に

必要なロール：admin

このタスクについて

同じデータベースインスタンスに複数のサーバー名 (エイリアス) があり、データベースコレクターが Tableau 接続で定義されているエイリアスとは異なるエイリアスを使用する場合は、ホスト名マッピングファイルを使用します。このオプションの構成では、データベースのホスト名を正規名にマップして、一貫した IRI コイニングを実現します。

手順

1. hostnames.yml という名前の YAML ファイルを作成します。
2. ホスト名マッピングエントリをファイルに追加します。

   次の形式を使用します。

   mappingValues:
                           - originalHostname: "<Original_HostName>"
                           canonicalHostname: "<canonical_HostName>"

   例:Tableau ソースで db-server-01.company.local を使用しているが、データベースオブジェクトの IRI 作成中に db.company.com をホスト名として使用する場合:

   mappingValues:
                           - originalHostname: "db-server-01.company.local"
                           canonicalHostname: "db.company.com"

   注:

   ファイル内の環境変数を使用して、パスワードなどの機密情報を得ることができます。
3. hostnames.ymlファイルを保存します。
4. [ホスト名マッピングファイル] オプションを使用して、YAML ファイルをコレクターに渡します。

   コレクターを実行してhostnames.ymlファイルをアップロードするときに、[ホスト名マッピングファイル] オプションを使用します。

タスクの結果

コレクタは、データベースオブジェクト IRI をコイニングするときに、元のホスト名の代わりに正規ホスト名を使用します。