Βασικές έννοιες και χαρακτηριστικά

Το κιτ εργαλείων επεκτασιμότητας εισάγει μια σειρά δυνατοτήτων που έχουν σχεδιαστεί για να φέρουν την εφαρμογή δεδομένων σας σε δομή όσο το δυνατόν πιο απλή. Αυτές οι δυνατότητες επιτρέπουν στους προγραμματιστές να δημιουργούν πλούσιες, ολοκληρωμένες εμπειρίες με ελάχιστη προσπάθεια. Με το Κιτ εργαλείων επεκτασιμότητας, μπορείτε εύκολα να αποκτήσετε πρόσβαση στα API του Fabric απευθείας από το προσκήνιο, να διατηρήσετε τον ορισμό του στοιχείου (κατάσταση) στο Fabric, να χρησιμοποιήσετε μια τυποποιημένη ροή δημιουργίας στοιχείων και να επωφεληθείτε από τη βελτιωμένη ασφάλεια και διαλειτουργικότητα μέσω της χαλάρωσης του iFrame και της δημόσιας υποστήριξης API. Επιπλέον, απλοποιεί τον κύκλο ζωής της ανάπτυξής σας με ενσωματωμένη υποστήριξη CI/CD, διευκολύνοντας την αυτοματοποίηση της ανάπτυξης και της δοκιμής. Οι ακόλουθες ενότητες παρέχουν μια επισκόπηση των κύριων λειτουργιών και οδηγίες σχετικά με τον τρόπο ενσωμάτωσής τους στους φόρτους εργασίας σας.

Τυπική εμπειρία δημιουργίας αντικειμένων

Η δημιουργία στοιχείων τυποποιείται μέσω ενός αποκλειστικού στοιχείου ελέγχου Fabric που καθοδηγεί τους χρήστες στη διαδικασία. Αυτό το στοιχείο ελέγχου επιτρέπει στους χρήστες να επιλέξουν τον χώρο εργασίας όπου δημιουργείται το στοιχείο, να αντιστοιχίσουν ετικέτες ευαισθησίας και να διαμορφώσουν άλλες σχετικές ρυθμίσεις. Χρησιμοποιώντας αυτήν την τυποποιημένη εμπειρία, δεν χρειάζεται πλέον να χειρίζεστε μόνοι σας την πολυπλοκότητα της δημιουργίας αντικειμένων ή να ανησυχείτε για μελλοντικές αλλαγές στη διαδικασία. Επιπλέον, αυτή η προσέγγιση επιτρέπει τη δημιουργία στοιχείων να εμφανίζεται απευθείας στη σελίδα φόρτου εργασίας σας, παρέχοντας μια απρόσκοπτη και ολοκληρωμένη εμπειρία χρήστη.

Χρησιμοποιήστε τον οδηγό Πώς να δημιουργήσετε ένα στοιχείο για να κατανοήσετε πώς μπορεί να εφαρμοστεί.

Υποστήριξη API Frontend

Με το Extensibility Toolkit, μπορείτε να αποκτήσετε ένα διακριτικό Microsoft Entra On-Behalf-Of (OBO) απευθείας στην εφαρμογή frontend σας, επιτρέποντας την ασφαλή πρόσβαση σε οποιοδήποτε API που προστατεύεται από την Entra. Αυτή η δυνατότητα σάς επιτρέπει να ενοποιηθείτε σε βάθος με τις υπηρεσίες Microsoft Fabric—για παράδειγμα, μπορείτε να διαβάσετε και να αποθηκεύσετε δεδομένα στο OneLake, να δημιουργήσετε και να αλληλεπιδράσετε με άλλα στοιχεία Fabric ή να χρησιμοποιήσετε το Spark ως μηχανισμό επεξεργασίας μέσω των Livey API. Για περισσότερες πληροφορίες, ανατρέξτε στην τεκμηρίωση του Microsoft Entra, στην τεκμηρίωση του OneLake, στα API REST του Fabric και στο Spark in Fabric.

Χρησιμοποιήστε τον οδηγό Τρόπος απόκτησης του Microsoft Entra Token για να κατανοήσετε πώς μπορεί να εφαρμοστεί. Χρησιμοποιήστε επίσης τον οδηγό Τρόπος πρόσβασης στα API του Fabric για να κατανοήσετε τον τρόπο με τον οποίο μπορείτε να αλληλεπιδράσετε με το Fabric.

Αποθήκευση ορισμού στοιχείου (κατάσταση) στο Fabric

Αυτή η δυνατότητα σάς δίνει τη δυνατότητα να αποθηκεύετε τα μεταδεδομένα του στοιχείου σας—όπως τη διαμόρφωση του στοιχείου και άλλες σχετικές πληροφορίες—απευθείας στο OneLake μέσα σε έναν κρυφό φάκελο που δεν είναι ορατός στους τελικούς χρήστες. Τα δεδομένα αποθηκεύονται χρησιμοποιώντας την ίδια μορφή που εφαρμόζεται από δημόσια API και διαδικασίες CI/CD, διασφαλίζοντας συνέπεια και διαλειτουργικότητα σε διαφορετικά σημεία ολοκλήρωσης. Λεπτομέρειες σχετικά με τη μορφή και τη χρήση της με δημόσια API και CI/CD συζητούνται στις ακόλουθες ενότητες.

Χρησιμοποιήστε τον ορισμό Τρόπος αποθήκευσης στοιχείου για να κατανοήσετε πώς μπορεί να εφαρμοστεί.

Τι να αποθηκεύσετε στον ορισμό

Σκεφτείτε την κατάσταση ως κάτι που περιέχει όλες τις πληροφορίες που απαιτούνται για την επαναφορά ενός στοιχείου εάν διαγραφεί ή αντιγραφεί αλλού. Αυτό δεν περιλαμβάνει τα ίδια τα δεδομένα, τα οποία είναι αποθηκευμένα στο OneLake (βλ. Αποθήκευση δεδομένων στοιχείων στο OneLake).

Ακολουθούν μερικά πρακτικά παραδείγματα:

• Στοιχείο σημειωματάριου: Η κατάσταση αποθηκεύει τον κώδικα του σημειωματάριου, τη σειρά κελιών και τα μεταδεδομένα, όπως ποια μηχανή εκτέλεσης (π.χ. Spark, SQL) πρέπει να χρησιμοποιηθεί. Τα πραγματικά δεδομένα που επεξεργάζεται το σημειωματάριο δεν αποθηκεύονται στην κατάσταση.
• Στοιχείο προγράμματος επεξεργασίας αρχείων: Η κατάσταση δεν αποθηκεύει τα ίδια τα περιεχόμενα του αρχείου, αλλά αποθηκεύει τη διαμόρφωση του προγράμματος επεξεργασίας, όπως συνδυασμό χρωμάτων, ρυθμίσεις αυτόματης συμπλήρωσης, μέγεθος γραμματοσειράς και άλλες προτιμήσεις χρήστη.
• Στοιχείο προγράμματος εγκατάστασης ή Orchestrator: Εάν το στοιχείο σας εγκαθιστά ή παρέχει άλλα στοιχεία (όπως βάσεις δεδομένων ή υπολογιστικούς πόρους), η κατάσταση θα πρέπει να περιέχει αναφορές (αναγνωριστικά, URI) στα στοιχεία που δημιούργησε. Αυτό επιτρέπει στον φόρτο εργασίας σας να ελέγξει την κατάστασή του ή να τον διαχειριστεί αργότερα.

Εστιάζοντας στη διαμόρφωση, τα μεταδεδομένα και τις αναφορές, διασφαλίζετε ότι η κατάσταση του αντικειμένου σας είναι φορητή, ελαφριά και εύκολη στην επαναφορά ή τη μετεγκατάσταση.

Αποθήκευση δεδομένων στοιχείων στο OneLake

Κάθε στοιχείο συνοδεύεται από τον δικό του φάκελο στοιχείων Onelake όπου οι προγραμματιστές μπορούν να αποθηκεύουν δομημένα αλλά και μη δομημένα δεδομένα. Παρόμοια με ένα Lakehouse , το στοιχείο έχει έναν φάκελο Table όπου τα δεδομένα μπορούν να αποθηκευτούν σε μορφή Delta ή Iceberg και έναν φάκελο Files όπου μπορούν να αποθηκευτούν μη δομημένα δεδομένα.

Χρησιμοποιήστε τον τρόπο αποθήκευσης δεδομένων στο στοιχείο για να κατανοήσετε πώς μπορεί να εφαρμοστεί.

Δεδομένα συντόμευσης

Όπως κάθε στοιχείο έχει, τον δικό του φάκελο Onelake μπορούν επίσης να λειτουργήσουν με Συντομεύσεις. Μέσω του φόρτου εργασίας του API Δημόσιας Συντόμευσης , οι προγραμματιστές μπορούν να δημιουργήσουν διαφορετικούς τύπους συντομεύσεων από ή προς το στοιχείο τους για να συμμετάσχουν στην υπόσχεση ενός αντιγράφου από το OneLake.

Χρησιμοποιήστε τον τρόπο δημιουργίας συντομεύσεων για να κατανοήσετε πώς μπορεί να εφαρμοστεί.

Υποστήριξη API στοιχείων CRUD

Οι χρήστες μπορούν να δημιουργούν, να ενημερώνουν και να διαγράφουν στοιχεία με περιεχόμενο χρησιμοποιώντας τα τυπικά API Fabric Item Rest. Αυτή η αυτόματη ενεργοποίηση καθιστά πολύ πιο εύκολη την ενσωμάτωση με στοιχεία φόρτου εργασίας με τον ίδιο τρόπο όπως τα βασικά στοιχεία Fabric, βελτιστοποιώντας τη διαλειτουργικότητα και μειώνοντας την προσπάθεια που απαιτείται για τη δημιουργία ισχυρών ενοποιήσεων.

Υποστήριξη CI/CD

Σημείωση

Η υποστήριξη CI/CD για την Εργαλειοθήκη Επεκτασιμότητας βρίσκεται επί του παρόντος υπό ανάπτυξη. Οι δυνατότητες που περιγράφονται παρακάτω είναι προγραμματισμένες δυνατότητες και ενδέχεται να αλλάξουν πριν από την κυκλοφορία.

Η υποστήριξη CI/CD για όλα τα είδη είναι ένα από τα υψηλότερα αιτήματα από τους πελάτες. Με αυτήν τη δυνατότητα όλα τα στοιχεία, συμμετέχουν στο CICD εκτός συσκευασίας, χωρίς να χρειάζεται να εφαρμόσετε κάποια συγκεκριμένη λογική ή λειτουργίες. Αυτό σημαίνει ότι μπορείτε να αυτοματοποιήσετε την ανάπτυξη, τη δοκιμή και τις ενημερώσεις για τους φόρτους εργασίας σας χρησιμοποιώντας τυπικές διοχετεύσεις και εργαλεία Azure. Η μορφή στοιχείου και τα API έχουν σχεδιαστεί για να είναι πλήρως συμβατά με τις διαδικασίες CI/CD, διασφαλίζοντας μια συνεπή και αξιόπιστη εμπειρία σε όλα τα περιβάλλοντα. Για περισσότερες πληροφορίες σχετικά με την ενοποίηση με CI/CD, ανατρέξτε στην τεκμηρίωση του Fabric CICD.

API κοινοποίησης στοιχείου CRUD

Σημείωση

Η υποστήριξη API ειδοποιήσεων CRUD για το Extensibility Toolkit βρίσκεται επί του παρόντος υπό ανάπτυξη. Οι δυνατότητες που περιγράφονται παρακάτω είναι προγραμματισμένες δυνατότητες και ενδέχεται να αλλάξουν πριν από την κυκλοφορία.

Υπάρχουν περιπτώσεις όπου ο φόρτος εργασίας σας πρέπει να συμμετέχει στα συμβάντα Item CRUD. Καθώς τα στοιχεία δημιουργούνται στην πλατφόρμα απευθείας μέσω του UX, τα δημόσια API ή οι κάτοχοι φόρτου εργασίας CI/CD δεν έχουν τον έλεγχο όταν δημιουργείται ένα νέο στοιχείο σε αυτά τα σημεία εισόδου. Από προεπιλογή, τα στοιχεία αποθηκεύουν την κατάστασή τους στο Fabric και δεν χρειάζεται να ενημερώνονται για την αλλαγή του στοιχείου τους. Ωστόσο, υπάρχουν ορισμένες περιπτώσεις όπου ο φόρτος εργασίας πρέπει να συμμετέχει στη ροή CRUD. Αυτό ισχύει κυρίως εάν η υποδομή για στοιχεία πρέπει να παρασχεθεί ή να ρυθμιστεί (για παράδειγμα, βάσεις δεδομένων). Για αυτά τα σενάρια, επιτρέπουμε στους συνεργάτες να υλοποιήσουν ένα API ειδοποίησης Crud το οποίο καλεί το Fabric σε κάθε συμβάν. Σε αυτό το σενάριο, ο προγραμματιστής φόρτου εργασίας πρέπει να βεβαιωθεί ότι το API του είναι προσβάσιμο, διαφορετικά οι λειτουργίες Fabric αποτυγχάνουν.

Προγραμματιστής υφασμάτων

Σημείωση

Η υποστήριξη προγραμματιστή δομής για το κιτ εργαλείων επεκτασιμότητας βρίσκεται επί του παρόντος υπό ανάπτυξη. Οι δυνατότητες που περιγράφονται παρακάτω είναι προγραμματισμένες δυνατότητες και ενδέχεται να αλλάξουν πριν από την κυκλοφορία.

Το Fabric υποστηρίζει τον προγραμματισμό εργασιών για φόρτους εργασίας. Αυτή η δυνατότητα επιτρέπει στους προγραμματιστές να δημιουργούν φόρτους εργασίας που ειδοποιούνται ακόμα κι αν ο χρήστης δεν βρίσκεται μπροστά στο UX και να ενεργούν με βάση την εργασία που πρέπει να εκτελεστεί (για παράδειγμα, αντιγραφή δεδομένων στο Onelake). Οι συνεργάτες πρέπει να υλοποιήσουν ένα API και να διαμορφώσουν τον φόρτο εργασίας τους για να συμμετέχουν σε αυτήν τη λειτουργία.

Χαλάρωση iFrame

Οι προγραμματιστές μπορούν να ζητήσουν περισσότερα χαρακτηριστικά iFrame για να ενεργοποιήσουν προηγμένα σενάρια, όπως λήψεις αρχείων ή άνοιγμα εξωτερικών ιστότοπων. Αυτή η δυνατότητα επιτρέπει στον φόρτο εργασίας σας να ζητά από τους χρήστες ρητή συγκατάθεση πριν από την εκτέλεση ενεργειών που απαιτούν ευρύτερες δυνατότητες του προγράμματος περιήγησης, όπως η εκκίνηση λήψεων ή η σύνδεση χρηστών σε εξωτερικά API χρησιμοποιώντας τα τρέχοντα διαπιστευτήριά τους Fabric. Καθορίζοντας αυτές τις απαιτήσεις στη διαμόρφωση του φόρτου εργασίας σας, διασφαλίζετε ότι οι χρήστες ενημερώνονται και μπορούν να εκχωρήσουν τα απαραίτητα δικαιώματα, επιτρέποντας την απρόσκοπτη ενοποίηση με εξωτερικά συστήματα, διατηρώντας παράλληλα την ασφάλεια και την εμπιστοσύνη των χρηστών.

Χρησιμοποιήστε το Πώς να χαλαρώσετε το iFrame για να κατανοήσετε πώς μπορεί να εφαρμοστεί.

Σημείωση

Η ενεργοποίηση αυτής της δυνατότητας απαιτεί από τους χρήστες να εκχωρήσουν περισσότερη συγκατάθεση στο Microsoft Entra για το εύρος χαλάρωσης, πέρα από το τυπικό εύρος Fabric που απαιτείται για τη βασική λειτουργικότητα φόρτου εργασίας.

Περιορισμοί δυνατοτήτων

Ιδιωτικός σύνδεσμος

Όλοι οι φόρτοι εργασίας αποκλείονται για κατανάλωση και ανάπτυξη, εάν η ιδιωτική σύνδεση είναι ενεργοποιημένη σε επίπεδο μισθωτή ή χώρου εργασίας.