Bagikan melalui

Menjalankan pemindaian metadata

  • Artikel

Panduan singkat berikut menunjukkan cara menggunakan API pemindai untuk mengambil metadata dari item Fabric organisasi Anda. Ini mengasumsikan bahwa admin Fabric telah menyiapkan pemindaian metadata di organisasi Anda.

Untuk daftar metadata artefak dan subartifak yang dikembalikan pemindaian metadata, lihat dokumentasi untuk API Admin - WorkspaceInfo GetScanResult.

Berikut ini adalah API pemindai. Mereka mendukung sovereign cloud dan publik.

Penting

Aplikasi yang Anda kembangkan untuk pemindaian dapat mengautentikasi dengan menggunakan token akses admin standar yang didelegasikan atau perwakilan layanan. Dua jalur autentikasi saling eksklusif. Saat berjalan di bawah perwakilan layanan, tidak boleh ada izin yang diperlukan admin Power BI yang diatur di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan autentikasi perwakilan layanan untuk API admin baca-saja.

Langkah 1: Lakukan pemindaian penuh

Panggil workspaces/modified tanpa parameter modifiedSince untuk mendapatkan daftar lengkap ID ruang kerja di penyewa. Pemindaian ini mengambil semua ruang kerja di penyewa, termasuk ruang kerja pribadi dan ruang kerja bersama. Jika Anda ingin mengecualikan ruang kerja pribadi dari pemindaian, gunakan parameter ruang kerja/modifikasi excludePersonalWorkspaces .

Bagilah daftar menjadi potongan-potongan paling banyak 100 ruang kerja.

Untuk setiap potongan 100 ruang kerja:

Panggil ruang kerja/getInfo untuk memicu panggilan pemindaian untuk 100 ruang kerja ini. Anda akan menerima scanId dalam respons yang akan digunakan di langkah berikutnya. Di header lokasi, Anda juga akan menerima Pengidentifikasi Sumber Daya Seragam (URI) untuk memanggil langkah berikutnya.

Catatan

Tidak lebih dari 16 panggilan dapat dilakukan secara bersamaan. Pemanggil harus menunggu respons pemindaian berhasil/gagal dari API scanStatus sebelum memanggil panggilan lain.

Jika beberapa metadata yang diharapkan tidak dikembalikan, tanyakan kepada admin Fabric Anda untuk memastikan mereka telah mengaktifkan semua pengalihan admin yang relevan.

Gunakan URI dari header lokasi yang Anda terima dari memanggil ruang kerja/getInfo dan polling pada ruang kerja/scanStatus/{scan_id} hingga status yang dikembalikan adalah "Berhasil". Status ini berarti hasil pemindaian sudah siap. Disarankan untuk menggunakan interval polling 30-60 detik. Di header lokasi, Anda juga menerima URI untuk dihubungi di langkah berikutnya. Gunakan hanya setelah status "Berhasil".

Gunakan URI dari header lokasi yang Anda terima dari memanggil ruang kerja/scanStatus/{scan-id} dan membaca data menggunakan ruang kerja/scanResult/{scan_id}. Data berisi daftar ruang kerja, info item, dan metadata lainnya berdasarkan parameter yang diteruskan di ruang kerja/panggilan getInfo .

Langkah 2: Lakukan pemindaian bertahap

Sekarang setelah Anda memiliki semua ruang kerja dan metadata serta silsilah asetnya, sebaiknya Anda hanya melakukan pemindaian bertahap yang merujuk pada pemindaian sebelumnya yang Anda lakukan.

Panggil ruang kerja/dimodifikasi dengan parameter modifiedSince yang diatur ke waktu mulai pemindaian terakhir untuk mendapatkan ruang kerja yang telah berubah, dan karenanya memerlukan pemindaian lain. Parameter modifiedSince harus diatur untuk tanggal dalam 30 hari terakhir.

Bagi daftar ini menjadi potongan hingga 100 ruang kerja, dan dapatkan data untuk ruang kerja yang diubah ini dengan menggunakan tiga panggilan API, ruang kerja/getInfo, ruang kerja/scanStatus/{scan_id}, dan ruang kerja/scanResult/{scan_id}, seperti yang dijelaskan di Langkah 1.

Pertimbangan dan batasan

  • model semantik yang belum di-refresh atau diterbitkan ulang akan dikembalikan dalam respons API tetapi tanpa informasi dan ekspresi subartifaknya. Misalnya, nama model semantik dan silsilah data disertakan dalam respons, tetapi bukan nama tabel dan kolom model semantik.
  • model semantik yang hanya berisi tabel DirectQuery akan mengembalikan metadata subartifact hanya jika beberapa jenis tindakan telah diambil pada model semantik, seperti seseorang membangun laporan di atasnya, seseorang melihat laporan berdasarkan itu, dll.
  • Himpunan data real time, model semantik dengan keamanan tingkat objek, model semantik dengan koneksi langsung ke AS-Azure dan AS lokal, dan himpunan data keakuratan penuh Excel tidak didukung untuk metadata subartifact. Untuk himpunan data yang tidak didukung, respons mengembalikan alasan untuk tidak mendapatkan metadata subartifact dari himpunan data. Ini ditemukan di bidang bernama schemaRetrievalError, misalnya, schemaRetrievalError: Permintaan yang tidak didukung. Himpunan data RealTime tidak didukung.
  • API tidak mengembalikan metadata subartifact untuk model semantik yang lebih besar dari 1 GB di ruang kerja bersama. Di ruang kerja Premium, tidak ada batasan ukuran pada model semantik.

Pelisensian

Pemindaian metadata tidak memerlukan lisensi khusus. Ini berfungsi untuk semua metadata penyewa Anda, termasuk item yang terletak di ruang kerja non-Premium.

Konten terkait