--- schema_version: "1" id: 6faec6afb35c89010605b7438f5ad576e7d31427f2c2ed91eed36c1941944bfa title: CSV インポート ファイルのガイドライン collection: tableau version: next locale: ja-jp portal_url: https://docs.salesforce.com/tableau/next/ja-jp/server-linux/csvguidelines.md canonical_url: https://help.tableau.com/v0.0/server-linux/ja-jp/csvguidelines.htm source_site: help.tableau.com content_type: documentation content_hash: 13b9d1c5cc09a4dbf17d443c824428b0fbcfc01c3479d27e8b04d072f707e53b description: CSV file format guidelines for bulk importing users into Tableau Cloud and Tableau Cloud Manager, with required columns. --- [メイン コンテンツに進む](#main-content) # CSV インポート ファイルのガイドライン ユーザー情報を格納したコンマ区切りの値 (CSV) ファイルを作成し、それをインポートすることによって、ユーザーを一括で追加できます。CSV ファイルには、ライセンス レベルやパブリッシュ アクセスなど、インポートと同時にユーザーに適用する属性を含めることができます。 このトピックでは、CSV ファイル自体の詳細について説明します。CSV を使用してユーザーをインポートするには、次の方法があります。 - サーバーまたはサイトの管理ページを使用します。詳細については、「[ユーザーのインポート](https://help.tableau.com/v0.0/server-linux/ja-jp/users_import.htm)」を参照してください。 - `tabcmd` ユーティリティを使用します。詳細については、「[createsiteusers filename.csv](https://help.tableau.com/v0.0/server-linux/ja-jp/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894)」を参照してください。 ユーザーはサイトまたはサーバーのレベルでインポートできます。ユーザーをサーバーに (特定サイトにではない) インポートする場合、ユーザーはサイトに割り当てされず、Unlicensed としてインポートされます。 **注:** 特に明記されていない限り、このトピックで指定されているガイドラインは、[アイデンティティ プール](https://help.tableau.com/v0.0/server-linux/ja-jp/identity_pools.htm)を構成時に使用したかどうかにかかわらず、Tableau Server に適用されます。 ## CSV ファイル形式の要件 ユーザーをインポートするための CSV ファイルには、次の書式要件があります。 - 列の見出しはありません。Tableau Serverファイル内の各行を 1 人のユーザーと見なします。 - バイト オーダー マーク (BOM) 付きの UTF-8 形式は、サイトにインポートする場合にのみサポートされます。Tableau Cloud Manager にインポートする場合は、UTF-8 形式を使用し、ファイルから BOM を削除してください。 - BIG-5 などの文字エンコーディングは UTF-8 に変換する必要があります。この操作を行うには、テキスト エディターでファイルを開き、\[名前を付けて保存\] コマンドを使用します。 - `@` 文字がドメイン セパレーター以外の**ユーザー名**フィールドに存在する場合は、16 進形式 (`\0x40`) にする必要があります。たとえば、`user@fremont@mycompany.com` は `user\0x40fremont@mycompany.com` にする必要があります。 ## CSV ファイルの必須の列構造 ファイルにはヘッダー行を含めないでください。すべての列に入力する必要はありませんが、すべてのコンマ区切り記号をそのまま含めることによって、必須の列構造を保持する必要があります。 列構造は、製品やインポート ツールによって異なります。環境に適した構造を使用していることを確認します。 - **Tableau Cloud:** ユーザー名、パスワード、表示名、ライセンス レベル、管理者レベル、パブリッシュ機能、メール アドレス - **Tableau Cloud Manager (TCM) を使用する Tableau Cloud:** テナントまたはサイト URI、ユーザー名、パスワード、表示名、ライセンス レベル、管理者レベル、パブリッシュ機能、メール アドレス、認証タイプ - **Tableau Server:** ユーザー名、パスワード、表示名、ライセンス レベル、管理者レベル、パブリッシュ権限、メール アドレス - **アイデンティティ プールを使用する Tableau Server:** ユーザー名、パスワード、表示名、ライセンス レベル、管理者レベル、パブリッシュ機能、メール アドレス、アイデンティティ プール名、識別子 各列に指定できる値の詳細については、以下の「列の詳細」セクションを参照してください。 > [!WARNING] > > **重要:** 列の順序には重要な意味があります。列のコンテンツに関係なく、最初の列はユーザー名、2 番目の列はパスワード、3 番目の列は表示名などと表示されます。フィールドの値を省略する場合でも、フィールドのコンマ区切り記号は含める必要があります。 ## Tableau Server の列の詳細 **注**: 特定のサイトにサインインしておらず、ユーザーをサーバー レベルでインポートしている場合は、サーバー管理者と Unlicensed のサイト ロールのみを割り当てることができます。 CSV ファイルの列構造: `username, password, display name, license level, admin level, publishing capability, email address` ### 列の詳細  **Username:** _必須_。ユーザーの名前。 - サーバーが Active Directory を使用するように設定されている場合、この値は、Active Directory で定義されたユーザーと一致する必要があります。ユーザー名がドメイン全体で一意でない場合、ユーザー名の一部としてドメインを含めます (例: `example\Adam` または `adam@example`)。 - [アイデンティティ プール](https://help.tableau.com/v0.0/server-linux/ja-jp/identity_pools.htm)にユーザーを追加する場合は、以下を確認してください。 - AD を アイデンティティ ストアとして使用するアイデンティティ プールにユーザーを追加する場合は、必ずユーザー名に AD sAMAccountName 値を使用してください。 - アイデンティティ ストアとして LDAP を使用するアイデンティティ プールにユーザーを追加する場合は、必ずユーザー名に LDAP ユーザー名の値を使用してください。 **Password:** ユーザーのパスワード。この列が必須かどうかは、サーバーの構成によって異なります。 - ローカル認証: _必須_。Tableau Server 2024.2 より、必須パスワード フィールドの適用が開始されました。詳細については、[「Tableau Server 2024.2 で tabcmd 経由でユーザーを追加しようとすると、予期しない「errorCode=134」が発生する」](https://help.salesforce.com/s/articleView?id=002277940&type=1)のナレッジ記事を参照してください。 - Active Directory: _無視されます_。ベスト プラクティスとして、この列は空白のままにします。 **Display name:** 表示名は、サーバー上のユーザーを識別するのに使用される情報の一部です。この列が使用されるかどうかは、サーバーの構成によって異なります。 - ローカル認証:ユーザーの表示名がすでに使用されている場合、Tableau Server は、CSV ファイル内の設定で既存のユーザー情報を更新します。 - Active Directory: _無視されます_。ベスト プラクティスとして、この列は空白のままにします。 **License level:** **Creator**、**Explorer**、**Viewer**、または**Unlicensed**のいずれかです。 - ライセンス レベルが Creator の場合、パブリッシュ機能は Yes/True/1 である必要があります。 - ユーザーベースのサーバーがインストールされていて、ユーザーを追加するとライセンスで許可されるユーザー数を超える場合は、ユーザーはライセンスなしのユーザーとして追加されます。 - `tabcmd` を使用し、ライセンスを指定しているものの、インポートするユーザーがライセンスの制限を超過する場合は、ユーザーはライセンスなしのユーザーとしてインポートされます。 **Administrator level:** **System**、**Site**、または**None**のいずれかであり、ユーザーが管理者としてインポートされるかどうかを決定します。 - System = サーバー管理者、Site = サイト管理者、None = 管理者ではない、を示します。 - 特定のサイトにサインインしておらず、ユーザーをサーバー レベルでインポートしている場合は、サーバー管理者とライセンスなしのみを割り当てることができます。 - Web UI を使用してユーザーをインポートする場合、サーバー (全サイト) レベルでファイルのインポートを実行する場合にのみ、管理者サイト ロールを System に設定できます。特定のサイトにサインインしている場合、および CSV ファイル内のユーザーの管理者列が System に設定されている場合は、Tableau Server はユーザーをサイト管理者としてインポートします。 **Publishing capability:** **Yes/True/1** または **No/False/0** のいずれかです。Web UI を使用している場合、特定のサイトにサインイン中にインポートする場合にのみパブリッシュ機能が使用されます。 - ライセンス レベルが Creator の場合、パブリッシュ機能は Yes/True/1 である必要があります。 - ライセンス レベルが Explorer の場合、パブリッシュ機能の値によって Explorer (パブリッシュ可能) と Explorer のサイト ロールが区別されます。 - ライセンス レベルが Viewer またはライセンスなしの場合、この列の値に関係なく、ユーザーはパブリッシュすることはできません。 **Email address:** メール アドレスは、サーバー上のユーザーを識別するのに使用される情報の一部です。電子メール アドレスがすでに使用されている場合、Tableau Server は、CSV ファイル内の設定で既存のユーザー情報を更新します。 空白のままの列は、列構造を保持するためにコンマで区切る必要があります。 ### アイデンティティ プール アイデンティティ プールにユーザーを追加する場合は、標準の列に加えて以下の列が必要です。 CSV ファイルの列構造: `username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier` 追加の列の詳細: **アイデンティティ プール名:** ユーザーの追加先のアイデンティティ プールの名前。アイデンティティ プールにユーザーを追加する際にアイデンティティ プール名を指定しない場合、ユーザーは初期プール (TSM で構成済み) に追加されます。これは Tableau Server のセットアップ中に TSM でプロビジョニングされたユーザーのセットです。 **識別子:** 追加するユーザーの識別子。識別子は、アイデンティティ照合のためだけに使用されます。詳細については、「[Tableau におけるユーザー名と識別子](https://help.tableau.com/v0.0/server-linux/ja-jp/identity_pools.htm#usernames_identifiers)」を参照してください。 - ローカル認証: _オプション_ - Active Directory または LDAP: _必須_ #### アイデンティティ プールにユーザーを一括で追加 CSV インポート プロセスを使用すると、次のことができます。 - ユーザーを追加のアイデンティティ プールに一括で追加します。**注:** CSV インポート プロセスを使用して、ユーザーがすでに属しているアイデンティティ プールを別のアイデンティティ プールに置き換えることはできません。異なるアイデンティティ プール値を持つ既存のユーザーを追加すると、そのユーザーは追加のアイデンティティ プールに追加されます。 - まだ識別子を持っていないユーザーに識別子を一括で追加します。**注:** 同じプール内のユーザーに別の識別子を追加しても、そのユーザーの既存の識別子は置き換えられません。代わりに、そのユーザーに対して新しい識別子レコードが作成されます。 ### Tableau Server の CSV インポートの例 > [!TIP] > > **ヒント**: 構造は `username, password, display name, license level, admin level, publishing capability, email address` であることを忘れないでください。 次の例は、複数のユーザー用の情報を含む 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 ユーザーだけがサーバー管理者としてインポートされ、残りはライセンスなしに設定されます。 #### アイデンティティ プールの例 > [!TIP] > > **ヒント**: 構造は `username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier`であることを忘れないでください。 次の例は、アイデンティティ プールに追加された 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 ### 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 createsiteusers`、`deletesiteusers`、`addusers`、および `removeusers` コマンドに適用されます。 これらの設定の説明については、[tsm configuration set のオプション](https://help.tableau.com/v0.0/server-linux/ja-jp/cli_configuration-set_tsm.htm)を参照してください。 ## CSV 設定とサイト ロール ユーザーのライセンスレベル、管理者、およびパブリッシュ設定が、ユーザーのサイトロールがインポート プロセス中にどのように設定されるかを決定します。次に、サイト ロールを CSV に取り込む方法を示します。
サイト ロール License level Administrator level Publishing capability

サーバー管理者

このロールは、サーバーを管理しているとき (つまり、特定のサイトにサインインしていないとき) にユーザーをインポートする場合にのみ有効です。

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

サイト管理者 Creator またはサイト管理者 Explorer

これらのロールは、特定のサイトへのサインイン中にユーザーをインポートする場合にのみ有効です。

Creator または Explorer Site True
Creator Creator なし True
Explorer (パブリッシュ可能) Explorer なし True
Explorer Explorer なし False
Viewer Viewer なし False
ライセンスなし ライセンスなし なし False