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

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

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

ข้อกำหนดรูปแบบไฟล์ 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
CreatorCreatorไม่มีTrue
Explorer (สามารถเผยแพร่ได้)Explorerไม่มีTrue
ExplorerExplorerไม่มีFalse
ViewerViewerไม่มีFalse
ไม่มีใบอนุญาตไม่มีใบอนุญาตไม่มีFalse
ขอบคุณสำหรับข้อเสนอแนะของคุณส่งข้อเสนอแนะของคุณเรียบร้อยแล้ว ขอขอบคุณ