Mengembangkan proyek gudang di Visual Studio Code

Berlaku untuk:✅ 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.
  • Untuk membuat gudang sampel baru, lihat Buat gudang sampel di Microsoft Fabric.
• Instal Visual Studio Code di stasiun kerja Anda.
• Instal SDK .NET untuk membangun dan menerbitkan proyek database.
• Instal dua ekstensi Visual Studio Code: SQL Database Projects dan SQL Server (mssql).
  • Anda dapat menginstal ekstensi yang diperlukan langsung dari dalam Visual Studio Code marketplace dengan mencari "Proyek Database SQL" 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 Data sebagai SQL Server Database.

5. Pilih nama proyek dan pilih lokasi folder lokal.

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

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

   Penting

   Hanya proyek gaya 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 Database Projects dari bilah Aktivitas.

2. Di panel Proyek Database , pilih Buat baru.

   

3. Pilih Jenis Proyek Data sebagai SQL Server Database.

4. Pilih nama proyek dan pilih lokasi folder lokal.

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

6. Saat diminta, pilih Ya (disarankan) untuk proyek gaya SDK. Hanya proyek gaya 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 Anda, pilih titik akhir SQL, dan salin string yang disediakan. Ini adalah nama server gudang Anda, dan berbeda dari titik akhir analitik SQL. Rutenya terlihat seperti <server unique ID>.datawarehouse.fabric.microsoft.com.
   4. Untuk jenis Authentication, gunakan Microsoft Entra ID - Universal dengan dukungan MFA. Autentikasikan dengan Microsoft Entra ID Anda.
   5. Berikan informasi lain sebagai default, atau diinginkan, dan pilih Sambungkan.

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

3. Pilih tombol ... opsi dari panel Proyek Database dan pilih 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.

    

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.

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.

   

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 berlaku untuk proyek database, dan tidak akan muncul dalam Microsoft Fabric hingga Anda Build dan Publish 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 basis data.

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 Fabric Data Warehouse

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 penerbitan di masa mendatang saat 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.

   

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.

Artikel Terkait

• Alur kerja pengembangan dan penyebaran
• Mengembangkan dan menyebarkan dependensi lintas gudang
• Mulai menggunakan alur penyebaran Fabric