Προσθήκη περιγραφών αντικειμένων σχήματος σε έναν παράγοντα δεδομένων (έκδοση προεπισκόπησης)

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

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

Σημείωση

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

Σημείωση

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

Προσθήκη ή επεξεργασία περιγραφής

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

  1. Ανοίξτε τον παράγοντα δεδομένων και, στη συνέχεια, επιλέξτε Ρύθμιση.
  2. Κάτω από την προέλευση δεδομένων, επιλέξτε Περιγραφές αντικειμένων σχήματος.
  3. Αναπτύξτε το σχήμα για να βρείτε το αντικείμενο που θέλετε να περιγράψετε.
  4. Επιλέξτε το εικονίδιο Επεξεργασία δίπλα στο αντικείμενο.
  5. Πληκτρολογήστε μια περιγραφή και, στη συνέχεια, επιλέξτε Τέλος.

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

Προσθήκη περιγραφής με το Python SDK

Χρησιμοποιήστε το Python SDK του παράγοντα δεδομένων Fabric για να διαχειριστείτε τις περιγραφές αντικειμένων σχήματος μέσω προγραμματισμού. Το παρακάτω παράδειγμα ορίζει μια περιγραφή για έναν πίνακα στην πρώτη προέλευση δεδομένων ενός υπάρχοντος παράγοντα δεδομένων:

from fabric.dataagent.client import FabricDataAgentManagement

agent = FabricDataAgentManagement("<data-agent-name>")
datasource = agent.get_datasources()[0]

table_path = ("Schemas", "dbo", "Tables", "adoptions")
datasource.update_description({
    table_path: "Contains one row for each pet adoption transaction."
})

Η πλειάδα προσδιορίζει το στοιχείο σχήματος από τη διαδρομή του στην προέλευση δεδομένων. Για να περιγράψετε μια στήλη, προσθέστε το όνομά της στη διαδρομή του πίνακα. Για παράδειγμα, χρησιμοποιήστε το table_path + ("adoption_date",). Τα ονόματα διαδρομών κάνουν διάκριση πεζών-κεφαλαίων και πρέπει να συμφωνούν με την ιεραρχία που εμφανίζεται για την προέλευση δεδομένων.

Γράψτε αποτελεσματικές περιγραφές

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

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

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

  • Last updated on