คู่มือไฟล์นำเข้า CSV

คุณสามารถเพิ่มผู้ใช้จำนวนมากได้โดยสร้างไฟล์ค่าที่คั่นด้วยจุลภาค (CSV) พร้อมข้อมูลผู้ใช้ จากนั้นจึงนำเข้าไฟล์ คุณสามารถรวมข้อมูลแอตทริบิวต์ในไฟล์ CSV เช่น ระดับของใบอนุญาตและสิทธิ์เข้าถึงเพื่อเผยแพร่ เพื่อนำไปใช้กับผู้ใช้ในตอนที่คุณนำเข้าผู้ใช้ได้

หัวข้อนี้จะอธิบายรายละเอียดของไฟล์ CSV หากต้องการนำเข้าผู้ใช้โดยใช้ CSV คุณสามารถทำสิ่งต่อไปนี้ได้

ใช้หน้าการดูแลระบบเซิร์ฟเวอร์หรือไซต์ หากต้องการทราบข้อมูล โปรดดูนำเข้าผู้ใช้
ใช้ยูทิลิตี้ tabcmd หากต้องการทราบข้อมูล โปรดดู 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

ไฟล์ต้องไม่มีแถวส่วนหัว ไม่จำเป็นต้องมีข้อมูลในทุกคอลัมน์ แต่ต้องเก็บโครงสร้างคอลัมน์ที่จำเป็นไว้โดยรวมตัวคั่นจุลภาคที่กำหนดไว้ทั้งหมด

โครงสร้างคอลัมน์จะแตกต่างกันไปตามผลิตภัณฑ์และเครื่องมือนำเข้า ตรวจสอบให้แน่ใจว่าคุณใช้โครงสร้างที่เหมาะสมสำหรับสภาพแวดล้อมของคุณ

Tableau Cloud: อีเมลชื่อผู้ใช้, รหัสผ่าน, ชื่อที่แสดง, ระดับของใบอนุญาต, ระดับของผู้ดูแล, ความสามารถในการเผยแพร่
Tableau Cloud ที่มี Tableau Cloud Manager: อีเมลชื่อผู้ใช้, รหัสผ่าน, URI ไซต์, ชื่อที่แสดง, ระดับของใบอนุญาต, ระดับของผู้ดูแล, ความสามารถในการเผยแพร่, ประเภทการตรวจสอบสิทธิ์
Tableau Server: ชื่อผู้ใช้, รหัสผ่าน, ชื่อที่แสดง, ระดับของใบอนุญาต, ระดับของผู้ดูแล, ความสามารถในการเผยแพร่, ที่อยู่อีเมล
Tableau Server ที่ใช้พูลข้อมูลประจำตัว:ชื่อผู้ใช้, รหัสผ่าน, ชื่อที่แสดง, ระดับของใบอนุญาต, ระดับของผู้ดูแล, ความสามารถในการเผยแพร่, ที่อยู่อีเมล, ชื่อพูลข้อมูลประจำตัว, ตัวระบุ

ดูส่วนรายละเอียดคอลัมน์ด้านล่างสำหรับข้อมูลเพิ่มเติมเกี่ยวกับค่าที่เป็นไปได้ของแต่ละคอลัมน์

สำคัญ: ลำดับของคอลัมน์มีความสำคัญ คอลัมน์แรกจะถือเป็นชื่อผู้ใช้ คอลัมน์ที่สองจะเป็นรหัสผ่าน คอลัมน์ที่สามเป็นชื่อที่แสดง เป็นต้น โดนไม่คำนึงถึงเนื้อหาในคอลัมน์ ถ้าคุณละเว้นค่าสำหรับฟิลด์ คุณยังคงต้องรวมตัวคั่นจุลภาคของฟิลด์ด้วย

รายละเอียดคอลัมน์สำหรับ Tableau Server

หมายเหตุ: หากคุณไม่ได้เข้าสู่ระบบของไซต์เฉพาะใดๆ และกำลังนำเข้าผู้ใช้ที่ระดับเซิร์ฟเวอร์ คุณจะกำหนดได้เฉพาะบทบาทในไซต์ของผู้ดูแลเซิร์ฟเวอร์และผู้ใช้ที่ไม่มีใบอนุญาต

โครงสร้างคอลัมน์ของไฟล์ CSV: username, password, display name, license level, admin level, publishing capability, email address

รายละเอียดคอลัมน์:

ชื่อผู้ใช้: จำเป็น ชื่อของผู้ใช้

ถ้าเซิร์ฟเวอร์ถูกกำหนดค่าให้ใช้ Active Directory ค่านี้จะต้องตรงกับผู้ใช้ที่กำหนดไว้ใน Active Directory ถ้าชื่อผู้ใช้ไม่ใช่ชื่อที่ไม่ซ้ำกันภายในโดเมน ให้รวมโดเมนเป็นส่วนหนึ่งของชื่อผู้ใข้ (ตัวอย่างเช่น example\Adam หรือ adam@example)
หากเพิ่มผู้ใช้ลงในพูลข้อมูลประจำตัว(ลิงก์จะเปิดในหน้าต่างใหม่) ตรวจสอบรายการต่อไปนี้:

หากเพิ่มผู้ใช้ในพูลข้อมูลประจำตัวที่ใช้ AD เป็นที่เก็บข้อมูลประจำตัว ตรวจสอบให้แน่ใจว่าได้ใช้ค่า AD sAMAccountName สำหรับชื่อผู้ใช้
หากเพิ่มผู้ใช้ในพูลข้อมูลประจำตัวที่ใช้ LDAP เป็นที่เก็บข้อมูลประจำตัว ตรวจสอบให้แน่ใจว่าได้ใช้ค่า LDAP username สำหรับชื่อผู้ใช้

รหัสผ่าน: รหัสผ่านของผู้ใช้ คอลัมน์นี้จะจำเป็นหรือไม่นั้นขึ้นอยู่กับการกำหนดค่าเซิร์ฟเวอร์:

การตรวจสอบสิทธิ์ในเครื่อง: จำเป็น การบังคับใช้ฟิลด์รหัสผ่านที่จำเป็นเริ่มตั้งแต่ Tableau Server 2024.2 เป็นต้นไป หากต้องการข้อมูลเพิ่มเติม โปรดดูบทความในฐานข้อมูลหัวข้อ “errorCode=134” ที่ไม่คาดคิดเกิดขึ้นเมื่อพยายามเพิ่มผู้ใช้ผ่าน tabcmd ใน Tableau Server 2024.2
Active Directory: ละเว้น ตามแนวทางปฏิบัติที่ดีที่สุด ให้เว้นว่างคอลัมน์นี้

ชื่อที่แสดง: ชื่อที่แสดงเป็นส่วนของข้อมูลที่ใช้เพื่อระบุผู้ใช้บนเซิร์ฟเวอร์ คอลัมน์นี้จำเป็นต้องใช้หรือไม่นั้นขึ้นอยู่กับการกำหนดค่าเซิร์ฟเวอร์:

การตรวจสอบสิทธิ์ในเครื่อง: หากชื่อที่แสดงของผู้ใช้ถูกนำไปใช้แล้ว Tableau Server จะอัปเดตข้อมูลผู้ใช้ที่มีอยู่ด้วยการตั้งค่าในไฟล์ CSV
Active Directory: ละเว้น ตามแนวทางปฏิบัติที่ดีที่สุด ให้เว้นว่างคอลัมน์นี้

ระดับของใบอนุญาต: ซึ่งอาจเป็น Creator, Explorer, Viewer หรือไม่มีใบอนุญาต

หากระดับของใบอนุญาตคือ Creator ความสามารถในการเผยแพร่ต้องเป็นใช่/จริง/1
หากคุณมีการติดตั้งเซิร์ฟเวอร์อิงตามผู้ใช้และการเพิ่มผู้ใช้จะทำให้เกินจำนวนผู้ใช้ที่อนุญาตภายใต้ใบอนุญาตของคุณ ผู้ใช้จะถูกเพิ่มเป็นผู้ใช้ที่ไม่มีใบอนุญาต
หากคุณใช้คำสั่ง tabcmd และระบุใบอนุญาต แต่การนำเข้าผู้ใช้จะทำให้เกินจำนวนผู้ใช้ที่อนุญาตภายใต้ใบอนุญาตของคุณ ผู้ใช้จะถูกนำเข้าเป็นผู้ใช้ที่ไม่มีใบอนุญาต

ระดับของผู้ดูแล: ซึ่งอาจเป็นระบบ ไซต์ หรือไม่มี และกำหนดว่าผู้ใช้จะถูกนำเข้าเป็นผู้ดูแลหรือไม่

ระบบ = ผู้ดูแลเซิร์ฟเวอร์, ไซต์ = ผู้ดูแลไซต์, ไม่มี = ไม่ใช่ผู้ดูแล
หากคุณไม่ได้เข้าสู่ระบบของไซต์เฉพาะใดๆ และกำลังนำเข้าผู้ใช้ที่ระดับเซิร์ฟเวอร์ คุณจะกำหนดได้เฉพาะบทบาทผู้ดูแลเซิร์ฟเวอร์และผู้ใช้ที่ไม่มีใบอนุญาต
หากคุณใช้ UI เว็บเพื่อนำเข้าผู้ใช้ คุณจะกำหนดบทบาทในไซต์ของผู้ดูแลเป็น “ระบบ” ได้ต่อเมื่อคุณนำเข้าไฟล์ที่ระดับเซิร์ฟเวอร์ (ไซต์ทั้งหมด) เท่านั้น หากคุณเข้าสู่ระบบของไซต์ที่เฉพาะเจาะจง และหากคอลัมน์ผู้ดูแลสำหรับผู้ใช้ในไฟล์ CSV ถูกตั้งค่าเป็น “ระบบ” Tableau Server จะนำเข้าผู้ใข้เป็นผู้ดูแลไซต์

ความสามารถในการเผยแพร่: ซึ่งอาจเป็นใช่/จริง/1 หรือ ไม่/เท็จ/0 หากคุณใช้ UI เว็บ ความสามารถในการเผยแพร่จะถูกใช้ก็ต่อเมื่อคุณนำเข้าในขณะเข้าสู่ระบบไซต์ที่เฉพาะเจาะจงแล้ว

หากระดับของใบอนุญาตคือ Creator ความสามารถในการเผยแพร่ต้องเป็นใช่/จริง/1
หากระดับของใบอนุญาตเป็น Explorer ค่าความสามารถในการเผยแพร่จะเป็นตัวแยกความแตกต่างระหว่างบทบาทในไซต์ Explorer (เผยแพร่ได้) กับ Explorer
หากระดับของใบอนุญาตเป็น Viewer หรือไม่มีใบอนุญาต ผู้ใช้จะไม่สามารถเผยแพร่ได้ไม่ว่าค่าของคอลัมน์นี้จะเป็นอย่างไร

ที่อยู่อีเมล: ที่อยู่อีเมลเป็นส่วนของข้อมูลที่ใช้เพื่อระบุผู้ใช้บนเซิร์ฟเวอร์ ถ้าที่อยู่อีเมลของผู้ใช้ถูกนำไปใช้แล้ว Tableau Server จะอัปเดตข้อมูลผู้ใช้ที่มีอยู่ด้วยการตั้งค่าในไฟล์ CSV

คอลัมน์ใดๆ ที่เว้นว่างไว้ต้องคั่นด้วยเครื่องหมายจุลภาคเพื่อรักษาโครงสร้างคอลัมน์ไว้

พูลข้อมูลประจำตัว

หากเพิ่มผู้ใช้ลงในพูลข้อมูลประจำตัว จะต้องใช้คอลัมน์ต่อไปนี้เพิ่มเติมจากคอลัมน์ด้านบน

โครงสร้างคอลัมน์ของไฟล์ CSV: username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier

รายละเอียดคอลัมน์เพิ่มเติม

ชื่อพูลข้อมูลประจำตัว ชื่อพูลข้อมูลประจำตัวที่คุณต้องการเพิ่มผู้ใช้ หากคุณกำลังเพิ่มผู้ใช้ลงในพูลข้อมูลประจำตัวและไม่ได้ระบุชื่อพูลข้อมูลประจำตัว ผู้ใช้จะถูกเพิ่มลงในพูลเริ่มต้น (การกำหนดค่า TSM) ซึ่งเป็นชุดของผู้ใช้ที่ได้รับการจัดสรรใน TSM ระหว่างการตั้งค่า Tableau Server

ตัวระบุ ตัวระบุสำหรับผู้ใช้ที่คุณต้องการเพิ่ม ตัวระบุใช้เพื่อวัตถุประสงค์ในการจับคู่ข้อมูลประจำตัวเท่านั้น หากต้องการข้อมูลเพิ่มเติม โปรดดูชื่อผู้ใช้และตัวระบุใน Tableau

การตรวจสอบสิทธิ์ในเครื่อง: ไม่บังคับ
Active Directory หรือ LDAP: จำเป็น

เพิ่มผู้ใช้จำนวนมากด้วยพูลข้อมูลประจำตัว

คุณสามารถใช้กระบวนการนำเข้า CSV เพื่อดำเนินการดังนี้

เพิ่มผู้ใช้จำนวนมากลงในพูลข้อมูลประจำตัวเพิ่มเติม หมายเหตุ: คุณไม่สามารถใช้กระบวนการนำเข้า CSV เพื่อแทนที่พูลข้อมูลประจำตัวที่ผู้ใช้เป็นสมาชิกอยู่แล้วด้วยพูลข้อมูลประจำตัวอื่น หากคุณเพิ่มผู้ใช้ที่มีอยู่ด้วยค่าพูลข้อมูลประจำตัวอื่น ระบบจะเพิ่มผู้ใช้ดังกล่าวลงในพูลข้อมูลประจำตัวเพิ่มเติมนั้น
เพิ่มตัวระบุจำนวนมากสำหรับผู้ใช้ที่ยังไม่มี หมายเหตุ: หากคุณเพิ่มตัวระบุอื่นสำหรับผู้ใช้ในพูลเดียวกัน จะไม่แทนที่ตัวระบุที่มีอยู่สำหรับผู้ใช้นั้น แต่จะมีการสร้างบันทึกตัวระบุใหม่สำหรับผู้ใช้นั้นแทน

ตัวอย่างการนำเข้า CSV สำหรับ Tableau Server

เคล็ดลับ: โปรดทราบว่าโครงสร้างจะเป็น: 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

ถ้าคุณนำเข้าไฟล์นี้ในขณะจัดการไซต์ ผู้ใช้สี่คนจะถูกเพิ่มไปยังไซต์นั้น การตั้งค่า Administrator สำหรับผู้ใช้ชื่อ Michelle คือ System อย่างไรก็ตาม เนื่องจากคุณกำลังนำเข้าผู้ใช้ไปยังไซต์ Tableau Server จะกำหนดบทบาทในไซต์ของ Creator ผู้ดูแลไซต์ให้กับ Michelle ผู้ใช้สามรายมีสิทธิ์ในการเผยแพร่
ถ้าคุณนำเข้าไฟล์นี้ในขณะจัดการเซิร์ฟเวอร์ ผู้ใช้สี่รายจะถูกเพิ่มไปยังเซิร์ฟเวอร์ แต่จะไม่ถูกเพิ่มไปยังไซต์ใดๆ จะมีผู้ใช้เพียงรายเดียวเท่านั้นถูกนำเข้าเป็นผู้ดูแลระบบเซิร์ฟเวอร์ ผู้ใช้ที่เหลือจะถูกกำหนดเป็นผู้ใช้ที่ ‘ไม่มีใบอนุญาต’

ตัวอย่างพูลข้อมูลประจำตัว

เคล็ดลับ: โปรดทราบว่าโครงสร้างจะเป็น: username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier

ตัวอย่างต่อไปนี้แสดงไฟล์ 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

ตัวอย่างต่อไปนี้แสดงไฟล์ 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

ตัวอย่างต่อไปนี้แสดงไฟล์ 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

ปรับปรุงประสิทธิภาพสำหรับไฟล์ CSV ขนาดใหญ่ที่ป้อนผ่านคำสั่ง tabcmd

หมายเหตุ: การตั้งค่าเหล่านี้จะมีผลกับ Tableau Server เวอร์ชัน 2022.1 และก่อนหน้า บริการค้นหาและจัดทำดัชนีที่ได้รับผลกระทบได้ถูกเลิกใช้งานแล้วตั้งแต่เวอร์ชัน 2022.3 และเลิกใช้ (นำออกทั้งหมด) ในเวอร์ชัน 2023.3

ผู้ดูแลระบบเซิร์ฟเวอร์สามารถเปิดใช้การตั้งค่าเซิร์ฟเวอร์ที่ช่วยปรับปรุงประสิทธิภาพการนำเข้าไฟล์ CSV ขนาดใหญ่ผ่านคำสั่ง tabcmd ได้ คุณสามารถทำสิ่งนี้ได้โดยใช้คำสั่งe tsm configuration 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 createsiteusers, deletesiteusers, addusers และ removeusers

หากต้องการข้อมูลรายละเอียดสำหรับการตั้งค่าเหล่านี้ โปรดดู ตัวเลือกการกำหนดค่า tsm ที่ตั้งค่าไว้

การตั้งค่า CSV และบทบาทในไซต์

การตั้งค่าระดับใบอนุญาต ผู้ดูแลระบบ และการเผยแพร่สำหรับผู้ใช้จะเป็นการกำหนดลักษณะการตั้งค่าบทบาทในไซต์ของผู้ใช้ในระหว่างกระบวนการนำเข้า ข้อมูลต่อไปนี้จะแสดงให้เห็นว่าควรบันทึกบทบาทในไซต์อย่างไรในไฟล์ CSV

บทบาทในไซต์	ระดับของใบอนุญาต	ระดับของผู้ดูแล	ความสามารถในการเผยแพร่
ผู้ดูแลเซิร์ฟเวอร์ บทบาทนี้ใช้ได้ก็ต่อเมื่อคุณนำเข้าผู้ใช้ในขณะจัดการเซิร์ฟเวอร์ (นั่นคือ ไม่ได้เข้าสู่ระบบไซต์ใดไซต์หนึ่ง)	แต่บทบาทในไซต์ของผู้ดูแลเซิร์ฟเวอร์จะต้องใช้ใบอนุญาต Creator เสมอถ้ามีอยู่ ถ้ามีใบอนุญาต Creator พร้อมใช้งาน ให้ดูที่ แก้ปัญหาด้านการให้สิทธิ์อนุญาต เพื่อเรียนรู้เกี่ยวกับวิธีการจัดการงานนี้ของ Tableau Server	ระบบ	True
ผู้ดูแลไซต์ในฐานะ Creator หรือผู้ดูแลไซต์ในฐานะ Explorer บทบาทเหล่านี้ใช้ได้ก็ต่อเมื่อคุณนำเข้าผู้ใช้ในขณะเข้าสู่ระบบไซต์ใดไซต์หนึ่ง	Creator หรือ Explorer	ไซต์	True
Creator	Creator	ไม่มี	True
Explorer (สามารถเผยแพร่ได้)	Explorer	ไม่มี	True
Explorer	Explorer	ไม่มี	False
Viewer	Viewer	ไม่มี	False
ไม่มีใบอนุญาต	ไม่มีใบอนุญาต	ไม่มี	False

ย้อนกลับไปด้านบน

ความช่วยเหลือ Tableau Server บน Windows