Apa itu Fabric Apps (Pratinjau)?

Fabric Apps (pratinjau) membantu Anda membangun aplikasi berbasis data di Microsoft Fabric dengan menggabungkan model data, API yang dihasilkan, autentikasi, dan hosting dalam satu alur kerja pengembangan. Anda menentukan model data Anda di TypeScript, dan Fabric Apps menggunakannya untuk menghasilkan bagian ujung belakang yang dibutuhkan aplikasi Anda. Fabric Apps mendukung TypeScript sebagai bahasa untuk model data, kode klien, dan logika aplikasi.

Important

Fitur ini sedang dalam tahap pratinjau.

Fitur utama

Fabric Apps menyediakan kemampuan berikut:

Model data ke API – Hiasi kelas TypeScript dengan @entity(), , @text()@uuid(), dan dekorator lainnya. Fabric Apps menghasilkan skema database dan titik akhir GraphQL secara otomatis.
Klien dengan keamanan tipe – SDK klien memvalidasi kueri dan mutasi sebelum dikirim ke backend, mendeteksi kesalahan selama pengembangan.
Autentikasi bawaan – Manajemen sesi, penanganan token, dan alur autentikasi disertakan. Konfigurasikan SSO Fabric untuk aplikasi yang disebarkan atau gunakan email dan kata sandi selama pengembangan lokal.
Hosting statis - Bangun dan layani aplikasi frontend Anda bersama API backend Anda dengan satu perintah penyebaran.
Pengembangan lokal – Jalankan seluruh stack secara lokal dengan Docker untuk iterasi cepat, lalu deploy ke Microsoft Fabric saat siap untuk produksi. Buat kerangka proyek, kembangkan dengan GitHub Copilot, dan deploy ke Fabric menggunakan Rayfin CLI.

Prasyarat

Kapasitas kain

Ruang kerja Anda harus memiliki kapasitas Fabric yang ditetapkan. Saat membuat ruang kerja baru, pilih kapasitas Fabric untuk dikaitkan dengan ruang kerja tersebut. Layanan Fabric Apps mengonsumsi unit kapasitas dari kapasitas yang ditetapkan.

Pengaturan admin penyewa

Administrator penyewa Fabric harus mengaktifkan beban kerja Fabric Apps sebelum pengguna dapat membuat item.

Masuk ke portal admin Fabric.
Navigasikan ke pengaturan Penyewa.
Di bawah Fabric Apps (pratinjau), alihkan pengaturan ke Enabled.
Pilih apakah akan mengaktifkan untuk seluruh organisasi atau grup keamanan tertentu.
Pilih Terapkan.

Perubahan mungkin perlu waktu beberapa menit untuk disebarluaskan.

Cara kerjanya

Aplikasi Fabric berjalan sebagai layanan terkelola di Microsoft Fabric dengan rangkaian layanan yang menentukan backend seperti hosting aplikasi, database, API GraphQL, dan autentikasi. Fabric mengelola hosting, jaringan, dan penskalakan. Autentikasi hanya menggunakan Fabric SSO (single sign-on Microsoft Entra ID)—tidak ada penyedia autentikasi lain yang tersedia setelah penerapan.

Saat Anda menerapkan aplikasi dengan rayfin up, Fabric membuat layanan turunan berdasarkan konfigurasi rayfin.yml Anda. Layanan anak ini muncul sebagai item turunan di bawah aplikasi Fabric di portal Fabric.

Layanan anak	Apa yang disediakannya	Kemampuan portal
Database SQL di Fabric	Basis data SQL terkelola dengan skema Anda yang diterapkan berdasarkan dekorator model data TypeScript.	Tampilkan database, jalankan kueri dengan editor kueri, salin string koneksi. Database bersifat baca-saja di portal—perubahan skema harus berasal dari kode Anda melalui `rayfin up`.
Authentication	Autentikasi Fabric yang diperantarai menggunakan Microsoft Entra ID (SSO). Pengguna masuk melalui identitas Fabric yang ada.	Menampilkan pengguna yang diautentikasi di database SQL.
Konten Statis	Aset frontend bawaan Anda (HTML, CSS, JS) disajikan di URL publik menggunakan penyimpanan OneLake.	Lihat URL hosting. Aset diperbarui pada setiap penyebaran.

URL backend aplikasi

Setiap aplikasi Fabric memiliki satu titik akhir yang menyediakan akses ke semua layanan:

https://<your-app>-app.rayfin.windows.net/

Titik akhir mengekspos jalur untuk setiap layanan:

Jalur	Service
`/api/graphql`	DATA API (GraphQL) — digunakan oleh `RayfinClient` untuk operasi baca dan tulis
`/auth`	Layanan autentikasi
`/storage`	Penyimpanan file

Manajemen di portal Fabric

Setelah penyebaran, Anda dapat mengelola aplikasi Fabric langsung di portal Fabric.

Lihat properti item

Buka aplikasi Fabric di portal untuk melihat:

URL Backend Aplikasi — Titik akhir ini digunakan untuk semua layanan backend yang digunakan oleh aplikasi.
URL Aplikasi — URL publik tempat konten statis Anda dihosting. Fabric SSO diperlukan untuk mengakses aplikasi.

Mengelola item anak

Pilih aplikasi Fabric untuk melihat layanan anaknya:

Database SQL di Fabric — Membuka item Fabric SQL Database untuk melihat penjelajah objek. Anda dapat menjalankan kueri baca terhadap data Anda. Perubahan skema harus selalu dilakukan dalam kode di bawah rayfin/data folder. Konflik skema dapat terjadi jika skema diubah di SQL Database secara langsung dan dapat merusak aplikasi.

Hak akses item

Peran ruang kerja tidak menggantikan izin pada tingkat item. Untuk berbagi aplikasi dengan seseorang di organisasi Anda, mereka memerlukan izin Jalankan dan berinteraksi (Baca dan jalankan) untuk menjalankan aplikasi dan memanggil API backend.

Persetujuan	Kemungkinan yang diberikannya
Jalankan dan berinteraksi (default)	Buka dan gunakan aplikasi yang disebarkan. Semua anggota ruang kerja menerima tingkat ini secara default.
Edit (Tulis)	Ubah aplikasi Fabric—sebarkan kode dengan `rayfin up`, terapkan perubahan skema, perbarui pengaturan, dan kelola layanan turunan.
Bagikan ulang	Berikan pengguna lain akses ke aplikasi Fabric. Memerlukan peran admin di ruang kerja.

Pelajari selengkapnya tentang peran Ruang Kerja.

Pengembangan dengan Rayfin CLI

CLI membuat perancah proyek baru, meluncurkan infrastruktur lokal, menyinkronkan perubahan skema, dan menyebarkan ke Fabric. Instal itu dengan npm create @microsoft/rayfin@latest.

Perintah kunci:

Perintah	Kegunaan
`npm create @microsoft/rayfin@latest`	Buat proyek baru dari templat.
`npx rayfin up`	Sebarkan proyek Anda ke Fabric.
`npx rayfin up db apply`	Terapkan perubahan skema database.

Untuk referensi perintah lengkap, lihat referensi CLI.

Dekorator model data

Tentukan model data menggunakan dekorator TypeScript:

import {
  entity,
  role,
  text,
  boolean,
  date,
  uuid,
} from '@microsoft/rayfin-core';

@entity()
@role('authenticated', '*', {
  policy: (claims, item) => claims.sub.eq(item.user_id),
})
export class Todo {
  @uuid() id!: string;
  @text({ min: 1, max: 100 }) title!: string;
  @boolean() isCompleted!: boolean;
  @date() createdAt!: Date;
  @date({ optional: true }) dueDate?: Date;
  @text() user_id!: string;
}

Fabric Apps menganalisis dekorator ini dan menghasilkan:

Definisi tabel database
Titik akhir API GraphQL
Aturan otorisasi tingkat baris
Metode klien jenis aman

Kapan menggunakan aplikasi Fabric

Fabric Apps sangat ideal untuk:

Pembuatan prototipe cepat – Mulai dari ide ke URL langsung dalam menit dengan infrastruktur yang telah dikonfigurasi sebelumnya.
Alat dan dasbor internal – Membangun antarmuka admin terautentikasi tanpa menulis boilerplate backend.
Eksplorasi dan visualisasi data – Membuat kueri pada data Fabric melalui GraphQL dan menampilkannya di antarmuka depan kustom.
Aplikasi AI dan agen – Menyediakan layanan backend terstruktur untuk agen AI yang membutuhkan status persisten.

Fabric Apps mungkin tidak cocok untuk:

Aplikasi yang memerlukan transaksi multi-langkah yang kompleks atau prosedur tersimpan.
Aplikasi yang memerlukan penyedia autentikasi kustom di luar Fabric SSO dan email/kata sandi.

Tanggung jawab keamanan

Fabric menyediakan: Single Sign-On Fabric (Microsoft Entra ID), keamanan tingkat baris melalui @role dekorator, HTTPS, PKCE, serta izin tingkat ruang kerja dan tingkat item.

Anda bertanggung jawab untuk:

Menyimpan rahasia, kunci API, dan data sensitif dari kode, aset frontend, dan repositori Anda. Konten statis disajikan dari URL publik.
Apa yang diekspos aplikasi Anda melalui Fabric SSO mengendalikan proses masuk, karena kode Anda menentukan apa yang dapat dilihat dan dilakukan oleh pengguna yang diautentikasi.
Memberikan hanya izin yang diperlukan kontributor untuk menerapkan atau mengelola aplikasi.
Akuntabilitas hukum dan kepatuhan untuk data yang dikumpulkan, diproses, dan disimpan aplikasi Anda.

Langkah berikutnya

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-06-02