คู่มือไฟล์นำเข้า CSV
คุณสามารถเพิ่มผู้ใช้จำนวนมากได้โดยสร้างไฟล์ค่าที่คั่นด้วยจุลภาค (CSV) พร้อมข้อมูลผู้ใช้ จากนั้นจึงนำเข้าไฟล์ คุณสามารถรวมข้อมูลแอตทริบิวต์ในไฟล์ CSV เช่น ระดับของใบอนุญาตและสิทธิ์เข้าถึงเพื่อเผยแพร่ เพื่อนำไปใช้กับผู้ใช้ในตอนที่คุณนำเข้าผู้ใช้ได้
หัวข้อนี้จะอธิบายรายละเอียดของไฟล์ CSV หากต้องการนำเข้าผู้ใช้โดยใช้ CSV คุณสามารถทำสิ่งต่อไปนี้ได้
- ใช้หน้าการดูแลระบบไซต์ หากต้องการทราบข้อมูล โปรดดูนำเข้าผู้ใช้
- ใช้ยูทิลิตี้
tabcmd
หากต้องการทราบข้อมูล โปรดดู createsiteusers filename.csv - ใช้ Tableau Cloud Manager หากต้องการข้อมูลเพิ่มเติม โปรดดูจัดการผู้ใช้ด้วย Tableau Cloud Manager
ข้อกำหนดรูปแบบไฟล์ CSV
ไฟล์ CSV สำหรับนำเข้าผู้ใช้มีข้อกำหนดการจัดรูปแบบดังต่อไปนี้
- ไม่มีส่วนหัวคอลัมน์ Tableau Cloud จะถือว่าทุกบรรทัดในไฟล์แทนถึงผู้ใช้
- รูปแบบ UTF-8 ที่มีเครื่องหมายลำดับไบต์ (BOM)
- การเข้ารหัสตัวอักขระ เข่น BIG-5 ต้องถูกแปลงเป็น UTF-8 คุณสามารถทำได้โดยการเปิดไฟล์เครื่องมือแก้ไขข้อความ แล้วใช้คำสั่ง บันทึกเป็น
- หากมีอักขระ
@
อยู่ในฟิลด์ชื่อผู้ใช้ที่ไม่ใช่ตัวคั่นโดเมน อักขระนั้นจะต้องอยู่ในรูปแบบเลขฐานสิบหก:\0x40
ตัวอย่างเช่นuser@fremont@mycompany.com
ควรเป็นuser\0x40fremont@mycompany.com
โครงสร้างคอลัมน์ที่จำเป็นในไฟล์ CSV
ไฟล์ต้องไม่มีแถวส่วนหัว ไม่จำเป็นต้องมีข้อมูลในทุกคอลัมน์ แต่ต้องเก็บโครงสร้างคอลัมน์ที่จำเป็นไว้โดยรวมตัวคั่นจุลภาคที่กำหนดไว้ทั้งหมด
โครงสร้างคอลัมน์จะแตกต่างกันไปตามผลิตภัณฑ์และเครื่องมือนำเข้า ตรวจสอบให้แน่ใจว่าคุณใช้โครงสร้างที่เหมาะสมสำหรับสภาพแวดล้อมของคุณ
- Tableau Cloud: ชื่อผู้ใช้, รหัสผ่าน, ชื่อที่แสดง, ระดับของใบอนุญาต, ระดับของผู้ดูแล, ความสามารถในการเผยแพร่, ที่อยู่อีเมล
- Tableau Cloud ที่มี Tableau Cloud Manager (TCM): URI ของกลุ่มผู้ใช้หรือไซต์, ชื่อผู้ใช้, รหัสผ่าน, ชื่อที่แสดง, ระดับของใบอนุญาต, ระดับของผู้ดูแลระบบ ความสามารถในการเผยแพร่, ที่อยู่อีเมล, ประเภทการตรวจสอบสิทธิ์
- Tableau Server: ชื่อผู้ใช้, รหัสผ่าน, ชื่อที่แสดง, ระดับของใบอนุญาต, ระดับของผู้ดูแล, ความสามารถในการเผยแพร่, ที่อยู่อีเมล
- Tableau Server ที่ใช้พูลข้อมูลประจำตัว:ชื่อผู้ใช้, รหัสผ่าน, ชื่อที่แสดง, ระดับของใบอนุญาต, ระดับของผู้ดูแล, ความสามารถในการเผยแพร่, ที่อยู่อีเมล, ชื่อพูลข้อมูลประจำตัว, ตัวระบุ
ดูส่วนรายละเอียดคอลัมน์ด้านล่างสำหรับข้อมูลเพิ่มเติมเกี่ยวกับค่าที่เป็นไปได้ของแต่ละคอลัมน์
สำคัญ: ลำดับของคอลัมน์มีความสำคัญ คอลัมน์แรกจะถือเป็นชื่อผู้ใช้ คอลัมน์ที่สองจะเป็นรหัสผ่าน คอลัมน์ที่สามเป็นชื่อที่แสดง เป็นต้น โดนไม่คำนึงถึงเนื้อหาในคอลัมน์ ถ้าคุณละเว้นค่าสำหรับฟิลด์ คุณยังคงต้องรวมตัวคั่นจุลภาคของฟิลด์ด้วย
รายละเอียดคอลัมน์สำหรับไฟล์ CSV ของ Tableau Cloud
ถ้าไฟล์ CSV มีเฉพาะค่าชื่อผู้ใช้ (ที่อยู่อีเมล) ผู้ใช้จะได้รับการเชิญทางอีเมลไปยังไซต์ ผู้ใช้สามารถรวมไซต์เพื่อสร้างบัญชีของตน แต่บัญชีจะยังไม่มีใบอนุญาตจนกว่าผู้ดูแลระบบจะกำหนดค่าบัญชี (ชื่อที่แสดง ระดับใบอนุญาต เป็นต้น) ที่อยู่อีเมลของผู้ใช้บนไซต์อาจแสดงบนไซต์โดยมีจุดนําหน้า (เช่น .user@domain.com
) จนกว่าผู้ใช้จะเข้าสู่ระบบเป็นครั้งแรก
โครงสร้างคอลัมน์สำหรับไฟล์ CSV: ชื่อผู้ใช้, รหัสผ่าน, ชื่อที่แสดง, ระดับของใบอนุญาต, ระดับของผู้ดูแล, ความสามารถในการเผยแพร่, ที่อยู่อีเมล
รายละเอียดคอลัมน์:
ชื่อผู้ใช้: จำเป็น ที่อยู่อีเมลของผู้ใช้
รหัสผ่าน: ละเว้น ตามแนวทางปฏิบัติที่ดีที่สุด ให้เว้นว่างคอลัมน์นี้
- ผู้ใช้ใหม่จะต้องเลือกรหัสผ่านและชื่อที่แสดงเมื่อเข้าสู่ระบบครั้งแรกใน Tableau Cloud หากผู้ใช้มีบัญชี Tableau อยู่แล้ว ผู้ใช้เหล่านั้นก็อาจมีรหัสผ่านอยู่แล้ว
ชื่อที่แสดง: ละเว้น ตามแนวทางปฏิบัติที่ดีที่สุด ให้เว้นว่างคอลัมน์นี้
ระดับของใบอนุญาต: ซึ่งอาจเป็น Creator, Explorer, Viewer หรือ ไม่มีใบอนุญาต หากเว้นว่างไว้ ระดับของใบอนุญาตจะเป็น “ไม่มีใบอนุญาต”
ระดับของผู้ดูแล: ซึ่งอาจเป็นไซต์หรือไม่มี หากเว้นว่างไว้ ระดับของผู้ดูแลจะเป็น “ไม่มี”
- ไซต์ = ผู้ดูแลไซต์, ไม่มี = ไม่ใช่ผู้ดูแล
- หมายเหตุ: ระบบคลาวด์เป็นค่าเดียวที่เกี่ยวข้องเมื่อใช้ Tableau Cloud Manager หากต้องการข้อมูลเพิ่มเติม โปรดดูจัดการผู้ใช้ด้วย Tableau Cloud Manager
ความสามารถในการเผยแพร่: ซึ่งอาจเป็นใช่/จริง/1 หรือ ไม่/เท็จ/0 หากเว้นว่างไว้ ความสามารถในการเผยแพร่จะเป็น “เท็จ”
- หากระดับของใบอนุญาตคือ Creator ความสามารถในการเผยแพร่ต้องเป็นใช่/จริง/1
- หากระดับของใบอนุญาตเป็น Explorer ค่าความสามารถในการเผยแพร่จะเป็นตัวแยกความแตกต่างระหว่างบทบาทในไซต์ Explorer (เผยแพร่ได้) กับ Explorer
- หากระดับของใบอนุญาตเป็น Viewer หรือไม่มีใบอนุญาต ผู้ใช้จะไม่สามารถเผยแพร่ได้ไม่ว่าค่าของคอลัมน์นี้จะเป็นอย่างไร
ที่อยู่อีเมล: เริ่มตั้งแต่เดือนกรกฎาคม 2025 (Tableau 2025.2) โปรดระบุที่อยู่อีเมลหากต่างจากชื่อผู้ใช้ ที่อยู่อีเมลจะนำไปใช้เพื่อวัตถุประสงค์การแจ้งเตือนเท่านั้น หากไม่ได้ระบุค่าที่อยู่อีเมล Tableau Cloud จะใช้ค่าในฟิลด์ชื่อผู้ใช้ที่จำเป็นเพื่อส่งการแจ้งเตือน
คอลัมน์ใดๆ ที่เว้นว่างไว้ต้องคั่นด้วยเครื่องหมายจุลภาคเพื่อรักษาโครงสร้างคอลัมน์ไว้
ประเภทการตรวจสอบสิทธิ์ที่ไม่มี TCM
หากคุณไม่ได้ใช้ Tableau Cloud Manager คุณจะสามารถตั้งค่าประเภทการตรวจสอบสิทธิ์เริ่มต้นได้เพียงประเภทเดียวในระหว่างการอัปโหลด คุณสามารถเปลี่ยนประเภทการตรวจสอบสิทธิ์สำหรับผู้ใช้แต่ละรายได้ในภายหลัง
- เมื่ออัปโหลดไฟล์ CSV โดยตรงใน Tableau Cloud ให้ระบุประเภทการตรวจสอบสิทธิ์เมื่อคุณนำเข้าไฟล์และประเภทนั้นจะมีผลกับผู้ใช้ที่นำเข้าทั้งหมด
- เมื่อใช้
tabcmd
เพื่อนำเข้าผู้ใช้ ให้ตั้งค่าประเภทการตรวจสอบสิทธิ์และบทบาทในไซต์ที่จะนำไปใช้กับผู้ใช้ทั้งหมดในไฟล์ CSV ระหว่างอัปโหลด หากต้องการทราบข้อมูล โปรดดู createsiteusers filename.csv
หากต้องการตั้งค่าประเภทการตรวจสอบสิทธิ์เฉพาะผู้ใช้ในขณะที่อัปโหลด คุณต้องใช้ Tableau Cloud Manager หากต้องการข้อมูลเพิ่มเติม โปรดดูจัดการผู้ใช้ด้วย Tableau Cloud Manager
ตัวอย่างโครงสร้างไฟล์ CSV ของ Tableau Cloud
เคล็ดลับ:โปรดทราบว่าโครงสร้างจะเป็น: username, password, display name, license level, administrator level, publishing capability, email address
โดยไม่มีอะไรอยู่ระหว่างเครื่องหมายจุลภาคเมื่อเว้นว่างคอลัมน์
ตัวอย่างต่อไปนี้แสดงผู้ใช้ที่จะได้รับอนุญาตบทบาทในไซต์เป็น Explorer (เผยแพร่ได้) ซึ่งไม่ใช่ผู้ดูแลไซต์ และจะสามารถเผยแพร่ไปยังโปรเจกต์ที่พวกเขามีสิทธิ์ในเนื้อหาที่เหมาะสมอยู่
user1@domain.com,,,Explorer,None,true,user1@domain2.com
เมื่อเปลี่ยนแปลงคอลัมน์ระดับผู้ดูแลระบบ คุณสามารถนำเข้าผู้ใช้ต่อไปนี้เป็นผู้ดูแลไซต์พร้อมบทบาทในไซต์เป็น Explorer ผู้ดูแลไซต์
adminuser@domain.com,,,Explorer,Site,true
,adminuser@domain2.com
รายละเอียดคอลัมน์สำหรับไฟล์ CSV ของ TCM
หากไฟล์ CSV มีเฉพาะค่าชื่อผู้ใช้ (ที่อยู่อีเมล) ผู้ใช้จะได้รับคำเชิญทางอีเมลไปยังไซต์ ผู้ใช้สามารถรวมไซต์เพื่อสร้างบัญชีของตน แต่บัญชีจะยังไม่มีใบอนุญาตจนกว่าผู้ดูแลระบบจะกำหนดค่าบัญชี (ชื่อที่แสดง ระดับใบอนุญาต เป็นต้น)
โปรดทราบว่าคอลัมน์ที่เว้นว่างไว้ยังคงต้องคั่นด้วยเครื่องหมายจุลภาคเพื่อรักษาโครงสร้างคอลัมน์ไว้
โครงสร้างคอลัมน์ของไฟล์ CSV: tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type
รายละเอียดคอลัมน์:
URI ของกลุ่มผู้ใช้หรือไซต์: ตัวระบุทรัพยากรแบบเหมือนกันสำหรับกลุ่มผู้ใช้หรือไซต์
ชื่อผู้ใช้: จำเป็น ที่อยู่อีเมลของผู้ใช้
รหัสผ่าน: ละเว้น ตามแนวทางปฏิบัติที่ดีที่สุด ให้เว้นว่างคอลัมน์นี้
- ผู้ใช้ใหม่จะต้องเลือกรหัสผ่านและชื่อที่แสดงเมื่อเข้าสู่ระบบครั้งแรกใน Tableau Cloud หากผู้ใช้มีบัญชี Tableau อยู่แล้ว ผู้ใช้เหล่านั้นก็อาจมีรหัสผ่านอยู่แล้ว
ชื่อที่แสดง: ละเว้น ตามแนวทางปฏิบัติที่ดีที่สุด ให้เว้นว่างคอลัมน์นี้
ระดับของใบอนุญาต: ซึ่งอาจเป็น Creator, Explorer, Viewer หรือ ไม่มีใบอนุญาตสำหรับไซต์ หากเว้นว่างไว้ ระดับของใบอนุญาตจะเป็น “ไม่มีใบอนุญาต”
ระดับของผู้ดูแล: ซึ่งอาจเป็นไซต์ ระบบคลาวด์ หรือไม่มี หากเว้นว่างไว้ ระดับของผู้ดูแลจะเป็น “ไม่มี”
- ไซต์ = ผู้ดูแลไซต์, ไม่มี = ไม่ใช่ผู้ดูแล, ระบบคลาวด์ = ผู้ดูแลระบบคลาวด์
ความสามารถในการเผยแพร่: ค่านี้อาจเป็นจริงหรือเท็จสําหรับไซต์ก็ได้ หากเว้นว่างไว้ ความสามารถในการเผยแพร่จะเป็น “เท็จ”
- หากระดับของใบอนุญาตคือ Creator ความสามารถในการเผยแพร่ต้องเป็นจริง
- หากระดับของใบอนุญาตเป็น Explorer ค่าความสามารถในการเผยแพร่จะเป็นตัวแยกความแตกต่างระหว่างบทบาทในไซต์ Explorer (เผยแพร่ได้) กับ Explorer
- หากระดับของใบอนุญาตเป็น Viewer หรือไม่มีใบอนุญาต ผู้ใช้จะไม่สามารถเผยแพร่ได้ไม่ว่าค่าของคอลัมน์นี้จะเป็นอย่างไร
ประเภทการตรวจสอบสิทธิ์: ประเภทการตรวจสอบสิทธิ์ผู้ใช้สำหรับการเข้าถึงกลุ่มผู้ใช้หรือไซต์ ซึ่งอาจเป็น Google, OpenID, Salesforce, SAML, TableauIDWithMFA หรือ ค่าเริ่มต้น
ตัวอย่า โครงสร้างไฟล์ CSV ของ TCM
เคล็ดลับ:โปรดทราบว่าโครงสร้างจะเป็น: tenant or site URI, username, password, display name, license level, administrator level, publishing capability, email address, authentication type
โดยไม่มีอะไรอยู่ระหว่างเครื่องหมายจุลภาคเมื่อเว้นว่างคอลัมน์
ตัวอย่างต่อไปนี้แสดงผู้ใช้ที่ได้รับบทบาทผู้ดูแลระบบคลาวด์ใน Tableau Cloud Manager และตรวจสอบสิทธิ์โดยใช้ Tableau ร่วมกับ MFA
MyTCM,cloudadminuser@domain.com,,,,Cloud,,,TableauIDWithMFA
ด้วยการเปลี่ยนคอลัมน์การตรวจสอบสิทธิ์ คุณสามารถนำเข้าผู้ใช้ต่อไปนี้ด้วยประเภทการตรวจสอบสิทธิ์อื่นได้ หากกำหนดค่าไว้ในการตั้งค่า Tableau Cloud Manager
MyTCM,cloudadminuser@domain.com,,,,Cloud,,,Salesforce
ในตัวอย่างต่อไปนี้ คุณสามารถนําเข้าผู้ใช้ที่มี Explorer - สามารถเผยแพร่บทบาทในไซต์ที่มี Tableau ด้วยการตรวจสอบสิทธิ์ MFA
MySite,user1@domain.com,,,Explorer,None,True,,TableauIDWithMFA
การตั้งค่า CSV และบทบาทในไซต์
การตั้งค่าระดับใบอนุญาต ผู้ดูแลระบบ และการเผยแพร่สำหรับผู้ใช้จะเป็นการกำหนดลักษณะการตั้งค่าบทบาทในไซต์ของผู้ใช้ในระหว่างกระบวนการนำเข้า ข้อมูลต่อไปนี้จะแสดงให้เห็นว่าควรบันทึกบทบาทในไซต์อย่างไรในไฟล์ CSV
บทบาทในไซต์ | ระดับของใบอนุญาต | ระดับของผู้ดูแล | ความสามารถในการเผยแพร่ |
ผู้ดูแลระบบคลาวด์ บทบาทนี้ใช้ได้ก็ต่อเมื่อคุณนำเข้าผู้ใช้ในขณะเข้าสู่ระบบ Tableau Cloud Manager (นั่นคือ ไม่ได้เข้าสู่ระบบไซต์ใดไซต์หนึ่ง) | ไม่มีใบอนุญาต | ระบบคลาวด์ | False |
ผู้ดูแลไซต์ในฐานะ Creator หรือผู้ดูแลไซต์ในฐานะ Explorer บทบาทเหล่านี้ใช้ได้ก็ต่อเมื่อคุณนำเข้าผู้ใช้ในขณะเข้าสู่ระบบไซต์ใดไซต์หนึ่ง | Creator หรือ Explorer | ไซต์ | True |
Creator | Creator | ไม่มี | True |
Explorer (สามารถเผยแพร่ได้) | Explorer | ไม่มี | True |
Explorer | Explorer | ไม่มี | False |
Viewer | Viewer | ไม่มี | False |
ไม่มีใบอนุญาต | ไม่มีใบอนุญาต | ไม่มี | False |