Εκτέλεση κώδικα T-SQL σε σημειωματάρια Python Fabric

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

Στα σημειωματάρια Python Microsoft Fabric, παρουσιάσαμε μια νέα δυνατότητα που ονομάζεται μαγική εντολή T-SQL. Αυτή η δυνατότητα σάς επιτρέπει να εκτελείτε κώδικα T-SQL απευθείας σε σημειωματάρια Python με πλήρη επισήμανση σύνταξης και ολοκλήρωση κώδικα. Αυτό σημαίνει ότι μπορείτε να συντάξετε κώδικα T-SQL σε ένα σημειωματάριο Python και θα εκτελεστεί σαν να ήταν ένα κελί T-SQL. Αυτή η δυνατότητα είναι χρήσιμη για μηχανικούς δεδομένων που θέλουν να χρησιμοποιήσουν την ισχύ του T-SQL ενώ εξακολουθούν να χρησιμοποιούν την ευελιξία των σημειωματάριων Python.

Σε αυτό το άρθρο, θα εξερευνήσουμε την εντολή μαγείας T-SQL στα σημειωματάρια Microsoft Fabric. Καλύπτουμε τον τρόπο ενεργοποίησης αυτής της εντολής, τον καθορισμό της αποθήκης που θα χρησιμοποιηθεί και τον τρόπο σύνδεσης των αποτελεσμάτων των ερωτημάτων T-SQL με μεταβλητές Python.

Αυτή η δυνατότητα είναι διαθέσιμη για σημειωματάρια Python Fabric. Πρέπει να ορίσετε τη γλώσσα σε Python στο σημειωματάριο και τον τύπο κελιού σε T-SQL.

Important

Αυτή η δυνατότητα βρίσκεται προεπισκόπηση.

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

Για να ενεργοποιήσετε τη μαγική εντολή T-SQL στο σημειωματάριό σας Fabric, πρέπει να ορίσετε τη %%tsql μαγική εντολή στην αρχή του κελιού σας. Αυτή η εντολή υποδεικνύει ότι ο κώδικας σε αυτό το κελί θα πρέπει να αντιμετωπίζεται ως κώδικας T-SQL.

Σε αυτό το παράδειγμα, χρησιμοποιούμε την εντολή μαγείας T-SQL για να υποβάλετε ερώτημα σε μια Αποθήκη δεδομένων Fabric. Η εντολή λαμβάνει τις ακόλουθες παραμέτρους:

• Η -artifact παράμετρος καθορίζει το όνομα της αποθήκης δεδομένων που θα χρησιμοποιηθεί. Ο κώδικας T-SQL στο κελί εκτελείται έναντι της καθορισμένης αποθήκης δεδομένων στο Fabric.
• Η -type παράμετρος καθορίζει τον τύπο του στοιχείου Fabric. Για το Fabric Data Warehouse, χρησιμοποιήστε το Warehouse.
• Η -bind παράμετρος καθορίζει το όνομα της μεταβλητής για σύνδεση των αποτελεσμάτων του ερωτήματος T-SQL. Στο παρακάτω παράδειγμα, τα αποτελέσματα του ερωτήματος αποθηκεύονται σε μια μεταβλητή Python με την ονομασία df1. Εάν θέλετε να εφαρμόσετε οποιονδήποτε μετασχηματισμό στη μεταβλητή df1, μπορείτε να το κάνετε χρησιμοποιώντας κώδικα Python στο επόμενο κελί. Η -bind παράμετρος είναι προαιρετική, αλλά συνιστάται να συνδέσετε τα αποτελέσματα του ερωτήματος T-SQL σε μια μεταβλητή Python. Αυτή η παράμετρος σάς επιτρέπει να χειρίζεστε και να αναλύετε εύκολα τα αποτελέσματα χρησιμοποιώντας κώδικα Python.
• Η -workspace παράμετρος είναι προαιρετική και χρησιμοποιείται εάν η αποθήκη βρίσκεται σε διαφορετικό χώρο εργασίας. Χωρίς αυτήν την παράμετρο, το σημειωματάριο χρησιμοποιεί τον τρέχοντα χώρο εργασίας.

%%tsql -artifact dw1 -type Warehouse -bind df1
SELECT TOP (10) [GeographyID],
            [ZipCodeBKey],
            [County],
            [City],
            [State],
            [Country],
            [ZipCode]
FROM [dw1].[dbo].[Geography]

Εάν παραλειφθούν και οι δύο -artifact-type παράμετροι, το σημειωματάριο χρησιμοποιεί το προεπιλεγμένο στοιχείο αποθήκης στο τρέχον σημειωματάριο.

Χρήση μαγικής εντολής T-SQL για την υποβολή ερωτήματος σε βάση δεδομένων SQL

Μπορείτε επίσης να χρησιμοποιήσετε τη μαγική εντολή T-SQL για να υποβάλετε ερώτημα σε μια βάση δεδομένων SQL στο Fabric. Η σύνταξη είναι παρόμοια με την υποβολή ερωτημάτων σε μια αποθήκη δεδομένων, αλλά η -type παράμετρος πρέπει να οριστεί σε SQLDatabase. Η -bind παράμετρος καθορίζει το όνομα της μεταβλητής για σύνδεση των αποτελεσμάτων του ερωτήματος T-SQL.

Στο παρακάτω παράδειγμα, το αποτέλεσμα του ερωτήματος αποθηκεύεται σε μια μεταβλητή Python με την ονομασία df2.

%%tsql -artifact sqldb1 -type SQLDatabase -bind df2
SELECT TOP (10) [AddressID]
      ,[AddressLine1]
      ,[AddressLine2]
      ,[City]
      ,[StateProvince]
      ,[CountryRegion]
      ,[PostalCode]
      ,[rowguid]
      ,[ModifiedDate]
  FROM [SalesLT].[Address];

Χρήση της μαγικής εντολής T-SQL για την υποβολή ερωτημάτων στο τελικό σημείο ανάλυσης SQL lakehouse

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

Στο παρακάτω παράδειγμα, το αποτέλεσμα του ερωτήματος αποθηκεύεται σε μια μεταβλητή Python με την ονομασία df3.

%%tsql -artifact lakehouse1 -type Lakehouse -bind df3
SELECT TOP (10) [ProductID],
      [Name],
      [ProductNumber],
      [Color],
      [StandardCost],
      [ListPrice]
FROM [lakehouse1].[dbo].[Product];

Χρήση της μαγικής εντολής T-SQL ως μαγεία γραμμής

Αντί να εκτελείτε την T-SQL σε ένα κελί πλήρους κώδικα με %%tsql, μπορείτε να εκτελέσετε την T-SQL σε μία γραμμή με %tsql ως μαγική γραμμή. Ωστόσο, πρέπει πρώτα να δημιουργήσετε μια σύνδεση συνεδρίας.

Important

Πριν χρησιμοποιήσετε %tsql τη μαγική γραμμή, πρέπει να εκτελέσετε μια %%tsql μαγική εντολή κελιού με την -session παράμετρο για να αρχικοποιήσετε το μαγικό περιβάλλον SQL. Η εκτέλεση %tsql χωρίς αυτήν τη ρύθμιση θα έχει ως αποτέλεσμα ένα SQLMagicContextInitializationExceptionαρχείο .

Προϋποθέσεις για μαγεία γραμμής

1. Αρχικοποίηση της συνεδρίας: Σε ένα κελί που χρησιμοποιεί τη %%tsql μαγική εντολή, συμπεριλάβετε την παράμετρο -session για να καθορίσετε το περιβάλλον σύνδεσης. Για παράδειγμα:

   %%tsql -artifact ContosoDWH -type Warehouse -session
   SELECT TOP(10) * FROM [ContosoDWH].[dbo].[Geography];
   

2. Χρησιμοποιήστε τη μαγεία γραμμής: Μετά την προετοιμασία της συνεδρίας, μπορείτε να τη χρησιμοποιήσετε %tsql στα ακόλουθα κελιά. Η μαγική γραμμή θα χρησιμοποιήσει τη σύνδεση που δημιουργήθηκε στο βήμα 1 χωρίς να απαιτείται να καθορίσετε -artifact και -type ξανά. Για παράδειγμα:

   df = %tsql SELECT TOP(10) * FROM [ContosoDWH].[dbo].[Geography];
   

Αναφορά μεταβλητών Python στο T-SQL

Μπορείτε επίσης να αναφέρετε μεταβλητές Python σε κώδικα T-SQL. Για να το κάνετε αυτό, χρησιμοποιήστε το {} σύμβολο ακολουθούμενο από το όνομα της μεταβλητής Python. Για παράδειγμα, εάν έχετε μια μεταβλητή Python με την ονομασία count, μπορείτε να την αναφέρετε ως εξής στον κώδικά σας T-SQL:

count = 10

df = %tsql SELECT TOP({count}) * FROM [dw1].[dbo].[Geography];

Για να δείτε την πλήρη σύνταξη, χρησιμοποιήστε την %tsql? εντολή . Αυτή η εντολή εμφανίζει τις πληροφορίες βοήθειας για την εντολή μαγείας T-SQL, συμπεριλαμβανομένων των διαθέσιμων παραμέτρων και των περιγραφών τους.

Note

Μπορείτε να εκτελέσετε τις πλήρεις εντολές DML και DDL στην αποθήκη δεδομένων ή τη βάση δεδομένων SQL, αλλά μόνο για ανάγνωση σε σχέση με το τελικό σημείο SQL lakehouse.

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

Για περισσότερες πληροφορίες σχετικά με τα σημειωματάρια Fabric, ανατρέξτε στα παρακάτω άρθρα.

• Questions? Δοκιμάστε να ρωτήσετε την κοινότητα Fabric.
• Suggestions? Συνεισφέρετε ιδέες για τη βελτίωση του Fabric.