Bagikan melalui


Integrasi OneLake untuk model semantik

Penting

Integrasi OneLake untuk model semantik saat ini dalam pratinjau.

Dengan integrasi Microsoft OneLake untuk model semantik, data yang diimpor ke tabel model juga dapat ditulis secara otomatis ke tabel Delta di OneLake. Format Delta adalah format tabel terpadu di semua mesin komputasi di Microsoft Fabric. Integrasi OneLake mengekspor data dengan semua fitur performa utama yang diaktifkan untuk memberikan akses data yang lebih mulus dengan performa yang lebih tinggi.

Ilmuwan data, analis database, pengembang aplikasi, teknisi data, dan konsumen data lainnya kemudian dapat mengakses data yang sama yang mendorong kecerdasan bisnis dan laporan keuangan Anda di Power BI. Solusi T-SQL, Python, Scala, PySpark, Spark SQL, R, dan no-code/low-code semuanya dapat digunakan untuk mengkueri data dari tabel Delta.

Diagram of OneLake integration for semantic models

Sebelum menerapkan solusi integrasi OneLake di organisasi Anda, pastikan untuk membaca Pertimbangan dan batasan nanti di artikel ini.

Prasyarat

Integrasi OneLake untuk model semantik hanya didukung pada Power BI Premium P dan Microsoft Fabric F SKU. Ini tidak didukung pada Power BI Pro, Premium Per Pengguna, atau Power BI Embedded A/EM SKU.

Sebelum mengaktifkan integrasi OneLake, Anda harus memiliki:

  • Satu atau beberapa model semantik impor di ruang kerja pada kapasitas Power BI Premium atau Fabric.
  • Format penyimpanan model semantik besar diaktifkan untuk model.

Izin

Izin kontributor model (baca, tulis, jelajahi) diperlukan untuk mengakses konten folder model dan membuat pintasan yang ditautkan ke folder di penjelajah Lakehouse.

Mengaktifkan integrasi OneLake

Di pengaturan model semantik Anda, perluas integrasi OneLake, klik slider ke Aktif, lalu pilih Terapkan.

Enable OneLake integration in model settings.

Portal admin

Admin global dan penyewa dapat mengontrol integrasi OneLake dengan menggunakan pengaturan berikut di portal admin Power BI:

Screenshot of tenant settings for admin portal.

  • Model semantik dapat mengekspor data ke OneLake - memungkinkan integrasi OneLake di tingkat organisasi. Jika dinonaktifkan, pengguna tidak dapat mengaktifkan integrasi OneLake untuk model semantik mereka, dan model semantik apa pun yang saat ini dikonfigurasi untuk integrasi OneLake berhenti mengekspor tabel impor ke OneLake. Integrasi OneLake diaktifkan secara default untuk seluruh organisasi.

  • Pengguna dapat menyimpan tabel model semantik di OneLake - memungkinkan semua atau pengguna yang dipilih di organisasi untuk mengonfigurasi integrasi OneLake untuk model semantik mereka. Jika dinonaktifkan untuk pengguna tertentu, pengguna tersebut tidak dapat lagi mengaktifkan integrasi OneLake tetapi model semantik apa pun yang telah mereka konfigurasi untuk integrasi OneLake terus mengekspor tabel impor ke OneLake. Pengguna tersebut dapat menonaktifkan integrasi OneLake untuk model semantik yang sudah dikonfigurasi untuk integrasi OneLake, tetapi tidak dapat mengaktifkan kembali integrasi OneLake. Pengaturan mengharuskan model Semantik dapat mengekspor data ke pengaturan penyewa OneLake untuk diaktifkan. Secara default, semua pengguna di organisasi dapat mengonfigurasi integrasi OneLake untuk model semantik mereka.

Merefresh model

Agar data impor model ditulis ke tabel Delta di OneLake, setidaknya satu refresh manual atau terjadwal untuk model harus dijalankan. Jalankan refresh manual atau tunggu refresh terjadwal.

Mengekspor tabel Delta OneLake

Tabel Delta dapat diekspor dalam banyak cara. Jika model semantik Anda mengaktifkan mode baca-tulis XMLA, Anda dapat mengekspor secara terprogram dengan menggunakan Model Objek Tabular (TOM) dan Bahasa Pembuatan Skrip Model Tabular (TMSL).

Misalnya, Anda dapat menggunakan SQL Server Management Studio (SSMS) untuk menjalankan perintah TMSL berikut:

{  
 "export": {  
   "layout": "delta",
   "type": "full",  
   "objects": [  
     {  
       "database": "<database name>"  
     }  
   ]  
 }  
}

Menjelajahi file ekspor

Setelah mengekspor, Anda dapat menggunakan penjelajah file OneLake, yang mengintegrasikan OneLake dengan Windows File Explorer Anda, untuk menemukan file ekspor tabel Delta..

  1. Di penjelajah file OneLake, klik kanan pada folder ruang kerja, lalu pilih Sinkronkan dari OneLake.

  2. Gunakan Windows File Explorer untuk menemukan file data Anda. Di folder ruang kerja, cari subfolder dengan nama yang cocok dengan model semantik Anda dan diakhapi dengan . SemanticModel. Folder model semantik mencakup setiap tabel mode impor dalam subfolder yang berisi file dan log parket tabel Delta.

    TMSL export command in SSMS.

Pintasan

Dengan membuat pintasan untuk tabel Lakehouse model semantik Anda, Anda dapat menyediakan akses cepat dan mudah ke mereka dari beban kerja lain di Fabric.

  1. Di Lakehouse Explorer, klik kanan Tabel, lalu pilih Pintasan baru.

  2. Di Pintasan baru, pilih Microsoft OneLake.

  3. Di Pilih jenis sumber data, pilih model semantik Anda, lalu pilih tabel yang ingin Anda sertakan.

    OneLake shortcuts in Explorer

Pertimbangan dan batasan

  • Selama pratinjau, jenis data mata uang dengan nilai yang lebih besar dari 18 titik desimal dapat memiliki beberapa kehilangan presisi saat diekspor ke file Delta.

  • Selama pratinjau, model semantik di ruang kerja yang diaktifkan BYOK tidak didukung.

  • Selama pratinjau, tabel pintasan yang dibangun di atas model yang diekspor di Lakehouse tidak dapat dikueri dengan menggunakan titik akhir SQL.

  • Selama pratinjau, kapasitas Multi-Geo belum didukung.

  • Selama pratinjau, operasi mengekspor model ke OneLake tidak ditagih, tetapi penggunaan komputasi dan penyimpanan model yang diekspor di OneLake ditagih.

  • Untuk pengguna dengan izin kontributor untuk tabel model yang diekspor tetapi hanya izin penampil untuk ruang kerja, folder model muncul di penjelajah Lakehouse, tetapi kesalahan dikembalikan saat dipilih.

  • Pengukuran, tabel DirectQuery, tabel hibrid, tabel grup perhitungan, dan tabel agregasi terkelola sistem tidak dapat diekspor ke tabel format Delta.

  • Hanya satu versi tabel delta yang diekspor dan disimpan di OneLake. Versi lama tabel delta dihapus setelah ekspor berhasil. Mesin eksekusi lain yang menggunakan versi data yang lebih lama tetapi sekarang dihapus dapat mengalami kegagalan sementara.