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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Αναπαράσταση σε 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, παρέχετε αναγνωριστικά χώρου εργασίας και στοιχείων. Τα μη έγκυρα αναγνωριστικά προκαλούν σφάλματα.

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

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

Σημείωση

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

Παράδειγμα κώδικα Python

Το παρακάτω παράδειγμα κώδικα δείχνει πώς να χρησιμοποιήσετε μια αναφορά στοιχείου σε ένα σενάριο python.

var_ref = "$(/**/VarLibItem/itemReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
workspace_id = var_obj.get("workspaceId").value()
item_id = var_obj.get("itemId").value()
print(workspace_id)
print(item_id)

Αυτός ο κώδικας κάνει τα εξής:

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

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

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

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

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

Περιορισμοί

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

Πρόσθετες πληροφορίες

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

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

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

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

Σχόλια

Ήταν χρήσιμη αυτή η σελίδα;

Last updated on 2026-03-13