CI/CD ardışık düzeninde U-SQL derlemelerini yönetmeye yönelik en iyi yöntemler

Bu makalede, U-SQL derleme kaynak kodunu yeni tanıtılan U-SQL veritabanı projesiyle yönetmeyi öğreneceksiniz. Ayrıca, Azure DevOps kullanarak derleme kaydı için bir sürekli tümleştirme ve dağıtım (CI/CD) işlem hattı ayarlamayı öğreneceksiniz.

Derleme kaynak kodunu yönetmek için U-SQL veritabanı projesini kullanma

U-SQL veritabanı projesi , Visual Studio 'da, geliştiricilerin U-SQL veritabanlarını hızlı ve kolay bir şekilde geliştirmesine, yönetmesine ve dağıtmasına yardımcı olan bir proje türüdür. U-SQL veritabanı projesi ile tüm U-SQL veritabanı nesnelerini (kimlik bilgileri hariç) yönetebilirsiniz.

C# derleme kaynak kodunu ve derleme kaydı DDL U-SQL betiklerini yönetmek için şunu kullanın:

  • Derleme kaydı U-SQL betiklerini yönetmek için u-SQL veritabanı projesi.
  • C# kaynak kodunu ve Kullanıcı tanımlı operatörler, işlevleri ve aggreg'leri (UDOs, UDF 'ler ve Udag 'ler) yönetmek için sınıf kitaplığı (U-SQL uygulaması Için).
  • Sınıf kitaplığı projesine başvurmak için U-SQL veritabanı projesi.

Bir U-SQL veritabanı projesi, bir sınıf kitaplığına (U-SQL uygulaması Için) başvurabilir. Bu sınıf kitaplığı (U-SQL uygulaması Için) projesinde başvurulan C# kaynak kodunu kullanarak U-SQL veritabanında kayıtlı derlemeler oluşturabilirsiniz.

Projeler oluşturmak ve başvurular eklemek için bu adımları izleyin.

  1. Dosya > Yeni proje ' ye tıklayarak bir sınıf kitaplığı (U-SQL uygulaması için) projesi oluşturun > . Proje Azure Data Lake > U-SQL düğümü altındadır.

    Visual Studio için Data Lake araçları--C# sınıf kitaplığı projesi oluşturma

  2. Kullanıcı tanımlı C# kodunuzu sınıf kitaplığı (U-SQL uygulaması Için) projesine ekleyin.

  3. Dosya > Yeni proje ' ye tıklayarak bir U-SQL projesi oluşturun > . Proje Azure Data Lake > U-SQL düğümü altındadır.

    Visual Studio için Data Lake araçları--U-SQL veritabanı projesi oluşturma

  4. U-SQL veritabanı projesi için C# sınıf kitaplığı projesine bir başvuru ekleyin.

    Visual Studio için Data Lake araçları-başvuru Ekle

    Visual Studio için Data Lake araçları-U-SQL veritabanı proje başvurusu ekleme

  5. Projeye sağ tıklayıp Yeni öğe Ekle' yi seçerek U-SQL veritabanı projesinde bir derleme betiği oluşturun.

    Visual Studio için Data Lake araçları--derleme betiği Ekle

  6. Derleme betiğini derleme Tasarım görünümünde açın. Başvurudan derleme oluştur açılan menüsünden başvurulan derlemeyi seçin.

    Visual Studio için Data Lake araçları--derlemeden derleme oluştur

  7. Varsa, yönetilen bağımlılıklar ve ek dosyalar ekleyin. Ek dosyalar eklediğinizde, araç, derlemeleri yerel makinenizde ve derleme makinesinde daha sonra bulamediğinden emin olmak için göreli yolu kullanır.

En alttaki düzenleyici penceresinde @ _DeployTempDirectory , Aracı yapı çıkış klasörüne işaret eden önceden tanımlanmış bir değişkendir. Yapı çıktı klasörü altında, her derlemenin derleme adıyla adlı bir alt klasörü vardır. Tüm dll 'Ler ve ek dosyalar bu alt klasörde bulunur.

U-SQL veritabanı projesi oluşturma

U-SQL veritabanı projesi için derleme çıktısı bir U-SQL veritabanı dağıtım paketidir. Bu sonek ile adlandırılır .usqldbpack . .usqldbpackPaket, DDL klasöründeki tek bir U-SQL betiğinin tüm DDL deyimlerini içeren bir. zip dosyasıdır. Derleme için oluşturulan tüm. dll dosyaları ve ek dosyalar geçici klasöründedir.

U-SQL veritabanı dağıtma

.usqldbpackPaket, bir yerel hesaba veya Azure Data Lake Analytics hesabına dağıtılabilir. Visual Studio 'Yu veya dağıtım SDK 'sını kullanın.

Visual Studio 'da bir U-SQL veritabanı dağıtma

Bir u-SQL veritabanı projesi ya da Visual Studio 'da bir paket kullanarak bir U-SQL veritabanı dağıtabilirsiniz .usqldbpack .

U-SQL veritabanı projesi kullanarak dağıtma

  1. U-SQL veritabanı projesine sağ tıklayın ve ardından Dağıt' ı seçin.

  2. U-SQL veritabanı dağıtma sihirbazında, veritabanını dağıtmak Istediğiniz ADLA hesabını seçin. Hem yerel hesaplar hem de ADLA hesapları desteklenir.

  3. Veritabanı kaynağı otomatik olarak doldurulur. Projenin derleme çıkış klasöründeki. ustodbpack paketini işaret eder.

  4. Veritabanı oluşturmak için veritabanı adında bir ad girin. Hedef Azure Data Lake Analytics hesabında aynı ada sahip bir veritabanı zaten varsa, veritabanı projesinde tanımlanan tüm nesneler veritabanı yeniden oluşturulmadan oluşturulur.

  5. U-SQL veritabanını dağıtmak için Gönder' i seçin. Derlemeler ve ek dosyalar gibi tüm kaynaklar karşıya yüklenir. Tüm DDL deyimlerini içeren bir U-SQL işi gönderilir.

    Visual Studio için Data Lake araçları--U-SQL veritabanı projesini dağıtma

    Visual Studio için Data Lake araçları--U-SQL veritabanı proje Sihirbazı 'nı dağıtma

Azure DevOps 'da bir U-SQL veritabanı dağıtma

PackageDeploymentTool.exe U-SQL veritabanlarını dağıtmaya yardımcı olan programlama ve komut satırı arabirimlerini sağlar. SDK, konumunda bulunan U-SQL SDK NuGet paketinedahildir build/runtime/PackageDeploymentTool.exe .

Azure DevOps 'da, U-SQL veritabanı yenilemesi için bir Otomasyon işlem hattı ayarlamak üzere bir komut satırı görevi ve bu SDK kullanabilirsiniz. SDK ve U-SQL veritabanı dağıtımı için BIR CI/CD işlem hattı ayarlama hakkında daha fazla bilgi edinin.

Sonraki adımlar