CSV インポート ファイルのガイドライン

ユーザー情報を格納したコンマ区切りの値 (CSV) ファイルを作成し、インポートすることによってユーザーの追加を自動化できます。CSV ファイルには、ライセンス レベルやパブリッシュ アクセスなど、インポートと同時にユーザーに適用する属性を含めることができます。

ユーザーをインポートするには、サーバー、サイト管理ページ、または tabcmd ユーティリティを使用できます。tabcmd を使用すると、CSV ファイルに含まれるすべてのユーザーにサイト ロールを割り当てるオプションが提供されます。詳細については、ユーザーのインポートまたは createsiteusers filename.csv を参照してください。

ユーザーはサイトまたはサーバーのレベルでインポートできます。ユーザーをサーバーに (特定サイトにではない) インポートする場合、ユーザーはサイトに割り当てされず、ライセンスなしとしてインポートされます。

注: 特に明記されていない限り、このトピックで指定されたガイドラインは、Tableau Server がアイデンティティ プール(新しいウィンドウでリンクが開く)を使用して構成されたかどうかにかかわらず適用されます。

CSV ファイル形式の要件

ユーザーのインポート用の CSV ファイルを作成する場合は、ファイルが必ず次の書式要件を満たすようにします。

  • ファイルに列ヘッダーが含まれていない。Tableau Serverファイル内の各行を 1 人のユーザーと見なします。

  • ファイルは、UTF-8 形式であり、バイト オーダー マーク (BOM) が含まれています。

  • BIG-5 などのエンコードは UTF-8 に変換されています。この操作を行うには、テキスト エディターでファイルを開き、[名前を付けて保存] コマンドを使用します。

  • ユーザー名に "@" やそれを示す文字が含まれている場合 (ドメイン セパレーターを除く)、16 進形式で記号を参照する必要があります。\0x40

    たとえば、user@fremont@mycompany.comuser\0x40fremont@mycompany.com にする必要があります

CSV ファイルの必須の列

次のフィールドは各ユーザーに必須です。

  • ユーザー名ユーザー名。サーバーが Active Directory を使用するように設定されている場合、この値は、Active Directory で定義されたユーザーと一致する必要があります。ユーザー名がドメイン全体で一意でない場合、ユーザー名の一部としてドメインを含める必要があります (例: example\Adam または adam@example)。

    アイデンティティ プール(新しいウィンドウでリンクが開く)にユーザーを追加する場合は、以下を確認してください。

    • AD を アイデンティティ ストアとして使用するアイデンティティ プールにユーザーを追加する場合は、必ずユーザー名に AD sAMAccountName 値を使用してください。
    • アイデンティティ ストアとして LDAP を使用するアイデンティティ プールにユーザーを追加する場合は、必ずユーザー名に LDAP ユーザー名の値を使用してください。
  • パスワード。ユーザーのパスワード。

    • サーバーが Active Directory を使用するように設定されている場合、この値は使用されませんが、パスワード列が存在する必要があり、列自体は空である必要があります。

    • ローカル認証を使用するサーバーでは、新しいユーザーのパスワードを指定する必要があります。

    注: パスワード フィールドを必須とする強制は Tableau Server 2024.2 から開始されました。詳細については、「Tableau Server 2024.2 で tabcmd 経由でユーザーを追加しようとすると、予期しない「errorCode=134」が発生する」のナレッジ記事を参照してください。

インポート ファイルの追加オプション

CSV ファイルには、上記のフィールドに加えて、以下のフィールドをここに示す順序で含めることができます。

  • 表示名。表示名とは、サーバー上のユーザーを識別するのに使用される情報の一部です。ユーザーの表示名がすでに使用されている場合、Tableau Server は、CSV ファイル内の設定で既存のユーザー情報を更新します。サーバーが Active Directory を使用するように設定されている場合、この値は使用されません。

  • ライセンス レベル。これは CreatorExplorerViewer、またはライセンスなしである場合があります。特定のユーザーアカウントに [Creator] を指定する場合は、パブリッシュ機能も [True] に設定する必要があります。

  • 管理者のレベル (SystemSite、または None)。この設定は、ユーザーが管理者としてインポートされるかどうかを決定します。

    Web UI を使用してユーザーのインポートを行っている場合、サーバー(全ライト)レベルでファイルのインポートを実行する場合のみ、管理者サイトロールをシステムのみに設定できます。特定サイトにサインインしている場合、および CSV ファイル内のユーザーの管理者列がシステムに設定されている場合、Tableau Serverはユーザーをサイト管理者としてインポートします。

  • パブリッシャー パーミッション (yes/true/1 または no/false/0)。Web UI を使用している場合、特定サイトにサインイン中にインポートする場合にのみパブリッシャーの設定が使用されます。

  • 電子メール アドレス。電子メール アドレスとは、サーバー上のユーザーを識別するのに使用される情報の一部です。電子メール アドレスがすでに使用されている場合、Tableau Server は、CSV ファイル内の設定で既存のユーザー情報を更新します。

アイデンティティ プールにユーザーを追加する場合は、上記に加えて以下の値が必要です。

  • アイデンティティ プール名ユーザーを追加するアイデンティティ プールの名前

  • 識別子追加するユーザーの識別子。識別子は、アイデンティティを照合するためにのみ使用されます。詳細については、「Tableau におけるユーザー名と識別子」を参照してください。注: Active Directory (または LDAP) アイデンティティ ストアを使用するアイデンティティ プールにユーザーを追加する場合は、識別子が必要です。ローカル アイデンティティ ストアを使用するアイデンティティ プールにユーザーを追加する場合、識別子の入力は任意です。

    注:

    • アイデンティティ プールにユーザーを追加する際にアイデンティティ プール名を指定しない場合、ユーザーは初期プール (TSM で構成済み) に追加されます。これは Tableau Server のセットアップ中に TSM でプロビジョニングされたユーザーのセットです。
    • ユーザー名の値については、以下を確認してください。

      • AD を アイデンティティ ストアとして使用するアイデンティティ プールにユーザーを追加する場合は、必ずユーザー名に AD sAMAccountName 値を使用してください。
      • アイデンティティ ストアとして LDAP を使用するアイデンティティ プールにユーザーを追加する場合は、必ずユーザー名に LDAP ユーザー名の値を使用してください。
    • CSV インポート プロセスを使用すると、次のことができます。

      • ユーザーを追加のアイデンティティ プールに一括で追加します。注: CSV インポート プロセスを使用して、ユーザーがすでに属しているアイデンティティ プールを別のアイデンティティ プールに置き換えることはできません。異なるアイデンティティ プール値を持つ既存のユーザーを追加すると、そのユーザーは追加のアイデンティティ プールに追加されます。

      • まだ識別子を持っていないユーザーに識別子を一括で追加します。注: 同じプール内のユーザーに別の識別子を追加しても、そのユーザーの既存の識別子は置き換えられません。代わりに、そのユーザーに対して新しい識別子レコードが作成されます。

重要: 列の順序には重要な意味があります。列のコンテンツに関係なく、最初の列はユーザー名、2 番目の列はパスワード、3 番目の列は表示名などと表示されます。フィールドの値を省略する場合でも、フィールドのコンマ区切り記号は含める必要があります。

tabcmd に渡される大きな CSV ファイルのパフォーマンス改善

注: これらの設定は、Tableau Server バージョン 2022.1 以前に適用されます。影響を受ける検索およびインデックス サービスは、バージョン 2022.3 以降で非推奨になり、2023.3 で廃止 (完全に削除) されました。

サーバー管理者は tabcmd コマンドを使用して、大きな CSV ファイルのインポート時にパフォーマンスを改善できるサーバー設定を有効にできます。これは tsm configuration set コマンドを次のオプションとともに使用して可能です。

  • vizportal.csv_user_mgmt.index_site_users

  • vizportal.csv_user_mgmt.bulk_index_users

  • searchserver.index.bulk_query_user_groups

基本的に、これらのオプションを 1 つずつサーバーのデータベースに追加していくのではなく、CSV ファイルを 1 つ処理した後にインデックスを作成します。これにより、データベースを呼び出す回数も、ファイルの処理に必要となるメモリも減ります。これらの tsm configuration set オプションは、tabcmd createsiteusersdeletesiteusersaddusers、および removeusers コマンドに適用されます。

これらの設定の説明については、tsm configuration set のオプションを参照してください。

  • 特定のサイトにサインインしていなくて、ユーザーをサーバー レベルでインポートしている場合は、サーバー管理者とライセンスなしのサイトロールだけを割り当てることができます。

  • ユーザーベースのサーバーをインストール済みの場合で、ユーザーを追加するとライセンスで許可されたユーザー数を超える場合は、ユーザーはライセンスなしのユーザーとして追加されます。

  • tabcmd を使用し、ライセンスを指定するけれども、インポートするユーザーがライセンスの制限を超過する場合、ユーザーはライセンスなしとしてインポートされます。

CSV 設定とサイト ロール

ユーザーのライセンスレベル、管理者、およびパブリッシュ設定が、ユーザーのサイトロールがインポート プロセス中にどのように設定されるかを決定します。次の表は、設定がサイト ロールに変換される方法を示しています。

CSV の設定サイト ロール

License level=(any)

Administrator=System

Publisher=true

サーバー管理者。この設定は Tableau Server のみに適用され、サーバー管理中にユーザーをインポートする (つまり、特定サイトにサインインしていない) 場合にのみ有効です。

サーバー管理者サイトロールは Creator ライセンスが利用できる場合は常にそれを利用します。利用できる Creator ライセンスがない場合は、 ライセンス発行のトラブルシューティング を参照して Tableau Server がこれをどのように処理するかについて学んでください。

License level=Creator or Explorer

Administrator=Site

Publisher=true

サイト管理者 Creator またはサイト管理者 Explorer。この設定は、特定のサイトへのサインイン中にユーザーをインポートする場合にのみ有効です。

License level=Creator

Administrator=None

Publisher=true

Creator

License level=Explorer

Administrator=None

Publisher=true

Explorer (パブリッシュ可能)

License level=Explorer

Administrator=None

Publisher=false

Explorer

License level=Viewer

Administrator=None

Publisher=false

Viewer

License level=Unlicensed

Administrator=None

Publisher=false

ライセンスなし

Tableau Server の CSV インポートの例

次の例は、複数のユーザー用の情報を含む CSV ファイルを示しています。

henryw,henrypassword,Henry Wilson,Creator,None,yes,henryw@example.com
freds,fredpassword,Fred Suzuki,Viewer,None,no,freds@example.com
alanw,alanpassword,Alan Wang,Explorer,Site,yes,alanw@example.com
michellek,michellepassword,Michelle Kim,Creator,System,yes,michellek@example.com

サイトを管理中にこのファイルをインポート場合、そのサイトに 4 人のユーザーが追加されます。ユーザー Michelle の Administrator 設定は System です。ただし、サイトにユーザーをインポートしているので、Tableau Server は Michelle をサイト管理者 Creator サイトロールに設定します。ユーザーのうち 3 人はパブリッシュが許可されています。

サーバーを管理中にこのファイルをインポート場合、そのサーバーに 4 人のユーザーが追加されますが、それらのユーザーはサイトには追加されません。1 ユーザーだけがサーバー管理者としてインポートされ、残りはライセンスなしに設定されます。

アイデンティティ プールの例

次の例は、アイデンティティ プールに追加された 2 人のユーザーの情報を含む CSV ファイルを示しています。

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors,hwilson
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors,fsuzuki

次の例は、追加のアイデンティティ プールに追加された 2 人のユーザーの情報を含む CSV ファイルを示しています。

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors 2,hwilson
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors 2,fsuzuki

次の例は、既存の識別子を持たない 2 人のユーザーの情報を含む CSV ファイルを示しています。

janes,janepassword,Jane Smith,Viewer,None,yes,jsmith@myco.com,General Contractors,jwang
laurar,laurapassword,Laura Rodriguez,Creator,None,no,lrodriguez@myco.com,General Contractors,jrodriguez
フィードバックをお送りいただき、ありがとうございます。フィードバックは正常に送信されました。ありがとうございます!