Σημείωμα
Η πρόσβαση σε αυτήν τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να εισέλθετε ή να αλλάξετε καταλόγους.
Η πρόσβαση σε αυτήν τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να αλλάξετε καταλόγους.
Οι εφαρμογές Fabric (έκδοση προεπισκόπησης) σάς βοηθούν να δημιουργήσετε εφαρμογές που βασίζονται σε δεδομένα στο Microsoft Fabric συνδυάζοντας μοντέλα δεδομένων, API που δημιουργούνται, έλεγχο ταυτότητας και φιλοξενία σε μία ροή εργασιών ανάπτυξης. Ορίζετε τα μοντέλα δεδομένων σας στο TypeScript και το Fabric Apps τα χρησιμοποιεί για να δημιουργήσει τα τμήματα παρασκηνίου που χρειάζεται η εφαρμογή σας. Το Fabric Apps υποστηρίζει TypeScript ως γλώσσα για μοντέλα δεδομένων, κώδικα πελάτη και λογική εφαρμογών.
Σημαντικό
Αυτή η δυνατότητα βρίσκεται προεπισκόπηση.
Δυνατότητες κλειδιά
Το Fabric Apps παρέχει αυτές τις δυνατότητες:
-
Μοντέλα δεδομένων σε API – Διακοσμήστε τις κλάσεις TypeScript με
@entity(),@text(),@uuid(), και άλλους διακοσμητές. Το Fabric Apps δημιουργεί αυτόματα σχήματα βάσης δεδομένων και τελικά σημεία GraphQL. - Υπολογιστές-πελάτες ασφαλείς τύπου – Το SDK προγράμματος-πελάτη επικυρώνει ερωτήματα και μεταλλάξεις πριν φτάσουν στο backend, εντοπίζοντας σφάλματα κατά την ανάπτυξη.
- Ενσωματωμένος έλεγχος ταυτότητας – Περιλαμβάνονται η διαχείριση περιόδου λειτουργίας, ο χειρισμός διακριτικών και οι ροές ελέγχου ταυτότητας. Διαμορφώστε το Fabric SSO για αναπτυγμένες εφαρμογές ή χρησιμοποιήστε email και κωδικό πρόσβασης κατά την τοπική ανάπτυξη.
- Στατική φιλοξενία – Δημιουργήστε και εξυπηρετήστε την εφαρμογή frontend μαζί με τα backend API σας με μία μόνο εντολή ανάπτυξης.
- Τοπική ανάπτυξη – Εκτελέστε την πλήρη στοίβα τοπικά με το Docker για γρήγορη επανάληψη και, στη συνέχεια, αναπτύξτε την στο Microsoft Fabric όταν είστε έτοιμοι για παραγωγή. Έργα σκαλωσιάς, ανάπτυξη με το GitHub Copilot και ανάπτυξη στο Fabric χρησιμοποιώντας το Rayfin CLI.
Υποστηριζόμενες περιφέρειες
Οι εφαρμογές Fabric δεν είναι ακόμη διαθέσιμες σε όλες τις περιοχές. Ανατρέξτε στις υποστηριζόμενες περιοχές για την εφαρμογή Fabric για να μάθετε περισσότερα.
Προϋποθέσεις
Χωρητικότητα fabric
Ο χώρος εργασίας σας πρέπει να έχει εκχωρηθεί χωρητικότητα Fabric. Κατά τη δημιουργία ενός νέου χώρου εργασίας, επιλέξτε ένα σύνολο εκχωρημένων πόρων Fabric για να το συσχετίσετε. Οι υπηρεσίες Fabric Apps καταναλώνουν μονάδες χωρητικότητας από τους εκχωρημένους εκχωρημένους πόρους.
Ρυθμίσεις διαχειριστή μισθωτή
Ένας διαχειριστής μισθωτή Fabric πρέπει να ενεργοποιήσει τον φόρτο εργασίας Fabric Apps για να μπορούν οι χρήστες να δημιουργήσουν στοιχεία.
- Συνδεθείτε στην πύλη διαχείρισης Fabric.
- Μεταβείτε στις Ρυθμίσεις μισθωτή.
- Στην περιοχή Fabric Εφαρμογές (έκδοση προεπισκόπησης), αλλάξτε τη ρύθμιση σε Enabled.
- Επιλέξτε εάν θα ενεργοποιηθεί για ολόκληρο τον οργανισμό ή για συγκεκριμένες ομάδες ασφαλείας.
- Επιλέξτε Εφαρμογή.
Οι αλλαγές μπορεί να χρειαστούν μερικά λεπτά για να διαδοθούν.
Πώς λειτουργεί
Μια εφαρμογή Fabric εκτελείται ως διαχειριζόμενη υπηρεσία στο Microsoft Fabric με οικογένεια υπηρεσιών που καθορίζουν το παρασκήνιο, όπως φιλοξενία εφαρμογών, βάση δεδομένων, API GraphQL και έλεγχος ταυτότητας. Το Fabric διαχειρίζεται τη φιλοξενία, τη δικτύωση και την κλιμάκωση. Ο έλεγχος ταυτότητας χρησιμοποιεί αποκλειστικά το Fabric SSO (καθολική σύνδεση Microsoft Entra ID) — δεν υπάρχουν άλλες υπηρεσίες παροχής ελέγχου ταυτότητας μετά την ανάπτυξη.
Όταν αναπτύσσετε την εφαρμογή σας με rayfin up, Fabric δημιουργεί θυγατρικές υπηρεσίες με βάση τη διαμόρφωση rayfin.yml. Αυτές οι θυγατρικές υπηρεσίες εμφανίζονται ως θυγατρικά στοιχεία στην εφαρμογή Fabric στην πύλη Fabric.
| Υπηρεσία παιδιών | Τι παρέχει | Δυνατότητες πύλης |
|---|---|---|
| Βάση δεδομένων SQL στο Fabric | Μια διαχειριζόμενη βάση δεδομένων SQL με το σχήμα σας εφαρμοσμένο από διακοσμητές μοντέλων δεδομένων TypeScript. | Προβολή βάσης δεδομένων, εκτέλεση ερωτημάτων με το πρόγραμμα επεξεργασίας ερωτημάτων, αντιγραφή συμβολοσειρά σύνδεσης. Η βάση δεδομένων είναι μόνο για ανάγνωση στην πύλη—οι αλλαγές σχήματος πρέπει να προέρχονται από τον κώδικά σας μέσω rayfin up. |
| Έλεγχος ταυτότητας | Έλεγχος ταυτότητας μέσω Fabric με χρήση Microsoft Entra ID (SSO). Οι χρήστες συνδέονται μέσω της υπάρχουσας ταυτότητας Fabric. | Προβολή χρηστών με έλεγχο ταυτότητας στη βάση δεδομένων SQL. |
| Στατικό περιεχόμενο | Τα ενσωματωμένα στοιχεία διεπαφής (HTML, CSS, JS) εξυπηρετούνται σε μια δημόσια διεύθυνση URL χρησιμοποιώντας τον χώρο αποθήκευσης OneLake. | Δείτε τη διεύθυνση URL φιλοξενίας. Οι πόροι ενημερώνονται σε κάθε ανάπτυξη. |
URL υποστήριξης εφαρμογής
Κάθε εφαρμογή Fabric έχει ένα μόνο τελικό σημείο που παρέχει πρόσβαση σε όλες τις υπηρεσίες:
https://<your-app>-app.rayfin.windows.net/
Το τελικό σημείο εμφανίζει μια διαδρομή για κάθε υπηρεσία:
| Διαδρομή | Υπηρεσία |
|---|---|
/api/graphql |
API δεδομένων (GraphQL) — χρησιμοποιείται από RayfinClient για λειτουργίες ανάγνωσης και εγγραφής |
/auth |
Υπηρεσία ελέγχου ταυτότητας |
/storage |
Αποθήκευση αρχείων |
Διαχείριση στην πύλη Fabric
Μετά την ανάπτυξη, μπορείτε να διαχειριστείτε την εφαρμογή Fabric απευθείας στην πύλη Fabric.
Προβολή ιδιοτήτων αντικειμένου
Ανοίξτε την εφαρμογή Fabric στην πύλη για να δείτε:
- Διεύθυνση URL παρασκηνίου εφαρμογής — Αυτό το τελικό σημείο χρησιμοποιείται για όλες τις υπηρεσίες παρασκηνίου που χρησιμοποιούνται από την εφαρμογή.
- Διεύθυνση URL εφαρμογής — Η δημόσια διεύθυνση URL όπου φιλοξενείται το στατικό περιεχόμενό σας. Απαιτείται Fabric SSO για πρόσβαση στην εφαρμογή.
Διαχείριση θυγατρικών στοιχείων
Επιλέξτε την εφαρμογή Fabric για να δείτε τις θυγατρικές υπηρεσίες της:
- Βάση δεδομένων SQL στο Fabric — Ανοίγει το στοιχείο βάσης δεδομένων SQL Fabric για να προβάλετε την εξερεύνηση αντικειμένων. Μπορείτε να εκτελέσετε ερωτήματα ανάγνωσης στα δεδομένα σας. Οι αλλαγές σχήματος πρέπει πάντα να γίνονται στον κώδικα κάτω από
rayfin/dataτο φάκελο. Οι διενέξεις σχήματος μπορεί να προκύψουν εάν το σχήμα αλλάξει απευθείας στη βάση δεδομένων SQL και μπορεί να διακόψει τη λειτουργία της εφαρμογής.
Δικαιώματα στοιχείου
Οι ρόλοι χώρου εργασίας δεν αντικαθιστούν τα δικαιώματα σε επίπεδο στοιχείου. Για να κάνετε κοινή χρήση μιας εφαρμογής με κάποιον στον οργανισμό σας, χρειάζεται δικαίωμα εκτέλεσης και αλληλεπίδρασης (Ανάγνωση και εκτέλεση) για να εκτελέσει την εφαρμογή και να καλέσει τα API παρασκηνίου.
| Δικαίωμα | Τι επιτρέπει |
|---|---|
| Εκτέλεση και αλληλεπίδραση (προεπιλογή) | Ανοίξτε και χρησιμοποιήστε την εφαρμογή που έχει αναπτυχθεί. Όλα τα μέλη του χώρου εργασίας λαμβάνουν αυτό το επίπεδο από προεπιλογή. |
| Επεξεργασία (Εγγραφή) | Τροποποιήστε την εφαρμογή Fabric—αναπτύξτε κώδικα με rayfin up, εφαρμόστε αλλαγές σχήματος, ενημερώστε τις ρυθμίσεις και διαχειριστείτε τις θυγατρικές υπηρεσίες. |
| Επανάληψη κοινής χρήσης | Εκχωρήστε σε άλλους χρήστες πρόσβαση στην εφαρμογή Fabric. Απαιτεί ρόλο διαχειριστή στον χώρο εργασίας. |
Μάθετε περισσότερα σχετικά με τους ρόλους χώρου εργασίας.
Ανάπτυξη με Rayfin CLI
Το CLI δημιουργεί νέα έργα, λανσάρει τοπικές υποδομές, συγχρονίζει αλλαγές σχήματος και αναπτύσσεται στο Fabric. Εγκαταστήστε το με npm create @microsoft/rayfin@latest.
Βασικές εντολές:
| Εντολή | Purpose |
|---|---|
npm create @microsoft/rayfin@latest |
Δημιουργήστε ένα νέο έργο από ένα πρότυπο. |
npx rayfin up |
Αναπτύξτε το έργο σας στο Fabric. |
npx rayfin up db apply |
Εφαρμογή αλλαγών σχήματος βάσης δεδομένων. |
Για μια πλήρη αναφορά εντολών, ανατρέξτε στην ενότητα Αναφορά CLI.
Διακοσμητές μοντέλων δεδομένων
Ορίστε μοντέλα δεδομένων χρησιμοποιώντας διακοσμητές 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 αναλύει αυτούς τους διακοσμητές και δημιουργεί:
- Ορισμοί πινάκων βάσης δεδομένων
- Τελικά σημεία API GraphQL
- Κανόνες εξουσιοδότησης σε επίπεδο γραμμών
- Μέθοδοι υπολογιστή-πελάτη που είναι ασφαλείς για τον τύπο
Πότε να χρησιμοποιείτε τις εφαρμογές Fabric
Το Fabric Apps είναι ιδανικό για:
- Γρήγορη δημιουργία πρωτοτύπων – Μεταβείτε από την ιδέα στη ζωντανή διεύθυνση URL μέσα σε λίγα λεπτά με προδιαμορφωμένη υποδομή.
- Εσωτερικά εργαλεία και πίνακες εργαλείων – Δημιουργήστε διεπαφές διαχειριστή με έλεγχο ταυτότητας χωρίς να γράφετε boilerplate backend.
- Εξερεύνηση και οπτικοποίηση δεδομένων – Αναζητήστε δεδομένα Fabric μέσω του GraphQL και εμφανίστε τα σε προσαρμοσμένες διεπαφές.
- Εφαρμογές τεχνητής νοημοσύνης και πρακτόρων – Παρέχετε δομημένες υπηρεσίες υποστήριξης για πράκτορες τεχνητής νοημοσύνης που χρειάζονται μόνιμη κατάσταση.
Οι εφαρμογές Fabric ενδέχεται να μην είναι κατάλληλες για:
- Εφαρμογές που απαιτούν πολύπλοκες συναλλαγές πολλαπλών βημάτων ή αποθηκευμένες διαδικασίες.
- Εφαρμογές που απαιτούν προσαρμοσμένες υπηρεσίες παροχής ελέγχου ταυτότητας πέρα από το Fabric SSO και το ηλεκτρονικό ταχυδρομείο/κωδικό πρόσβασης.
Αρμοδιότητες ασφάλειας
Το Fabric παρέχει: Fabric καθολική σύνδεση (Microsoft Entra ID), ασφάλεια σε επίπεδο γραμμών μέσω διακοσμητών @role, HTTPS, PKCE και δικαιώματα χώρου εργασίας και σε επίπεδο στοιχείου.
Είστε υπεύθυνοι για:
- Διατήρηση μυστικών, κλειδιών API και ευαίσθητων δεδομένων από τον κώδικα, τα στοιχεία διεπαφής και το αποθετήριο σας. Το στατικό περιεχόμενο προβάλλεται από μια δημόσια διεύθυνση URL.
- Αυτό που εκθέτει η εφαρμογή σας μέσω του Fabric SSO ελέγχει την είσοδο, καθώς ο κώδικάς σας ελέγχει τι βλέπουν και τι κάνουν οι χρήστες που έχουν υποβληθεί σε έλεγχο ταυτότητας.
- Εκχώρηση μόνο των δικαιωμάτων που χρειάζονται οι συμβάλλοντες για την ανάπτυξη ή τη διαχείριση της εφαρμογής.
- Νομική λογοδοσία και λογοδοσία συμμόρφωσης για τα δεδομένα που συλλέγει, επεξεργάζεται και αποθηκεύει η εφαρμογή σας.