หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
บทความนี้อธิบายวิธีการใช้ 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 ออบเจ็กต์ของโปรไฟล์หรือส่งส่วนหัวการเลือกโปรไฟล์สําหรับเส้นทางที่โยกย้าย การเปลี่ยนส่วนหัวเพียงอย่างเดียวไม่ใช่การโยกย้าย: ข้อมูลประจําตัวใหม่จะต้องได้รับสิทธิ์พื้นที่ทํางานและทรัพยากรที่จําเป็นก่อน ดูที่ แทนที่โปรไฟล์บริการหลักด้วยบริการหลัก
เนื้อหาที่เกี่ยวข้อง
การใช้งานหลายรายการด้วยโครงร่างสําคัญของบริการเฉพาะ
โปรไฟล์บริการหลัก: โซลูชันการเช่าเป็นทางเลือก