Azure Data Lake için U-SQL veritabanı geliştirmek için U-SQL veritabanı projesi kullanma

Önemli

Azure Data Lake Analytics 29 Şubat 2024'te kullanımdan kaldırıldı. Bu duyuruyla daha fazla bilgi edinin.

Veri analizi için kuruluşunuz Azure Synapse Analytics veya Microsoft Fabric kullanabilir.

U-SQL veritabanı, tablolardaki yapılandırılmamış veriler ve yönetilen yapılandırılmış veriler üzerinde yapılandırılmış görünümler sağlar. Ayrıca, yapılandırılmış verilerinizi ve özel kodunuzu düzenlemek için genel bir meta veri kataloğu sistemi sağlar. Veritabanı, bu ilgili nesneleri birlikte gruplandıran kavramdır.

U-SQL veritabanı ve Veri Tanımı Dili (DDL) hakkında daha fazla bilgi edinin.

U-SQL veritabanı projesi, Visual Studio'da geliştiricilerin U-SQL veritabanlarını hızlı ve kolay bir şekilde geliştirmelerine, yönetmelerine ve dağıtmalarına yardımcı olan bir proje türüdür.

U-SQL veritabanı projesi oluşturma

Visual Studio için Azure Data Lake Araçları, 2.3.3000.0 sürümünden sonra U-SQL veritabanı projesi adlı yeni bir proje şablonu ekledi. U-SQL projesi oluşturmak için Dosya > Yeni Proje'yi >seçin. U-SQL Veritabanı Projesi , Azure Data Lake > U-SQL düğümü altında bulunabilir.

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

Veritabanı projesi kullanarak U-SQL veritabanı nesneleri geliştirme

U-SQL veritabanı projesine sağ tıklayın. Yeni öğe ekle > seçeneğini seçin. Desteklenen tüm yeni nesne türlerini Yeni Öğe Ekleme Sihirbazı'nda bulabilirsiniz.

Derleme olmayan bir nesne (örneğin, tablo değerli bir işlev) için, yeni bir öğe ekledikten sonra yeni bir U-SQL betiği oluşturulur. Düzenleyicide bu nesne için DDL deyimini geliştirmeye başlayabilirsiniz.

Bir derleme nesnesi için araç, derlemeyi kaydetmenize ve DLL dosyalarını ve diğer dosyaları dağıtmanıza yardımcı olan kullanıcı dostu bir kullanıcı arabirimi düzenleyicisi sağlar. Aşağıdaki adımlarda U-SQL veritabanı projesine bir derleme nesnesi tanımının nasıl ekleneceği gösterilmektedir:

  1. U-SQL veritabanı projesi için UDO/UDAG/UDF'yi içeren C# projesine başvurular ekleyin.

    Visual Studio için Data Lake Araçları - Başvuru ekle

    Visual Studio için Data Lake Araçları - U-SQL veritabanı proje referansı ekleme

  2. Derleme tasarımı görünümünde, Başvurudan derleme oluştur açılan menüsünden başvuruda bulunılan derlemeyi seçin.

    Visual Studio için Data Lake Araçları--referanstan derleme oluşturma

  3. Varsa Yönetilen Bağımlılıklar ve Ek Dosyalar ekleyin. Ek dosyalar eklediğinizde araç, derlemeleri hem yerel makinenizde hem de daha sonra derleme makinesinde bulabileceğinden emin olmak için göreli yolu kullanır.

@_DeployTempDirectory, aracı derleme çıktı klasörüne işaret eden önceden tanımlanmış bir değişkendir. Derleme çıktısı klasörünün altında, her derlemenin derleme adıyla adlandırılan bir alt klasörü vardır. Tüm DLL'ler ve ek dosyalar bu alt klasörde yer alır.

U-SQL veritabanı projesi oluşturma

U-SQL veritabanı projesinin derleme çıktısı, sonekiyle .usqldbpackadlandırılan bir U-SQL veritabanı dağıtım paketidir. Paket .usqldbpack , DDL klasöründeki tek bir U-SQL betiğindeki tüm DDL deyimlerini ve Temp klasöründeki derlemeler için tüm DLL'leri ve ek dosyaları içeren bir .zip dosyasıdır.

MSBuild komut satırı ve Azure DevOps Services derleme göreviyle U-SQL veritabanı projesi oluşturma hakkında daha fazla bilgi edinin.

U-SQL veritabanı dağıtma

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

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

Visual Studio'da U-SQL veritabanı projesi veya .usqldbpack paketi aracılığıyla U-SQL veritabanı dağıtabilirsiniz.

U-SQL veritabanı projesi aracılığıyla 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 ve projenin derleme çıktı klasöründeki .usqldbpack paketini gösterir.

  4. Veritabanı oluşturmak için Veritabanı Adı alanına 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ını yeniden oluşturmadan oluşturulur.

  5. U-SQL veritabanını dağıtmak için Gönder öğesini seçin. Tüm kaynaklar (derlemeler ve ek dosyalar) yüklendi ve tüm DDL deyimlerini içeren bir U-SQL işi gönderildi.

    Visual Studio için Data Lake Araçları--U-SQL veritabanı projesinin dağıtımı

    Visual Studio için Data Lake Araçları - U-SQL veritabanı projesi dağıtım sihirbazı

U-SQL veritabanı dağıtım paketi aracılığıyla dağıtma

  1. Sunucu Gezgini'ne gidin. Ardından veritabanını dağıtmak istediğiniz Azure Data Lake Analytics hesabını genişletin.

  2. U-SQL Veritabanları'nı sağ tıklatın veya basılı tutun ve ardından Veritabanını Dağıt'ı seçin.

  3. Veritabanı Kaynağı'nı U-SQL veritabanı dağıtım paketi (.usqldbpack dosyası) yoluna ayarlayın.

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

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

    Visual Studio için Data Lake Araçları--U-SQL veritabanı paketi dağıtma sihirbazı

SDK kullanarak U-SQL veritabanını dağıtma

PackageDeploymentTool.exe U-SQL veritabanlarını dağıtmaya yardımcı olan programlama ve komut satırı arabirimlerini sunmaktadır. U-SQL SDK NuGet paketi içindeki SDK, build/runtime/PackageDeploymentTool.exe konumunda bulunur.

SDK ve U-SQL veritabanı dağıtımı için CI/CD işlem hattını ayarlama hakkında daha fazla bilgi edinin.

U-SQL veritabanı projesine başvurma

U-SQL projesi bir U-SQL veritabanı projesine başvurabilir. Başvuru iki iş yükünü etkiler:

U-SQL veritabanı başvurusu nasıl eklenir

  1. Çözüm Gezgini'nde U-SQL projesine sağ tıklayın ve ardından U-SQL Veritabanı Başvurusu Ekle...'yi seçin.

    Visual Studio için Data Lake Araçları -- veritabanı projesi başvurusu ekleme

  2. Geçerli çözümde veya U-SQL veritabanı paket dosyasındaki bir U-SQL veritabanı projesinden veritabanı başvurusu yapılandırın.

  3. Veritabanının adını belirtin.

    Visual Studio için Data Lake Araçları veritabanı proje referansı ekleme sihirbazı

Sonraki Adımlar