Σημείωμα
Η πρόσβαση σε αυτήν τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να εισέλθετε ή να αλλάξετε καταλόγους.
Η πρόσβαση σε αυτήν τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να αλλάξετε καταλόγους.
Όταν αναπτύσσετε στοιχεία Fabric σε χώρους εργασίας (για παράδειγμα, από την ανάπτυξη έως τη δοκιμή έως την παραγωγή), οι εξαρτήσεις μεταξύ των στοιχείων μπορεί να διακοπούν. Ορισμένα στοιχεία αποθηκεύουν αναφορές στις εξαρτήσεις τους ως αναγνωριστικά αντικειμένων (GUID για συγκεκριμένο χώρο εργασίας), ενώ άλλα χρησιμοποιούν λογικά αναγνωριστικά (φορητά αναγνωριστικά μεταξύ χώρων εργασίας που είναι αποθηκευμένα στο .platform αρχείο).
Τα στοιχεία που χρησιμοποιούν λογικά αναγνωριστικά στους ορισμούς τους συνδέονται σωστά με το αντίστοιχο στοιχείο στον χώρο εργασίας προορισμού. Τα στοιχεία που χρησιμοποιούν αναγνωριστικά αντικειμένων παραμένουν στραμμένα στον χώρο εργασίας προέλευσης, γεγονός που διακόπτει την ανάπτυξη.
Αυτό το άρθρο αντιστοιχίζει ποιοι τύποι στοιχείων Fabric υποστηρίζουν τη δέσμευση εξαρτήσεων μέσω λογικών αναγνωριστικών όταν χρησιμοποιούμε την ενοποίηση Git και ποιοι όχι. Για να μάθετε περισσότερα σχετικά με τα λογικά αναγνωριστικά και τον τρόπο αναπαράστασης των στοιχείων στο στοιχείο ελέγχου προέλευσης, ανατρέξτε στο θέμα Λογικό αναγνωριστικό στο Fabric.
Βασικές έννοιες
-
Λογικό αναγνωριστικό: Ένα αναγνωριστικό μεταξύ χώρων εργασίας που δημιουργείται αυτόματα στο
.platformαρχείο. Τα στοιχεία με το ίδιο λογικό αναγνωριστικό αντιμετωπίζονται ως το ίδιο στοιχείο σε όλους τους χώρους εργασίας. - Αναγνωριστικό αντικειμένου: Ένα GUID για συγκεκριμένο χώρο εργασίας που προσδιορίζει μια συγκεκριμένη παρουσία. Τα αναγνωριστικά αντικειμένων δεν επιβιώνουν από την ανάπτυξη μεταξύ χώρων εργασίας χωρίς μη αυτόματη παρέμβαση ή παραμετροποίηση.
- Δέσμευση εξαρτήσεων (Git): Όταν συγχρονίζουμε μια διακλάδωση Git σε έναν νέο χώρο εργασίας, το Fabric επιλύει αναφορές εξαρτήσεων χρησιμοποιώντας λογικά αναγνωριστικά, δείχνοντας αυτόματα το σωστό στοιχείο στον χώρο εργασίας προορισμού.
- Κατά όνομα ή κατά URI: Ορισμένα στοιχεία αναφέρονται σε εξαρτήσεις με εμφανιζόμενο όνομα ή URI αντί για αναγνωριστικό. Αυτές οι αναφορές ενδέχεται να επιλυθούν ή να μην επιλυθούν σωστά, ανάλογα με τις συμβάσεις ονομασίας σε όλους τους χώρους εργασίας.
Πώς λειτουργεί η δέσμευση εξαρτήσεων
Μέσα σε έναν χώρο εργασίας, τα στοιχεία αναφέρονται στις εξαρτήσεις τους χρησιμοποιώντας αναγνωριστικά αντικειμένων. Όταν το Fabric εξάγει ένα στοιχείο στο Git, αντικαθιστά ορισμένα από αυτά τα αναγνωριστικά αντικειμένων με λογικά αναγνωριστικά από το .platform αρχείο. Όταν συγχρονίζουμε τον κλάδο Git σε έναν διαφορετικό χώρο εργασίας, το Fabric επιλύει αυτά τα λογικά αναγνωριστικά πίσω στα σωστά αναγνωριστικά αντικειμένων στον χώρο εργασίας προορισμού. Αυτό είναι που κάνει τη δεσμευτική εξάρτηση να λειτουργεί.
Ωστόσο, δεν αντικαθίστανται όλες οι αναφορές εξαρτήσεων με λογικά αναγνωριστικά κατά την εξαγωγή. Τα στοιχεία που διατηρούν αναγνωριστικά αντικειμένων στην αναπαράστασή τους στο Git εξακολουθούν να παραπέμπουν στον αρχικό χώρο εργασίας μετά τον συγχρονισμό και πρέπει να τα ενημερώσουμε χειροκίνητα ή μέσω παραμετροποίησης.
Σημαντικό
Η σύνδεση εξαρτήσεων ισχύει μόνο για αναφορές μεταξύ στοιχείων Fabric στον ίδιο χώρο εργασίας. Εάν ένα στοιχείο αναφέρεται σε ένα στοιχείο Fabric σε διαφορετικό χώρο εργασίας, αυτή η αναφορά χρησιμοποιεί ένα αναγνωριστικό αντικειμένου και δεν συνδέεται αυτόματα. Οι αναφορές σε Συνδέσεις (συνδέσεις προέλευσης δεδομένων, πύλες) επίσης δεν συνδέονται αυτόματα. Χρησιμοποιήστε βιβλιοθήκες μεταβλητών με σύνολα τιμών για συγκεκριμένο περιβάλλον για τη διαχείριση αναφορών σύνδεσης σε περιβάλλοντα.
Συμβατότητα δέσμευσης εξάρτησης
Οι παρακάτω πίνακες δείχνουν εάν οι εξαρτήσεις κάθε τύπου στοιχείου Fabric συνδέονται σωστά κατά την ανάπτυξη σε όλους τους χώρους εργασίας. Προς το παρόν, αυτό το άρθρο καλύπτει τη συμπεριφορά ενοποίησης του Git . Επειδή η σύνδεση καθορίζεται από τον τρόπο με τον οποίο κάθε στοιχείο αποθηκεύει τις αναφορές εξάρτησής του στον ορισμό του, η ίδια συμπεριφορά ισχύει και για άλλους μηχανισμούς ανάπτυξης που επαναχρησιμοποιούν αυτούς τους ορισμούς, όπως οι διοχετεύσεις ανάπτυξης και τα API εισαγωγής (μαζικά).
Αυτοί οι πίνακες υποθέτουν ότι η εξάρτηση είναι ένα άλλο στοιχείο στον ίδιο χώρο εργασίας με το στοιχείο προέλευσης. Μια αναφορά σε ένα στοιχείο σε διαφορετικό χώρο εργασίας δεν συνδέεται ποτέ αυτόματα. Παραμένει καρφιτσωμένο στο αναγνωριστικό αντικειμένου προέλευσης ανεξάρτητα από την τιμή που εμφανίζεται στον πίνακα.
Η στήλη Αυτόματη σύνδεση στο Git υποδεικνύει:
- Ναι: Ο ορισμός στοιχείου στο Git αποθηκεύει την αναφορά εξάρτησης ως λογικό αναγνωριστικό. Όταν συγχρονίζετε τη διακλάδωση σε έναν νέο χώρο εργασίας, η αναφορά συνδέεται αυτόματα με το αντίστοιχο στοιχείο σε αυτόν τον χώρο εργασίας.
- Όχι: Ο ορισμός στοιχείου στο Git αποθηκεύει την αναφορά εξάρτησης ως αναγνωριστικό αντικειμένου (GUID για συγκεκριμένο χώρο εργασίας). Η αναφορά συνεχίζει να δείχνει στον χώρο εργασίας προέλευσης μετά τον συγχρονισμό. Πρέπει να το ενημερώσετε ή να το παραμετροποιήσετε με μη αυτόματο τρόπο για ανάπτυξη μεταξύ χώρων εργασίας.
- Μερική: Το στοιχείο επιλύει την εξάρτηση με βάση το όνομα ή το URI, το οποίο μπορεί να λειτουργήσει εάν η ονομασία είναι συνεπής σε όλους τους χώρους εργασίας.
Σημειωματάρια
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Lakehouse | Ναι | Απαιτεί την ενεργοποίηση της "Αυτόματης δέσμευσης Lakehouse στο Git" στις ρυθμίσεις του σημειωματαρίου. Όταν είναι ενεργοποιημένο, το αναγνωριστικό αντικειμένου αντικαθίσταται με ένα λογικό αναγνωριστικό στο notebook-settings.json. Αυτή η ρύθμιση είναι απενεργοποιημένη από προεπιλογή. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Αυτόματη δέσμευση Lakehouse στο Git. |
| Περιβάλλον | Ναι | |
| Κατοπτρική βάση δεδομένων | Όχι |
Σημείωση
Η σύνδεση Notebook to Lakehouse δεν είναι ενεργοποιημένη από προεπιλογή. Πρέπει να ενεργοποιήσετε τη ρύθμιση "Αυτόματη σύνδεση Lakehouse στο Git" στις ρυθμίσεις κάθε σημειωματαρίου. Για περισσότερες πληροφορίες, ανατρέξτε στην ενότητα Έλεγχος και ανάπτυξη προέλευσης σημειωματαρίου.
Αναφορές
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Σημασιολογικό μοντέλο (από την αναφορά Power BI) | Μερική | Η αναφορά αναφέρεται στο μοντέλο μέσω μιας σχετικής byPath αναφοράς στο definition.pbir, όχι μέσω ενός ρητού λογικού αναγνωριστικού. Επιλύεται σωστά όταν το μοντέλο αναπτύσσεται στην ίδια σχετική θέση στον χώρο εργασίας προορισμού, αλλά δεν συνδέεται μέσω ενός λογικού αναγνωριστικού. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Φάκελος αναφοράς έργων του Power BI Desktop. |
| Σημασιολογικό μοντέλο (από σελιδοποιημένη αναφορά) | Όχι | Η συμβολοσειρά σύνδεσης της αναφοράς αναφέρεται στο μοντέλο σημασιολογίας με ένα αναγνωριστικό για συγκεκριμένο χώρο εργασίας που δεν ξαναγράφεται κατά την ανάπτυξη, επομένως παραμένει στραμμένο στο μοντέλο προέλευσης. Πρέπει να ενημερώσετε αυτήν την αναφορά για ανάπτυξη μεταξύ χώρων εργασίας. (Οι αναφορές που έχουν συνταχθεί στο Εργαλείο δόμησης αναφορών και αναφέρονται στο μοντέλο με βάση το όνομα μπορεί να επιλυθούν με εμφανιζόμενο όνομα, το οποίο είναι Μερικό.) |
Pipeline
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Pipeline | Ναι | |
| Σημειωματάριο | Ναι | |
| Ροή δεδομένων Gen2 | Ναι | |
| Βάση δεδομένων SQL | Ναι | |
| Ορισμός εργασίας Spark | Όχι | Η δραστηριότητα SparkJobDefinition αναφέρεται στον ορισμό εργασίας Spark κατά αναγνωριστικό αντικειμένου, όχι λογικό αναγνωριστικό, ώστε να παραμένει στραμμένη στο στοιχείο προέλευσης μετά την ανάπτυξη. Πρέπει να παραμετροποιήσετε αυτήν την τιμή για ανάπτυξη μεταξύ χώρων εργασίας. |
| Lakehouse | Ναι | |
| Μοντέλο σημασιολογίας | Όχι | Η δραστηριότητα PBISemanticModelRefresh αναφέρεται στο μοντέλο σημασιολογίας κατά αναγνωριστικό στοιχείου και όχι κατά λογικό αναγνωριστικό. Πρέπει να παραμετροποιήσετε αυτήν την τιμή για ανάπτυξη μεταξύ χώρων εργασίας. |
| Warehouse | Όχι | Η αποθήκη artifactId επιλύεται μέσω του λογικού αναγνωριστικού και επανασυνδέεται, αλλά αποθηκεύει linkedService επίσης την SQL endpointτου χώρου εργασίας προέλευσης , η οποία δεν ξαναγράφεται. Παραμετροποιήστε το endpoint για ανάπτυξη μεταξύ χώρων εργασίας. |
Σημασιολογικά μοντέλα
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Σημασιολογικό μοντέλο | Μερική | Οι αλυσιδωτές ή σύνθετες αναφορές μοντέλων χρησιμοποιούν συμβολοσειρές σύνδεσης με βάση το όνομα. |
| Τελικό σημείο ανάλυσης SQL (lakehouse) | Όχι | Η συμβολοσειρά σύνδεσης Direct Lake στο TMDL expressions.tmdl περιέχει μια διεύθυνση URL τελικού σημείου για συγκεκριμένο χώρο εργασίας και ένα GUID βάσης δεδομένων. Πρέπει να αντικαταστήσετε αυτές τις παραμέτρους για ανάπτυξη μεταξύ χώρων εργασίας. |
| Βάση δεδομένων KQL | Όχι | Η συμβολοσειρά σύνδεσης με ένα URI συμπλέγματος σε εκφράσεις TMDL περιέχει τιμές για συγκεκριμένους χώρους εργασίας. |
| SQL database | Όχι | Η συμβολοσειρά σύνδεσης σε παραστάσεις TMDL περιέχει τιμές για συγκεκριμένο χώρο εργασίας. |
| Warehouse | Όχι | Η σύνδεση με το τελικό σημείο ανάλυσης SQL αποθήκης χρησιμοποιεί μια διεύθυνση URL για συγκεκριμένο χώρο εργασίας. |
Λιμνοκατοικίες
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Lakehouse (συντόμευση) | Ναι | Οι εσωτερικές συντομεύσεις OneLake που παραπέμπουν σε ένα άλλο στοιχείο Fabric, όπως μια λίμνη ή μια αποθήκη, αποθηκεύονται ως λογικό αναγνωριστικό και επανασυνδέονται με το στοιχείο προορισμού-χώρου εργασίας. Οι συντομεύσεις σε εξωτερικές προελεύσεις, όπως το Azure Data Lake Storage Gen2 ή το Amazon S3, δείχνουν έξω από το Fabric και φέρουν μια αναφορά σύνδεσης, ώστε να μην υπόκεινται σε σύνδεση λογικού αναγνωριστικού. Για την πλήρη λίστα των στόχων συντόμευσης, ανατρέξτε στο θέμα Συντομεύσεις OneLake. Για τη συμπεριφορά ανάπτυξης, ανατρέξτε στο θέμα Διοχετεύσεις ενοποίησης και ανάπτυξης Lakehouse Git. |
Ροές δεδομένων (Gen2)
Από προεπιλογή, το Dataflow Gen2 δημιουργεί απόλυτες αναφορές σε στοιχεία Fabric: το ερώτημα αποθηκεύει το αναγνωριστικό χώρου εργασίας προέλευσης και το αναγνωριστικό αντικειμένου του στοιχείου, τα οποία δεν επανεγγράφονται κατά την ανάπτυξη. Μια αναφορά πηγής μπορεί να χρησιμοποιήσει μια σχετική αναφορά: όταν επιλέγετε ένα στοιχείο κάτω από το !( Current Workspace) σε μια σύνδεση Fabric, το ερώτημα αποθηκεύει το στοιχείο κατά όνομα (χωρίς GUID) και επιλύεται στο αντίστοιχο στοιχείο στον χώρο εργασίας προορισμού κατά την ανάπτυξη. Οι προορισμοί εξόδου χρησιμοποιούν πάντα απόλυτες αναφορές και δεν επανασυνδέονται. Για προορισμούς και για οποιαδήποτε απόλυτη αναφορά προέλευσης, παραμετροποιήστε τις τιμές για ανάπτυξη μεταξύ χώρων εργασίας. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Σχετικές αναφορές με συνδέσεις Fabric στο Dataflow Gen2 και στο Dataflow Gen2 με ενοποίηση CI/CD και Git.
Αναφορές πηγών:
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Lakehouse | Μερική | Επανασυνδέεται μόνο όταν έχει συνταχθεί ως σχετική αναφορά (!( Τρέχων χώρος εργασίας)); Η προεπιλεγμένη απόλυτη αναφορά δεν επανασυνδέεται. |
| Warehouse | Μερική | Επανασυνδέεται μόνο όταν έχει συνταχθεί ως σχετική αναφορά (!( Τρέχων χώρος εργασίας)); Η προεπιλεγμένη απόλυτη αναφορά δεν επανασυνδέεται. |
Αναφορές προορισμού:
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Lakehouse | Όχι | |
| Warehouse | Όχι | |
| Βάση δεδομένων SQL | Όχι |
Ορισμοί εργασιών Spark
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Περιβάλλον | Ναι | |
| Lakehouse | Όχι | Χρησιμοποιεί defaultLakehouseArtifactId ένα αναγνωριστικό αντικειμένου. |
Αντιγραφή εργασιών
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Lakehouse | Ναι | |
| Warehouse | Όχι | Η αποθήκη artifactId επιλύεται μέσω του λογικού αναγνωριστικού και επανασυνδέεται, αλλά αποθηκεύει linkedService επίσης την SQL endPointτου χώρου εργασίας προέλευσης , η οποία δεν ξαναγράφεται. Παραμετροποιήστε το endPoint για ανάπτυξη μεταξύ χώρων εργασίας. |
| Βάση δεδομένων SQL | Ναι |
Τα API GraphQL
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Τελικό σημείο SQL | Ναι | |
| Warehouse | Ναι | |
| Βάση δεδομένων SQL | Ναι |
Για όλες τις πηγές δεδομένων GraphQL API, ίσως χρειαστεί να διαμορφώσετε εκ νέου τη σύνδεση και τα διαπιστευτήρια μετά την ανάπτυξη.
Ροές συμβάντων
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Lakehouse | Ναι | |
| Eventhouse | Ναι | Όλοι οι προορισμοί υποστηρίζονται πλήρως για CI/CD όταν τα στοιχεία βρίσκονται στον ίδιο χώρο εργασίας. Για την αποθήκη συμβάντων με λειτουργία άμεσης πρόσληψης, ίσως χρειαστεί να ρυθμίσετε εκ νέου τις παραμέτρους της σύνδεσης με μη αυτόματο τρόπο μετά την ανάπτυξη. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα CI/CD ροής συμβάντων. |
| Ενεργοποιητής (Reflex) | Ναι | Όλοι οι προορισμοί υποστηρίζονται πλήρως για CI/CD όταν τα στοιχεία βρίσκονται στον ίδιο χώρο εργασίας. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα CI/CD ροής συμβάντων. |
Είδη KQL
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Βάση δεδομένων KQL σε βάση δεδομένων συμβάντων | Ναι | Το parentEventhouseItemId in DatabaseProperties.json είναι ένα λογικό αναγνωριστικό και συνδέεται με τον οργανισμό συμβάντων προορισμού. Μια βάση δεδομένων KQL αναπτύσσεται ως θυγατρική της γονικής βιβλιοθήκης συμβάντων. |
| KQL queryset στη βάση δεδομένων KQL | Μερική | Επιλύεται μέσω clusterUri και databaseName, όχι μέσω του αναγνωριστικού στοιχείου. Ο ορισμός περιλαμβάνει ένα databaseItemId, αλλά είναι ένα αναγνωριστικό αντικειμένου που δεν επανασυνδέεται, επομένως η ανάλυση εξαρτάται από το URI σε όλα τα περιβάλλοντα. |
| Real-Time Πίνακας ελέγχου στη βάση δεδομένων KQL | Μερική | Χρησιμοποιεί έναν dataSources πίνακα με URI συμπλέγματος. Ίδιο μοτίβο με το σύνολο ερωτημάτων KQL. |
Αποθήκες
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Αποθήκη (παραπομπή) | Όχι | Οι αναφορές σε άλλες αποθήκες χρησιμοποιούν αναγνωριστικά αντικειμένων. |
| Τελικό σημείο SQL | Όχι | Οι αναφορές τελικού σημείου SQL χρησιμοποιούν αναγνωριστικά ειδικά για τον χώρο εργασίας. |
Μεταβλητές Βιβλιοθήκες
| Εξάρτηση | Αυτόματη σύνδεση στο Git | Σημειώσεις |
|---|---|---|
| Fabric items (ItemReference type) | Όχι | Ο ItemReference τύπος μεταβλητής αποθηκεύει workspaceId και itemId ως ακατέργαστα GUID. Πρέπει να ενημερώσετε ή να παρακάμψετε αυτές τις τιμές με μη αυτόματο τρόπο μέσω συνόλων τιμών ανά περιβάλλον. |
Στοιχεία χωρίς εξαρτήσεις
Τα ακόλουθα στοιχεία δεν έχουν ζητήματα δέσμευσης εξάρτησης μεταξύ χώρων εργασίας:
- Περιβάλλον
- Βάση δεδομένων SQL
- Βάση δεδομένων Eventhouse (στοιχείο περιέκτη; Οι βάσεις δεδομένων KQL το αναφέρουν)
- Κατοπτρική βάση δεδομένων (μόνο ρύθμιση παραμέτρων εξωτερικής πηγής)
Σύνοψη
Όταν αναπτύσσετε στοιχεία Fabric σε χώρους εργασίας, οι εξαρτήσεις μεταξύ των στοιχείων μπορεί να διακοπούν εάν οι αναφορές αποθηκεύονται ως αναγνωριστικά αντικειμένων για συγκεκριμένο χώρο εργασίας αντί για φορητά λογικά αναγνωριστικά. Δεν υποστηρίζουν όλοι οι τύποι στοιχείων τη σύνδεση εξαρτήσεων μέσω λογικών αναγνωριστικών. Πριν ρυθμίσετε την ανάπτυξη μεταξύ χώρων εργασίας, εξετάστε τους πίνακες συμβατότητας σε αυτό το άρθρο για να προσδιορίσετε ποιες εξαρτήσεις συνδέονται αυτόματα και ποιες απαιτούν μη αυτόματη παραμετροποίηση.