Power Query SDK test çerçevesi başvurusu

Bu çok parçalı başvuru, Power Query bağlayıcısı geliştiricileri için standart bir test paketinin kurulumunu ve çalıştırılmasını kapsar. Uzantı bağlayıcınızı test etmek için ortamınızın ayarlandığından emin olmak için başvurunun sırayla izlenmesi amaçlanır.

Bu başvuruda Power Query SDK test çerçevesi, standartlaştırılmış bir test paketi ve NewYork City Taxi &Limousine Commission (TLC) yeşil yolculuk kaydı verilerinin değiştirilmiş bir sürümü kullanılır. Sonraki bölümlerde, uzantı bağlayıcınızı doğrulamak için ortamınızı ayarlama adımlarında izlenmektedir.

Test çerçevesi, Power Query SDK geliştiricilerinin standart testlere ve bir uzantı bağlayıcısının DirectQuery (DQ) özelliklerini doğrulamak için test koşumlarına erişmesini sağlar. Bu yeni özellik sayesinde geliştiriciler, bağlayıcıları doğrulamak için standart bir yönteme ve özel testler eklemek için bir platforma sahiptir. Bunu, Power Query SDK'sı tarafından sağlanan test iş akışının üretkenliğini artırmanın ilk adımı olarak öngörüyoruz.

Power Query SDK test çerçevesi nedir?

Power Query SDK test çerçevesi, yeni ve mevcut uzantı bağlayıcılarının testini standart hale getirmek için önceden oluşturulmuş testlerle hazırto-go bir test gücüdür. İşlevsel, uyumluluk ve regresyon testlerini büyük ölçekte gerçekleştirme özelliğine sahiptir. Uzantı bağlayıcılarının gereksinimlerini karşılamak için kapsamlı bir test çerçevesi gereksinimini gidermeye yardımcı olur.

Geliştirici için iş akışı

Aşağıdaki liste, test çerçevesine sahip tipik Power Query SDK geliştirici iş akışıdır:

1. Power Query SDK Visual Studio Code uzantısını yükleyin: Bağlayıcı geliştiricisinin uzantı bağlayıcısı geliştirmek için PowerQuery SDK Visual Studio Code uzantısını yüklemesi gerekir. Visual Studio Code uzantısı, PQTest.exetest koşumunu da içeren Microsoft.PowerQuery.SdkTools NuGet paketini sarmalar. PQTest test koşumu, test çerçevesinde mevcut testleri yürütmek için yeni karşılaştırma komutunu içerir.
2. DataConnectors GitHub Deposunu kopyalayın: Test çerçevesinde yer alan test verilerine ve testlere erişmek için DataConnectors GitHub deposunu kopyalayın. Bu testler hakkında daha fazla bilgi için PowerQuery SDK test çerçevesi bölüm 3 - Test paketi'ne gidin.
3. Test verilerini veri kaynağına yükleyin: Bağlayıcı geliştiricisinin, iki CSV dosyasından oluşan test verilerini, şemanın sağlanan SQL şema dosyasıyla eşleşmesini sağlayan veri kaynaklarına tablo olarak yüklemesi gerekir. Daha fazla ayrıntı için Power Query SDK test çerçevesi bölüm 2 - Test verileri'ne gidin.
4. Testleri yapılandırın ve çalıştırın: Bağlayıcı geliştiricisinin testleri çalıştırmak için PQTest karşılaştırma komutunu kullanan sağlanan RunPQSDKTestSuites PowerShell yardımcı programını kullanarak çalıştırması gerekir. Daha fazla ayrıntı için Power Query SDK test çerçevesi bölüm 5 - Uzantı bağlayıcınızı test etme bölümüne gidin.
5. Raporlama & CI/CD: Varsayılan test raporu konsolda oluşturulur ve raporu özet, ayrıntılı, TRX ve JSON biçimlerinde oluşturma seçenekleri de vardır. TRX (Visual Studio test sonuçları dosyası) biçimi, bir işlem hattının parçası olarak çalıştırıldığında sonuçları görüntülemek için kullanışlıdır. Daha fazla ayrıntı için Power Query SDK test çerçevesi bölüm 7 - İşlem hattı kılavuzu'na gidin.

Test çerçevesinin hedefleri

Power Query SDK test çerçevesinin uzun vadeli hedefi, uzantı bağlayıcılarını test etmek için Visual Studio Code SDK'sı ile tümleştirilmiş sağlam bir test çözümü sağlamaktır. Bağlayıcıların geliştirilmesi için geliştirici deneyimini büyük ölçüde geliştirmelidir. Ayrıca, standartlaştırmayı oldukça parçalanmış test uygulamalarına getirerek kalite çıtasını artırmalı ve bağlayıcıların sürdürülebilirlik çalışmalarını azaltmalıdır.

Test çerçevesi ilk sürümünün hedefleri şunları sağlamaktır:

• Kullanıcıların uzantı bağlayıcılarını kolayca test etmeleri için kullanımı kolay komut satırı yardımcı programı: Test çerçevesi, testleri çalıştırmak için sezgisel seçeneklerle PQTest karşılaştırma komutunu tanıtır. Ayrıca, toplu teste de yardımcı olan RunPQSDKTestSuites PowerShell yardımcı programını sağlar. Testleri yapılandırmak ve çalıştırmak için kolay ve otomatik yapılandırmalar sağlanır.
• Hazır- bağlayıcıyı doğrulamak için yürütülecek ilk standart test kümesinito-go: Test çerçevesi, test tablolarının şemasını, satır sayısını ve verilerini doğrulamak için bir akıllılık testleri paketi sağlar. Ayrıca Veri Türleri, Matematik, Tarih, Saat, Metin işlevleri, işleçler ve birleşimleri doğrulamak için standart bir test paketi sağlar.
• Testi genişletmek için el ile test eklemenin zahmetsiz yolu: Test çerçevesindeki testler, gerekli yapılandırmaları en aza indirerek test oluşturma işlemini basitleştiren yeni PQ/PQOut test biçimini kullanır. Bağlayıcı geliştiricileri daha sonra test için M sorgusu oluşturmaya odaklanabilir. Her test modülerdir ve bakımı basitleştirmek için ayrı ayrı dosyalara ayrılır. Beklenen çıkış da ilk çalıştırmada oluşturulur.
• Sorgu katlama testlerini test etme özelliği: Test çerçevesi bir bağlayıcı için tanılama da oluşturabilir. Şu anda tanılama özelliği, ODBC tabanlı bağlayıcı için sorguyu katlama sırasında SQL sorgu oluşturma ile sınırlıdır. Bu özellik gelecekte diğer tanılamalara genişletilecek.

Başvuru kılavuzuna genel bakış

Bu kılavuzda şunları yapmak için:

• Power Query SDK test çerçevesi hakkında bilgi edinme.
• Test çerçevesini yükleyerek geliştirme ortamını ayarlamayı öğrenin.
• Test paketinde kullanılan veri kümesini getirin ve uzantı bağlayıcınıza göre bir veri kaynağına yükleyin.
• Test Çerçevesi içindeki dosya biçimleri ve işlevleri olan test biçimi belirtimlerini anlayın.
• Uzantı bağlayıcınızı doğrulama testlerini içeren test paketini getirin ve çalıştırın.
• Farklı yapılandırmalarla tek tek testler çalıştırma.
• Bağlayıcıya özgü işlevselliğinizi doğrulamak için kendi testlerinizi ekleyin.
• Testler için bir işlem hattı ayarlayarak test çalıştırmalarını otomatikleştirin.

Parçalar

Bölüm	section	Ayrıntılar
1	Kurulum	Ortamınızı ayarlayın.
2	Verileri hazırlama	Test verileri hazırlanıyor.
3	Test paketi	Test paketini getirme ve anlama.
4	Test biçimi belirtimi	Test çerçevesinde kullanılan çeşitli dosya biçimlerini anlama.
5	Bağlayıcı testi	Uzantı bağlayıcınızı test etme.
6	Test ekleme	Kendi testlerinizi ekleme ve test çerçevesindeki çeşitli seçenekleri ve yapılandırmaları anlama.
7	İşlem hattı kurulum kılavuzu	Testleri bir işlem hattında çalıştırma.