Τι είναι η ενοποίηση microsoft Fabric Git;
Αυτό το άρθρο εξηγεί στους προγραμματιστές πώς μπορείτε να ενσωματώσετε τον έλεγχο έκδοσης Git με το εργαλείο διαχείρισης κύκλου ζωής εφαρμογών Microsoft Fabric (ALM).
Σημείωση
Ορισμένα από τα στοιχεία για την ενοποίηση Git βρίσκονται σε προεπισκόπηση. Για περισσότερες πληροφορίες, ανατρέξτε στη λίστα των υποστηριζόμενων στοιχείων.
Η ενοποίηση Git στο Microsoft Fabric επιτρέπει στους προγραμματιστές να ενσωματώνουν τις διαδικασίες ανάπτυξης, τα εργαλεία και τις βέλτιστες πρακτικές τους απευθείας στην πλατφόρμα Fabric. Επιτρέπει στους προγραμματιστές που αναπτύσσουν in Fabric να:
- Δημιουργία αντιγράφων ασφαλείας και διαχείριση εκδόσεων της εργασίας τους
- Επαναφορά στα προηγούμενα στάδια, ανάλογα με τις ανάγκες
- Συνεργασία με άλλους ή εργασία μόνη της με διακλαδώσεις του Git
- Εφαρμογή των δυνατοτήτων οικείων εργαλείων ελέγχου προέλευσης για τη διαχείριση στοιχείων Fabric
Δείτε τη λίστα των υποστηριζόμενων στοιχείων.
Διαβάστε περισσότερα σχετικά με τη διαδικασία ενοποίησης Git.
Διαβάστε σχετικά με τον καλύτερο τρόπο διαχείρισης των διακλαδώσεις σας Git.
Πληροφορίες προστασίας προσωπικών δεδομένων
Προτού ενεργοποιήσετε την ενοποίηση Git, βεβαιωθείτε ότι ελέγχετε τις παρακάτω δηλώσεις προστασίας προσωπικών δεδομένων:
- Δήλωση προστασίας προσωπικών δεδομένων της Microsoft
- Επισκόπηση προστασίας δεδομένων υπηρεσιών Azure DevOps
- Σύμβαση προστασίας δεδομένων GitHub
Υποστηριζόμενες υπηρεσίες παροχής Git
Υποστηρίζονται οι ακόλουθες υπηρεσίες παροχής Git:
- Git στα αποθετήρια δεδομένων Azure με τον ίδιο μισθωτή με τον μισθωτή Fabric
- GitHub (μόνο εκδόσεις cloud)
- GitHub Enterprise (μόνο εκδόσεις cloud)
Υποστηριζόμενα στοιχεία
Προς το παρόν υποστηρίζονται τα ακόλουθα στοιχεία:
- Διοχετεύσειςδεδομένων (προεπισκόπηση)
- ροών δεδομένων gen2(προεπισκόπηση)
- Βάση δεδομένωνEventhouse και KQL (προεπισκόπηση)
-
EventStream (προεπισκόπηση) - Lakehouse(προεπισκόπηση)
- βάσης δεδομένων (προεπισκόπηση)
- Σημειωματάρια
- Σελιδοποιημένες αναφορές(προεπισκόπηση)
- Reflex (προεπισκόπηση)
- αναφορών του
(εκτός από αναφορές που είναι συνδεδεμένες με σημασιολογικά μοντέλα που φιλοξενούνται στο των Υπηρεσιών ανάλυσης του Azure , Υπηρεσιών ανάλυσης του SQL Server ή αναφορές που εξάγονται από το Power BI Desktop και εξαρτώνται από σημασιολογικά μοντέλα που φιλοξενούνται στο MyWorkspace )(προεπισκόπηση) - Σημασιολογικά μοντέλα (εκτός από τα σύνολα δεδομένων προώθησης, τις δυναμικές συνδέσεις στις Υπηρεσίες ανάλυσης, το μοντέλο v1) (προεπισκόπηση)
- Ορισμοίεργασίας Spark (προεπισκόπηση)
- ΠεριβάλλονSpark (προεπισκόπηση)
- Βάση δεδομένωνSQL (προεπισκόπηση)
- Αποθήκες(προεπισκόπηση)
Εάν ο χώρος εργασίας ή ο κατάλογος Git έχει μη υποστηριζόμενα στοιχεία, μπορεί ακόμα να συνδεθεί, αλλά τα μη υποστηριζόμενα στοιχεία παραβλέπονται. Δεν αποθηκεύονται ή συγχρονίζονται, αλλά δεν διαγράφονται. Εμφανίζονται στον πίνακα ελέγχου προέλευσης, αλλά δεν μπορείτε να τα δεσμεύσετε ή να τα ενημερώσετε.
Ζητήματα προς εξέταση και περιορισμοί
Γενικοί περιορισμοί ενοποίησης Git
- Η μέθοδος ελέγχου ταυτότητας στο Fabric πρέπει να είναι τουλάχιστον τόσο ισχυρή όσο η μέθοδος ελέγχου ταυτότητας για το Git. Για παράδειγμα, εάν το Git απαιτεί έλεγχο ταυτότητας πολλών παραγόντων, το Fabric πρέπει να απαιτεί επίσης έλεγχο ταυτότητας πολλών παραγόντων.
- Τα σύνολα δεδομένων Power BI που είναι συνδεδεμένα στις Υπηρεσίες ανάλυσης δεν υποστηρίζονται προς το παρόν.
- Δεν είναι δυνατή η σύνδεση χώρων εργασίας με εγκατεστημένες εφαρμογές προτύπου στο Git.
- Τα υπομονάδες δεν υποστηρίζονται.
- Δεν υποστηρίζονται εθνικά cloud.
- Ο λογαριασμός Azure DevOps πρέπει να έχει καταχωρηθεί στον ίδιο χρήστη που χρησιμοποιεί τον χώρο εργασίας Fabric.
- Το Azure DevOps δεν υποστηρίζεται εάν είναι ενεργοποιημένη Ενεργοποίηση επικύρωσης πολιτικής πρόσβασης υπό όρους IP.
- Ο διαχειριστής μισθωτή πρέπει να ενεργοποιήσει τις εξαγωγές cross-geo εάν ο χώρος εργασίας και το αποθετήριο Git βρίσκονται σε δύο διαφορετικές γεωγραφικές περιοχές.
- Εάν ο οργανισμός σας έχει ρυθμίσει πρόσβαση υπό όρους, βεβαιωθείτε ότι η υπηρεσία Power BI έχει τις ίδιες συνθήκες που έχουν οριστεί ελέγχου ταυτότητας ώστε να λειτουργεί με τον αναμενόμενο τρόπο.
- Το μέγεθος δέσμευσης περιορίζεται σε 125 MB.
Περιορισμοί για το GitHub Enterprise
Ορισμένες ρυθμίσεις GitHub Enterprise δεν υποστηρίζονται. Για παράδειγμα:
- Λίστα επιτρεπόμενων διευθύνσεων IP
- Ιδιωτική δικτύωση
- Προσαρμοσμένοι τομείς
Περιορισμοί χώρου εργασίας
- Μόνο ο διαχειριστής χώρου εργασίας μπορεί να διαχειριστεί τις συνδέσεις στο Git Repo , όπως σύνδεση, αποσύνδεση ή προσθήκη διακλάδωσης.
Αφού συνδεθεί, οποιοσδήποτε διαθέτει δικαιώματα μπορεί να εργαστεί στον χώρο εργασίας.
Περιορισμοί διακλάδωσης και φακέλων
- Το μέγιστο μήκος ονόματος διακλάδωσης είναι 244 χαρακτήρες.
- Το μέγιστο μήκος πλήρους διαδρομής για τα ονόματα αρχείων είναι 250 χαρακτήρες. Τα μεγαλύτερα ονόματα αποτυγχάνουν.
- Το μέγιστο μέγεθος αρχείου είναι 25 MB.
- Η δομή φακέλων διατηρείται σε βάθος έως 10 επιπέδων.
- Δεν μπορείτε να κάνετε λήψη μιας αναφοράς/συνόλου δεδομένων ως .pbix από την υπηρεσία μετά την ανάπτυξή τους με ενοποίηση Git.
- Εάν το εμφανιζόμενο όνομα του στοιχείου έχει οποιοδήποτε από αυτά τα χαρακτηριστικά, ο φάκελος Git μετονομάζεται στο λογικό αναγνωριστικό (Guid) και στον τύπο:
- Έχει περισσότερους από 256 χαρακτήρες
- Τελειώνει με ένα . ή ένα κενό διάστημα
- Περιέχει τυχόν απαγορευμένους χαρακτήρες, όπως περιγράφεται τους περιορισμούς ονόματος καταλόγου
- Όταν συνδέετε έναν χώρο εργασίας που έχει φακέλους στο Git, πρέπει να καταχωρήσετε αλλαγές στο αποθετήριο Git εάν αυτή δομή φακέλων διαφέρει.
Περιορισμοί ονόματος καταλόγου
Το όνομα του καταλόγου που συνδέεται στο αποθετήριο δεδομένων Git έχει τους ακόλουθους περιορισμούς ονοματοθεσίας:
- Το όνομα του καταλόγου δεν μπορεί να αρχίζει ή να τελειώνει με ένα κενό διάστημα ή καρτέλα.
- Το όνομα του καταλόγου δεν μπορεί να περιέχει οποιονδήποτε από τους ακόλουθους χαρακτήρες: "/:<>\*?|
Ο φάκελος στοιχείου (ο φάκελος που περιέχει τα αρχεία στοιχείων) δεν μπορεί να περιέχει οποιονδήποτε από τους ακόλουθους χαρακτήρες: ":<>\*?|. Εάν μετονομάσετε τον φάκελο σε κάτι που περιλαμβάνει έναν από αυτούς τους χαρακτήρες, το Git δεν μπορεί να συνδεθεί ή να συγχρονιστεί με τον χώρο εργασίας και παρουσιάζεται ένα σφάλμα.
Περιορισμοί διακλάδωσης
- Η διακλάδωση απαιτεί δικαιώματα που παρατίθενται στον πίνακα δικαιωμάτων.
- Πρέπει να υπάρχει ένα διαθέσιμο σύνολο εκχωρημένων πόρων για αυτήν την ενέργεια.
- Όλοι οι περιορισμοί ονοματοθεσίας χώρων εργασίας και διακλαδών ισχύουν κατά τη διακλάδωση σε έναν νέο χώρο εργασίας.
- Μόνο στοιχεία που υποστηρίζονται από το Git είναι διαθέσιμα στον νέο χώρο εργασίας.
- Η λίστα σχετικών κλάδων εμφανίζει μόνο κλάδους και χώρους εργασίας για τους οποία έχετε δικαίωμα προβολής.
- Η ενοποίηση Git πρέπει να ενεργοποιηθεί.
- Κατά τη διακλάδωση, δημιουργείται ένας νέος κλάδος και οι ρυθμίσεις από τον αρχικό κλάδο δεν αντιγράφονται. Προσαρμόστε τυχόν ρυθμίσεις ή ορισμούς για να διασφαλίσετε ότι ο νέος χρήστης πληροί τις πολιτικές του οργανισμού σας.
- Κατά τη διακλάδωση σε έναν υπάρχοντα χώρο εργασίας:
- Ο χώρος εργασίας προορισμού πρέπει να υποστηρίζει μια σύνδεση Git.
- Ο χρήστης πρέπει να είναι διαχειριστής του χώρου εργασίας προορισμού.
- Ο χώρος εργασίας προορισμού πρέπει να έχει εκχωρημένους πόρους.
- Ο χώρος εργασίας δεν μπορεί να έχει εφαρμογές προτύπου.
- Σημειώστε ότι όταν κάνετε διακλάδωση σε έναν χώρο εργασίας, οποιαδήποτε στοιχεία δεν αποθηκεύονται στο Git μπορεί να χαθούν. Συνιστούμε να δεσμεύσετε στοιχεία που θέλετε να διατηρήσετε πριν από την διακλάδωση.
Περιορισμοί συγχρονισμού και δέσμευσης
- Μπορείτε να συγχρονίσετε μόνο προς μία κατεύθυνση κάθε φορά. Δεν μπορείτε να πραγματοποιήσετε και να ενημερώσετε ταυτόχρονα.
- Οι ετικέτες ευαισθησίας δεν υποστηρίζονται και η εξαγωγή στοιχείων με ετικέτες ευαισθησίας μπορεί να είναι απενεργοποιημένη. Για να δεσμεύσετε στοιχεία που έχουν ετικέτες ευαισθησίας χωρίς την ετικέτα ευαισθησίας, ζητήστε βοήθεια από τον διαχειριστή σας.
- Λειτουργεί με περιορισμένα στοιχεία. Τα μη υποστηριζόμενα στοιχεία στον φάκελο παραβλέπονται.
- Δεν επιτρέπεται η αντιγραφή ονομάτων. Ακόμη και αν το Power BI επιτρέπει την αντιγραφή ονόματος, η ενέργεια ενημέρωσης, δέσμευσης ή αναίρεσης αποτυγχάνει.
- Το B2B δεν υποστηρίζεται.
- Η επίλυση διένεξης πραγματοποιείται εν μέρει στο Git.
- Κατά τη διαδικασία Δέσμευση στο Git , η υπηρεσία Fabric διαγράφει αρχεία μέσα στον φάκελο στοιχείου που δεν αποτελούν μέρος του ορισμού στοιχείου. Δεν διαγράφονται μη σχετιζόμενα αρχεία που δεν βρίσκονται σε έναν φάκελο στοιχείων.
- Μετά την πραγματοποίηση αλλαγών, ενδέχεται να παρατηρήσετε ορισμένες μη αναμενόμενες αλλαγές στο στοιχείο που δεν πραγματοποιήσατε. Αυτές οι αλλαγές είναι σημασιολογικά ασήμαντες και μπορούν να συμβούν για διάφορους λόγους. Για παράδειγμα:
- Αλλαγή με μη αυτόματο τρόπο του αρχείου ορισμού στοιχείου. Αυτές οι αλλαγές είναι έγκυρες, αλλά μπορεί να είναι διαφορετικές από ότι εάν γίνονται μέσω των συντακτών. Για παράδειγμα, εάν μετονομάσετε μια στήλη σημασιολογικού μοντέλου στο Git και εισαγάγετε αυτή την αλλαγή στον χώρο εργασίας, την επόμενη φορά που θα πραγματοποιήσετε αλλαγές στο μοντέλο σημασιολογίας, το αρχείο bim θα καταχωρηθεί όπως έχει αλλάξει και η τροποποιημένη στήλη θα προωθηθεί στο πίσω μέρος του
columns
πίνακα. Αυτό συμβαίνει επειδή η μηχανή AS που δημιουργεί τα αρχεία bim προωθεί μετονομασμένες στήλες στο τέλος του πίνακα. Αυτή η αλλαγή δεν επηρεάζει τον τρόπο λειτουργίας του στοιχείου. - Δέσμευση ενός αρχείου που χρησιμοποιεί αλλαγές γραμμής του CRLF . Η υπηρεσία χρησιμοποιεί αλλαγές γραμμής LF (αλλαγή γραμμής). Εάν είχατε αρχεία στοιχείων στο αποθετήριο Git με αλλαγές γραμμής CRLF , όταν δεσμεύετε από την υπηρεσία, αυτά τα αρχεία αλλάζουν σε LF. Για παράδειγμα, εάν ανοίξετε μια αναφορά στο desktop, αποθηκεύστε το αρχείο έργου (.pbip) και αποστείλετε στο Git χρησιμοποιώντας CRLF .
- Αλλαγή με μη αυτόματο τρόπο του αρχείου ορισμού στοιχείου. Αυτές οι αλλαγές είναι έγκυρες, αλλά μπορεί να είναι διαφορετικές από ότι εάν γίνονται μέσω των συντακτών. Για παράδειγμα, εάν μετονομάσετε μια στήλη σημασιολογικού μοντέλου στο Git και εισαγάγετε αυτή την αλλαγή στον χώρο εργασίας, την επόμενη φορά που θα πραγματοποιήσετε αλλαγές στο μοντέλο σημασιολογίας, το αρχείο bim θα καταχωρηθεί όπως έχει αλλάξει και η τροποποιημένη στήλη θα προωθηθεί στο πίσω μέρος του
- Η ανανέωση ενός σημασιολογικού μοντέλου με χρήση του API Βελτιωμένης ανανέωσης προκαλεί μια διαφορά Git μετά από κάθε ανανέωση.