Τύπος μεταβλητής αναφοράς στοιχείου (έκδοση προεπισκόπησης)

Για να βελτιώσουμε την ευελιξία και την επεκτασιμότητα, εισάγουμε προηγμένες μεταβλητές μαζί με τους υπάρχοντες βασικούς τύπους μεταβλητών. Αυτές οι προηγμένες μεταβλητές έχουν σχεδιαστεί για να πληρούν βασικές απαιτήσεις, όπως η παραμετροποίηση εξωτερικών και εσωτερικών συνδέσεων (π.χ. Snowflake, AWS, OneLake).

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

Τρόπος χρήσης

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

1. Είσοδος στο Microsoft Fabric
2. Μεταβείτε στον χώρο εργασίας και τη βιβλιοθήκη μεταβλητών σας
3. Στο επάνω μέρος, επιλέξτε + Νέα μεταβλητή
4. Δώστε ένα όνομα για τη μεταβλητή, επιλέξτε αναφορά στοιχείου για τον τύπο και, στη συνέχεια, κάντε κλικ στο ... για να επιλέξετε μια τιμή
5. Αυτό θα ανοίξει ένα παράθυρο διαλόγου για να επιλέξετε το επιθυμητό στοιχείο. Θα δείτε όλα τα στοιχεία για τα οποία έχετε δικαιώματα, διαθέσιμα για επιλογή. Χρησιμοποιήστε τον εξερευνητή στα αριστερά για να φιλτράρετε τη λίστα κατά χώρο εργασίας. Χρησιμοποιήστε το φίλτρο στην πάνω δεξιά γωνία για να φιλτράρετε κατά τύπο.

6. Μόλις επιλεγεί, θα εμφανιστεί έτσι στη σελίδα varlib - ως στοιχείο μόνο για ανάγνωση που δείχνει το όνομα του στοιχείου.

Εάν πρέπει να επεξεργαστείτε μια αναφορά στοιχείου ή πρέπει να ελέγξετε ξανά την τιμή:

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

Πώς λειτουργεί

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

• WorkspaceID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbbbb
• Αναγνωριστικό στοιχείου = 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

Αυτά τα δύο αναγνωριστικά μαζί προσδιορίζουν μοναδικά το αναφερόμενο στοιχείο.

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

• Οι αναφορές στοιχείων επιτρέπουν την παραμετροποίηση εσωτερικής σύνδεσης, επιτρέποντας στους προγραμματιστές να συνδέουν δυναμικά στοιχεία με συγκεκριμένους πόρους Fabric με βάση το στάδιο ανάπτυξης ή το περιβάλλον χώρου εργασίας.
• Η αναφορά είναι στατική, δείχνει ένα συγκεκριμένο στοιχείο και δεν προσαρμόζεται αυτόματα σε όλα τα περιβάλλοντα.
• Για παραλλαγές που αφορούν συγκεκριμένα στάδια, χρησιμοποιήστε σύνολα τιμών, όπου κάθε σύνολο μπορεί να παραπέμπει σε διαφορετικό στατικό στοιχείο (π.χ. διαφορετικά lakehouses ανά στάδιο).
• Όλες οι τιμές σε όλα τα σύνολα τιμών θα πρέπει να είναι του ίδιου τύπου στοιχείου για να διασφαλιστεί η συμβατότητα και να αποφευχθούν σφάλματα χρόνου εκτέλεσης. Ωστόσο, δεν επιβάλλουμε τον ίδιο τύπο στοιχείου σε όλα τα σύνολα τιμών.

Υποστηριζόμενα στοιχεία

Ακολουθεί μια λίστα με τα στοιχεία που υποστηρίζονται αυτήν τη στιγμή χρησιμοποιώντας την αναφορά στοιχείου:

• Συντόμευση για ένα lakehouse
• Λειτουργίες δεδομένων χρήστη
• Notebook, μέσω του NotebookUtils

Σημείωση

Το Notebook, through %%configure δεν υποστηρίζεται.

Περιορισμοί

Προς το παρόν, μπορείτε να αναφέρετε μόνο υφασμάτινα αντικείμενα και σημασιολογικά μοντέλα. Άλλα στοιχεία Power BI, όπως Datamarts, Dataflow Gen1 δεν υποστηρίζονται προς το παρόν.

Δικαιώματα που απαιτούνται για τη δημιουργία/χρήση αναφορών στοιχείων

Η χρήση μεταβλητών αναφοράς στοιχείου περιλαμβάνει δύο επίπεδα δικαιωμάτων:

• Δημιουργία/Επεξεργασία - Παρόλο που οποιοσδήποτε συμβάλλων χώρου εργασίας μπορεί να τροποποιήσει τις τιμές μεταβλητών, μια μεταβλητή αναφοράς στοιχείου επιτρέπει στους χρήστες να ορίσουν ως στοιχεία τιμών μόνο για τα οποία έχουν δικαιώματα ανάγνωσης. Αυτό ισχύει για οποιαδήποτε τιμή, το προεπιλεγμένο ενεργό σύνολο τιμών ή άλλα σύνολα τιμών. Λάβετε υπόψη ότι κατά την αποθήκευση ενός στοιχείου βιβλιοθήκης μεταβλητών, πραγματοποιείται έλεγχος δικαιωμάτων στις ενεργές τιμές των μεταβλητών αναφοράς στοιχείου για τον χρήστη που αποθηκεύει το στοιχείο, ακόμα κι αν αυτές οι τιμές παραμένουν αμετάβλητες.
• Χρήση μεταβλητής αναφοράς στοιχείου - Κατά τη δημιουργία/ενημέρωση μιας αναφοράς σε μια μεταβλητή σε ένα στοιχείο καταναλωτή, οι χρήστες δεν μπορούν να ορίσουν μια αναφορά σε μια μεταβλητή αναφοράς στοιχείου, εκτός εάν έχουν τουλάχιστον δικαίωμα READ για το στοιχείο στο ενεργό σύνολο τιμών.

Επικύρωση αδειών

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

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

• UI - Κατά τη διάρκεια της ΑΠΟΘΗΚΕΥΣΗΣ του στοιχείου βιβλιοθήκης μεταβλητών, εκτελείται έλεγχος δικαιωμάτων στις ενεργές τιμές των μεταβλητών αναφοράς στοιχείου για το χρήστη που αποθηκεύει το στοιχείο, ακόμα και αν αυτές οι τιμές παραμένουν αμετάβλητες.

• APIs/Git Update - Η επικύρωση δικαιωμάτων πραγματοποιείται κατά τη διάρκεια της ενημέρωσης και αποτυγχάνει εάν δεν υπάρχει δικαίωμα ανάγνωσης στην ενεργή τιμή της αναφοράς στοιχείου του ενημερωμένου χώρου εργασίας.

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

• Προβολή πρόσθετων λεπτομερειών αναφοράς στοιχείου στη σελίδα βιβλιοθήκης μεταβλητών (μόνο περιβάλλον εργασίας χρήστη) Οι χρήστες με πρόσβαση στη βιβλιοθήκη μεταβλητών (πρόγραμμα προβολής WS ή νεότερη έκδοση) που δεν έχουν δικαιώματα για το στοιχείο στη μεταβλητή στοιχείου αναφοράς, δεν θα βλέπουν τις λεπτομέρειες τους στο περιβάλλον εργασίας χρήστη. Αντίθετα, θα βλέπουν το αναγνωριστικό στοιχείου συνοδευόμενο από ένα μήνυμα κατάδειξης και όχι το στοιχείο λεπτομερειών.

• Δημιουργία/Επεξεργασία μεταβλητής αναφοράς στοιχείου

  • UI - Κατά την ενημέρωση της τιμής οποιουδήποτε συνόλου τιμών (Προεπιλογή ή άλλη), ο χρήστης μπορεί να επιλέξει στοιχείο από μια λίστα που εμφανίζει μόνο τα στοιχεία στα οποία έχει τουλάχιστον δικαίωμα ανάγνωσης.
  • APIs/Git Update ή Deployment - δείτε Επεξεργασία στοιχείου βιβλιοθήκης μεταβλητών παραπάνω.

• Χρήση μεταβλητής αναφοράς στοιχείου σε είδος καταναλωτή

  • UI - Δημιουργία αναφοράς σε μεταβλητή - Όταν δημιουργείτε σε ένα στοιχείο μια αναφορά σε μια μεταβλητή "Αναφορά στοιχείου" χρησιμοποιώντας το παράθυρο διαλόγου διεπαφής χρήστη "Επιλογή μεταβλητής" (όπως στη Συντόμευση για το Lakehouse και τη διοχέτευση δεδομένων), υπάρχει επικύρωση ότι ο χρήστης που δημιουργεί την αναφορά έχει τουλάχιστον δικαίωμα ανάγνωσης στα στοιχεία στις μεταβλητές "αναφορά στοιχείου" (η επικύρωση αφορά μόνο τις ενεργές τιμές). Εάν όχι, ο χρήστης βλέπει μόνο το αναγνωριστικό των στοιχείων.

Συμπεριφορά σε διοχετεύσεις CI/CD και στάδια ανάπτυξης

Η Βιβλιοθήκη μεταβλητών ενεργοποιεί το CI/CD για περιεχόμενο Fabric σε όλα τα περιβάλλοντα (Dev, Test, Prod) χρησιμοποιώντας μεταβλητές αναφοράς στοιχείων για διαμορφώσεις για συγκεκριμένα στάδια. Λάβετε υπόψη σας τα εξής:

Στατικές αναφορές

• Οι αναφορές στοιχείων συνδέονται με έναν συγκεκριμένο χώρο εργασίας και αναγνωριστικό στοιχείου.
• Κατά την ανάπτυξη σε ένα νέο στάδιο, αυτές οι αναφορές εξακολουθούν να παραπέμπουν στον αρχικό χώρο εργασίας, εκτός εάν ενημερωθούν με μη αυτόματο τρόπο.
• Χρησιμοποιήστε πολλαπλές Value-Sets για κάθε στάδιο και ενεργοποιήστε το σωστό σύνολο χειροκίνητα ή μέσω σεναρίων API.

Για περισσότερες πληροφορίες, δείτε : σύνολα τιμών σε βιβλιοθήκες μεταβλητών.

Αναπαράσταση σε Git και API

Η διαχείριση της Βιβλιοθήκης Μεταβλητών γίνεται ως κώδικας. Χρησιμοποιώντας Git ή REST API, οι μεταβλητές αναφοράς στοιχείων έχουν σαφή μορφή JSON. Όλες οι μεταβλητές εμφανίζονται στο αρχείο ορισμών της Βιβλιοθήκης Μεταβλητών (αποθηκευμένο στο Git, συνήθως .json), αναφέροντας ιδιότητες όπως όνομα, τύπο και τιμή.

Για μια μεταβλητή αναφοράς στοιχείου (στατική), η τιμή είναι δομημένα δεδομένα για αναγνωριστικά χώρου εργασίας και στοιχείων. Παράδειγμα:

{
 "name": "MyDataLake",
 "note": "",
 "type": "ItemReference",
 "value": {
  "itemId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
 }
}

 

Να θυμάστε τα εξής όταν εργάζεστε μέσω API:

• Αποθηκεύονται μόνο αναγνωριστικά. Τα ονόματα και τα μετα-δεδομένα ανακτώνται κατά τον χρόνο εκτέλεσης ή αποθηκεύονται στο cache στο Fabric.
• Δημιουργώντας/ενημερώνοντας μέσω API, παρέχετε αναγνωριστικά χώρου εργασίας και στοιχείων. Τα μη έγκυρα αναγνωριστικά προκαλούν σφάλματα.

Σχετικό περιεχόμενο

• Επισκόπηση βιβλιοθήκης μεταβλητών
• Τύποι μεταβλητών
• Σύνολα τιμών
• Δικαιώματα βιβλιοθήκης μεταβλητών](./variable-library-permissions.md)