Tutorial: Menyimpan skema database di Git

• .NET 8 SDK
• Visual Studio 2022 Komunitas, Profesional, atau Perusahaan
• Menginstal SQL Server Data Tools (SSDT) untuk Visual Studio

• .NET 8 SDK
• Visual Studio Code
• Ekstensi Proyek Basis Data SQL

• .NET SDK
• SQL Server Management Studio (SSMS)
• Beban kerja DevOps untuk Database terinstal di SQL Server Management Studio

• .NET 8 SDK
• SqlPackage CLI
• Microsoft.Build.Sql.Templates templat .NET

# install SqlPackage CLI
dotnet tool install -g Microsoft.SqlPackage

# install Microsoft.Build.Sql.Templates
dotnet new install Microsoft.Build.Sql.Templates

Dari SQL Server Object Explorer di Visual Studio, klik kanan database yang ingin Anda buat project dan pilih Buat Project Baru... .

Dalam dialog Buat Project Baru, masukkan nama project. Nama proyek tidak perlu cocok dengan nama database. Verifikasi dan ubah lokasi proyek sesuai kebutuhan. Pengaturan impor default mengimpor objek ke dalam folder menurut skema, lalu jenis objek. Anda dapat mengubah pengaturan impor untuk mengubah struktur folder atau menyertakan izin dalam objek yang sedang diimpor. Mulai proses impor.

Dialog Impor Database menampilkan kemajuan impor sebagai pesan. Setelah impor selesai, Anda dapat melihat objek yang diimpor di Penjelajah Solusi. Proses ini menyimpan log dalam file di direktori proyek di bawah Import Schema Logs. Pilih Selesai.

Dalam tampilan penjelajah objek database di Visual Studio Code, pilih database tempat Anda ingin membuat proyek. Klik kanan database dan pilih Buat Proyek dari Database.

Dalam Visual Studio Code, dialog Buat proyek dari database memerlukan nama dan lokasi proyek. Pengaturan impor default mengimpor objek ke dalam folder menurut skema, lalu jenis objek. Anda dapat memilih struktur folder lain atau memilih untuk menyertakan izin dalam objek yang sedang diimpor sebelum memilih Buat.

Buka tampilan Proyek Database untuk melihat proyek baru dan definisi objek yang diimpor.

Dari Object Explorer di SQL Server Management Studio, klik kanan database yang ingin Anda buat project dan pilih Buat Project dari Database... di bawah menu Tugas.

Dalam dialog Buat Project SQL dari Database, verifikasi database yang dipilih dan ubah nama dan lokasi project sesuai kebutuhan. Proyek baru dibuat dengan objek dari database yang dipilih dan disusun dalam folder menurut skema, lalu jenis objek.

File solusi secara otomatis dibuat di folder di atas folder proyek, dan terbuka di Penjelajah Solusi setelah pembuatan. Jika Anda ingin menambahkan proyek baru Anda ke solusi yang sudah ada, pilih Tambahkan ke solusi dan telusuri ke file solusi. Pilih Buat untuk membuat proyek.

Gunakan SqlPackage CLI untuk mengekstrak skema database yang ada ke proyek SQL. Perintah SqlPackage berikut mengekstrak skema database ke proyek SQL lengkap. File .sql diatur oleh skema berlapis dan folder jenis objek dan .sqlproj file dibuat untuk mengelola proyek dengan kumpulan properti yang cocok dengan opsi database.

sqlpackage /a:Extract /ssn:localhost /sdn:MyDatabase /tf:MyDatabaseProject /p:ExtractTarget=SqlProject

Dengan proyek SQL terbuka di Visual Studio, buat repositori Git lokal dan dorong ke jarak jauh.

1. Pilih Git>Create Git Repository dari bilah menu.

2. Dalam dialog Buat Repositori Git, di bawah bagian Dorong ke jarak jauh baru, pilih GitHub atau Azure DevOps. Jika Anda memilih untuk push ke GitHub, masuk ke akun GitHub Anda saat diminta. Jika Anda memilih Azure DevOps, masuk ke akun Azure DevOps Anda dan pilih atau buat proyek.

3. Masukkan nama dan deskripsi repositori. Pastikan templat .gitignore diatur ke VisualStudio dan pilih Buat dan Push.

Visual Studio membuat repositori Git lokal, melakukan komit awal dengan file proyek SQL Anda, dan mendorongnya ke repositori remote.

Untuk memverifikasi bahwa kode berhasil didorong, buka browser dan navigasikan ke repositori Anda di GitHub (https://github.com) atau Azure DevOps (https://dev.azure.com). Anda akan melihat file proyek SQL, termasuk .sqlproj file dan .sql definisi objek.

Untuk informasi selengkapnya, lihat Tentang Git di Visual Studio.

Dengan folder proyek SQL terbuka di Visual Studio Code, inisialisasi repositori Git lokal dan dorong ke jarak jauh.

1. Buka tampilan Kontrol Sumber dengan memilih ikon Kontrol Sumber di Bilah Aktivitas, atau tekan Ctrl+Shift+G.

2. Pilih Inisialisasi Repositori untuk membuat repositori Git baru di folder saat ini.

3. Semua file proyek muncul sebagai perubahan yang tidak terlacak. Pilih ikon + di samping Perubahan untuk menambahkan semua berkas ke staging area.

4. Masukkan pesan penerapan seperti Initial commit of SQL project dalam kotak input pesan dan pilih tombol Terapkan (ikon tanda centang).

5. Pilih Terbitkan Cabang dalam tampilan Kontrol Sumber untuk mendorong repositori lokal Anda ke jarak jauh. Pilih apakah akan menerbitkan ke GitHub atau Azure DevOps dan mengikuti perintah masuk. Pilih visibilitas repositori (publik atau privat) dan konfirmasi.

Untuk memverifikasi bahwa kode berhasil didorong, buka browser dan navigasikan ke repositori Anda di GitHub (https://github.com) atau Azure DevOps (https://dev.azure.com). Anda akan melihat file proyek SQL, termasuk .sqlproj file dan .sql definisi objek.

Untuk informasi selengkapnya, lihat Kontrol Sumber di Visual Studio Code.

Dengan proyek SQL terbuka di SQL Server Management Studio, buat repositori Git lokal dan dorong ke jarak jauh.

1. Pilih Git>Create Git Repository dari bilah menu.

2. Dalam dialog Buat Repositori Git, di bawah bagian Dorong ke jarak jauh baru, pilih GitHub atau Azure DevOps. Jika Anda memilih untuk push ke GitHub, masuk ke akun GitHub Anda saat diminta. Jika Anda memilih Azure DevOps, masuk ke akun Azure DevOps Anda dan pilih atau buat proyek.

3. Masukkan nama dan deskripsi repositori. Pastikan templat .gitignore diatur ke VisualStudio dan pilih Buat dan Push.

SSMS membuat repositori Git lokal, membuat commit awal dengan file proyek SQL Anda, dan mendorongnya ke repositori remote.

Untuk memverifikasi bahwa kode berhasil didorong, buka browser dan navigasikan ke repositori Anda di GitHub (https://github.com) atau Azure DevOps (https://dev.azure.com). Anda akan melihat file proyek SQL, termasuk .sqlproj file dan .sql definisi objek.

Untuk informasi selengkapnya, lihat Tentang Git di Visual Studio.

Dari direktori proyek SQL, inisialisasi repositori Git lokal, komitkan semua file, lalu push ke repositori remote.

1. Inisialisasi repositori Git baru, tambahkan .gitignore file, dan buat penerapan awal:

   cd MyDatabaseProject
   git init
   dotnet new gitignore
   git add .
   git commit -m "Initial commit of SQL project"
   

2. Buat repositori jarak jauh baru di GitHub atau Azure DevOps:

   • GitHub: Buka https://github.com/new dan buat repositori baru. Jangan menginisialisasinya dengan README, .gitignore, atau lisensi.
   • Azure DevOps: Buka proyek Azure DevOps Anda, pilih Repositori, dan buat repositori baru. Hapus centang Tambahkan README.

3. Tambahkan remote dan lakukan push commit awal Anda:

   git remote add origin <your-repository-url>
   git push -u origin main
   

   Ganti <your-repository-url> dengan URL yang disediakan oleh GitHub atau Azure DevOps saat Anda membuat repositori.

Untuk memverifikasi bahwa kode berhasil di-push, buka browser dan kunjungi repositori Anda. Anda akan melihat file proyek SQL, termasuk .sqlproj file dan .sql definisi objek.

Gunakan perbandingan skema untuk memperbarui proyek SQL dari database.

1. Di SQL Server Object Explorer, klik kanan database dan pilih Perbandingan Skema.

2. Di jendela Bandingkan Skema , database diatur sebagai sumbernya. Pilih daftar dropdown Pilih Target dan pilih Pilih Target.

3. Dalam dialog Pilih Skema Target, pilih Project dan pilih proyek database SQL Anda. Pilih OK.

4. Pilih Bandingkan untuk menjalankan perbandingan. Hasilnya menampilkan perbedaan antara database (sumber) dan proyek (target).

5. Tinjau perbedaannya. Hapus centang perubahan apa pun yang tidak ingin Anda terapkan ke proyek.

6. Pilih Perbarui untuk menerapkan perubahan yang dipilih ke proyek SQL.

File proyek diperbarui agar sesuai dengan skema database. Tinjau perubahan di jendela Perubahan Git , masukkan pesan penerapan, dan pilih Terapkan Semua. Pilih Dorong untuk mendorong perubahan ke repositori jarak jauh.

Gunakan perintah Perbarui Project dari Database untuk memperbarui project SQL dari database.

1. Di penjelajah objek database, klik kanan database dan pilih SQL Database Projects>Update Project dari Database.

2. Pilih proyek database SQL untuk memperbarui dan mengonfirmasi.

3. Proses perbandingan dijalankan dan menerapkan perubahan dari basis data ke proyek. File yang diperbarui .sql muncul dalam tampilan Kontrol Sumber sebagai file yang dimodifikasi.

Tinjau perubahan dalam tampilan Kontrol Sumber , tahapkan file yang dimodifikasi, masukkan pesan penerapan, dan pilih Terapkan. Pilih Sinkronkan Perubahan untuk mendorong penerapan ke repositori jarak jauh.

Gunakan perbandingan skema untuk memperbarui proyek SQL dari database.

1. Di Object Explorer, klik kanan database dan pilih Tugas>Bandingkan Skema (pratinjau).

2. Di jendela Bandingkan Skema , database diatur sebagai sumbernya. Pilih tombol elipsis target dan pilih proyek database SQL Anda sebagai target.

3. Pilih Bandingkan untuk menjalankan perbandingan. Hasilnya menampilkan perbedaan antara database (sumber) dan proyek (target).

4. Tinjau perbedaannya. Hapus centang perubahan apa pun yang tidak ingin Anda terapkan ke proyek.

5. Pilih Terapkan untuk menerapkan perubahan yang dipilih ke proyek SQL.

File proyek diperbarui agar sesuai dengan skema database. Tinjau perubahan di jendela Perubahan Git , masukkan pesan penerapan, dan pilih Terapkan Semua. Pilih Dorong untuk mendorong perubahan ke repositori jarak jauh.

Gunakan SqlPackage untuk meregenerasi proyek SQL dari database, mengganti file proyek yang ada dengan skema database saat ini. Meskipun alat proyek SQL lainnya menyediakan antarmuka grafis, SqlPackage menawarkan pendekatan baris perintah untuk otomatisasi yang tidak memberikan kesempatan untuk meninjau perubahan file sebelum menerapkannya.

1. Hapus file objek SQL yang ada dan regenerasi proyek:

   rm -rf MyDatabaseProject
   sqlpackage /a:Extract /ssn:localhost /sdn:MyDatabase /tf:MyDatabaseProject /p:ExtractTarget=SqlProject
   

2. Tinjau perubahan dengan Git dan terapkan:

   cd MyDatabaseProject
   dotnet new gitignore
   git add .
   git status
   git commit -m "Update project from database changes"
   git push
   

1. Pilih Git>Pull dari bilah menu untuk menarik perubahan terbaru dari repositori jarak jauh.

2. Di Penjelajah Solusi, klik kanan simpul proyek database SQL dan pilih Perbandingan Skema.

3. Di jendela Bandingkan Skema, proyek ditetapkan sebagai sumber. Pilih daftar dropdown Pilih Target dan pilih Pilih Target.

4. Dalam dialog Pilih Skema Target , pilih Database dan pilih koneksi database pengembangan lokal Anda. Pilih OK.

5. Pilih Bandingkan untuk menjalankan perbandingan. Hasilnya menampilkan perbedaan antara proyek (sumber) dan database (target).

6. Tinjau perbedaan untuk memverifikasi perubahan yang diharapkan.

7. Pilih Perbarui untuk menerapkan perubahan ke database.

1. Buka tampilan Kontrol Sumber dan pilih Tarik dari menu ... (atau gunakan tombol sinkronisasi di Bilah Status) untuk menarik perubahan terbaru dari repositori jarak jauh.

2. Dalam tampilan Proyek Database , klik kanan proyek database SQL dan pilih Perbandingan Skema.

3. Dalam jendela Bandingkan Skema, proyek ditetapkan sebagai sumber. Pilih tombol elipsis target dan pilih koneksi database pengembangan lokal Anda sebagai target.

4. Pilih Bandingkan untuk menjalankan perbandingan. Hasilnya menampilkan perbedaan antara proyek (sumber) dan database (target).

5. Tinjau perbedaan untuk memverifikasi perubahan yang diharapkan.

6. Pilih Terapkan untuk menerapkan perubahan ke database.

1. Buka terminal dan jalankan git pull di direktori proyek untuk menarik perubahan terbaru dari repositori jarak jauh.

2. Di Penjelajah Solusi, klik kanan simpul proyek database SQL dan pilih Perbandingan Skema (pratinjau).

3. Di jendela Perbandingan Skema, proyek diatur sebagai sumber. Pilih target dan pilih koneksi database pengembangan lokal Anda.

4. Pilih Bandingkan untuk menjalankan perbandingan. Hasilnya menampilkan perbedaan antara proyek (sumber) dan database (target).

5. Tinjau perbedaan untuk memverifikasi perubahan yang diharapkan.

6. Pilih Terapkan untuk menerapkan perubahan ke database.

1. Tarik perubahan terbaru dari repositori jarak jauh:

   cd MyDatabaseProject
   git pull
   

2. Bangun proyek untuk memverifikasi perubahan yang berhasil dikompilasi:

   dotnet build
   

3. Sebarkan perubahan pada database pengembangan lokal Anda menggunakan SqlPackage:

   sqlpackage /a:Publish /sf:bin/Debug/MyDatabaseProject.dacpac /tsn:localhost /tdn:MyDatabase
   

   Ganti MyDatabaseProject.dacpac dengan nama file output Anda .dacpac , dan perbarui nilai server target (/tsn) dan database (/tdn) sesuai kebutuhan.