M365Con 2027 – konferensi online gratis · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Microsoft Fabric Apps: Apa Itu dan Cara Menggunakannya

By ·

Fabric Apps (pratinjau) memungkinkan developer membangun aplikasi berbasis data di Microsoft Fabric menggunakan TypeScript. Panduan ini membahas apa itu fitur ini, sakelar admin, cara membuat dan men-deploy aplikasi, izin, serta batasan saat ini.

Automatically translated with AI from the original post. Read the English original

Fabric Apps adalah fitur Microsoft Fabric yang saat ini berstatus pratinjau, untuk membangun aplikasi berbasis data. Developer menulis model data dalam TypeScript, dan Fabric menghasilkan skema database, API GraphQL, masuk, serta hosting. Fitur ini ditujukan untuk developer, bukan untuk pembuat laporan, dan terpisah dari aplikasi Power BI.

Poin Penting

  • Fabric Apps adalah fitur pratinjau yang dibangun di atas Rayfin SDK. Developer mendefinisikan model data dalam TypeScript, dan Fabric menghasilkan database, API GraphQL, autentikasi, serta hosting.
  • Admin penyewa harus terlebih dahulu mengaktifkan Fabric Apps (pratinjau) di bawah Tenant settings pada portal admin Fabric, untuk seluruh organisasi atau untuk grup keamanan tertentu.
  • Ruang kerja harus sudah ditetapkan kapasitas Fabric. Layanan Fabric Apps menggunakan unit kapasitas dari kapasitas tersebut.
  • Setelah di-deploy, masuk hanya menggunakan Fabric SSO melalui Microsoft Entra ID. Email dan kata sandi hanya berfungsi untuk pengembangan lokal.
  • Microsoft mencantumkan batasan seperti tidak adanya relasi banyak-ke-banyak, tidak adanya composite key, tidak adanya ALM, dan tidak adanya dukungan private link, jadi periksa batasan tersebut sebelum Anda memutuskan sebuah desain.

Apa yang dilakukan Fabric Apps

Microsoft Learn menjelaskan Fabric Apps dibangun di atas Rayfin SDK. Anda memberi dekorator pada kelas TypeScript, misalnya dengan @entity(), @text(), atau @uuid(). Dari model tersebut, Fabric menghasilkan:

  • tabel database, dengan database SQL di Fabric sebagai penyimpanan terkelola
  • endpoint GraphQL di /api/graphql pada URL backend aplikasi
  • aturan otorisasi tingkat baris melalui dekorator @role
  • metode klien yang aman tipe
  • hosting statis untuk frontend

Saat Anda men-deploy dengan rayfin up, Fabric membuat item turunan di bawah aplikasi: database SQL di Fabric, Authentication, dan Static Content. Setiap aplikasi memiliki satu endpoint backend dengan format https://<your-app>-app.rayfin.windows.net/, dengan jalur /api/graphql untuk data dan /auth untuk autentikasi.

Kemampuan terdokumentasi lainnya mencakup konektor bertipe ke lakehouse, warehouse, database SQL di Fabric, atau semantic model, serta penyimpanan file bertipe dengan kebijakan akses.

Kapan cocok digunakan

Microsoft menyebut kasus berikut sebagai penggunaan yang cocok: prototipe cepat, alat internal dan dashboard, eksplorasi data dengan konektor Fabric, serta aplikasi AI atau agen yang membutuhkan status persisten. Microsoft juga menyebut kasus yang kemungkinan kurang cocok: aplikasi yang membutuhkan transaksi multi-langkah yang kompleks atau stored procedure, dan aplikasi yang membutuhkan penyedia autentikasi kustom.

Langkah 1: Aktifkan pengaturan penyewa

Ini adalah tugas admin, dan harus dilakukan sebelum pengguna dapat membuat item tersebut.

  1. Masuk ke portal admin Fabric.
  2. Buka Tenant settings.
  3. Di bawah Fabric Apps (preview), atur sakelar ke Enabled.
  4. Pilih seluruh organisasi atau grup keamanan tertentu.
  5. Pilih Terapkan.

Perubahan mungkin memerlukan beberapa menit untuk diterapkan.

Langkah 2: Siapkan ruang kerja

Ruang kerja harus memiliki kapasitas Fabric yang sudah ditetapkan. Pilih kapasitas saat Anda membuat ruang kerja. Untuk membuat aplikasi, Anda memerlukan izin Contributor atau Admin di dalamnya. Untuk pengerjaan lokal, instal Node.js 20 atau yang lebih baru.

Langkah 3: Buat item aplikasi

  1. Di navigasi kiri, pilih Workspaces dan buka ruang kerja Anda.
  2. Pilih New item, cari App, lalu pilih.
  3. Masukkan nama, lalu pilih Create.

Portal kemudian menampilkan perintah untuk mengunduh proyek ke lokal. Bentuknya seperti ini:

npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>

Langkah 4: Kembangkan dan deploy

Sunting proyek, atau bekerja dengan GitHub Copilot, lalu uji terhadap backend Fabric dengan npm run dev. Deploy dengan npx rayfin up. Untuk deploy ke ruang kerja lain, tambahkan --workspace <workspacename>. Pastikan backend dengan npx rayfin up status.

Contoh komentar di FAQ menyebutkan bahwa deployment khusus konten statis dengan npx rayfin up staticapp deploy membutuhkan waktu 30 hingga 60 detik setelah deployment awal. Halaman yang saya baca tidak memberikan waktu untuk deployment pertama. Deployment khusus statis tidak dapat membuat aplikasi remote awal, jadi jalankan npx rayfin up satu kali terlebih dahulu. Untuk melakukan rollback, checkout commit git sebelumnya lalu jalankan npx rayfin up lagi.

Yang terlihat di portal Fabric

Setelah rayfin up, item aplikasi menampilkan item turunan yang dibuat Fabric dari konfigurasi rayfin.yml Anda:

  • SQL database in Fabric: database terkelola dengan skema dari decorator Anda. Database ini bersifat hanya-baca di portal, jadi ubah skema melalui kode.
  • Authentication: proses masuk yang difasilitasi Fabric melalui Microsoft Entra ID. Anda dapat melihat pengguna yang terautentikasi di database SQL.
  • Static Content: aset frontend yang sudah dibangun, disajikan dari URL hosting dan diperbarui pada setiap deploy. Ikhtisar menyebutkan bahwa hosting statis dapat memerlukan akses item Fabric atau mengizinkan akses anonim.

Autentikasi dan izin

Learn mencantumkan SSO Fabric untuk aplikasi yang sudah di-deploy dan email serta kata sandi untuk pengembangan lokal. Masuk dengan email dan kata sandi tidak berfungsi setelah deployment, dan deployment memerlukan autentikasi Fabric yang diaktifkan.

Izin item terpisah dari peran ruang kerja:

| Izin | Memungkinkan | |---|---| | Run and interact | Membuka dan menggunakan aplikasi serta memanggil API backend-nya. Semua anggota ruang kerja mendapatkannya secara default. | | Edit (Write) | Deploy, mengubah skema, memperbarui pengaturan, mengelola layanan turunan | | Reshare | Memberikan akses kepada orang lain. Memerlukan peran admin di ruang kerja. |

Administrator Fabric dapat memblokir sementara pengguna lain agar tidak memuat aplikasi, sementara pemilik tetap dapat membukanya.

Keamanan sebagian tetap menjadi tanggung jawab Anda. Microsoft menyarankan agar rahasia tidak disimpan di dalam kode dan aset frontend, dan kode Anda yang menentukan apa yang dapat dilihat dan dilakukan pengguna yang sudah masuk.

Batasan yang perlu diperiksa lebih dulu

FAQ mencantumkan batasan saat ini berikut:

  • tidak ada relasi many-to-many dan tidak ada composite primary key (setiap entitas memerlukan satu field UUID tunggal bernama id)
  • tidak ada penyedia autentikasi kustom
  • tidak ada manajemen multi-lingkungan bawaan
  • tidak ada proteksi akses keluar ruang kerja (workspace outbound access protection)
  • tidak ada private link tingkat penyewa atau tingkat ruang kerja
  • tidak ada application lifecycle management (ALM)
  • count() tidak tersedia pada fluent GraphQL client

Model data ditulis dalam TypeScript dengan decorator.

Masalah umum

Microsoft menyebut build production yang belum dibuat sebagai penyebab paling umum error build, jadi jalankan npm run build terlebih dahulu. Untuk error terkait kapasitas atau izin, pastikan ruang kerja memiliki kapasitas dan Anda dapat membuat atau mengubah item di dalamnya. Untuk error skema, tinjau perubahan sejak deployment berhasil terakhir. Halaman pemecahan masalah menyatakan bahwa kode aplikasi adalah sumber kebenaran. Jangan mengubah skema remote melalui portal Fabric atau alat SQL, karena menghapus atau mengubah kolom yang ada dapat merusak aplikasi dan deployment-nya. Buat perubahan skema di dalam kode dan terapkan dengan npx rayfin up db apply.

Terkait

Sumber

FAQ

Apakah Fabric Apps sudah tersedia secara umum?

Belum. Microsoft Learn menandai Fabric Apps sebagai fitur pratinjau dan menyebutkan bahwa fitur ini belum tersedia di semua wilayah. Halaman yang dibaca untuk artikel ini tidak mencantumkan tanggal ketersediaan umum.

Siapa yang dapat membuat aplikasi Fabric?

Menurut Microsoft Learn, Anda memerlukan izin Contributor atau Admin di ruang kerja Fabric yang memiliki kapasitas Fabric, dan admin penyewa harus sudah mengaktifkan pengaturan penyewa Fabric Apps (pratinjau). Node.js 20 atau yang lebih baru diperlukan untuk pengembangan lokal.

Metode masuk apa yang didukung oleh Fabric Apps yang sudah di-deploy?

Microsoft Learn menyatakan bahwa aplikasi yang sudah di-deploy hanya menggunakan Fabric SSO, yaitu single sign-on Microsoft Entra. Masuk dengan email dan kata sandi hanya tersedia untuk pengembangan lokal, dan Anda tidak dapat men-deploy tanpa autentikasi yang diaktifkan.

Apakah aplikasi Fabric dapat menggunakan database yang sudah ada?

Tidak. FAQ Microsoft Learn menyatakan bahwa Fabric Apps mengelola skema dari model TypeScript Anda dan tidak dapat diarahkan ke database dengan skema yang sudah ditentukan. Untuk mengakses lakehouse, warehouse, atau database SQL yang sudah ada di Fabric, Anda menambahkan konektor.

Apakah halaman Microsoft menjelaskan harga Fabric Apps?

Tidak. Halaman yang dibaca tidak memuat informasi harga. Ikhtisar hanya menyebutkan bahwa ruang kerja memerlukan kapasitas Fabric dan layanan Fabric Apps menggunakan unit kapasitas dari kapasitas tersebut, sedangkan FAQ menyatakan bahwa performa bergantung pada kapasitas Fabric Anda.

Entities in this article

Topik artikel ini:

Microsoft Fabric Apps – Alat analitik dan BI dari Microsoft Microsoft Fabric – Alat analitik dan BI dari Microsoft Fabric capacity – Konsep Fabric tenant settings – Konsep

Related articles

Artikel lain tentang Microsoft Fabric:

RSS