Κοινοποίηση μέσω

Χρήση βιβλιοθηκών μεταβλητών Fabric στο Dataflow Gen2 (Έκδοση προεπισκόπησης)

Σημείωση

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

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

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

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

Τρόπος χρήσης βιβλιοθηκών μεταβλητών Fabric στο Dataflow Gen2

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

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

$(/**/LibraryName/VariableName)

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

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

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

Εφαρμόζοντας αυτήν τη συνάρτηση σε μια δέσμη ενεργειών ερωτήματος, ας πάρουμε το παρακάτω παράδειγμα ερωτήματος που συνδέεται σε έναν πίνακα με το όνομα Table1 από ένα συγκεκριμένο LakehouseId και WorkspaceId χρησιμοποιώντας τη σύνδεση Fabric Lakehouse.

let
  Source = Lakehouse.Contents([]),
  #"Navigation 1" = Source{[workspaceId = "cfafbeb1-8037-4d0c-896e-a46fb27ff229"]}[Data],
  #"Navigation 2" = #"Navigation 1"{[lakehouseId = "5b218778-e7a5-4d73-8187-f10824047715"]}[Data],
  #"Navigation 3" = #"Navigation 2"{[Id = "Table1", ItemKind = "Table"]}[Data]
in
  #"Navigation 3"

Σκοπεύετε να αντικαταστήσετε τις τιμές που έχουν περάσει για το workspaceId και lakehouseId έτσι ώστε σε σενάρια CI/CD να δείχνει δυναμικά στο σωστό στοιχείο στο σωστό στάδιο.

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

Όνομα μεταβλητής Τύπος μεταβλητής Προεπιλεγμένο σύνολο τιμών
Αναγνωριστικό χώρου εργασίας Συμβολοσειρά A8A1BFFA-7EEA-49DC-A1D2-6281C1D031F1
Αναγνωριστικό Lakehouse Συμβολοσειρά 37DC8A41-DEA9-465D-B528-3E95043B2356

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

let
  Source = Lakehouse.Contents([]),
  #"Navigation 1" = Source{[workspaceId = Variable.ValueOrDefault("$(/**/My Library/Workspace ID)",  "cfafbeb1-8037-4d0c-896e-a46fb27ff229")]}[Data],
  #"Navigation 2" = #"Navigation 1"{[lakehouseId =  Variable.ValueOrDefault("$(/**/My Library/Lakehouse ID)","5b218778-e7a5-4d73-8187-f10824047715")]}[Data],
  #"Navigation 3" = #"Navigation 2"{[Id = "Table1", ItemKind = "Table"]}[Data]
in
  #"Navigation 3"

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

Προσοχή

Το πρόγραμμα επεξεργασίας Power Query δεν υποστηρίζει προς το παρόν την αξιολόγηση μεταβλητών. Συνιστούμε να χρησιμοποιήσετε τη συνάρτηση Variable.ValueOrDefault για να εξασφαλίσετε ότι η εμπειρία σύνταξης χρησιμοποιεί την προεπιλεγμένη τιμή για τη δημιουργία πρωτοτύπων.

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

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

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

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

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

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

  • Υποστήριξη προγράμματος επεξεργασίας Power Query: Δεν υπάρχει τρέχουσα υποστήριξη για την επίλυση ή την αξιολόγηση μεταβλητών στο πρόγραμμα επεξεργασίας Power Query.

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

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

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

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

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

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

  • Όριο μεταβλητών: Οι ροές δεδομένων μπορούν να ανακτήσουν έως και 50 μεταβλητές.

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

  • Last updated on