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.
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:
U-SQL veritabanı projesi için UDO/UDAG/UDF'yi içeren C# projesine başvurular ekleyin.
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.
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
U-SQL veritabanı projesine sağ tıklayın ve dağıt'ı seçin.
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.
Veritabanı Kaynağı otomatik olarak doldurulur ve projenin derleme çıktı klasöründeki .usqldbpack paketini gösterir.
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.
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.
U-SQL veritabanı dağıtım paketi aracılığıyla dağıtma
Sunucu Gezgini'ne gidin. Ardından veritabanını dağıtmak istediğiniz Azure Data Lake Analytics hesabını genişletin.
U-SQL Veritabanları'nı sağ tıklatın veya basılı tutun ve ardından Veritabanını Dağıt'ı seçin.
Veritabanı Kaynağı'nı U-SQL veritabanı dağıtım paketi (.usqldbpack dosyası) yoluna ayarlayın.
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.
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:
- Proje derleme: U-SQL betiklerini oluşturmadan önce başvuruda bulunılan veritabanı ortamlarını ayarlayın.
- (yerel proje) hesabıyla yerel çalıştırma: Başvuruda bulunılan veritabanı ortamları U-SQL betiği yürütmeden önce (yerel-proje) hesaba dağıtılır. Yerel çalıştırmalar ve (yerel makine) ile (yerel proje) hesabı arasındaki farklar hakkında daha fazla bilgiyi burada bulabilirsiniz.
U-SQL veritabanı başvurusu ekleme
Çözüm Gezgini'da U-SQL projesine sağ tıklayın ve ardından U-SQL Veritabanı Başvurusu Ekle...'yi seçin.
Geçerli çözümde veya U-SQL veritabanı paket dosyasındaki bir U-SQL veritabanı projesinden veritabanı başvurusu yapılandırın.
Veritabanının adını belirtin.