Bagikan melalui

Mengembangkan proyek gudang di Visual Studio Code

Diterapkan pada:✅ Gudang di Microsoft Fabric

Pelajari cara menyiapkan proyek database untuk Fabric Data Warehouse di Visual Studio Code. Anda akan membuat proyek baru, menentukan objek skema, membangun dan memvalidasi proyek, dan menerbitkannya ke gudang Anda.

Prasyarat

Sebelum memulai, pastikan Anda:

  • Dapatkan akses ke item Gudang yang ada dalam ruang kerja Fabric dengan hak akses Kontributor atau lebih tinggi.
  • Instal Visual Studio Code di stasiun kerja Anda.
  • Instal .NET SDK untuk membangun dan menerbitkan proyek database.
  • Instal dua ekstensi Visual Studio Code: Proyek SQL Database dan SQL Server (mssql).
    • Anda dapat menginstal ekstensi yang diperlukan langsung dari dalam marketplace Visual Studio Code dengan mencari "Proyek SQL Database" atau "SQL Server (mssql)".

Membuat proyek database baru

Anda dapat membuat proyek database dari awal atau gudang yang ada.

Opsi 1: Buat proyek database baru dari Palet Perintah di Visual Studio Code

  1. Buka Visual Studio Code.

  2. Buka Palet Perintah (Ctrl+Shift+P atau Cmd+Shift+P di Mac).

  3. Cari Proyek Basis Data: Baru.

  4. Pilih Jenis Proyek Database sebagai Database SQL Server.

  5. Pilih nama proyek dan pilih lokasi folder lokal.

  6. Pilih Gudang Data Synapse di Microsoft Fabric sebagai platform target.

  7. Saat diminta, pilih Ya (disarankan) untuk proyek gaya SDK.

    Penting

    Hanya proyek bergaya SDK yang didukung untuk Fabric Data Warehouse.

  8. Pilih Ya untuk pertanyaan Apakah Anda ingin mengonfigurasi build proyek SQL sebagai konfigurasi build default untuk folder ini?

  9. Pilih Ya untuk mempercayai penulis file dalam folder ini.

Opsi 2: Buat proyek database baru dari ekstensi Proyek Database

  1. Di Visual Studio Code, pilih ikon ekstensi Proyek Database dari Bilah Aktivitas.

  2. Di panel Proyek Database , pilih Buat baru.

    Cuplikan layar dari Visual Studio Code memperlihatkan panel ekstensi Proyek Database dan tombol Buat baru.

  3. Pilih Jenis Proyek Database sebagai Database SQL Server.

  4. Pilih nama proyek dan pilih lokasi folder lokal.

  5. Pilih Gudang Data Synapse di Microsoft Fabric sebagai platform target.

  6. Saat diminta, pilih Ya (disarankan) untuk proyek gaya SDK. Hanya proyek bergaya SDK yang didukung untuk Fabric Data Warehouse.

  7. Pilih Ya untuk pertanyaan Apakah Anda ingin mengonfigurasi build proyek SQL sebagai konfigurasi build default untuk folder ini?

  8. Pilih Ya untuk mempercayai penulis file dalam folder ini.

Opsi 3: Membuat proyek database dari gudang yang sudah ada

  1. Pertama, buat profil koneksi baru untuk gudang Anda di Visual Studio Code.

    1. Pilih ekstensi SQL Server di Visual Studio Code dari Bilah Aktivitas.
    2. Berikan Nama Profil. Pilih Parameter.
    3. Berikan Nama server. Di portal Fabric, di Pengaturan gudang data Anda, dapatkan string Titik Akhir SQL. (Ini berbeda dari titik akhir analitik SQL.) Sepertinya <server unique ID>.datawarehouse.fabric.microsoft.com. Ini adalah Nama server.
    4. Untuk Jenis autentikasi, gunakan MICROSOFT Entra ID - Universal dengan dukungan MFA. Autentikasi dengan ID Microsoft Entra Anda.
    5. Berikan informasi lain sebagai default, atau diinginkan, dan pilih Sambungkan.

  2. Di Visual Studio Code, pilih ikon ekstensi Proyek Database dari Bilah Aktivitas.

  3. Pilih tombol ... opsi dari panel Proyek Database dan pilih opsi Buat Proyek Dari Database .

    Cuplikan layar dari Visual Studio Code memperlihatkan opsi Buat Proyek dari Database.

  4. Pilih gudang Anda dari profil koneksi yang ada.

  5. Berikan nama proyek dan pilih folder proyek di stasiun kerja Anda.

  6. Untuk struktur folder, pilih Skema/Jenis Objek (disarankan).

  7. Untuk Sertakan izin dalam proyek, pilih Tidak (default).

  8. Untuk proyek bergaya SDK, pilih Ya (disarankan).

  9. Pilih Ya untuk pertanyaan Apakah Anda ingin mengonfigurasi build proyek SQL sebagai konfigurasi build default untuk folder ini?

  10. Visual Studio Code mengekstrak file proyek dari proyek gudang.

    Cuplikan layar dari Visual Studio Code memperlihatkan pemberitahuan kemajuan file proyek ekstrak.

  11. Setelah berhasil mengekstrak, Anda akan melihat pemberitahuan berikut: "Ekstrak file proyek: Berhasil. Selesai".

  12. Pilih Ya untuk mempercayai penulis file dalam folder ini.

Proyek database baru untuk gudang Anda

Proyek database baru untuk gudang Anda ditampilkan di menu Proyek SQL Database.

Cuplikan layar dari Visual Studio Code memperlihatkan proyek database baru untuk AdventureWorksDW2022.

Struktur proyek Anda terlihat seperti ini:

 | Project Name
 ├── Database References
 ├── SQLCMD Variables
 ├── .vscode/
 └── schema/
     ├── Functions
     ├── Tables
     └── Views

Mengonfigurasi proyek database

  1. Klik kanan pada proyek dan pilih Edit File .sqlproj.

    Cuplikan layar dari Visual Studio Code dan menu konteks proyek database. Opsi Edit File sqlproj disorot.

  2. Verifikasi versi terbaru Microsoft.Build.Sql SDK ada dalam file. Misalnya, dalam .sqlproj file, ubah versi untuk Microsoft.Build.Sql menjadi 2.0.0.

       <Sdk Name="Microsoft.Build.Sql" Version="2.0.0" />

  3. Verifikasi versi terbaru Microsoft.SqlServer.Dacpacs.FabricDw, dan tambahkan referensi di dalam simpul Project/ItemGroup XML. Contohnya:

       <PackageReference Include="Microsoft.SqlServer.Dacpacs.FabricDw" Version="170.0.2" />

    Ini adalah bagaimana proyek database Anda untuk gudang akan terlihat seperti setelah pembaruan.

     <?xml version="1.0" encoding="utf-8"?>
 <Project DefaultTargets="Build">
   <Sdk Name="Microsoft.Build.Sql" Version="2.0.0" />
   <PropertyGroup>
     <Name>DatabaseProject715wh</Name>
     <ProjectGuid>{2E278BCC-F118-4DDB-9255-94697F2930B4}</ProjectGuid>
     <DSP>Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider</DSP>
     <ModelCollation>1033, CI</ModelCollation>
   </PropertyGroup>
   <ItemGroup>
     <None Include=".vscode\tasks.json" />
     <PackageReference Include="Microsoft.SqlServer.Dacpacs.FabricDw" Version="170.0.2" />
   </ItemGroup>
   <Target Name="BeforeBuild">
     <Delete Files="$(BaseIntermediateOutputPath)\project.assets.json" />
   </Target>
 </Project>

  4. Simpan file Anda .sqlproj . Pada perintah untuk memuat ulang proyek database Anda, pilih Ya.

Penting

Tim Fabric Data Warehouse sering merilis versi baru paket NuGet. Karena nilai versi default dalam .sqlproj file dapat berubah dari waktu ke waktu, pastikan untuk memperbaruinya di proyek lokal Anda agar tetap selaras dengan versi terbaru yang tersedia dari NuGet untuk Microsoft.SqlServer.Dacpacs.FabricDw.

Menambahkan atau memperbarui objek database

Anda dapat menentukan atau mengubah objek database seperti tabel, tampilan, prosedur tersimpan, dan fungsi dalam proyek gudang Anda.

Di bawah folder untuk skema, misalnya dbo, tambahkan atau hapus atau buat perubahan pada definisi T-SQL objek di gudang Anda. Untuk mengubah objek yang ada, buka file yang .sql sesuai dan perbarui definisi sesuai kebutuhan.

Saat Anda membuat proyek, semua objek baru dan yang diperbarui divalidasi dan disertakan dalam file dacpac yang dihasilkan dalam {project folder location}/bin/debug/{project name}.dacpac file.

Perubahan yang dilakukan di sini hanya untuk proyek database, dan tidak tercermin dalam Microsoft Fabric hingga Anda Membangun dan Menerbitkan proyek Anda.

Membangun dan memvalidasi proyek

  1. Buka proyek database jika belum dibuka.

  2. Klik kanan pada proyek dan pilih Bangun untuk membangun proyek database.

    Cuplikan layar dari Visual Studio Code memperlihatkan opsi untuk Membangun proyek database.

  3. Proses build harus berhasil. Perbaiki kesalahan apa pun berdasarkan pesan yang disediakan dalam output peristiwa build.

Nota

Saat ini, terminal default Visual Studio Code Anda harus PowerShell agar proses Build di ekstensi Proyek Database berhasil. Di Palet Perintah, pilih Terminal: Pilih Profil Default, lalu pilih PowerShell.

Terbitkan ke Gudang Data Fabric

Setelah mengompilasi proyek Anda, terbitkan ke repositori target Anda. Penerbitan membuat skrip untuk menyelesaikan perbedaan antara proyek database dan gudang aktual, dan menjalankan skrip untuk membuat gudang cocok dengan proyek. Model yang dikompilasi dari skema gudang dalam file .dacpac dapat disebarkan ke gudang target.

  1. Klik kanan pada proyek dan pilih Terbitkan.

  2. Pilih Terbitkan ke server SQL yang sudah ada.

  3. Untuk Pilih terbitkan profil untuk dimuat, saat pertama kali Anda menerbitkan, pilih Jangan gunakan profil.

    • Anda dapat menyimpan opsi untuk menerbitkan gudang Anda ke profil penerbitan. Setelah selesai, Anda diberi opsi dalam pemberitahuan Visual Studio Code untuk menyimpan opsi penerbitan yang baru saja Anda gunakan untuk menerbitkan file profil.
    • Anda dapat menggunakan kembali profil publikasi di masa mendatang ketika menerbitkan proyek ke gudang Anda. Anda mungkin memiliki opsi profil yang berbeda untuk gudang yang berbeda, atau untuk lingkungan yang berbeda di lingkungan pengembangan dev/test/acceptance/production Anda.

  4. Pilih profil koneksi Fabric Data Warehouse dari daftar.

  5. Pilih nama gudang target.

  6. Di opsi Pilih tindakan , Anda dapat Membuat Skrip untuk meninjau skrip sebelum menerbitkan, atau menerbitkan proyek ke gudang.

    • Pertama kali Anda ingin menyebarkan perubahan, Anda harus dengan hati-hati Membuat Skrip dan meninjau T-SQL yang dihasilkan untuk diterapkan ke gudang target. Tidak ada perubahan yang dilakukan pada gudang target.
    • Jika Anda memilih Terbitkan, perubahan akan ditulis ke gudang target Anda.

    Cuplikan layar dari Visual Studio Code memperlihatkan pemberitahuan Sebarkan dacpac: Sedang berlangsung.

  7. Pada pemberitahuan Apakah Anda ingin menyimpan pengaturan di profil (.publish.xml)?, pilih Ya dan simpan pilihan profil publikasi Anda untuk kali berikutnya Anda perlu menerbitkan.

Pengaturan implementasi penting untuk proyek gudang data

Saat menyebarkan proyek database ke Fabric Data Warehouse, beberapa pengaturan mengontrol perubahan skema dan dapat memengaruhi keamanan data. Gunakan dengan hati-hati.

  • BlockOnPossibleDataLoss

    • Apa fungsinya: Mencegah penyebaran jika ada risiko kehilangan data (misalnya, menghilangkan kolom atau tabel yang berisi data).
    • Rekomendasi: Selalu atur ke True dalam produksi untuk melindungi data penting.
    • Hati: Mengaturnya untuk False memungkinkan penyebaran meskipun data dapat hilang. Gunakan hanya di lingkungan terkontrol (misalnya, dev/test).

  • DropObjectsNotInSource

    • Apa fungsinya: Menghilangkan objek dalam database target yang tidak ada di sumber proyek.
    • Rekomendasi: Gunakan di lingkungan dev/test untuk membersihkan objek sisa.
    • Hati: Menggunakan DropObjectsNotInSource dalam produksi dapat menghapus objek dan data penting. Periksa kembali sebelum mengaktifkan.

  • Pre-Deployment Scripts

    • Apa fungsinya: Menjalankan skrip SQL kustom sebelum penyebaran skema.
    • Penggunaan umum:
      • Mengarsipkan atau mencadangkan data sebelum menghilangkan tabel
      • Menonaktifkan batasan atau pemicu untuk sementara
      • Membersihkan objek warisan
    • Perhatian: Pastikan skrip idempoten serta tidak menyebabkan perubahan skema yang bertentangan dengan penyebaran.

Petunjuk / Saran

Ketika proses penyebaran idempotensi, proses tersebut dapat dijalankan beberapa kali tanpa menyebabkan masalah, dan Anda dapat menyebarkan ke beberapa database tanpa perlu menentukan statusnya.

  • Post-Deployment Scripts

    • Apa fungsinya: Menjalankan skrip SQL kustom setelah penyebaran skema.
    • Penggunaan umum:
      • Pencarian benih atau data referensi
      • Mengaktifkan kembali batasan atau pemicu
      • Riwayat penerapan log
    • Hati: Hindari operasi berat pada tabel besar dalam produksi; pastikan skrip dapat berjalan dengan aman beberapa kali jika diperlukan.

Penting

Selalu tinjau skrip dan pengaturan penyebaran sebelum menerbitkan. Uji di lingkungan dev/test terlebih dahulu untuk mencegah kehilangan data yang tidak diinginkan.

Memverifikasi penerbitan

Sambungkan ke objek gudang dan skrip Anda yang diubah atau diverifikasi dengan menjalankan objek katalog sistem.

  • Last updated on