Azure Data Lake Analytics kodunuzu test etme
Azure Data Lake, U-SQL dilini sağlar. U-SQL, herhangi bir ölçekte verileri işlemek Için bildirim temelli SQL 'i tanımlayıcı C# ile birleştirir. Bu belgede, U-SQL ve genişletilmiş C# Kullanıcı tanımlı operatör (UDO) kodu için test çalışmaları oluşturmayı öğreneceksiniz.
U-SQL betiklerini test etme
U-SQL betiği derlenir ve çalıştırılabilir kodun Azure 'da veya yerel bilgisayarınızda çalışması için iyileştirilmiştir. Derleme ve iyileştirme işlemi, tüm U-SQL betiğini bir bütün olarak değerlendirir. Her bildiri için geleneksel birim testi yapamazsınız. Ancak, U-SQL test SDK 'sını ve yerel çalışma SDK 'sını kullanarak betik düzeyinde testler yapabilirsiniz.
U-SQL betiği için test çalışmaları oluşturma
Visual Studio için Azure Data Lake Araçları, U-SQL betik test çalışmaları oluşturmanızı sağlar.
Çözüm Gezgini ' de bir U-SQL komut dosyasına sağ tıklayın ve ardından birim testi oluştur' u seçin.
Yeni bir test projesi oluşturun veya var olan bir test projesine test durumunu ekleyin.
Test veri kaynağını yönetme
U-SQL betiklerini test ettiğinizde, test giriş dosyaları gerekir. Test verilerini yönetmek için, Çözüm Gezgini' de, U-SQL projesine sağ tıklayın ve Özellikler' i seçin. Test veri kaynağına bir kaynak girebilirsiniz.
Initialize()U-SQL test SDK 'sında arabirimini çağırdığınızda, test projesinin çalışma dizini altında geçici bir yerel veri kök klasörü oluşturulur. U-SQL betik test çalışmalarını çalıştırmadan önce, test veri kaynağı klasöründeki tüm dosyalar ve klasörler geçici yerel veri kök klasörüne kopyalanır. Test veri klasörü yolunu noktalı virgülle ayırarak daha fazla test veri kaynağı klasörü ekleyebilirsiniz.
Test için veritabanı ortamını yönetme
U-SQL komut dosyalarınız U-SQL veritabanı nesneleriyle kullanıyorsa veya sorgulardaysa, U-SQL test çalışmalarını çalıştırmadan önce veritabanı ortamını başlatmalısınız. Saklı yordamlar çağrılırken bu yaklaşım gerekli olabilir. Initialize()U-SQL test SDK 'sindeki arabirim, u-SQL projesi tarafından başvurulan tüm veritabanlarını, test projesinin çalışma dizinindeki geçici yerel veri kök klasörüne dağıtmanıza yardımcı olur.
U-SQL projesi için U-SQL veritabanı proje başvurularını yönetme hakkında daha fazla bilgi için, bkz. u-SQL veritabanı projesine başvuru.
Test sonuçlarını doğrula
Run()Arabirim bir iş yürütme sonucu döndürür. 0 başarılı anlamına gelir ve 1 hata anlamına gelir. Çıkışları doğrulamak için C# onaylama işlevlerini de kullanabilirsiniz.
Visual Studio 'da test çalışmalarını çalıştırma
Bir U-SQL betiği test projesi, C# birim testi çerçevesinin üzerine kurulmuştur. Projeyi derledikten sonra, Test > Windows > Test Gezgini' ni seçin. Test Gezgini'nden test çalışmalarını çalıştırabilirsiniz. Alternatif olarak, birim testinizde. cs dosyasına sağ tıklayın ve Testleri Çalıştır' ı seçin.
C# UDOs 'yi test etme
C# UDOs için test çalışmaları oluşturma
C# Kullanıcı tanımlı operatörlerinizi (UDOs) test etmek için C# birim testi çerçevesini kullanabilirsiniz. Uıdos test edilirken, karşılık gelen IRowset nesnelerini giriş olarak hazırlamanız gerekir.
IRowset nesnesi oluşturmanın iki yolu vardır:
IRowset oluşturmak için bir dosyadaki verileri yükleme:
//Schema: "a:int, b:int" USqlColumn<int> col1 = new USqlColumn<int>("a"); USqlColumn<int> col2 = new USqlColumn<int>("b"); List<IColumn> columns = new List<IColumn> { col1, col2 }; USqlSchema schema = new USqlSchema(columns); //Generate one row with default values IUpdatableRow output = new USqlRow(schema, null).AsUpdatable(); //Get data from file IRowset rowset = UnitTestHelper.GetRowsetFromFile(@"processor.txt", schema, output.AsReadOnly(), discardAdditionalColumns: true, rowDelimiter: null, columnSeparator: '\t');IRowset oluşturmak için bir veri koleksiyonundaki verileri kullanın:
//Schema: "a:int, b:int" USqlSchema schema = new USqlSchema( new USqlColumn<int>("a"), new USqlColumn<int>("b") ); IUpdatableRow output = new USqlRow(schema, null).AsUpdatable(); //Generate Rowset with specified values List<object[]> values = new List<object[]>{ new object[2] { 2, 3 }, new object[2] { 10, 20 } }; IEnumerable<IRow> rows = UnitTestHelper.CreateRowsFromValues(schema, values); IRowset rowset = UnitTestHelper.GetRowsetFromCollection(rows, output.AsReadOnly());
Test sonuçlarını doğrula
UıDO işlevlerini çağırırsanız, C# onay işlevlerini kullanarak şema ve satır kümesi değer doğrulama aracılığıyla sonuçları doğrulayabilirsiniz. Çözümünüze bir U-SQL C# UıDO birim testi projesi ekleyebilirsiniz. Bunu yapmak için, Visual Studio 'da dosya > yeni > proje ' yi seçin.
Visual Studio 'da test çalışmalarını çalıştırma
Projeyi derledikten sonra, Test > Windows > Test Gezgini' ni seçin. Test Gezgini'nden test çalışmalarını çalıştırabilirsiniz. Alternatif olarak, birim testinizde. cs dosyasına sağ tıklayın ve Testleri Çalıştır' ı seçin.
Azure Pipelines 'de test çalışmalarını çalıştırma
Hem U-SQL betik testi projeleri hem de c# Udo test projeleri , c# birim testi projelerini devralınır. Azure Pipelines içindeki Visual Studio test görevi bu test çalışmalarını çalıştırabilir.
Azure Pipelines 'de U-SQL test çalışmalarını çalıştırma
U-SQL testi için, yapı bilgisayarınıza yüklediğinizden emin olun CPPSDK ve CPPSDK yolu ' ye geçirin USqlScriptTestRunner(cppSdkFolderFullPath: @"") .
CPPSDK nedir?
CPPSDK, Microsoft Visual C++ 14 ve Windows SDK 10.0.10240.0 içeren bir pakettir. Bu paket, U-SQL çalışma zamanı için gereken ortamı içerir. Bu paketi Visual Studio için Azure Data Lake Araçları yükleme klasörü altında edinebilirsiniz:
- Visual Studio 2015 için
C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\Extensions\Microsoft\Microsoft Azure Data Lake Tools for Visual Studio 2015\X.X.XXXX.X\CppSDK - Visual Studio 2017 için
C:\Program Files (x86)\Microsoft Visual Studio\2017\<Visual Studio Edition>\SDK\ScopeCppSDK - Visual Studio 2019 için
C:\Program Files (x86)\Microsoft Visual Studio\2019\<Visual Studio Edition>\SDK\ScopeCppSDK
Azure Pipelines yapı aracısında CPPSDK hazırlama
Azure Pipelines CPPSDK bağımlılığını hazırlamanın en yaygın yolu aşağıdaki gibidir:
CPPSDK kitaplıklarını içeren klasörü ZIP.
Kaynak denetim sisteminize. zip dosyasını iade edin. . Zip dosyası, bir dosya nedeniyle dosyaların yoksayılmaması için CPPSDK klasörü altındaki tüm kitaplıkları iade almanızı sağlar
.gitignore.Derleme ardışık düzeninde. zip dosyasını açın.
USqlScriptTestRunnerYapı bilgisayarında bu zip 'lenmiş bir klasöre işaret edin.
Azure Pipelines C# UDO test çalışmalarını çalıştırma
Bir C# UDO testi için, Uıdos için gereken aşağıdaki derlemelere başvurduğunuzdan emin olun.
- Microsoft. Analytics. Interfaces
- Microsoft. Analytics. Types
- Microsoft. Analytics. UnitTest
Bunlara Microsoft. Azure. DataLake. USQL. Interfaces NuGet paketiaracılığıyla başvurdıysanız, yapı ardışık düzenine bir NuGet geri yükleme görevi eklediğinizden emin olun.