Menggunakan proyek database U-SQL untuk mengembangkan database U-SQL untuk Azure Data Lake

Penting

Azure Data Lake Analytics pensiun pada 29 Februari 2024. Pelajari lebih lanjut dengan pengumuman ini.

Untuk analitik data, organisasi Anda dapat menggunakan Azure Synapse Analytics atau Microsoft Fabric.

Database U-SQL menyediakan tampilan terstruktur atas data yang tidak terstruktur dan data terstruktur terkelola di tabel. Selain itu, menyediakan sistem katalog metadata umum untuk mengatur data terstruktur dan kode kustom Anda. Database adalah konsep yang menyatukan objek terkait ini.

Pelajari selengkapnya tentang database U-SQL dan Bahasa Definisi Data (DDL).

Proyek database U-SQL adalah jenis proyek di Visual Studio yang membantu pengembang dalam mengembangkan, mengelola, dan menerapkan database U-SQL dengan cepat dan mudah.

Membuat proyek database U-SQL

Azure Data Lake Tools for Visual Studio menambahkan templat proyek baru yang disebut proyek database U-SQL setelah versi 2.3.3000.0. Untuk membuat proyek U-SQL, pilih File > Proyek Baru>. Proyek U-SQL Database dapat ditemukan di bawah simpul Azure Data Lake > U-SQL.

Data Lake Tools for Visual Studio--buat proyek database U-SQL

Mengembangkan objek database U-SQL menggunakan proyek database

Klik kanan proyek database U-SQL. Pilih Tambahkan > Item baru. Anda dapat menemukan semua jenis objek baru yang didukung di Wizard Tambahkan Item Baru.

Untuk objek non-perakitan (misalnya, fungsi bernilai tabel), skrip U-SQL baru dibuat setelah Anda menambahkan item baru. Anda dapat mulai mengembangkan pernyataan DDL untuk objek tersebut di editor.

Untuk objek assembly, alat ini menyediakan editor UI yang mudah digunakan yang membantu Anda mendaftarkan assembly dan menyebarkan file DLL dan file lainnya. Langkah-langkah berikut ini menunjukkan kepada Anda cara menambahkan definisi objek perakitan ke proyek database U-SQL:

  1. Tambahkan referensi ke proyek C# yang menyertakan UDO/UDAG/UDF untuk proyek database U-SQL.

    Data Lake Tools for Visual Studio - Menambahkan referensi

    Data Lake Tools for Visual Studio - Tambahkan referensi proyek database U-SQL

  2. Dalam tampilan desain perakitan, pilih perakitan yang direferensikan dari Buat perakitan dari referensi menu tarik turun.

    Data Lake Tools for Visual Studio--membuat perakitan dari referensi

  3. Tambahkan Dependensi Terkelola dan File Tambahan jika ada. Ketika Anda menambahkan file tambahan, alat ini menggunakan jalur relatif untuk memastikan dapat menemukan rakitan pada komputer lokal maupun pada komputer build nantinya.

@_DeployTempDirectory adalah variabel yang telah ditentukan sebelumnya yang mengarahkan alat ke folder output build. Pada folder output build, setiap perakitan memiliki subfolder yang dinamai dengan nama perakitan. Semua DLL dan file tambahan ada di subfolder tersebut.

Membangun proyek database U-SQL

Output build untuk proyek database U-SQL adalah paket penyebaran database U-SQL, dinamai dengan akhiran .usqldbpack. Paket .usqldbpack ini adalah file .zip yang mencakup semua pernyataan DDL dalam satu skrip U-SQL di folder DDL, dan semua DLL dan file tambahan untuk rakitan di folder Temp.

Pelajari selengkapnya tentang cara membangun proyek database U-SQL dengan baris perintah MSBuild dan tugas bangun Azure DevOps Services.

Menyebarkan database U-SQL

Paket .usqldbpack dapat disebarkan ke akun lokal atau akun Azure Data Lake Analytics menggunakan Visual Studio atau SDK penyebaran.

Menyebarkan database U-SQL di Visual Studio

Anda dapat menyebarkan database U-SQL melalui proyek database U-SQL atau paket .usqldbpack di Visual Studio.

Menyebarkan melalui proyek database U-SQL

  1. Klik kanan proyek database U-SQL, lalu pilih Sebarkan.

  2. Dalam Wizard Menyebarkan U-SQL Database, pilih akun Data Lake Analytics yang ingin Anda sebarkan databasenya. Ini mendukung akun lokal dan akun Data Lake Analytics.

  3. Sumber Database diisi secara otomatis, dan mengarah ke paket .usqldbpack di folder output build proyek.

  4. Masukkan nama di Nama Database untuk membuat database. Jika database dengan nama yang sama sudah ada di akun Data Lake Analytics, semua objek yang ditentukan dalam proyek database dibuat tanpa membuat ulang database.

  5. Untuk menggunakan database U-SQL, pilih Kirim. Semua sumber daya (rakitan dan file tambahan) diunggah, dan pekerjaan U-SQL yang mencakup semua pernyataan DDL akan dikirimkan.

    Data Lake Tools for Visual Studio--Menyebarkan proyek database U-SQL

    Data Lake Tools for Visual Studio--Wizard menyebarkan proyek database U-SQL

Menyebarkan paket penyebaran database U-SQL

  1. Buka Penjelajah Server. Lalu perluas akun Azure Data Lake Analytics yang ingin Anda sebarkan databasenya.

  2. Klik kanan atau tekan dan tahan Database U-SQL, lalu pilih Sebarkan Database.

  3. Atur Sumber Database ke jalur paket penyebaran database U-SQL (file.usqldbpack).

  4. Masukkan Nama Database untuk membuat database. Jika ada database dengan nama yang sama yang sudah ada di akun azure Data Lake Analytics target, semua objek yang ditentukan dalam proyek database dibuat tanpa membuat ulang database.

    Data Lake Tools for Visual Studio--Menyebarkan paket database U-SQL

    Data Lake Tools for Visual Studio--Wizard menyebarkan paket database U-SQL

Menyebarkan database U-SQL menggunakan SDK

PackageDeploymentTool.exe menyediakan antarmuka pemrograman dan baris perintah yang membantu menyebarkan database U-SQL. SDK disertakan dalam paket U-SQL SDK NuGet, yang terletak di build/runtime/PackageDeploymentTool.exe.

Pelajari selengkapnya tentang SDK dan cara menyiapkan alur CI/CD untuk penyebaran database U-SQL.

Mereferensikan proyek database U-SQL

Proyek U-SQL dapat mereferensikan proyek database U-SQL. Referensi ini mempengaruhi dua beban kerja:

Cara menambahkan referensi database U-SQL

  1. Klik kanan proyek U-SQL di Penjelajah Solusi, lalu pilih Tambahkan Referensi U-SQL Database... .

    Data Lake Tools for Visual Studio -- tambahkan referensi proyek database U-SQL

  2. Mengonfigurasi referensi database dari proyek database U-SQL di solusi saat ini atau di file paket database U-SQL.

  3. Berikan nama untuk database.

    Data Lake Tools for Visual Studio, wizard tambahkan referensi proyek database U-SQL

Langkah berikutnya