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

Önemli

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

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

U-SQL veritabanı, yapılandırılmamış veriler ve tablolardaki 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ştirmesine, yönetmesine ve dağıtması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 ekledik. 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'yi >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österilir:

  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 ekleme

    Visual Studio için Data Lake Araçları - U-SQL veritabanı proje başvurusu 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ı--başvurudan 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 bulabilmesini sağlamak 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 adlı 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ı projesi için derleme çıkışı, adlı bir U-SQL veritabanı dağıtım paketidir..usqldbpack .usqldbpack Paket, 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 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'i seçin. Tüm kaynaklar (derlemeler ve ek dosyalar) karşıya yüklenir ve 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ı projesini dağıtma 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ı 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 paketinebuild/runtime/PackageDeploymentTool.exe dahildir.

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 ekleme

  1. Çözüm Gezgini'da 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 başvurusu ekleme sihirbazı

Sonraki adımlar