Visual Studio Code kullanarak satır içi Python Kusto Sorgu Dili hatalarını ayıklama

Şunlar için geçerlidir: ✅Microsoft Fabric✅Azure Veri Gezgini

Python() eklentisini kullanarak Kusto Sorgu Dili sorgulara Python kodu ekleyebilirsiniz. Eklenti çalışma zamanı yalıtılmış ve güvenli bir Python ortamı olan korumalı alanda barındırılır. python() eklenti özelliği, Kusto Sorgu Dili yerel işlevleri OSS Python paketlerinin büyük arşiviyle genişletir. Bu uzantı, sorgunun bir parçası olarak makine öğrenmesi, yapay zeka, istatistiksel ve zaman serisi gibi gelişmiş algoritmalar çalıştırmanızı sağlar.

Kusto Sorgu Dili araçları Python algoritmaları geliştirmek ve hata ayıklamak için uygun değildir. Bu nedenle algoritmayı Jupyter, PyCharm, Visual Studio veya Visual Studio Code gibi sık kullandığınız Python ile tümleşik geliştirme ortamında geliştirin. Algoritma tamamlandığında kopyalayıp KQL'ye yapıştırın. Bu iş akışını geliştirmek ve kolaylaştırmak için Kusto Explorer veya Web UI istemcileri, satır içi Python kodu yazmak ve hata ayıklamak için Visual Studio Code ile tümleştirebilir.

Not

Bu iş akışı yalnızca görece küçük giriş tablolarında (en fazla birkaç MB) hata ayıklamak için kullanılabilir. Bu nedenle, hata ayıklama için girişi sınırlamanız gerekebilir. Büyük bir tabloyu işlemeniz gerekiyorsa, , | sampleveya where rand() < 0.xkullanarak | takehata ayıklama için sınırlayın.

Önkoşullar

• Microsoft Fabric özellikli kapasiteye sahip bir çalışma alanı.
• Bir veritabanı. KQL veritabanı oluşturma.
• Python Anaconda Dağıtım'ı yükleyin. Gelişmiş Seçenekler'de PATH ortam değişkenime Anaconda ekle'yi seçin.
• Visual Studio Code’u yükleyin.
• Visual Studio Code için Python uzantısını yükleyin.
• Python eklentisini etkinleştirin.

Visual Studio Code'da Python hata ayıklamasını etkinleştirme

1. İstemci uygulamanızda, ile satır içi Python içeren bir sorguya ön ek ekleyin set query_python_debug;

2. Sorguyu çalıştırın.

   • Kusto Gezgini: Visual Studio Code, debug_python.py betiğiyle otomatik olarak başlatılır.
   • KQL sorgu kümesi:
     1. debug_python.py, df.txt ve kargs.txt indirip kaydedin. Pencerede İzin Ver'i seçin. Dosyaları seçili dizine kaydedin .
     2. debug_python.py sağ tıklayın ve Visual Studio Code ile açın. debug_python.py betiği, df.txt giriş veri çerçevesini ve kargs.txt parametrelerin sözlüğünü başlatmak için şablon kodu tarafından ön ekli KQL sorgusundaki satır içi Python kodunu içerir.

3. Visual Studio Code'da Visual Studio Code hata ayıklayıcısını başlatın: Hata Ayıklamayı Başlat 'ı (F5) çalıştırın>, Python yapılandırması'nı seçin. Hata ayıklayıcı başlatılır ve satır içi kodun hatalarını ayıklamak için otomatik olarak bir kesme noktası ayarlar.

Visual Studio Code'da satır içi Python hata ayıklaması nasıl çalışır?

1. Sorgu ayrıştırılır ve gerekli | evaluate python() yan tümcesine ulaşılana kadar sunucuda yürütülür.
2. Python korumalı alanı çağrılır ancak kodu çalıştırmak yerine giriş tablosunu, parametrelerin sözlüğü ve kodu seri hale getirerek istemciye geri gönderir.
3. Bu üç nesne üç dosyaya kaydedilir: df.txt, kargs.txt ve seçili dizinde (Web UI) veya istemci %TEMP% dizininde (Kusto Gezgini) debug_python.py .
4. Visual Studio Code başlatılır, ilgili dosyalarından df ve kargs'ı başlatmak için bir ön ek kodu içeren debug_python.py dosyası ve ardından KQL sorgusuna eklenmiş Python betiği ile birlikte yüklenir.

Sorgu örneği

1. İstemci uygulamanızda aşağıdaki KQL sorgusunu çalıştırın:

   range x from 1 to 4 step 1
   | evaluate python(typeof(*, x4:int), 
   'exp = kargs["exp"]\n'
   'result = df\n'
   'result["x4"] = df["x"].pow(exp)\n'
   , bag_pack('exp', 4))
   

   Sonuçta elde edilen tabloya bakın:

   x	x4
   1	Kategori 1
   2	16
   3	81
   4	Kategori 256

2. kullanarak set query_python_debug;istemci uygulamanızda aynı KQL sorgusunu çalıştırın:

   set query_python_debug;
   range x from 1 to 4 step 1
   | evaluate python(typeof(*, x4:int), 
   'exp = kargs["exp"]\n'
   'result = df\n'
   'result["x4"] = df["x"].pow(exp)\n'
   , bag_pack('exp', 4))
   

3. Visual Studio Code başlatılır:

   

4. Visual Studio Code hata ayıklama konsolunda 'result' veri çerçevesinde hata ayıklar ve yazdırır:

   

Not

Python korumalı alan görüntüsü ile yerel yüklemeniz arasında farklar olabilir. Eklentiyi sorgulayarak belirli paketler için korumalı alan görüntüsünü denetleyin.

Not

Visual Studio Code hata ayıklama oturumu başlatılırken hatalar olması durumunda, varsayılan terminal profilini komut istemi olarak ayarlamayı deneyin:

• Komut Paleti'ni açmak için CTRL + SHIFT + P tuşlarına basın.
• "Terminal: Varsayılan Profili Seç" araması yapın ve "Komut İstemi" seçeneğini belirleyin