Fabric Uygulamaları (Önizleme) nedir?

Fabric Uygulamaları (önizleme), veri modellerini, oluşturulan API'leri, kimlik doğrulamayı ve barındırmayı tek bir geliştirme iş akışında birleştirerek Microsoft Fabric üzerinde veri temelli uygulamalar oluşturmanıza yardımcı olur. Veri modellerinizi TypeScript'te tanımlarsınız ve Fabric Uygulamalar bunları kullanarak uygulamanızın ihtiyaç duyduğu arka uç parçalarını oluşturur. Fabric Uygulamaları veri modelleri, istemci kodu ve uygulama mantığı için dil olarak TypeScript destekler.

Important

Bu özellik önizleme aşamasındadır.

Temel özellikler

Fabric Uygulamaları şu özellikleri sağlar:

• API'lere veri modelleri – TypeScript sınıflarını , @entity(), @text()ve diğer dekoratörlerle @uuid()süsleyin. Fabric Apps otomatik olarak veritabanı şemaları ve GraphQL uç noktaları oluşturur.
• Tür açısından güvenli istemciler – İstemci SDK'sı arka uca ulaşmadan önce sorguları ve mutasyonları doğrular ve geliştirme sırasında hataları yakalar.
• Yerleşik kimlik doğrulaması – Oturum yönetimi, belirteç işleme ve kimlik doğrulama akışları dahildir. Dağıtılan uygulamalar için Fabric SSO yapılandırın veya yerel geliştirme sırasında e-posta ve parola kullanın.
• Statik barındırma – Tek bir dağıtım komutuyla arka uç API'lerinizin yanı sıra ön uç uygulamanızı derleyin ve hizmet edin.
• Local development – Hızlı yineleme için docker ile tam yığını yerel olarak çalıştırın, ardından üretime hazır olduğunuzda Microsoft Fabric dağıtın. Proje iskeletleri oluşturun, GitHub Copilot ile geliştirin ve Rayfin CLI’yi kullanarak Fabric’e dağıtın.

Prerequisites

Kumaş kapasitesi

Çalışma alanınıza Fabric kapasitesi atanmış olmalıdır. Yeni bir çalışma alanı oluştururken, bununla ilişkilendirmek için bir Fabric kapasitesi seçin. Fabric Apps hizmetleri, kendilerine atanan kapasiteden kapasite birimleri tüketir.

Kiracı yöneticisi ayarları

Fabric kiracı yöneticisinin, kullanıcıların öğe oluşturabilmesi için önce Fabric Apps iş yükünü etkinleştirmesi gerekir.

1. Fabric yönetim portalında oturum açın.
2. Kiracı ayarları'na gidin.
3. Fabric Apps (önizleme) altında, ayarı Enabled olarak değiştirin.
4. Kuruluşun tamamı için mi yoksa belirli güvenlik grupları için mi etkinleştirileceğini seçin.
5. seçin, sonra daUygula'yı seçin.

Değişikliklerin yayılması birkaç dakika sürebilir.

Nasıl çalışır?

Bir Fabric uygulaması, uygulama barındırma, veritabanı, GraphQL API’leri ve kimlik doğrulaması gibi arka uç bileşenlerini tanımlayan bir hizmet paketiyle birlikte Microsoft Fabric’te yönetilen bir hizmet olarak çalışır. Fabric barındırmayı, ağı ve ölçeklendirmeyi yönetir. Kimlik doğrulaması yalnızca Fabric SSO (Microsoft Entra ID çoklu oturum açma) kullanır; dağıtımdan sonra başka hiçbir kimlik doğrulama sağlayıcısı kullanılamaz.

Uygulamanızı rayfin up ile dağıttığınızda, Fabric rayfin.yml yapılandırmanıza göre alt hizmetler oluşturur. Bu alt hizmetler, Fabric portalında Fabric uygulaması altında alt öğeler olarak görünür.

Alt servis	Ne sağlar?	Portal özellikleri
Fabric'de SQL veritabanı	TypeScript veri modeli dekoratörlerinden uygulanan şemanızla yönetilen bir SQL veritabanı.	Veritabanını görüntüleyin, sorgu düzenleyicisiyle sorgu çalıştırın, bağlantı dizesi kopyalayın. Veritabanı portalda salt okunurdur—şema değişiklikleri kodunuz aracılığıyla rayfin up yapılmalıdır.
Authentication	Microsoft Entra ID (SSO) kullanan Fabric aracılı kimlik doğrulaması. Kullanıcılar mevcut Fabric kimlikleri üzerinden oturum açar.	SQL veritabanında kimliği doğrulanmış kullanıcıları görüntüleyin.
Statik İçerik	Yerleşik ön uç varlıklarınız (HTML, CSS, JS), OneLake depolama kullanılarak genel bir URL'de hizmet verdi.	Barındırma URL'sini görüntüleyin. Varlıklar her dağıtımda güncelleştirilir.

Uygulama arka uç URL'si

Her Fabric uygulamasının tüm hizmetlere erişim sağlayan tek bir uç noktası vardır:

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

Uç nokta her hizmet için bir yol sunar:

Yol	Service
/api/graphql	Veri API'si (GraphQL) — tarafından RayfinClient okuma ve yazma işlemleri için kullanılır
/auth	Kimlik doğrulama hizmeti
/storage	Dosya depolama

Fabric portalında yönetim

Dağıtımdan sonra Fabric uygulamanızı doğrudan Fabric portalından yönetebilirsiniz.

Öğe özelliklerini görüntüleme

Aşağıdakileri görmek için portalda Fabric uygulamasını açın:

• Uygulama Arka Uç URL'si — Bu uç nokta, uygulama tarafından kullanılan tüm arka uç hizmetleri için kullanılır.
• Uygulama URL'si — Statik içeriğinizin barındırıldığı genel URL. uygulamaya erişmek için Fabric SSO gereklidir.

Alt öğeleri yönet

Alt hizmetlerini görmek için Fabric uygulamasını seçin:

• Fabric içindeki SQL veritabanı — Obje gezginini görüntülemek için Fabric SQL veritabanı öğesini açar. Verilerinizde okuma sorguları çalıştırabilirsiniz. Şema değişiklikleri her zaman klasörün altındaki rayfin/data kodda yapılmalıdır. Şema doğrudan SQL veritabanında değiştirilirse şema çakışmaları oluşabilir ve bu uygulamayı bozabilir.

Öğe izinleri

Çalışma alanı rolleri, öğe düzeyi izinlerinin yerine geçmez. Bir uygulamayı kuruluşunuzdaki biriyle paylaşmak için uygulamayı çalıştırmak ve arka uç API'lerini çağırmak için Çalıştırma ve etkileşim kurma (Okuma ve yürütme) izni gerekir.

İzin	Ne yapmasına izin veriyor
Çalıştırma ve etkileşim kurma (varsayılan)	Dağıtılan uygulamayı açın ve kullanın. Tüm çalışma alanı üyeleri varsayılan olarak bu düzeyi alır.
Düzenle (Yazma)	Fabric uygulamasını değiştirin; rayfin up ile kod dağıtın, şema değişikliklerini uygulayın, ayarları güncelleştirin ve alt hizmetleri yönetin.
Yeniden paylaş	Diğer kullanıcılara Fabric uygulamasına erişim izni verin. Çalışma alanında yönetici rolü gerektirir.

Çalışma alanı rolleri hakkında daha fazla bilgi edinin.

Rayfin CLI ile geliştirme

CLI yeni projeler oluşturur, yerel altyapıyı başlatır, şema değişikliklerini senkronize eder ve Fabric’e dağıtır. npm create @microsoft/rayfin@latest ile yükleyin.

Tuş komutları:

Komut	Purpose
npm create @microsoft/rayfin@latest	Şablondan yeni bir proje oluşturun.
npx rayfin up	Projenizi Fabric dağıtın.
npx rayfin up db apply	Veritabanı şeması değişikliklerini uygulama.

Tam bir komut başvurusu için bkz. CLI başvurusu.

Veri modeli dekoratörleri

TypeScript dekoratörlerini kullanarak veri modellerini tanımlayın:

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 bu dekoratörleri analiz eder ve şunları oluşturur:

• Veritabanı tablosu tanımları
• GraphQL API uç noktaları
• Satır düzeyi yetkilendirme kuralları
• Tür açısından güvenli istemci yöntemleri

Fabric Uygulamaları ne zaman kullanılır?

Fabric Uygulamaları şu uygulamalar için idealdir:

• Hızlı prototip oluşturma – Önceden yapılandırılmış altyapıyla fikirden canlı URL'ye dakikalar içinde geçin.
• İç araçlar ve panolar – Arka uç ortak yapısı yazmadan kimliği doğrulanmış yönetici arabirimleri oluşturun.
• Veri araştırma ve görselleştirme – GraphQL aracılığıyla Fabric verileri sorgulayın ve özel ön uçlarda görüntüleyin.
• Yapay zeka ve aracı uygulamaları – Kalıcı duruma ihtiyaç duyan yapay zeka aracıları için yapılandırılmış arka uç hizmetleri sağlar.

Fabric Uygulamaları aşağıdakiler için uygun olmayabilir:

• Karmaşık çok adımlı işlemler veya saklı yordamlar gerektiren uygulamalar.
• Fabric SSO ve e-posta/parola dışında özel kimlik doğrulama sağlayıcıları gerektiren uygulamalar.

Güvenlik sorumlulukları

Fabric şunları sağlar: Fabric Tek Oturum Açma (Microsoft Entra ID), @role dekoratörleri aracılığıyla satır düzeyinde güvenlik, HTTPS, PKCE ve çalışma alanı ve öğe düzeyinde izinler.

Bundan siz sorumlusunuz:

• Gizli dizileri, API anahtarlarını ve hassas verileri kodunuzun, ön uç varlıklarınızın ve deponuzun dışında tutma. Statik içerik genel URL'den sunulur.
• Kodunuz, kimliği doğrulanmış kullanıcıların neleri görebileceğini ve neler yapabileceğini denetlediği için, oturum açmayı uygulamanızın Fabric SSO aracılığıyla sundukları denetler.
• Yalnızca katkıda bulunanların uygulamayı dağıtması veya yönetmesi gereken izinleri verme.
• Uygulamanızın topladığı, işlediği ve depoladığı veriler için yasal ve uyumluluk sorumluluğu.

Sonraki Adımlar

• İlk Fabric Uygulamaları projenizi oluşturma
• Dekoratörlerle veri modelleri tanımlama
• Deploy to Microsoft Fabric
• Kimlik doğrulamasını yapılandırma