Σημείωση
Η πρόσβαση σε αυτή τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να συνδεθείτε ή να αλλάξετε καταλόγους.
Η πρόσβαση σε αυτή τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να αλλάξετε καταλόγους.
Αυτό το εκπαιδευτικό βοήθημα σάς δείχνει πώς μπορείτε να χρησιμοποιήσετε δυναμικό περιεχόμενο σε διοχετεύσεις Microsoft Fabric. Όταν δημιουργείτε ένα στοιχείο βιβλιοθήκης μεταβλητών και προσθέτετε μεταβλητές σε αυτό, μπορείτε να αυτοματοποιήσετε τιμές για διάφορα στάδια της διοχέτευσης ανάπτυξης. Σε αυτό το σεμινάριο, αντιγράφετε δεδομένα από το ένα σπίτι της λίμνης στο άλλο. Στη συνέχεια, μπορείτε να χρησιμοποιήσετε τη βιβλιοθήκη μεταβλητών για να ορίσετε τις τιμές προέλευσης και προορισμού για τη δραστηριότητα αντιγραφής.
Σε αυτό το πρόγραμμα εκμάθησης:
- Δημιουργήστε μια βιβλιοθήκη μεταβλητών.
- Προσθέστε μεταβλητές στη βιβλιοθήκη.
- Ορίστε πρόσθετα σύνολα τιμών για τις μεταβλητές.
- Καταναλώστε τις μεταβλητές σε ένα άλλο στοιχείο στον χώρο εργασίας (μια διοχέτευση).
- Επεξεργαστείτε τις μεταβλητές σε ένα αποθετήριο Git.
- Δημιουργήστε μια διοχέτευση ανάπτυξης και αναπτύξτε τη βιβλιοθήκη μεταβλητών.
- Αλλάξτε την ενεργή τιμή που έχει οριστεί στο στάδιο προορισμού της διοχέτευσης ανάπτυξης.
- Δείξτε ότι η τιμή της μεταβλητής συμμορφώνεται με την ενεργή τιμή που έχει οριστεί σε κάθε στάδιο.
Το παρακάτω διάγραμμα δείχνει τη διάταξη του χώρου εργασίας για αυτό το πρόγραμμα εκμάθησης.
Προαπαιτούμενα στοιχεία
Ένας λογαριασμός μισθωτή Fabric με ενεργή συνδρομή. Δημιουργία λογαριασμού δωρεάν.
Ο ακόλουθος διακόπτης μισθωτή ενεργοποιείται από την πύλη διαχείρισης:
Ο διαχειριστής μισθωτή, ο διαχειριστής εκχωρημένων πόρων ή ο διαχειριστής χώρου εργασίας μπορούν να ενεργοποιήσουν αυτούς τους διακόπτες, ανάλογα με τις ρυθμίσεις του οργανισμού σας.
Δημιουργήστε τον χώρο εργασίας Stage LHs, SourceLH_Stage λιμναίο σπίτι με δείγμα δεδομένων και Pipeline_Stage διοχέτευση
Αρχικά, δημιουργήστε έναν χώρο εργασίας και ένα σπίτι λίμνης για να χρησιμοποιήσετε ως αρχικά δεδομένα σταδιοποίησης:
Μεταβείτε στο Power BI.
Στην πλαϊνή στήλη, επιλέξτε «Χώρος εργασίας».
Δημιουργήστε έναν χώρο εργασίας. Ονομάστε το Stage LHs.
Δημιουργήστε ένα σπίτι λίμνης:
Δημιουργήστε μια διοχέτευση:
Στο lakehouse, επιλέξτε Νέα διοχέτευση.
Πληκτρολογήστε το όνομα Pipeline_Stage και, στη συνέχεια, επιλέξτε Δημιουργία.
Στον οδηγό Αντιγραφή δεδομένων στο Lakehouse , στη σελίδα Επιλογή προέλευσης δεδομένων , επιλέξτε Δείγμα δεδομένων.
Επιλέξτε Δημόσιες αργίες.
Αφού ολοκληρωθεί η φόρτωση του δείγματος δεδομένων, επιλέξτε Επόμενο.
Στη σελίδα Σύνδεση με προορισμό δεδομένων , επιλέξτε Επόμενο.
Στη σελίδα Αναθεώρηση + αποθήκευση , επιλέξτε Αποθήκευση + Εκτέλεση.
Δημιουργία του χώρου εργασίας Source LHs with Variables
Τώρα, δημιουργήστε τον χώρο εργασίας από τον οποίο θα εργαστείτε και θα χρησιμοποιήσετε με τη βιβλιοθήκη μεταβλητών σας:
Μεταβείτε στο Power BI.
Στην πλαϊνή στήλη, επιλέξτε «Χώρος εργασίας».
Δημιουργήστε έναν χώρο εργασίας. Ονομάστε το Πηγή LHs με μεταβλητές.
Δημιουργήστε τα SourceLH_Dev, SourceLH_Test και SourceLH_Prod λιμνών
Στη συνέχεια, δημιουργήστε τα τρία σπίτια λιμνών για χρήση με τη μεταβλητή βιβλιοθήκη:
Δημιουργήστε το πρώτο λιμναίο σπίτι:
Στην πλαϊνή στήλη, επιλέξτε τον χώρο εργασίας «Πηγή LHs με μεταβλητές ».
Επιλέξτε νέο στοιχείο.
Στην περιοχή Αποθήκευση δεδομένων, επιλέξτε Lakehouse.
Πληκτρολογήστε το όνομα SourceLH_Dev και, στη συνέχεια, επιλέξτε Δημιουργία.
Δημιουργήστε το δεύτερο σπίτι λίμνης ακολουθώντας τα προηγούμενα βήματα. Ονομάστε το SourceLH_Test.
Δημιουργήστε το τρίτο σπίτι λίμνης ακολουθώντας τα προηγούμενα βήματα. Ονομάστε το SourceLH_Prod.
Στην πλαϊνή γραμμή, επιλέξτε τον χώρο εργασίας «Πηγή LHs με μεταβλητές» και βεβαιωθείτε ότι περιέχει όλα τα νεοδημιουργηθέντα λιμναία σπίτια.
Λήψη των αναγνωριστικών χώρου εργασίας και των αναγνωριστικών αντικειμένων για σπίτια λιμνών
Σε αυτά τα βήματα, λαμβάνετε τα μοναδικά αναγνωριστικά που μπορείτε να χρησιμοποιήσετε στη βιβλιοθήκη μεταβλητών σας:
Στο Power BI, στην πλαϊνή γραμμή, επιλέξτε τον χώρο εργασίας Stage LH.
Στο χώρο εργασίας, επιλέξτε το SourceLH_Stage lakehouse.
Αντιγράψτε το αναγνωριστικό χώρου εργασίας και το αναγνωριστικό αντικειμένου λίμνης στη διεύθυνση URL.
Επαναλάβετε τα προηγούμενα βήματα για τα SourceLH_Dev και SourceLH_Test λιμνοκατοικίες στο χώρο εργασίας Προέλευση LHs με μεταβλητές .
Δημιουργία βιβλιοθήκης μεταβλητών με μεταβλητές
Τώρα, δημιουργήστε τη βιβλιοθήκη μεταβλητών:
Στο χώρο εργασίας Προέλευση LHs with Variables , επιλέξτε New item.
Στην περιοχή Ανάπτυξη δεδομένων, επιλέξτε **Βιβλιοθήκη μεταβλητών **.
Ονομάστε τις μεταβλητές WS της βιβλιοθήκης και, στη συνέχεια, επιλέξτε Δημιουργία.
Επιλέξτε Νέα μεταβλητή.
Δημιουργήστε τις ακόλουθες μεταβλητές:
Ονομασία Type Προεπιλεγμένο σύνολο τιμών Source_LHΣυμβλοσειρά <GUID του SourceLH_Stage lakehouse> Source_WSIDΣυμβλοσειρά <GUID του χώρου εργασίας SourceLH_Stage> Destination_LHΣυμβλοσειρά <GUID της λίμνης SourceLH_Dev> Destination_WSIDΣυμβλοσειρά <GUID του χώρου εργασίας SourceLH_Dev> SourceTable_NameΣυμβλοσειρά ProcessedDestinationTable_NameΣυμβλοσειρά DevCopiedDataΕπιλέξτε Αποθήκευση.
Δημιουργία εναλλακτικών συνόλων τιμών
Σε αυτά τα βήματα, μπορείτε να προσθέσετε τα εναλλακτικά σύνολα τιμών στη βιβλιοθήκη μεταβλητών σας:
Δημιουργήστε το πρώτο σύνολο τιμών:
Στη βιβλιοθήκη μεταβλητών WS Variables , επιλέξτε Add value set.
Πληκτρολογήστε Test VS για το όνομα και, στη συνέχεια, επιλέξτε Δημιουργία.
Δημιουργήστε τις ακόλουθες μεταβλητές:
Ονομασία Type Προεπιλεγμένο σύνολο τιμών Source_LHΣυμβλοσειρά <GUID της λίμνης SourceLH_Dev> Source_WSIDΣυμβλοσειρά <GUID του χώρου εργασίας SourceLH_Dev> Destination_LHΣυμβλοσειρά <GUID της λίμνης SourceLH_Test> Destination_WSIDΣυμβλοσειρά <GUID του χώρου εργασίας SourceLH_Test> SourceTable_NameΣυμβλοσειρά DevCopiedDataDestinationTable_NameΣυμβλοσειρά TestCopiedDataΕπιλέξτε Αποθήκευση>Συμφωνώ.
Δημιουργήστε το δεύτερο σύνολο τιμών:
Επιλέξτε Προσθήκη συνόλου τιμών.
Πληκτρολογήστε Prod VS για το όνομα και, στη συνέχεια, επιλέξτε Δημιουργία.
Δημιουργήστε τις ακόλουθες μεταβλητές:
Ονομασία Type Προεπιλεγμένο σύνολο τιμών Source_LHΣυμβλοσειρά <GUID της λίμνης SourceLH_Test> Source_WSIDΣυμβλοσειρά <GUID του χώρου εργασίας SourceLH_Test> Destination_LHΣυμβλοσειρά <GUID της λίμνης SourceLH_Prod> Destination_WSIDΣυμβλοσειρά <GUID του χώρου εργασίας SourceLH_Prod> SourceTable_NameΣυμβλοσειρά TestCopiedDataDestinationTable_NameΣυμβλοσειρά ProdCopiedDataΕπιλέξτε Αποθήκευση>Συμφωνώ.
Δημιουργήστε τη διοχέτευση Pipeline_Deploy και δηλώστε μεταβλητές
Σε αυτά τα βήματα, δημιουργείτε τη διοχέτευση και δηλώνετε τις μεταβλητές σας:
Στο χώρο εργασίας Προέλευση LHs with Variables , επιλέξτε New item.
Στην περιοχή Λήψη δεδομένων, επιλέξτε Διοχέτευση.
Πληκτρολογήστε το όνομα Pipeline_Deploy και, στη συνέχεια, επιλέξτε Δημιουργία.
Επιλέξτε Αντιγραφή δεδομένων>Προσθήκη στον καμβά.
Επιλέξτε τον καμβά έτσι ώστε η εστίαση να είναι απενεργοποιημένη Αντιγραφή δεδομένων.
Επιλέξτε **Μεταβλητές βιβλιοθήκης **.
Επιλέξτε Δημιουργίακαι, στη συνέχεια, προσθέστε τις ακόλουθες μεταβλητές:
Ονομασία Βιβλιοθήκη Όνομα μεταβλητής Type SourceLHΜεταβλητές WS Source_LHΣυμβλοσειρά SourceWSIDΜεταβλητές WS Source_WSIDΣυμβλοσειρά DestinationLHΜεταβλητές WS Destination_LHΣυμβλοσειρά DestinationWSIDΜεταβλητές WS Destination_WSIDΣυμβλοσειρά SourceTableNameΜεταβλητές WS SourceTable_NameΣυμβλοσειρά DestinationTableNameΜεταβλητές WS DestinationTable_NameΣυμβλοσειρά Επιλέξτε Αποθήκευση.
Ρύθμιση παραμέτρων της σύνδεσης προέλευσης για τη διοχέτευση Pipeline_Deploy
Σε αυτά τα βήματα, μπορείτε να ρυθμίσετε τη σύνδεση προέλευσης για τη διοχέτευση σας:
Στο χώρο εργασίας Προέλευση LHs με μεταβλητές , μεταβείτε στο Pipeline_Deploy.
Στον καμβά, επιλέξτε Αντιγραφή δεδομένων , ώστε η εστίαση να είναι στην Αντιγραφή δεδομένων.
Επιλέξτε Πηγή.
Ρύθμιση παραμέτρων SourceLH:
Ρύθμιση παραμέτρων SourceWSID:
Ρύθμιση παραμέτρων SourceTableName:
Στην περιοχή >, επιλέξτε Enter με μη αυτόματο τρόπο, επιλέξτε Όνομα πίνακα και, στη συνέχεια, επιλέξτε Προσθήκη δυναμικού περιεχομένου.
Επιλέξτε τα αποσιωπητικά (...) και, στη συνέχεια, επιλέξτε **Μεταβλητές βιβλιοθήκης **.
Επιλέξτε SourceTableName. Συμπληρώνει το κουτί με
@pipeline().libraryVariables.SourceTableName. Επιλέξτε ΟΚ.
Τώρα που έχει ρυθμιστεί η σύνδεση προέλευσης, μπορείτε να τη δοκιμάσετε. Επιλέξτε Προεπισκόπηση δεδομένων και, στη συνέχεια, επιλέξτε OK στο αναδυόμενο στοιχείο. Μετά τη συμπλήρωση των δεδομένων, μπορείτε να κλείσετε την προεπισκόπηση δεδομένων.
Ρύθμιση παραμέτρων της σύνδεσης προορισμού για τη διοχέτευση Pipeline_Deploy
Σε αυτά τα βήματα, μπορείτε να ρυθμίσετε τη σύνδεση προορισμού για τη διοχέτευση σας:
Στο χώρο εργασίας Προέλευση LHs με μεταβλητές , μεταβείτε στο Pipeline_Deploy.
Στον καμβά, επιλέξτε Αντιγραφή δεδομένων , ώστε η εστίαση να είναι στην Αντιγραφή δεδομένων.
Επιλέξτε Προορισμός.
Ρύθμιση παραμέτρων SourceLH:
Ρύθμιση παραμέτρων DestinationWSID:
Ρύθμιση παραμέτρων DestinationTableName:
Στην περιοχή Πίνακας προορισμού>, επιλέξτε Enter με μη αυτόματο τρόπο, επιλέξτε Όνομα πίνακα και, στη συνέχεια, επιλέξτε Προσθήκη δυναμικού περιεχομένου.
Επιλέξτε τα αποσιωπητικά (...) και, στη συνέχεια, επιλέξτε **Μεταβλητές βιβλιοθήκης **.
Επιλέξτε DestinationTableName. Συμπληρώνει το κουτί με
@pipeline().libraryVariables.DestinationTableName. Επιλέξτε ΟΚ.
Τώρα που έχει ρυθμιστεί η σύνδεση προορισμού, αποθηκεύστε τη διοχέτευση και επιλέξτε Εκτέλεση. Επιβεβαιώστε ότι εκτελείται με επιτυχία.
Δημιουργία της διοχέτευσης ανάπτυξης
Τώρα, δημιουργήστε τη διοχέτευση ανάπτυξης:
Στο χώρο εργασίας Προέλευση LHs με μεταβλητές , επιλέξτε Δημιουργία διοχέτευσης ανάπτυξης.
Ονομάστε το Deployment_Pipeline_Var διοχέτευσης και, στη συνέχεια, επιλέξτε Επόμενο.
Στη διοχέτευση ανάπτυξης, επιλέξτε Δημιουργία και συνέχεια.
Για το στάδιο ανάπτυξης :
Για το στάδιο δοκιμής :
Για το στάδιο της παραγωγής :
Ορισμός του ενεργού συνόλου της βιβλιοθήκης μεταβλητών για κάθε στάδιο
Σε αυτά τα βήματα, μπορείτε να ρυθμίσετε το ενεργό σύνολο για κάθε στάδιο της διοχέτευσης ανάπτυξης:
Ρυθμίστε τις παραμέτρους του ενεργού συνόλου για το στάδιο δοκιμής :
Στην πλαϊνή στήλη, επιλέξτε τη διοχέτευση Deployment_Pipeline_Var .
Επιλέξτε το στάδιο δοκιμής .
Επιλέξτε WS Variables.
Επιλέξτε τα αποσιωπητικά (...) και, στη συνέχεια, επιλέξτε Ορισμός ως ενεργού. Επιλέξτε το κουμπί Ορισμός ως ενεργού .
Το ενεργό σύνολο έχει πλέον ρυθμιστεί.
Επιλέξτε Αποθήκευση>Συμφωνώ.
Διαμορφώστε το ενεργό σύνολο για το στάδιο Prod :
Στην πλαϊνή στήλη, επιλέξτε τη διοχέτευση Deployment_Pipeline_Var .
Επιλέξτε το στάδιο Prod .
Επιλέξτε WS Variables.
Επιλέξτε τα αποσιωπητικά (...) και, στη συνέχεια, επιλέξτε Ορισμός ως ενεργού. Επιλέξτε το κουμπί Ορισμός ως ενεργού .
Επιλέξτε Αποθήκευση>Συμφωνώ.
Επαλήθευση και δοκιμή της βιβλιοθήκης μεταβλητών
Τώρα που ρυθμίζετε τη βιβλιοθήκη μεταβλητών και ρυθμίζετε όλες τις παραμέτρους όλων των ενεργών συνόλων για κάθε στάδιο της διοχέτευσης ανάπτυξης, μπορείτε να τα επαληθεύσετε:
Ελέγξτε το SourceLHs_Dev lakehouse:
Μεταβείτε στο SourceLHs_Test lakehouse και επαναλάβετε τα προηγούμενα βήματα.
Ο πίνακας TestCopiedData δεν πρέπει να εμφανίζεται, επειδή δεν έχετε εκτελέσει ακόμα τη διοχέτευση με το ενεργό σύνολο Test VS.
Μεταβείτε στο SourceLHs_Prod το σπίτι της λίμνης και επαναλάβετε τα προηγούμενα βήματα.
Ο πίνακας ProdCopiedData δεν πρέπει να εμφανίζεται, επειδή δεν έχετε εκτελέσει ακόμα τη διοχέτευση με το ενεργό σύνολο Prod VS .
Ελέγξτε το Στάδιο δοκιμής της διοχέτευσης Deployment_Pipeline_Var :
Μεταβείτε στη διοχέτευση Deployment_Pipeline_Var και επιλέξτε το στάδιο δοκιμής .
Επιλέξτε τη Pipeline_Deploy διοχέτευση.
Επιλέξτε Εκτέλεση. Αυτή η διαδικασία θα πρέπει να ολοκληρωθεί με επιτυχία.
Ελέγξτε ξανά το SourceLHs_Test lakehouse:
Ελέγξτε το στάδιο παραγωγής του αγωγού Deployment_Pipeline_Var :
Μεταβείτε στη διοχέτευση Deployment_Pipeline_Var και επιλέξτε το Στάδιο παραγωγής .
Επιλέξτε τη Pipeline_Deploy διοχέτευση.
Επιλέξτε Εκτέλεση. Αυτή η διαδικασία θα πρέπει να ολοκληρωθεί με επιτυχία.
Ελέγξτε ξανά το SourceLHs_Prod lakehouse:
Μεταβείτε στο SourceLHs_Prod lakehouse.
Αλλάξτε τη σύνδεση από τελικό σημείο Lakehouse σε SQL analytics.
Στον εξερευνητή, αναπτύξτε το στοιχείο Σχήματα>dbo>Πίνακες.
Επιβεβαιώστε ότι εμφανίζεται ο πίνακας ProdCopiedData .
Προσαρμογή των τιμών μεταβλητών στο Git (προαιρετικό)
Για να δείτε πώς αναπαρίσταται η βιβλιοθήκη μεταβλητών στο Git ή για να επεξεργαστείτε τις μεταβλητές από ένα αποθετήριο Git:
Στον χώρο εργασίας, επιλέξτε Στοιχείο ελέγχου προέλευσης και συνδέστε τον χώρο εργασίας σε ένα αποθετήριο Git.
Στο παράθυρο ελέγχου Προέλευση , επιλέξτε Δέσμευση για να προωθήσετε το περιεχόμενο του χώρου εργασίας στο αποθετήριο Git.
Το αποθετήριο Git έχει έναν φάκελο για κάθε στοιχείο στον χώρο εργασίας. Ένας φάκελος που ονομάζεται μεταβλητές WS. VariableLibrary αντιπροσωπεύει το στοιχείο βιβλιοθήκης μεταβλητών. Για περισσότερες πληροφορίες σχετικά με τα περιεχόμενα αυτού του φακέλου, ανατρέξτε στο θέμα Βιβλιοθήκη μεταβλητών CI/CD.
Συγκρίνετε τα αρχεία ProdVS.json και TestVS.json στο φάκελο valueSets. Επιβεβαιώστε ότι η
overridesμεταβλητή έχει οριστεί στις διαφορετικές τιμές. Μπορείτε να επεξεργαστείτε αυτές τις τιμές απευθείας στο περιβάλλον εργασίας χρήστη ή με επεξεργασία αυτού του αρχείου στο Git και ενημέρωση του στο χώρο εργασίας.{ "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json", "valueSetName": "Test VS", "overrides": [ { "name": "Source_LH", "value": "4fe228d3-a363-4b7f-a5d4-fae9d2abca43" }, { "name": "DestinationTableName", "value": "TestCopiedData" } ] }{ "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json", "valueSetName": "Prod VS", "overrides": [ { "name": "Source_LH", "value": "c0f13027-9bf4-4e8c-8f57-ec5c18c8656b" }, { "name": "DestinationTableName", "value": "ProdCopiedData" } ] }