สิทธิ์ REST API ของแบบจําลองเชิงความหมาย
บทความนี้อธิบายสิทธิ์ Power BI โดยทั่วไปและสิทธิ์แบบจําลองเชิงความหมายในบริบทของ Power BI REST API
สิทธิ์ Power BI
Power BI มีสองชุดของสิทธิ์:
การอนุญาตของพื้นที่ทํางาน
การอนุญาตของพื้นที่ทํางาน หรือที่เรียกว่าการอนุญาตหรือ บทบาทของโฟลเดอร์เป็นระดับสูงสุดของสิทธิ์ใน Power BI สิทธิ์เหล่านี้จะแทนที่สิทธิ์ที่กําหนดให้กับรายการที่ระบุในโฟลเดอร์พื้นที่ทํางาน
ตารางด้านล่างแสดงบทบาทโฟลเดอร์สี่ชนิด ซึ่งแสดงระดับของแต่ละบทบาทและสตริงโค้ดที่ส่งกลับโดย Power BI REST API ผู้ดูแลระบบคือระดับสิทธิ์ของพื้นที่ทํางานสูงสุด และผู้ชมอยู่ในระดับต่ําสุด ระดับสิทธิ์ทุกระดับมีความสามารถของสิทธิ์ด้านล่างนี้ คุณสามารถตรวจสอบความสามารถของแต่ละสิทธิ์ใน บทบาทพื้นที่ทํางานได้
บทบาทโฟลเดอร์ | ระดับ | สิทธิ์ที่ได้รับมาสําหรับแบบจําลองความหมายที่สร้างขึ้นในพื้นที่ทํางาน |
---|---|---|
ผู้ดูแลระบบ | 4 | ReadWriteReshareExplore |
สมาชิก | 3 | ReadWriteReshareExplore |
ผู้สนับสนุน | 2 | ReadWriteExplore |
ผู้ดู | 1 | Read |
หมายเหตุ
สิทธิ์การเขียนจะถูกนําไปใช้กับแบบจําลองความหมายของ Power BI ที่สร้างขึ้นโดยผู้ดูแลระบบ สมาชิก และผู้สนับสนุนในพื้นที่ทํางานที่พวกเขาเป็นเจ้าของ สิทธิ์ในการเขียนสามารถมอบหรือลบได้โดยใช้สิทธิ์ของพื้นที่ทํางานเท่านั้น ซึ่งไม่สามารถมอบให้ หรือลบออกจากรายการ Power BI ได้โดยตรง
รับและเพิ่มสิทธิ์ของพื้นที่ทํางานด้วย API
หากต้องการรับและเพิ่มสิทธิ์ของพื้นที่ทํางานทางโปรแกรม ให้ใช้ API เหล่านี้:
กลุ่ม - เพิ่มผู้ใช้ กลุ่ม - โพสต์ API สําหรับการเพิ่มสิทธิ์ของพื้นที่ทํางาน
กลุ่ม - อัปเดตผู้ใช้ กลุ่ม - PUT API สําหรับการเปลี่ยนแปลงสิทธิ์ของพื้นที่ทํางาน
กลุ่ม - รับผู้ใช้ กลุ่ม - GET API สําหรับการรับสิทธิ์ของพื้นที่ทํางาน
การอนุญาตรายการ
รายการ Power BI เช่น รายงาน แบบจําลองความหมาย และแดชบอร์ดจะมีสิทธิ์ของตนเอง สิทธิ์รายการไม่สามารถแทนที่สิทธิ์ของพื้นที่ทํางาน และเฉพาะผู้ที่มีสิทธิ์ระดับเดียวกันเท่านั้น
สิทธิ์แบบจําลองความหมายและ REST API
สิทธิ์ของแบบจําลองความหมายเป็นส่วนหนึ่งของสิทธิ์รายการ ตารางด้านล่างแสดงรายการสิทธิ์แบบจําลองความหมายของ Power BI และการแสดงสิทธิ์ใน Power BI REST API
เคล็ดลับ
แม้ว่าสิทธิ์ API จะเหมือนกับสิทธิ์บริการของ Power BI แต่build
สิทธิ์จะเรียกว่าการสํารวจสิทธิ์ใน API
สิทธิ์ | อ่าน | สำรวจ | แชร์ต่อ |
---|---|---|---|
คำอธิบาย | อนุญาตให้ผู้ใช้สามารถอ่านเนื้อหาของแบบจําลองความหมาย | เทียบเท่ากับ สิทธิ์ในการสร้าง | อนุญาตให้ผู้ใช้แชร์เนื้อหาของแบบจําลองความหมายกับผู้ใช้รายอื่นที่จะได้รับการอ่าน แชร์ต่อ หรือสํารวจสิทธิ์สําหรับแบบจําลองดังกล่าว |
ReadReshareExplore | |||
อ่านแชร์ | |||
ReadExplore | |||
อ่าน |
หมายเหตุ
เมื่อต้องการอนุญาตให้ผู้ใช้ดําเนินการเขียนบนแบบจําลองความหมาย ก่อนอื่นให้เปลี่ยนสิทธิ์ของพื้นที่ทํางาน
สร้างสิทธิ์และ REST API
ใน Power BI REST APIbuild
สิทธิ์จะถูกส่งกลับเป็นการสํารวจ ตัวอย่างเช่น สตริงที่มีสิทธิการอ่าน แชร์ต่อ และสร้างจะมีลักษณะดังนี้: ReadReshareExplore
เมื่อคุณให้สิทธิ์ผู้ใช้ build
พวกเขาสามารถสร้างเนื้อหาใหม่บนแบบจําลองความหมายของคุณได้ ตัวอย่างของเนื้อหาที่พวกเขาสามารถสร้างได้ คือ รายงาน แดชบอร์ด ไทล์ที่ปักหมุดจาก Q&A รายงานที่มีการแบ่งหน้า และการค้นพบข้อมูลเชิงลึก
ผู้ใช้ยังต้อง build
มีสิทธิ์ในการทํางานกับข้อมูลภายนอก Power BI:
ในการส่งออกข้อมูลต้นแบบ
เพื่อสร้างเนื้อหาใหม่บนแบบจําลองความหมายเช่น ด้วยวิเคราะห์ใน Excel
เพื่อเข้าถึงข้อมูลผ่านตําแหน่งข้อมูล XMLA
การรักษาความปลอดภัยระดับต่ำ
สําหรับแบบจําลองความหมายที่ใช้การรักษาความปลอดภัยระดับแถว (RLS) สิทธิ์ใด ๆ ที่build
สูงกว่าจะทําให้ผู้ใช้สามารถดูข้อมูลทั้งหมดในแบบจําลองความหมายได้ Build
และสิทธิ์ที่ต่ํากว่า build
จะทําให้ผู้ใช้แบบจําลองเชิงความหมายสามารถเข้าถึงข้อมูลที่ได้รับอนุญาตให้ดูตามที่กําหนดค่าไว้ในการตั้งค่า RLS ของคุณเท่านั้น
รับและอัปเดตสิทธิ์แบบจําลองความหมายด้วย API
โพสต์ API ช่วยให้คุณเพิ่มสิทธิ์ใหม่ลงในแบบจําลองความหมาย คุณสามารถใช้ API เหล่านี้เพื่อเพิ่มสิทธิ์สําหรับผู้ใช้ แต่ไม่สามารถลบสิทธิ์ออกได้ ตัวอย่างเช่น คุณสามารถเพิ่ม
Reshare
สิทธิ์ให้ผู้ใช้ที่มีสิทธิ์Read
ได้ อย่างไรก็ตาม คุณไม่สามารถเอาสิทธิ์ออกจากReshare
ผู้ใช้ที่มีสิทธิ์ทั้งRead
และReshare
โดยการพยายามเพิ่มRead
สิทธิ์PUT API จะอัปเดตสิทธิ์ของผู้ใช้ในชุดข้อมูลที่ระบุ PUT API ไม่สามารถใช้สําหรับการเปลี่ยนแปลงสิทธิ์การเขียนหรือระดับโฟลเดอร์ใดๆ ที่สืบทอดมาได้ API นี้ยังรองรับการลบสิทธิ์ทั้งหมดสําหรับชุดข้อมูลสําหรับเป้าหมายที่กําหนด
GET API ส่งกลับรายการโครงร่างสําคัญที่มีสิทธิ์เข้าถึงชุดข้อมูลที่ระบุ
ข้อควรพิจารณาและข้อจำกัด
API แต่ละตัวข้างต้นมาพร้อมกับข้อจํากัดบางอย่างเกี่ยวกับผู้ที่สามารถใช้งานและวิธีใช้งาน เมื่อต้องการดูข้อจํากัดของแต่ละ API เลือกลิงก์สําหรับ API นั้น