透過建立含有使用者資訊的逗號分隔值 (CSV) 檔案,然後匯入該檔案,即可自動新增使用者。您可以在 CSV 檔案中包括屬性(例如授權層級和發佈存取權限),以便在匯入這些屬性的同時將它們應用於使用者。

若要匯入使用者,您可以使用伺服器或網站管理頁面或 tabcmd 公用程式。使用 tabcmd 提供用於為 CSV 檔案中的所有使用者指派站點角色的選項。有關資訊,請參閱匯入使用者createsiteusers filename.csv

您可以在網站或伺服器層級匯入使用者。如果將使用者匯入到伺服器(而不是匯入特定網站),則不會將使用者指派到網站,並且會以「未授權」方式匯入使用者。

CSV 檔案格式要求

在建立用於匯入使用者的 CSV 檔案時,請確保檔滿足以下格式要求:

  • 檔不包括列標題。Tableau Server假定檔案中的每一行代表一個使用者。

  • 檔為 UTF-8 格式,並包括位元組順序標記 (BOM)。

  • 諸如 BIG-5 等字元編碼已轉換為 UTF-8。可透過在文字編輯器中開啟檔並使用「另存新檔」命令來達到此目的。

  • 如果使用者名包括的「@」字元不是表示域分隔符號,則您需要使用十六進位格式引用該符號:\0x40

    例如,user@fremont@mycompany.com 應該為 user\0x40fremont@mycompany.com

CSV 檔案中所需的列

需要為每個使用者提供以下值:

  • 使用者名

  • Password:如果將 Tableau Server 設定為使用 Active Directory 驗證,則必須具有一個 Password 列,但該列本身應該是空的。如果伺服器使用本機驗證,則必須為新使用者提供密碼。

其他匯入檔選項

CSV 檔案可按以下順序包含以下欄位:

  • User name。使用者名。如果伺服器設定為使用 Active Directory,則此值必須與 Active Directory 中定義的使用者相符。如果使用者名在域之間不唯一,則必須包括域作為使用者名的一部分(例如,example\Adamadam@example)。這是唯一需要的欄位。

  • Password。使用者的密碼。如果伺服器設定為使用 Active Directory,則不使用此值。

  • Display name。顯示名稱是用於在伺服器上標識使用者的資訊的一部分。如果使用者的顯示名稱已在使用,Tableau Server 將使用 CSV 檔案中的設定更新現有使用者資訊。如果伺服器設定為使用 Active Directory,則不使用此值。

  • License level。可以是「Creator」「Explorer」「Viewer」「Unlicensed」

  • 管理員層級(SystemSiteNone)。此設定確定是否以管理員形式匯入使用者。

    如果使用 Web UI 匯入使用者,則只有在伺服器(所有網站)層級匯入檔時,您才能將管理員網站角色設定為「System」。如果登入到特定網站,並且 CSV 檔案中使用者的管理員列設定為「System」,則 Tableau Server 將以網站管理員形式匯入使用者。

  • 發佈能力(yes/true/1no/false/0)。如果使用 Web UI,則只有在登入到特定網站的同時進行匯入才會使用發佈者設定。如果在伺服器(所有網站)層級匯入使用者,則不使用此值。

  • 電子郵件地址。電子郵件地址是用於在伺服器上識別使用者的資訊的一部分。如果電子郵件地址已在使用,Tableau Server 將使用 CSV 檔案中的設定更新現有使用者資訊。

列的順序非常重要。將第一列視為使用者名,將第二列視為密碼,將第三列視為顯示名稱等等,而不考慮列中的內容。如果忽略欄位的值,您必須仍然包括欄位的逗號分隔符號。

提高透過 tabcmd 傳遞的大型 CSV 檔案的效能

伺服器管理員可以啟用伺服器設定,幫助提高透過 tabcmd 命令匯入大型 CSV 檔案的效能。您可以使用以下選項執行 tsm configuraiton set 命令來完成此操作:

  • vizportal.csv_user_mgmt.index_site_users

  • vizportal.csv_user_mgmt.bulk_index_users

  • searchserver.index.bulk_query_user_groups

本質上,這些選項會在處理 CSV 檔案後建立這些使用者的索引,而不是在將使用者新增到伺服器的資料庫後逐個建立使用者索引。這將減少資料庫調用次數和處理檔所需的記憶體。這些 tsm configuration set 選項適用於 tabcmd createsiteusersdeletesiteusersaddusersremoveusers 命令。

有關這些設定的描述,請參閱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」網站角色。其中三個使用者允許進行發佈。

如果在管理伺服器的同時匯入此檔案,則會向伺服器中新增四個使用者,但不會將它們新增到任何網站。只會匯入一個使用者作為伺服器管理員;其餘使用者設定為「未授權」。

感謝您的意見回饋!