Fabric αποθήκη δεδομένων Διακομιστής MCP (Προεπισκόπηση)

Ισχύει για:✅ Τελικό σημείο ανάλυσης SQL και Αποθήκη στο Microsoft Fabric

Ο απομακρυσμένος διακομιστής MCP Fabric αποθήκη δεδομένων είναι ένα φιλοξενούμενο τελικό σημείο MCP που επιτρέπει στους πράκτορες AI να συνεργάζονται με μια αποθήκη χρησιμοποιώντας φυσική γλώσσα. Χτισμένο στο Model Context Protocol (MCP), παρέχει στους πράκτορες έναν ελεγχόμενο τρόπο εκτέλεσης δηλώσεων T-SQL μέσω του executeSQL εργαλείου, επιθεώρησης αποτελεσμάτων και επανάληψης σε πραγματικό περιβάλλον αποθήκης, με σεβασμό στα δικαιώματα Fabric και τα όρια ασφαλείας.

Αυτό το άρθρο σας δείχνει πώς να:

• Συνδεθείτε στον απομακρυσμένο διακομιστή Fabric αποθήκη δεδομένων MCP στο Visual Studio Code

• Ρύθμιση παραμέτρων του καθολικού τελικού σημείου ή ενός τελικού σημείου σε επίπεδο στοιχείου

• Χρησιμοποιήστε GitHub Copilot για να δημιουργήσετε και να εκτελέσετε T-SQL έναντι Fabric αποθήκη δεδομένων

• Επικύρωση της σύνδεσης με ερωτήματα δοκιμής

Prerequisites

Πριν ξεκινήσετε, βεβαιωθείτε ότι έχετε:

• Visual Studio Code: Εγκαταστήστε την πιο πρόσφατη έκδοση του Visual Studio Code.

  • Λήψη του Visual Studio Code

• GitHub Copilot: Εγκαταστήστε και συνδεθείτε στο GitHub Copilot και στο GitHub Copilot Chat στο Visual Studio Code.

  • Επέκταση GitHub Copilot
  • GitHub Copilot Chat επέκταση

• Fabric αποθήκη δεδομένων πρόσβαση: Χρειάζεστε πρόσβαση σε τουλάχιστον ένα τελικό σημείο ανάλυσης Fabric αποθήκη δεδομένων ή SQL.

• Δικαιώματα αποθήκης: Χρειάζεστε τον απαιτούμενο χώρο εργασίας Fabric και δικαιώματα SQL για να εκτελέσετε τις προτάσεις T-SQL που ζητάτε από τον εκπρόσωπο να εκτελέσει.

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

Επιλέξτε ένα τελικό σημείο

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

Καθολικό τελικό σημείο

Όταν θέλετε να συνδεθείτε στον διακομιστή Fabric αποθήκη δεδομένων MCP, παρέχετε το περιβάλλον αποθήκης μέσω προτροπών ή ορισμάτων εργαλείων χρησιμοποιώντας το καθολικό τελικό σημείο:

https://api.fabric.microsoft.com/v1/mcp/dataPlane/sqlEndpoint

Τελικό σημείο σε επίπεδο στοιχείου

Χρησιμοποιήστε το τελικό σημείο σε επίπεδο στοιχείου όταν θέλετε η σύνδεση διακομιστή MCP να είναι συνδεδεμένη με ένα συγκεκριμένο στοιχείο Fabric αποθήκη δεδομένων.

https://api.fabric.microsoft.com/v1/mcp/dataPlane/workspaces/<workspace-id>/items/<item-id>/sqlEndpoint

Αντικαταστήσει:

• <workspace-id>με το αναγνωριστικό χώρου εργασίας Fabric.

• <item-id>με το αναγνωριστικό Fabric αποθήκη δεδομένων στοιχείου.

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

Ρύθμιση στον κώδικα του Visual Studio

Διαμορφώστε τον Fabric αποθήκη δεδομένων διακομιστή MCP στο Visual Studio Code προσθέτοντας τη διαμόρφωση διακομιστή στο αρχείο ρυθμίσεων MCP. Επιλέξτε μεταξύ του καθολικού τελικού σημείου για ευέλικτη επιλογή αποθήκης ή του τελικού σημείου σε επίπεδο είδους για να συνδέσετε τη σύνδεση με μια συγκεκριμένη αποθήκη.

Επιλογή 1: Ρύθμιση παραμέτρων του καθολικού τελικού σημείου

Προσθέστε την ακόλουθη διαμόρφωση διακομιστή στο αρχείο διαμόρφωσης Visual Studio Code MCP:

{
   "servers": {
      "fabric-dw-global": {
         "type": "http",
         "url": "https://api.fabric.microsoft.com/v1/mcp/dataPlane/sqlEndpoint"
      }
   }
}

Αφού αποθηκεύσετε τη διαμόρφωση, επανεκκινήστε ή ανανεώστε τους διακομιστές MCP στον κώδικα του Visual Studio Code.

Επιλογή 2: Ρύθμιση παραμέτρων του τελικού σημείου σε επίπεδο στοιχείου

Προσθέστε την ακόλουθη διαμόρφωση διακομιστή στο αρχείο διαμόρφωσης Visual Studio Code MCP:

{
   "servers": {
      "fabric-dw-item": {
         "type": "http",
         "url": "https://api.fabric.microsoft.com/v1/mcp/dataPlane/workspaces/<workspace-id>/items/<item-id>/sqlEndpoint"
      }
   }
}

Αντικαταστήστε το <workspace-id> και το <item-id> με τις τιμές για την αποθήκη σας.

Αφού αποθηκεύσετε τη διαμόρφωση, επανεκκινήστε ή ανανεώστε τους διακομιστές MCP στον κώδικα του Visual Studio Code.

Δοκιμή της σύνδεσής σας

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

1. Εκκινήστε τον διακομιστή MCP στο Visual Studio Code.

   • Ανοίξτε τον πίνακα διακομιστών MCP.

   • Επιβεβαιώστε ότι ο διακομιστής MCP Fabric αποθήκη δεδομένων εμφανίζεται ως συνδεδεμένος.

2. Ανοίξτε το GitHub Copilot Chat.

   • Εκκινήστε το Copilot Chat στο Visual Studio Code.

   • Ενεργοποίηση λειτουργίας παράγοντα.

3. Παρέχετε το περιβάλλον αποθήκης εάν χρησιμοποιείτε το καθολικό τελικό σημείο.

   • Εάν ρυθμίσατε τις παραμέτρους του καθολικού τελικού σημείου, πείτε στο Copilot ποια αποθήκη να χρησιμοποιήσει με μια προτροπή όπως:

     Use the Fabric Data Warehouse named SalesDW in the Sales Analytics workspace.
     

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

4. Κάντε μια ερώτηση.

   • Παράδειγμα:

   What tables and views are in this warehouse?
   

   • Παράδειγμα:

   Show me the top 10 products by sales revenue.
   

5. Εξουσιοδοτήστε τη χρήση του εργαλείου.

   • Όταν σας ζητηθεί, ελέγξτε και εγκρίνετε την executeSQL κλήση εργαλείου.

   • Πραγματοποιήστε έλεγχο ταυτότητας με τα διαπιστευτήριά σας Microsoft, εάν σας ζητηθεί.

6. Ελέγξτε την απάντηση.

   • Copilot χρησιμοποιεί τον διακομιστή Fabric αποθήκη δεδομένων MCP για να εκτελέσει την εγκεκριμένη δήλωση T-SQL και επιστρέφει το αποτέλεσμα στη συνομιλία.

Διαθέσιμα εργαλεία

Ο διακομιστής MCP Fabric αποθήκη δεδομένων εκθέτει ένα εργαλείο.

Εργαλείο	Περιγραφή
executeSQL	Εκτελεί μια εγκεκριμένη πρόταση T-SQL έναντι Fabric αποθήκη δεδομένων και επιστρέφει το αποτέλεσμα.

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

Για παράδειγμα, αντί να καλέσει ένα ξεχωριστό εργαλείο εντοπισμού πίνακα, ο εκπρόσωπος μπορεί να χρησιμοποιήσει executeSQL ένα ερώτημα έναντι INFORMATION_SCHEMA.TABLES ή άλλες υποστηριζόμενες προβολές συστήματος.

Επικύρωση με δείγματα προτροπών

Χρησιμοποιήστε αυτές τις προτροπές για να επιβεβαιώσετε ότι ο διακομιστής μπορεί να δημιουργήσει T-SQL, να εκτελέσει T-SQL και να εξηγήσει τα αποτελέσματα.

Εξερευνήστε αντικείμενα αποθήκης

• Καταγράψτε όλα τα σχήματα σε αυτήν την αποθήκη.

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

• Εμφάνιση των στηλών, των τύπων δεδομένων και της δυνατότητας nullability για τον dbo.Customers πίνακα.

Δημιουργία και εκτέλεση T-SQL

• Γράψτε και εκτελέστε ένα ερώτημα T-SQL που επιστρέφει τα 10 κορυφαία προϊόντα με βάση τα έσοδα.

• Εκτελέστε ένα ερώτημα που μετράει γραμμές κατά κατάσταση παραγγελίας στον Orders πίνακα.

• Δημιουργήστε ένα ερώτημα που ενώνει Ordersτα , Customers, Productsκαι Regions για να εμφανίσετε τα έσοδα κατά περιοχή.

Κατανόηση και βελτίωση ερωτημάτων

• Εξηγήστε τι κάνει αυτό το ερώτημα T-SQL πριν το εκτελέσετε.

• Ξαναγράψτε αυτό το ερώτημα για να το κάνετε πιο ευανάγνωστο χωρίς να αλλάξετε το αποτέλεσμα.

• Προτείνετε βελτιώσεις σε αυτό το μοτίβο ερωτήματος και, στη συνέχεια, εμφανίστε την αναθεωρημένη T-SQL.

Παρακολούθηση δραστηριότητας αποθήκης

• Εμφάνιση πρόσφατης δραστηριότητας ερωτήματος για αυτήν την αποθήκη.

• Βρείτε μακροχρόνια ερωτήματα ή συνεδρίες που μπορεί να χρειάζονται προσοχή.

• Συνοψίστε τις πρόσφατες αποτυχίες ερωτημάτων και ομαδοποιήστε τις κατά πιθανή βασική αιτία.

Note

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

Ασφάλεια και δικαιώματα

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

Κλήσεις εργαλείων που executeSQL θα πρέπει να απαιτούν ρητή έγκριση χρήστη στο πρόγραμμα-πελάτη MCP. Ελέγξτε την T-SQL που δημιουργήθηκε πριν επιτρέψετε executeSQL την εκτέλεση, ειδικά για λειτουργίες εγγραφής όπως CREATE, ALTER, DROP, INSERT, UPDATE, ή DELETE.

Χρησιμοποιήστε πρόσβαση με ελάχιστα δικαιώματα για αποθήκες παραγωγής.

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

Αντιμετώπιση προβλημάτων

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

Ο διακομιστής MCP δεν εμφανίζεται ως συνδεδεμένος

Επιβεβαιώστε ότι η ρύθμιση παραμέτρων MCP έχει αποθηκευτεί σωστά, ότι η διεύθυνση URL τελικού σημείου είναι σωστή και ότι επανεκκινήσατε ή ανανεώσατε τους διακομιστές MCP στο Visual Studio Code μετά την πραγματοποίηση αλλαγών.

Το Copilot δεν μπορεί να βρει την αποθήκη

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

Ο έλεγχος ταυτότητας αποτυγχάνει

Εισέλθετε ξανά με τον Λογαριασμός Microsoft σας. Βεβαιωθείτε ότι χρησιμοποιείτε τον σωστό μισθωτή και κατάλογο.

Οι κλήσεις εργαλείων αποτυγχάνουν με σφάλματα δικαιωμάτων

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

Ο πράκτορας δεν μπορεί να παραθέσει σχήματα ή πίνακες

Ο διακομιστής εκθέτει executeSQLμόνο . Ζητήστε από τον πράκτορα να χρησιμοποιήσει ερωτήματα μετα-δεδομένων SQL αντί να περιμένετε ξεχωριστά εργαλεία εντοπισμού σχήματος.

Παράδειγμα:

Use executeSQL with INFORMATION_SCHEMA views to list the tables in this warehouse.

Τα αποτελέσματα του ερωτήματος είναι απροσδόκητα

Ρωτήστε το Copilot να εμφανίσει την T-SQL που δημιουργήθηκε πριν από την εκτέλεση. Εξετάστε τα ονόματα πινάκων, τους συνδέσμους, τα φίλτρα, τη λογική ημερομηνίας και τη λογική συνάθροισης πριν εγκρίνετε την κλήση εργαλείου.

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

• Διακομιστές MCP στον κώδικα του Visual Studio Code