ใช้ SDK Power BI กับโปรไฟล์บริการหลัก

บทความนี้อธิบายวิธีการใช้ SDK กับโปรไฟล์บริการหลัก

หมายเหตุ

ตัวอย่างเหล่านี้นําไปใช้กับแอปพลิเคชันที่เลือก โซลูชันโปรไฟล์โครงร่างสําคัญของบริการที่เลือกได้ สําหรับโซลูชันการหลายรายการใหม่ เริ่มต้นด้วยโครงร่าง สําคัญของการบริการลูกค้าโดยเฉพาะ โดยใช้ข้อมูลประจําตัวที่มีการจัดการและสหพันธ์ที่ข้อกําหนดเหมาะสม ID โปรไฟล์ไม่ใช่ ID Microsoft Entra หลัก และไม่สามารถใช้เป็นข้อมูลประจําตัวที่มี Fabric REST API ได้

ถ้าข้อจํากัดของโปรไฟล์จํากัดโซลูชันของคุณ ให้ดู แทนที่โปรไฟล์บริการหลักด้วยบริการหลัก มิฉะนั้น ให้ใช้รูปแบบ SDK ตามโปรไฟล์ในบทความนี้ต่อไป

มีสองวิธีในการเชื่อมต่อไคลเอ็นต์ Power BI กับโปรไฟล์บริการหลัก คุณสามารถ:

เมื่อไคลเอ็นต์เชื่อมโยงกับโปรไฟล์ คุณสามารถรับโปรไฟล์บริการหลักปัจจุบันจากไคลเอ็นต์ Power BI ได้

สร้าง Power BI ไคลเอ็นต์ด้วยโปรไฟล์บริการหลัก

var profileObjectId = new Guid("81f24a6d-7ebb-4478-99c7-2c36f7870a26"); 
var powerBIclient = new PowerBIClient(credentials, profileObjectId: profileObjectId);

เมื่อคุณสร้างไคลเอ็นต์ Power BI ด้วย ID ออบเจ็กต์โปรไฟล์ การเรียกใช้ API ทั้งหมดที่ใช้ไคลเอ็นต์จะมี X-PowerBI-profile-id ในส่วนหัวของคําขอ

ตัวอย่างเช่น:

GET https://powerbiapi.analysis-df.windows.net/v1.0/myorg/groups


Authorization: Bearer eyJ0eXAiO.....5U_g
X-PowerBI-profile-id: 81f24a6d-7ebb-4478-99c7-2c36f7870a26

ตั้งค่าโปรไฟล์ในการเรียกใช้คําขอ API

อีกวิธีหนึ่งคือ คุณสามารถระบุรหัสโปรไฟล์ในคําขอ API โดยใช้customHeadersคุณสมบัติในของ API โอเวอร์โหลด PowerBIClient เมธอดWithHttpMessagesAsync

var powerBIclient = new PowerBIClient(credentials); 
var profileHeader = new Dictionary<string, List<string>>(); 
profileHeader.Add("X-PowerBI-profile-id", new List<string> { "81f24a6d-7ebb-4478-99c7-2c36f7870a26" }); 
var groups = await powerBIclient.Groups.GetGroupsWithHttpMessagesAsync(customHeaders: profileHeader); 

ตัวอย่างเช่น

GET https://powerbiapi.analysis-df.windows.net/v1.0/myorg/groups 

Authorization: Bearer eyJ0eXAiO.....5U_g 
X-PowerBI-profile-id: 81f24a6d-7ebb-4478-99c7-2c36f7870a26 

ในตัวอย่างโค้ดก่อนหน้านี้ ส่วนหัวของโปรไฟล์ ไม่ใช่ ส่วนหนึ่งของส่วนหัวเริ่มต้นของไคลเอ็นต์ เนื่องจากโค้ดไม่ได้เพิ่มส่วนหัวของโปรไฟล์ คุณจําเป็นต้องระบุส่วนหัวของโปรไฟล์ที่มีคําขอ API ทั้งหมด

ตรวจสอบให้แน่ใจว่าคุณหลีกเลี่ยงการทําซ้ํา ตัวอย่างเช่น การสร้างไคลเอ็นต์ที่มี ID ออปเจ็กต์โปรไฟล์จากนั้นระบุส่วนหัวที่มีผลลัพธ์คําขอ API ในข้อผิดพลาดที่ไม่ได้รับอนุญาต

รับโปรไฟล์บริการหลักปัจจุบันจากไคลเอ็นต์ Power BI

เมื่อต้องการเรียกใช้โปรไฟล์บริการหลักปัจจุบันจากไคลเอ็นต์ SDK ให้เรียกใช้GetServicePrincipalProfileObjectId

var profileObjectId = new Guid("81f24a6d-7ebb-4478-99c7-2c36f7870a26"); 
var powerBIclient = new PowerBIClient(credentials, profileObjectId: profileObjectId); 
var currentProfileObjectId = powerBIclient.GetServicePrincipalProfileObjectId(); 

ข้อควรพิจารณาและข้อจำกัด

ไม่มีการสนับสนุนสําหรับโปรไฟล์โครงร่างสําคัญของบริการที่มี Azure Analysis Services (AAS) ในโหมดการเชื่อมต่อสด

สําหรับการกํากับดูแลข้อมูลประจําตัว ความเข้ากันได้ของ API และข้อจํากัดอื่น ๆ ให้ดู ข้อมูลประจําตัวและข้อจํากัดของ API

หลังจากโยกย้ายลูกค้าไปยังบริการหลักเฉพาะ แล้วให้รับรองความถูกต้องของคําขอโดยใช้โทเค็นการเข้าถึงของแอปพลิเคชันลูกค้านั้น อย่ากําหนดค่า ID ออบเจ็กต์ของโปรไฟล์หรือส่งส่วนหัวการเลือกโปรไฟล์สําหรับเส้นทางที่โยกย้าย การเปลี่ยนส่วนหัวเพียงอย่างเดียวไม่ใช่การโยกย้าย: ข้อมูลประจําตัวใหม่จะต้องได้รับสิทธิ์พื้นที่ทํางานและทรัพยากรที่จําเป็นก่อน ดูที่ แทนที่โปรไฟล์บริการหลักด้วยบริการหลัก

การใช้งานหลายรายการด้วยโครงร่างสําคัญของบริการเฉพาะ

โปรไฟล์บริการหลัก: โซลูชันการเช่าเป็นทางเลือก

โปรไฟล์บริการหลักใน Power BI Embedded

แทนที่โปรไฟล์บริการหลักด้วยบริการหลัก