Χρήση βιβλιοθηκών μεταβλητών Fabric στο Dataflow Gen2

Σημείωση

Για περισσότερες πληροφορίες σχετικά με τον τρόπο αξιοποίησης αυτής της δυνατότητας σε σενάρια συνεχούς ενοποίησης / συνεχούς ανάπτυξης (CI/CD), φροντίστε να διαβάσετε το άρθρο σχετικά με τις αρχιτεκτονικές λύσεων CI/CD και ALM για το Dataflow Gen2 και το ολοκληρωμένο εκπαιδευτικό βοήθημα σχετικά με τις αναφορές μεταβλητών σε μια ροή δεδομένων.

Οι βιβλιοθήκες μεταβλητών Fabric προσφέρουν έναν κεντρικό τρόπο διαχείρισης τιμών ρύθμισης παραμέτρων σε φόρτους εργασίας Microsoft Fabric. Με τη νέα ενοποίηση στο Dataflow Gen2, μπορείτε να αναφέρετε αυτές τις μεταβλητές απευθείας στη ροή δεδομένων σας, επιτρέποντας τη δυναμική συμπεριφορά σε όλα τα περιβάλλοντα και απλοποιώντας τις ροές εργασιών CI/CD.

Προαπαιτούμενα

Για να χρησιμοποιήσετε βιβλιοθήκες μεταβλητών Fabric στο Dataflow Gen2, βεβαιωθείτε για τα εξής:

Μεταβλητές αναφοράς με χρήση widget εισόδου

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

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

Σημείωση

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

Ορισμένα παράθυρα διαλόγου υποστηρίζουν την εμπειρία γραφικών στοιχείων εισόδου και τις βιβλιοθήκες μεταβλητών Fabric, όπως:

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

Στιγμιότυπο οθόνης του παραθύρου διαλόγου επιλογής μεταβλητής που εμφανίζει όλες τις διαθέσιμες βιβλιοθήκες και μεταβλητές στον τρέχοντα χώρο εργασίας.

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

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

Σημείωση

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

Μεταβλητές συναρτήσεις

Μέσα στη ροή δεδομένων Gen2, μπορείτε να αναφέρετε μια μεταβλητή χρησιμοποιώντας μία από τις ακόλουθες συναρτήσεις:

Το αναγνωριστικό που μεταβιβάζετε σε οποιαδήποτε συνάρτηση πρέπει να χρησιμοποιεί την ακόλουθη μορφή:

$(/**/LibraryName/VariableName)

Τα ακόλουθα παραδείγματα προϋποθέτουν μια βιβλιοθήκη μεταβλητών με το όνομα Η βιβλιοθήκη μου και μια μεταβλητή συμβολοσειράς με το όνομα Η μεταβλητή μου:

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")

Variable.Value("$(/**/My Library/My Variable)")

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

Συμβουλή

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

Ζητήματα προς εξέταση και περιορισμοί

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

  • Πεδίο χώρου εργασίας: Οι βιβλιοθήκες μεταβλητών πρέπει να βρίσκονται στον ίδιο χώρο εργασίας με τη ροή δεδομένων Gen2 με CI/CD.

  • Θέση αναφοράς: Οι μεταβλητές μπορούν να χρησιμοποιηθούν μόνο μέσα στο αρχείο mashup.pq μιας ροής δεδομένων Gen2 με CI/CD.

  • Συμπεριφορά χρόνου εκτέλεσης: Οι μεταβλητές τιμές ανακτώνται στην αρχή μιας λειτουργίας εκτέλεσης και διατηρούνται καθ' όλη τη διάρκεια της λειτουργίας. Οι αλλαγές σε μια βιβλιοθήκη κατά τη διάρκεια μιας εκτέλεσης ροής δεδομένων δεν διακόπτουν ούτε επηρεάζουν αυτήν την εκτέλεση.

  • Χρήση προεπιλεγμένης τιμής: Όταν χρησιμοποιείτε μια προεπιλεγμένη τιμή μέσω της συνάρτησης Variable.ValueOrDefault, βεβαιωθείτε ότι ο τύπος δεδομένων της προεπιλεγμένης τιμής ταιριάζει με τον τύπο δεδομένων της μεταβλητής αναφοράς.

  • Υποστηριζόμενοι τύποι: Υποστηρίζονται μόνο μεταβλητές βασικών τύπων (boolean, datetime, guid, integer, number, και string).

  • Σταθερές συνδέσεις: Οι μεταβλητές δεν μπορούν να αλλάξουν τις πληροφορίες σύνδεσης. Οι συνδέσεις παραμένουν σταθερές στις ρυθμίσεις παραμέτρων διαδρομής πόρου που έχουν συνταχθεί.

  • Παράκαμψη κινδύνου: Οι χρήστες με πρόσβαση στην τροποποίηση βιβλιοθηκών μεταβλητών μπορούν να παρακάμψουν τις τιμές μεταβλητών, επηρεάζοντας ενδεχομένως την έξοδο ροής δεδομένων.

  • Αντιστοίχιση σχήματος: Οι μεταβλητές δεν μπορούν να τροποποιήσουν αντιστοιχίσεις σχήματος προορισμού. Οι αντιστοιχίσεις ακολουθούν τη ρύθμιση που έχει συνταχθεί.

  • Ορατότητα διαχρονικής καταγραφής: Οι προβολές διαχρονικής καταγραφής δεν εμφανίζουν συνδέσεις μεταξύ της ροής δεδομένων Gen2 και των βιβλιοθηκών μεταβλητών στις οποίες αναφέρεται.

  • Last updated on