แชร์ผ่าน

เรียกใช้การสแกนเมตาดาต้า

  • บทความ

การฝึกปฏิบัติสั้น ๆ ต่อไปนี้แสดงวิธีการใช้ API ของสแกนเนอร์เพื่อดึงข้อมูลเมตาดาต้าจากรายการ Fabric ขององค์กรของคุณ ซึ่งสันนิษฐานว่าผู้ดูแลระบบ Fabric ได้ตั้งค่าการสแกนเมตาดาต้าในองค์กรของคุณแล้ว

สําหรับรายการของเมตาดาต้าของอาร์ทิแฟกต์และวัตถุย่อยที่การสแกนเมตาดาต้าส่งกลับ ให้ดูเอกสารประกอบสําหรับผู้ดูแลระบบ - WorkspaceInfo GetScanResult API

ต่อไปนี้คือ API ของสแกนเนอร์ พวกเขาสนับสนุนทั้งคลาวด์สาธารณะและสาธารณะ

สำคัญ

แอปที่คุณพัฒนาสําหรับการสแกนสามารถรับรองความถูกต้องโดยใช้โทเค็นการเข้าถึงของผู้ดูแลระบบที่ได้รับมอบสิทธิ์มาตรฐานหรือบริการหลัก เส้นทางการรับรองความถูกต้องสองเส้นทางนั้นเป็นแบบไม่รวมกัน เมื่อเรียกใช้ภายใต้โครงร่างสําคัญของบริการ ต้องไม่มีสิทธิ์ที่จําเป็นสําหรับผู้ดูแลระบบ Power BI ที่ตั้งค่าในแอปของคุณ สําหรับข้อมูลเพิ่มเติม ดู เปิดใช้งานการรับรองความถูกต้องแบบโครงร่างสําคัญของบริการสําหรับ API ของผู้ดูแลระบบแบบอ่านอย่างเดียว

ขั้นตอนที่ 1: ทําการสแกนเต็มรูปแบบ

เรียก พื้นที่ทํางาน/แก้ไข โดยไม่มี พารามิเตอร์ modifiedSince เพื่อรับรายการทั้งหมดของรหัสพื้นที่ทํางานในผู้เช่า การสแกนนี้จะเรียกใช้พื้นที่ทํางานทั้งหมดในผู้เช่า รวมถึงพื้นที่ทํางานส่วนบุคคลและพื้นที่ทํางานที่ใช้ร่วมกัน ถ้าคุณต้องการแยกพื้นที่ทํางานส่วนบุคคลออกจากการสแกน ให้ใช้พารามิเตอร์ พื้นที่ทํางาน/แก้ไขส่วนบุคคลพื้นที่ทํางาน

แบ่งรายการออกเป็นกลุ่มๆ ละ 100 พื้นที่ทํางานมากที่สุด

สําหรับแต่ละกลุ่มของพื้นที่ทํางาน 100 พื้นที่:

เรียก พื้นที่ทํางาน/getInfo เพื่อทริกเกอร์การเรียกการสแกนสําหรับพื้นที่ทํางาน 100 เหล่านี้ คุณจะได้รับ scanId เพื่อเป็นการตอบสนองเพื่อใช้ในขั้นตอนถัดไป ในส่วนหัวของตําแหน่งที่ตั้ง คุณจะได้รับ Uniform Resource Identifier (URI) เพื่อเรียกใช้ขั้นตอนถัดไป

หมายเหตุ

สามารถโทรพร้อมกันได้ไม่เกิน 16 ครั้ง ผู้เรียกควรรอการตอบสนองการสแกนสําเร็จ/ล้มเหลวจาก scanStatus API ก่อนที่จะเรียกการเรียกอื่น

หากระบบไม่ส่งกลับเมตาดาต้าบางรายการที่คุณคาดว่าจะได้รับ ให้ตรวจสอบกับผู้ดูแลระบบ Fabric ของคุณเพื่อให้แน่ใจว่าได้ เปิดใช้งานสวิตช์ผู้ดูแลระบบที่เกี่ยวข้องทั้งหมด

ใช้ URI จากส่วนหัวของตําแหน่งที่ตั้งที่คุณได้รับจากการเรียก พื้นที่ทํางาน/getInfo และแบบสํารวจบน พื้นที่ทํางาน/scanStatus/{scan_id} จนกว่าสถานะที่ส่งกลับจะเป็น "สําเร็จแล้ว" สถานะนี้หมายความว่าผลลัพธ์การสแกนพร้อมแล้ว ขอแนะนําให้ใช้ช่วงการโพลล์ 30-60 วินาที ในส่วนหัวของตําแหน่งที่ตั้ง คุณจะได้รับ URI เพื่อเรียกใช้ในขั้นตอนถัดไป ใช้ได้เฉพาะหลังจากที่สถานะเป็น "สําเร็จแล้ว" เท่านั้น

ใช้ URI จากส่วนหัวของตําแหน่งที่ตั้งที่คุณได้รับจากการเรียกพื้นที่ทํางาน/scanStatus/{scan-id} และอ่านข้อมูลโดยใช้พื้นที่ทํางาน/scanResult/{scan_id} ข้อมูลประกอบด้วยรายการของพื้นที่ทํางาน ข้อมูลรายการ และเมตาดาต้าอื่น ๆ ตามพารามิเตอร์ที่ส่งผ่านใน พื้นที่ทํางาน/getInfo call

ขั้นตอนที่ 2: ทําการสแกนแบบเพิ่มหน่วย

ตอนนี้คุณมีพื้นที่ทํางานทั้งหมดและเมตาดาต้าและสายข้อมูลของแอสเซทแล้ว ขอแนะนําให้คุณทําการสแกนแบบเพิ่มหน่วยที่อ้างอิงการสแกนก่อนหน้านี้ที่คุณทํา

เรียก พื้นที่ทํางาน/แก้ไข ด้วย พารามิเตอร์ modifiedSince ที่ตั้งค่าเป็นเวลาเริ่มต้นของการสแกนล่าสุดเพื่อให้ได้พื้นที่ทํางานที่มีการเปลี่ยนแปลงดังนั้นจึงต้องมีการสแกนอื่น ควร ตั้งค่าพารามิเตอร์ modifiedSince สําหรับวันที่ภายใน 30 วันที่ผ่านมา

แบ่งรายการนี้ออกเป็นกลุ่มๆ ที่มีพื้นที่ทํางานสูงสุด 100 แห่ง และรับข้อมูลสําหรับพื้นที่ทํางานที่เปลี่ยนแปลงเหล่านี้โดยใช้การเรียกใช้ API สามรายการ พื้นที่ทํางาน /getInfo พื้นที่ทํางาน /scanStatus/{scan_id}, และ พื้นที่ทํางาน/scanResult/{scan_id} ตามที่อธิบายไว้ใน ขั้นตอนที่ 1

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

  • แบบจําลองความหมายที่ยังไม่ได้รีเฟรชหรือเผยแพร่ใหม่จะถูกส่งกลับในการตอบสนอง API แต่ไม่มีข้อมูลและนิพจน์ย่อย ตัวอย่างเช่น ชื่อแบบจําลองความหมายและสายข้อมูลจะรวมอยู่ในการตอบสนอง แต่ไม่ใช่ตารางและชื่อคอลัมน์ของแบบจําลองความหมาย
  • แบบจําลองความหมายที่มีเฉพาะ ตาราง DirectQuery จะส่งคืนเมตาดาต้าของส่วนย่อยเฉพาะเมื่อมีการดําเนินการบางอย่างในแบบจําลองความหมายเช่น บางคนสร้างรายงานที่ด้านบนของแบบจําลอง คนดูรายงานที่อิงจากแบบจําลองดังกล่าว เป็นต้น
  • ชุดข้อมูลแบบเรียลไทม์ แบบจําลองความหมายที่มีการ รักษาความปลอดภัยระดับออบเจ็กต์แบบจําลองความหมายด้วยการเชื่อมต่อแบบสดไปยัง AS-Azure และ AS ภายในองค์กร และชุดข้อมูลที่มีความเที่ยงตรงแบบเต็มของ Excel จะไม่ได้รับการสนับสนุนสําหรับเมตาดาต้าของส่วนย่อย สําหรับชุดข้อมูลที่ไม่สนับสนุน การตอบกลับจะส่งกลับเหตุผลสําหรับการไม่ได้รับเมตาดาต้าของ subartifact จากชุดข้อมูล พบได้ในเขตข้อมูลที่ชื่อว่า schemaRetrievalError ตัวอย่างเช่น schemaRetrievalError: คําขอที่ไม่รองรับ ชุดข้อมูลเรียลไทม์ไม่ได้รับการสนับสนุน
  • API ไม่ส่งกลับข้อมูลเมตาดาต้าย่อยสําหรับแบบจําลองความหมายที่มีขนาดใหญ่กว่า 1 GB ในพื้นที่ทํางานที่ใช้ร่วมกัน ในพื้นที่ทํางานแบบพรีเมียม จะไม่มีข้อจํากัดด้านขนาดบนแบบจําลองความหมาย

สิทธิ์การใช้งาน

การสแกนเมตาดาต้าไม่จําเป็นต้องมีสิทธิ์การใช้งานพิเศษ ซึ่งทํางานได้กับเมตาดาต้าของผู้เช่าของคุณทั้งหมด รวมถึงรายการที่อยู่ในพื้นที่ทํางานที่ไม่ใช่พรีเมียม

เนื้อหาที่เกี่ยวข้อง