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

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

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

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

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

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

Στιγμιότυπο οθόνης της αναφοράς σύνδεσης.

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

Στιγμιότυπο οθόνης του αναδυόμενου παραθύρου αναφοράς σύνδεσης.

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

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

Αναγνωριστικό σύνδεσης = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbbbbbb

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

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

  • Αποθηκεύει ένα προκαθορισμένο αναγνωριστικό σύνδεσης σε επίπεδο μισθωτή.
  • Οι αναφορές σύνδεσης δεν συνδέονται αυτόματα κατά την ανάπτυξη. Οι αξίες τους παραμένουν σταθερές σε όλα τα περιβάλλοντα.
  • Υποστηρίζει CI/CD και αυτοματισμό παραμετροποιώντας εξωτερικές συνδέσεις για διαφορετικά περιβάλλοντα (dev, test, prod).
  • Επιτρέπει τη δυναμική ρύθμιση παραμέτρων εξωτερικών σχέσεων (Για παράδειγμα, εναλλαγή προελεύσεων δεδομένων ή διαπιστευτηρίων ανά περιβάλλον).
  • Οι τιμές επιλέγονται μέσω ενός διαλόγου διεπαφής χρήστη, όχι μέσω ελεύθερου κειμένου, διασφαλίζοντας ότι είναι επιλέξιμες μόνο εξουσιοδοτημένες συνδέσεις.
  • Μόνο συνδέσεις με τουλάχιστον δικαιώματα ανάγνωσης είναι διαθέσιμες για επιλογή.

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

Μια αναφορά σύνδεσης είναι ένας σύνθετος τύπος μεταβλητής του οποίου το σχήμα τιμών αποθηκεύει το connectionId (και η πλατφόρμα επιλύει/εμφανίζει μεταδεδομένα). Το ωφέλιμο φορτίο σύνταξης περιλαμβάνει:

  • name: το displayName της μεταβλητής αναφοράς σύνδεσης
  • Σημείωση: Προαιρετικό, μπορεί να χρησιμοποιηθεί για περιγραφή ή άλλες σημειώσεις.
  • τύπος: "connectionReference" (σύνθετος τύπος)
  • value: ανά σύνολο τιμών, κάθε τιμή αποθηκεύει { "connectionId": "<GUID/ID string>" }

Παράδειγμα:


  {
   "name": "PrimaryDb",
   "note": "",
   "type": "connectionReference",
   "value": { "connectionId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" }
  }

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

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

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

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

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

Ακολουθεί μια λίστα στοιχείων που υποστηρίζουν μεταβλητές αναφοράς σύνδεσης:

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

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

var_ref = "$(/**/VarLibItem/ConnectionReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
connection_id = var_obj.get("connectionId").value()
print(connection_id)

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

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

Περιορισμοί

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

  • Οι ενσωματωμένες συνδέσεις στα σημειωματάρια δεν υποστηρίζονται, καθώς η connection_id για τη σύνδεση του σημειωματαρίου δεν είναι η ίδια.

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

  • Last updated on