CSV 匯入檔案指導方針
透過建立含有使用者資訊的逗號分隔值 (CSV) 檔案，然後匯入該檔案，即可自動新增使用者。您可以在 CSV 檔案中包括屬性（例如授權層級和發佈存取權限），以便在匯入這些屬性的同時將它們應用於使用者。
若要匯入使用者，您可以使用伺服器或網站管理頁面或 tabcmd 公用程式。使用 tabcmd 提供用於為 CSV 檔案中的所有使用者指派站點角色的選項。有關資訊，請參閱匯入使用者或createsiteusers filename.csv。
您可以在網站或伺服器層級匯入使用者。如果將使用者匯入到伺服器（而不是匯入特定網站），則不會將使用者指派到網站，並且會以「未授權」方式匯入使用者。
附註：除非另有說明，否則本主題中指定的指導方針對已設定或未設定身分集區(連結在新視窗開啟)的 Tableau Server 均適用。
CSV 檔案格式要求
在建立用於匯入使用者的 CSV 檔案時，請確保檔滿足以下格式要求：
檔不包括列標題。Tableau Server假定檔案中的每一行代表一個使用者。
檔為 UTF-8 格式，並包括位元組順序標記 (BOM)。
諸如 BIG-5 等字元編碼已轉換為 UTF-8。可透過在文字編輯器中開啟檔並使用「另存新檔」命令來達到此目的。
如果使用者名包括的「@」字元不是表示域分隔符號，則您需要使用十六進位格式引用該符號：
\0x40例如，
user@fremont@mycompany.com應該為user\0x40fremont@mycompany.com
CSV 檔案中所需的列
每個使用者都需要以下欄位：
使用者名稱。使用者名。如果伺服器設定為使用 Active Directory，則此值必須與 Active Directory 中定義的使用者相符。如果使用者名在域之間不唯一，則必須包括域作為使用者名的一部分（例如，
example\Adam或adam@example）。若要將使用者新增到身分集區(連結在新視窗開啟)，請確保以下內容：
- 如果將使用者新增至使用 AD 作為其識別身分存放區的身分識別集區中，請確保使用 AD sAMAccountName 值作為使用者名稱。
- 如果將使用者新增至使用 LDAP 作為其識別身分存放區的身分識別集區中，請確保使用 LDAP 使用者名稱值作為使用者名稱。
Password。使用者的密碼。
若伺服器設定為使用 Active Directory，則不使用此值，但是，必須有一個密碼欄，且欄本身應為空白。
如果伺服器使用本機驗證，則必須為新使用者提供密碼。
附註： 從 Tableau Server 2024.2 開始強制執行必填密碼欄位。有關詳細資訊，請參閱 Knowledge 文章在 Tableau Server 2024.2 中嘗試透過 tabcmd 新增使用者時出現意外的「errorCode=134」。
其他匯入檔選項
除了上面列出的欄位之外，CSV 檔案還可以包含以下欄位（按此處顯示的順序）：
Display name。顯示名稱是用於在伺服器上標識使用者的資訊的一部分。如果使用者的顯示名稱已在使用，Tableau Server 將使用 CSV 檔案中的設定更新現有使用者資訊。如果伺服器設定為使用 Active Directory，則不使用此值。
License level。可以是「Creator」、「Explorer」、「Viewer」或「Unlicensed」。如果為特定使用者帳戶指定「Creator」，還必須將發佈功能設定為「True」。
管理員層級（System、Site 或 None）。此設定確定是否以管理員形式匯入使用者。
如果使用 Web UI 匯入使用者，則只有在伺服器（所有網站）層級匯入檔時，您才能將管理員網站角色設定為「System」。如果登入到特定網站，並且 CSV 檔案中使用者的管理員列設定為「System」，則 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 匯入過程使用另一個身分集區取代使用者所屬的身分集區。如果新增具有不同身分集區值的現有使用者，則會將其新增至該附加身分集區。
為尚未沒有識別碼的使用者大量新增識別碼。附註：如果為同一集區中的使用者新增不同的識別碼，則不會取代該使用者的現有識別碼。相反，將為該使用者建立新的識別碼記錄。
重要提示：欄的順序至關重要。將第一列視為使用者名，將第二列視為密碼，將第三列視為顯示名稱等等，而不考慮列中的內容。如果忽略欄位的值，您必須仍然包括欄位的逗號分隔符號。
提高透過 tabcmd 傳遞的大型 CSV 檔案的效能
附註：這些設定適用於 Tableau Server 版本 2022.1 及更早版本。從版本 2022.3 開始，它們影響的搜尋和索引服務已棄用，並在 2023.3 中已淘汰（完全移除）。
伺服器管理員可以啟用伺服器設定，幫助提高透過 tabcmd 命令匯入大型 CSV 檔案的效能。您可以使用以下選項執行 tsm configuration set 命令來完成此操作：
vizportal.csv_user_mgmt.index_site_usersvizportal.csv_user_mgmt.bulk_index_userssearchserver.index.bulk_query_user_groups
本質上，這些選項會在處理 CSV 檔案後建立這些使用者的索引，而不是在將使用者新增到伺服器的資料庫後逐個建立使用者索引。這將減少資料庫調用次數和處理檔所需的記憶體。這些 tsm configuration set 選項適用於 tabcmd createsiteusers、deletesiteusers、addusers 和 removeusers 命令。
有關這些設定的描述，請參閱tsm configuration set 選項。
說明
如果未登入到特定網站，並且在伺服器層級匯入使用者，則只能指派「伺服器管理員」和「未授權」網站角色。
如果有基於使用者的伺服器安裝，並且新增使用者會超出授權允許的使用者數，則會以未授權使用者形式新增使用者。
如果使用
tabcmd並指定授權，但匯入使用者會超出授權限制，則會以「未授權」方式匯入使用者。
CSV 設定和網站角色
使用者的授權層級、管理員和發佈設定確定如何在匯入過程中設定使用者的網站角色。下表顯示這些設定如何轉換為網站角色。
| CSV 設定 | 網站角色 |
|---|---|
授權層級 =（任意） Administrator=System Publisher=true | 伺服器管理員。此設定僅適用於 Tableau Server only，並且只有在管理伺服器（即，未登入到特定網站）的同時匯入使用者才有效。 「伺服器管理員」網站角色始終獲得「Creator」授權（如果有）。如果沒有「Creator」授權，請參閱授權疑難排解瞭解 Tableau Server 如何處理此情況。 |
License level=Creator 或 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
如果在管理網站的同時匯入此檔案，則會向該網站中新增四個使用者。使用者 Michelle 的 Administrator 設定為 System。但是，由於您在將使用者匯入網站，Tableau Server 會為 Michelle 授予「網站管理員 Creator」網站角色。其中三個使用者允許進行發佈。
如果在管理伺服器的同時匯入此檔案，則會向伺服器中新增四個使用者，但不會將它們新增到任何網站。只會匯入一個使用者作為伺服器管理員；其餘使用者設定為「未授權」。
身分集區範例
以下範例顯示了一個 CSV 檔案，其中包含新增到身分集區的兩個使用者的資訊。
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors,fsuzuki
以下範例演示了一個 CSV 檔案，其中包含新增到身分集區的兩個使用者的資訊。
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors 2,fsuzuki
以下範例顯示了一個 CSV 檔案，其中包含沒有現有識別碼的兩個使用者的資訊。
laurar,laurapassword,Laura Rodriguez,Creator,None,no,lrodriguez@myco.com,General Contractors,jrodriguez