Χρήση δημόσιων παραμέτρων στο Dataflow Gen2

Φιλοδώρημα

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

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

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

Prerequisites

• Μια ροή δεδομένων Gen2 με υποστήριξη CI/CD
• Οι παράμετροι πρέπει να οριστούν στη ροή δεδομένων σας.Μάθετε περισσότερα σχετικά με τον τρόπο ορισμού παραμέτρων ερωτήματος στο Dataflow.

Ενεργοποίηση της δημόσιας λειτουργίας παραμέτρων

Ως κάτοχος της ροής δεδομένων, ανοίξτε τη ροή δεδομένων. Μέσα στην Κεντρική καρτέλα της κορδέλας, επιλέξτε το κουμπί Επιλογές .

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

Επιλέξτε το κουμπί OK για να πραγματοποιήσετε αυτές τις αλλαγές.

Όταν αυτή η λειτουργία είναι ενεργοποιημένη, λαμβάνετε μια ειδοποίηση στο παράθυρο διαλόγου Διαχείριση παραμέτρων με την ένδειξη "Η λειτουργία δημόσιων παραμέτρων είναι ενεργοποιημένη" στο επάνω μέρος του διαλόγου.

Όταν ενεργοποιηθεί η δημόσια λειτουργία παραμέτρου, μπορείτε να αποθηκεύσετε τη ροή δεδομένων σας.

Διαβίβαση προσαρμοσμένων τιμών παραμέτρων για εκτελέσεις ροής δεδομένων

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

• Απαιτούμενες παράμετροι: εάν μια παράμετρος έχει οριστεί ως απαιτείται, για να εκτελεστεί η ροή δεδομένων πρέπει να μεταβιβαστεί μια τιμή στην εργασία εκτέλεσης. Η εκτέλεση αποτυγχάνει εάν δεν μεταβιβαστεί καμία τιμή για μια παράμετρο που έχει οριστεί σε υποχρεωτική.
• Μη απαιτούμενες παράμετροι: ονομάζονται επίσης προαιρετικές παράμετροι και δεν απαιτείται να μεταβιβαστεί καμία τιμή για να ενεργοποιηθεί μια εκτέλεση. Εάν δεν περάσει καμία τιμή, η τρέχουσα τιμή που ορίζεται στην παράμετρο σας χρησιμοποιείται για εκτέλεση.

Χρήση της δραστηριότητας ροής δεδομένων εντός διοχετεύσεων

Note

Συνιστούμε να διαβάσετε περισσότερα σχετικά με τη δραστηριότητα ροής δεδομένων από διοχετεύσεις Fabric για να κατανοήσετε όλες τις δυνατότητές της.

Όταν δημιουργείτε μια διοχέτευση στο Fabric, μπορείτε να χρησιμοποιήσετε τη δραστηριότητα ροής δεδομένων για να ενεργοποιήσετε την εκτέλεση μιας ροής δεδομένων Gen2 με υποστήριξη CI/CD που έχει ενεργοποιημένη τη λειτουργία δημόσιων παραμέτρων.

Μπορείτε να επιλέξετε τη ροή δεδομένων που θέλετε να χρησιμοποιήσετε και να ορίσετε τις παραμέτρους που θέλετε να χρησιμοποιήσετε στην ενότητα Παράμετροι ροής δεδομένων .

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

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

Μπορείτε να επιλέξετε το κουμπί ανανέωσης για να ζητήσετε τις πιο πρόσφατες πληροφορίες παραμέτρων από τη ροή δεδομένων σας.

Υποστηριζόμενοι τύποι παραμέτρων

Φιλοδώρημα

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

Ο παρακάτω πίνακας παρουσιάζει τους τύπους παραμέτρων που υποστηρίζονται αυτήν τη στιγμή και τη σύνδεση προς τον ορισμό του REST API για να κατανοήσει ποιες είναι οι τιμές που αναμένονται από το REST API.

Τύπος παραμέτρου ροής δεδομένων	Ορισμός REST API
Κείμενο	Παράμετρος συμβολοσειράς ροής δεδομένων
Ακέραιος (int64)	DataflowIntegerParameter
Δεκαδικός αριθμός	Παράμετρος DataflowNumberParameter
Ημερομηνία	Παράμετρος DataflowDateParameter
Ημερομηνία/ώρα	Παράμετρος ροής_ημερομηνίας/ώρας
Time	Παράμετρος DataflowTimeParameter
Ζώνη ημερομηνίας/ώρας	Παράμετρος DataflowDateTimeZoneParameter
Duration	Παράμετρος DataflowDurationParameter
Σωστό/Λάθος	DataflowBooleanParameter

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

Ακολουθεί μια λίστα με όλα τα ζητήματα και τους περιορισμούς κατά τη χρήση της λειτουργίας δημόσιων παραμέτρων στο Dataflow Gen2 με CI/CD:

• Προγραμματισμός και μη αυτόματη ενεργοποίηση: Οι ροές δεδομένων με δημόσιες παραμέτρους δεν μπορούν να προγραμματιστούν ή να ενεργοποιηθούν με μη αυτόματο τρόπο μέσω του Fabric, εκτός εάν δεν έχουν οριστεί απαιτούμενες παράμετροι.
• Μη υποστηριζόμενη παραμετροποίηση: Οι παράμετροι που αλλάζουν τις διαδρομές πόρων για προελεύσεις ή προορισμούς δεν υποστηρίζονται. Οι συνδέσεις είναι σταθερές στη διαδρομή σύνταξης.
• Επαυξητική ανανέωση: Δεν είναι συμβατή με τη λειτουργία δημόσιων παραμέτρων.
• Τροποποίηση λογικής: Οι δημόσιες παράμετροι επιτρέπουν στους χρήστες να έχουν πρόσβαση σε τιμές παράκαμψης, αλλάζοντας ενδεχομένως την έξοδο ροής δεδομένων.
• Διανομέας παρακολούθησης: Ο διανομέας παρακολούθησης δεν εμφανίζει τιμές παραμέτρων που χρησιμοποιούνται κατά την εκτέλεση.
• Συμπεριφορά προεργασίας: Μόνο η πιο πρόσφατη εκτέλεση αποθηκεύεται στο Dataflow Staging Lakehouse και επιστρέφεται από τη σύνδεση ροής δεδομένων. Εξετάστε το ενδεχόμενο να χρησιμοποιήσετε έναν προορισμό δεδομένων για να διατηρήσετε δεδομένα για κάθε εκτέλεση.
• Διπλότυπα αιτήματα: Εάν οι ίδιες τιμές παραμέτρων υποβληθούν πολλές φορές, μόνο το πρώτο αίτημα γίνεται αποδεκτό μέχρι να ολοκληρωθεί.
• Αντιστοίχιση σχήματος: Οι παράμετροι δεν μπορούν να τροποποιήσουν αντιστοιχίσεις σχήματος προορισμού. Όλες οι αντιστοιχίσεις ακολουθούν τη διαμόρφωση που έχει συνταχθεί. Ανατρέξτε στο άρθρο για περισσότερες πληροφορίες σχετικά με τους προορισμούς δεδομένων και τις διαχειριζόμενες ρυθμίσεις στο Dataflow Gen2.