Database Project Pengaturan
Anda menggunakan pengaturan proyek database untuk mengontrol aspek database, debugging, dan konfigurasi build Anda. Pengaturan ini termasuk dalam kategori berikut.
Untuk mengonfigurasi properti untuk proyek database Anda
Di Penjelajah Solusi, klik kanan proyek database yang ingin Anda konfigurasi propertinya, dan pilih Properti.
Atau, klik dua kali simpul Properti proyek di Penjelajah Solusi.
Lembar properti untuk proyek database Anda muncul.
Klik tab Pengaturan Proyek . Sekarang Anda dapat mengonfigurasi properti umum properti proyek database Anda. Perhatikan ketersediaan berbagai tab (mewakili kategori yang berbeda) di panel kiri.
Pengaturan proyek
Pengaturan dalam tabel berikut berlaku untuk semua konfigurasi proyek database ini.
| Bidang | Nilai default | Deskripsi |
|---|---|---|
| Target Platform | Microsoft SQL Server 2012 | Menentukan versi SQL Server yang Anda targetkan dengan proyek database ini. |
| Aktifkan verifikasi Transact-SQL yang diperluas untuk objek umum. | Tidak diaktifkan saat Anda membuat proyek baru. Diaktifkan saat Anda membuat proyek dari SQL Server Object Explorer tersambung ke SQL Azure, mengimpor database Azure SQL ke dalam proyek, atau mengubah Platform Target proyek ke SQL Azure. |
Ketika opsi ini diaktifkan, kesalahan yang ditemukan dalam proyek yang gagal SQL Server verifikasi Compiler dilaporkan. Jika Anda mengubah platform target ke SQL Azure, Verifikasi diperpanjang akan diaktifkan. Opsi tidak akan dicentang jika Anda mengubah Platform Target Anda. Anda dapat mengaktifkan opsi ini untuk versi SQL Server lainnya, tetapi validasi terbatas pada Microsoft SQL Server 2012 Partially Contained Databases dan SQL Azure. Tidak semua sintaks Transact-SQL didukung untuk semua versi SQL Server. Untuk informasi selengkapnya, lihat Verifikasi Transact-SQL yang Diperluas nanti dalam topik ini |
| Jenis output | ||
| Aplikasi tingkat data (file.dacpac) | Diaktifkan dan dikunci. Output build proyek database selalu menghasilkan paket .dacpac saat proyek dibangun. | Jika Anda menggunakan versi SQL Server Data Tools (SSDT) yang memiliki opsi "Buat file .dacpac tingkat bawah tambahan (v2.0)", periksa apakah Anda ingin paket kompatibel dengan SQL Server Management Studio atau Portal Manajemen Azure SQL. Anda dapat menyebarkan paket .dacpac langsung dari (SSDT), tetapi Anda hanya dapat menyebarkan file .dacpac versi 2.0 melalui SQL Server Management Studio pada saat SQL Server Data Tools dirilis. |
| Buat Skrip (File.sql) | Menentukan apakah skrip .sql CREATE lengkap dihasilkan untuk semua objek dalam proyek, dan ditempatkan di folder bin\debug saat proyek dibangun. Anda dapat membuat skrip pembaruan inkremental menggunakan perintah Project Publish atau utilitas SQL Compare. | |
| Generik | ||
| Skema default | dbo | Menentukan skema default tempat objek SQLCLR dan Transact-SQL dibuat. Anda dapat mengambil alih pengaturan ini dengan menentukan skema langsung pada objek." |
| Sertakan nama skema dalam nama file | tidak | Menentukan apakah nama file menyertakan skema sebagai awalan (misalnya, dbo. Products.table.sql). Jika kotak centang ini dikosongkan, nama file untuk objek mengambil formulir ObjectName.ObjectType.sql (misalnya, Products.table.sql). |
| Memvalidasi Casing pada Pengidentifikasi | ya | Menentukan apakah casing pada pengidentifikasi di objek SQL dalam proyek divalidasi saat proyek dibangun. Opsi ini berlaku untuk proyek database yang menentukan kolatasi peka huruf besar/kecil untuk database. |
| Pengaturan Database | Pengaturan default berdasarkan pengaturan konfigurasi standar untuk database | Contoh pengaturan yang bisa Anda tentukan termasuk metode kolase dan pengaturan tingkat database untuk database SQL Server. |
Verifikasi Transact-SQL yang Diperluas
Penting
Fitur Extended Transact-SQL Verification akan dihapus dari rilis fitur berikutnya SQL Server Data Tools dan rilis utama Visual Studio berikutnya.
Verifikasi Transact-SQL yang Diperluas adalah fitur dalam sistem proyek database yang memungkinkan pengembang mengirimkan proyek database mereka ke Layanan Pengkompilasi Transact-SQL pada waktu build untuk memvalidasi kode mereka terhadap pengurai dan penerjemah mesin SQL Server.
Layanan Pengkompilasi Transact-SQL
Layanan Pengkompilasi Transact-SQL adalah komponen berdasarkan Mesin Database Microsoft SQL Server 2012. Layanan ini dapat memvalidasi sintaks dan semantik pernyataan DDL dengan keakuratan yang sama dengan mesin Microsoft SQL Server 2012 Database. Ini secara inheren berarti bahwa Compiler Service tidak mendukung sintaksis atau fitur yang tidak digunakan lagi di Microsoft SQL Server 2012. Untuk informasi selengkapnya tentang fitur yang tidak digunakan lagi, lihat Fungsionalitas Mesin Database yang Dihentikan di SQL Server 2012.
Untuk tujuan validasi proyek database, Compiler Service membuat database yang sebagian berisi dan mensimulasikan eksekusi pernyataan DDL terhadap database tersebut. Untuk informasi selengkapnya, lihat Database yang Terkandung Sebagian.
Layanan Pengkompilasi memiliki dua kategori batasan.
Fitur yang mengandalkan database atau konfigurasi instans termasuk:
Referensi objek 3 atau 4 bagian
FileTables
Pelacakan Perubahan
Fungsi rowset - OPENROWSET, OPENQUERY, OPENDATASOURCE
Pencarian Semantik Teks Lengkap
Fitur yang saat ini tidak didukung untuk validasi termasuk:
Service Broker
Skema Yang Dipartisi dengan FileGroup yang ditentukan pengguna
Kolase Metadata Azure SQL (Layanan Pengkompilasi menggunakan kolase metadata Database terkandung Sebagian SQL Server 2012 - Latin1_General_100_CI_AS_KS_WS_SC)
Mengaktifkan/Menonaktifkan Verifikasi Diperpanjang
Verifikasi Transact-SQL yang Diperluas diaktifkan secara default dalam proyek database yang dibuat langsung dari database Azure SQL atau proyek yang platform targetnya diatur ke SQL Azure. Disarankan agar Extended Verification digunakan saat mengembangkan untuk SQL Azure atau database dengan cakupan aplikasi yang menargetkan SQL Server 2012. Untuk informasi selengkapnya tentang database terlingkup aplikasi, lihat Database yang Terkandung Sebagian.
Fitur Verifikasi Yang Diperluas juga dapat digunakan saat mengembangkan database cakupan aplikasi untuk SQL Server 2008/R2 untuk mencapai kompatibilitas dengan Microsoft SQL Server 2012 dan SQL Azure.
Untuk mengaktifkan atau menonaktifkan Verifikasi Diperpanjang di tingkat proyek
Di Penjelajah Solusi, klik kanan pada file proyek, lalu klik Properti.
Di Pengaturan Proyek, di bawah Platform Target, centang atau hapus centang Aktifkan verifikasi Transact-SQL yang diperluas untuk objek umum.
Untuk menonaktifkan Verifikasi Diperpanjang di tingkat file
Di Penjelajah Solusi, klik kanan pada file .sql.
Catatan
Untuk menonaktifkan fitur Extended Transact-SQL Verification di tingkat file, properti Build Action file harus diatur ke Build.
Di Properti, ubah properti Verifikasi T-SQL yang Diperluas menjadi False.
Pertimbangan Khusus untuk Kolajek
Untuk informasi selengkapnya mengenai kolase dalam database yang sebagian dimuat, lihat Kolase Database Mandiri.
SQLCLR
Untuk informasi tentang opsi Assembly, lihat Kotak Dialog Informasi Assembly.
Untuk informasi tentang penandatanganan, lihat bagian Penandatanganan Assembly dari halaman Penandatanganan, topik Perancang Proyek .
Build SQLCLR dan SQLCLR
Halaman properti Build SQLCLR dan SQLCLR berisi banyak pengaturan untuk menggunakan objek SQL CLR dalam proyek Anda. Secara khusus, halaman properti SQLCLR memiliki pengaturan tingkat izin untuk mengatur izin pada rakitan SQLCLR. Ini juga memiliki pengaturan "hasilkan DDL" untuk mengontrol apakah Dynamic Data Language (DDL) dihasilkan untuk objek SQLCLR yang telah ditambahkan ke proyek. Halaman properti Build SQLCLR berisi semua opsi pengkompilasi yang dapat Anda atur untuk mengonfigurasi kompilasi kode SQLCLR dalam proyek.
Halaman properti Build SQLCLR berisi pengaturan build tingkat lanjut untuk membangun objek SQL CLR Anda. Opsi yang berbeda disediakan berdasarkan bahasa (VB atau C#) yang digunakan untuk mengodekan objek SQL CLR.
Jika objek ditulis dalam C#, Anda dapat mengakses opsi dengan mengklik tombol Tingkat Lanjut di halaman properti Build SQLCLR . Deskripsi untuk opsi C# dapat ditemukan di Kotak Dialog Pengaturan Build Tingkat Lanjut (C#).
Jika objek ditulis dalam VB, Anda dapat terlebih dahulu memilih VB di daftar dropdown Bahasa , lalu klik tombol Tingkat Lanjut . Deskripsi untuk opsi VB dapat ditemukan di Kotak Dialog Pengaturan Pengkompilasi Tingkat Lanjut (Visual Basic)
Build
Anda dapat memilih konfigurasi build untuk setiap proyek database dalam solusi Anda. Secara default ada satu konfigurasi, tetapi Anda dapat menambahkan konfigurasi kustom. Anda dapat memilih untuk melakukan ini, misalnya, jika Anda menginginkan konfigurasi kustom tempat Anda selalu menghapus dan membuat ulang database. Dalam solusi yang berisi berbagai jenis proyek, Anda dapat membuat konfigurasi solusi kustom yang berisi konfigurasi build tertentu untuk setiap proyek.
Untuk menentukan konfigurasi build untuk solusi
Di Penjelajah Solusi, klik simpul solusi yang ingin Anda tentukan konfigurasi buildnya.
Pada menu Build, klik Configuration Manager. Kotak dialog Configuration Manager akan muncul.
Tentukan pengaturan konfigurasi yang ingin Anda gunakan untuk setiap proyek dalam solusi Anda.
Untuk menentukan konfigurasi build untuk proyek database
Di Penjelajah Solusi, klik kanan proyek database yang ingin Anda tentukan konfigurasi buildnya, dan pilih Properti.
Pada tab Build , gunakan daftar dropdown Konfigurasi untuk menentukan pengaturan konfigurasi yang ingin Anda gunakan untuk proyek ini.
Pengaturan dalam tabel berikut berlaku untuk membangun konfigurasi proyek database ini.
| Bidang | Nilai default | Deskripsi |
|---|---|---|
| Jalur output build | bin\Debug| Menentukan di mana output build dihasilkan saat Anda membangun atau menyebarkan proyek database. Jika Anda menentukan jalur relatif, Anda harus menentukannya relatif terhadap jalur proyek database. Jika jalur tidak ada, jalur akan dibuat. | |
| Nama file output build | DatabaseProjectName | Menentukan nama yang ingin Anda berikan output yang dihasilkan saat Anda membangun proyek database |
| Perlakukan peringatan Transact-SQL sebagai kesalahan | Tidak | Menentukan apakah peringatan Transact-SQL harus menyebabkan proses build dan penyebaran dibatalkan. Jika kotak centang ini dikosongkan, peringatan muncul, tetapi proses build dan penyebaran berlanjut. Pengaturan ini khusus untuk proyek, bukan pengguna, dan disimpan dalam file .sqlproj. |
| Sembunyikan Peringatan Transact-SQL | Kosong | Menentukan daftar angka peringatan, dibatasi oleh koma atau titik koma yang mengidentifikasi peringatan yang ditekan. Peringatan yang disembunyikan tidak muncul di jendela Daftar Kesalahan , dan peringatan tersebut tidak memengaruhi keberhasilan build, bahkan jika Anda memilih kotak centang Perlakukan peringatan Transact-SQL sebagai kesalahan . |
Variabel SQLCMD
Dalam SQL Server Proyek Database, Anda dapat menggunakan variabel SQLCMD untuk memberikan substitusi dinamis yang akan digunakan untuk penelusuran kesalahan atau penerbitan. Anda memasukkan nama variabel dan nilai dan selama build, nilai akan diganti. Jika tidak ada nilai lokal, nilai default akan digunakan. Dengan memasukkan variabel ini di properti proyek, variabel tersebut akan secara otomatis ditawarkan dalam penerbitan dan disimpan dalam profil penerbitan. Anda dapat menarik nilai proyek variabel ke dalam publikasi melalui tombol Muat Nilai.
Pastikan variabel yang tepat dimasukkan dalam properti proyek, karena variabel ini tidak divalidasi terhadap skrip dalam proyek, juga bukan variabel yang digunakan dalam skrip yang diisi secara otomatis.
Selain itu, penerbitan baris perintah memungkinkan Anda untuk mengambil alih nilai-nilai ini di baris perintah atau menggunakan profil.
Peristiwa Build
Anda dapat menggunakan pengaturan ini untuk menentukan baris perintah yang akan dijalankan sebelum operasi build dimulai dan baris perintah untuk dijalankan setelah operasi build selesai.
| Bidang | Nilai default | Deskripsi |
|---|---|---|
| Baris perintah peristiwa pra-build | Tidak ada | Menentukan baris perintah yang akan dijalankan sebelum proyek dibangun. Klik Edit Pra-build untuk mengubah baris perintah. |
| Baris perintah peristiwa pasca-build | Tidak ada | Menentukan baris perintah yang akan dijalankan setelah proyek dibuat. Klik Edit Pasca-build untuk mengubah baris perintah. |
| Menjalankan peristiwa pasca-build | Pada build yang berhasil | Menentukan apakah baris perintah pasca-build harus selalu dijalankan, hanya jika build berhasil, atau hanya ketika build memperbarui output proyek (skrip build). |
Debug
Anda bisa menggunakan pengaturan ini untuk mengontrol penelusuran kesalahan proyek database Anda.
| Bidang | Nilai default | Deskripsi |
|---|---|---|
| Mulai Tindakan | Tidak ada | Menentukan skrip atau program eksternal untuk dijalankan saat Anda men-debug proyek Anda. |
| String Koneksi Target | Sumber Data=(localdb)\SolutionName;Initial Catalog=DatabaseProjectName;Integrated Security=True; Pooling=False; Waktu Habis Sambungkan=30 | Menentukan informasi koneksi untuk server database yang ingin Anda targetkan untuk konfigurasi build yang ditentukan. String koneksi default bertentangan dengan instans dan database LocalDB SQL Server yang dibuat secara dinamis. |
| Menyebarkan properti database | Ya | Menentukan apakah pengaturan DatabaseProperties.DatabaseProperties disebarkan atau diperbarui saat Anda menyebarkan proyek database. |
| Selalu buat ulang database | Tidak | Menentukan apakah akan menghapus dan membuat ulang database alih-alih melakukan peningkatan inkremental. Anda mungkin ingin memilih kotak centang ini jika Anda ingin menjalankan pengujian unit database terhadap penyebaran database yang bersih, misalnya. Jika kotak centang ini dikosongkan, database yang ada akan diperbarui alih-alih dihilangkan dan dibuat ulang. |
| Memblokir penyebaran inkremental jika kehilangan data mungkin terjadi | Ya | Menentukan apakah penyebaran akan berhenti jika pembaruan dapat menyebabkan kehilangan data. Jika kotak centang ini dipilih, perubahan yang akan membuat kehilangan data menyebabkan penyebaran berhenti dengan kesalahan, yang membuat data tidak hilang. Misalnya, penyebaran akan berhenti jika varchar(50) kolom diubah menjadi varchar(30).CATATAN: Penyebaran diblokir hanya jika tabel tempat kehilangan data mungkin terjadi berisi data. Penyebaran berlanjut jika tidak ada data yang akan hilang. |
| DROP objek dalam target tetapi tidak dalam proyek | Tidak | Menentukan apakah objek yang ada di database target tetapi tidak dalam proyek database harus dihilangkan sebagai bagian dari skrip penyebaran. Anda dapat mengecualikan beberapa file dalam proyek Anda untuk menghapusnya sementara dari skrip build Anda. Namun, Anda mungkin ingin meninggalkan versi objek tersebut yang sudah ada di database target. Kotak centang ini tidak berpengaruh jika kotak centang Selalu buat ulang database dipilih, karena database akan dihilangkan. |
| Jangan gunakan pernyataan ALTER ASSEMBLY untuk memperbarui jenis CLR | Tidak | Menentukan apakah pernyataan ALTER ASSEMBLY digunakan untuk memperbarui jenis run-time bahasa umum (CLR) atau apakah objek yang membuat instans jenis CLR akan dihilangkan dan dibuat ulang saat Anda menyebarkan perubahan. |
| Lanjutan... | Tidak | Tombol perintah yang memungkinkan Anda menentukan opsi yang mengontrol peristiwa dan perilaku untuk penyebaran. |
Jalur Referensi
Anda dapat menggunakan halaman ini untuk menentukan variabel server dan database yang terkait dengan referensi lintas database. Selain itu, Anda dapat menentukan nilai variabel tersebut. Untuk informasi selengkapnya, lihat Menggunakan Referensi di Proyek Database.
Analisis Kode
Anda dapat menggunakan Analisis Kode untuk menemukan potensi masalah dalam skrip Anda, seperti masalah desain, penamaan, dan performa. Aturan untuk proyek database diatur ke dalam seperangkat aturan yang telah ditentukan sebelumnya yang menargetkan area tertentu, dan Anda dapat mengaktifkan atau menonaktifkan aturan apa pun di tab Analisis Kode dari halaman properti Properti Proyek . Di tab yang sama, Anda dapat menentukan analisis kode yang akan dijalankan secara otomatis setiap kali proyek dibuat, atau apakah peringatan diperlakukan sebagai kesalahan.
Untuk menggunakan Analisis Kode secara manual, klik kanan proyek Anda di Penjelajah Solusi dan pilih Jalankan Analisis Kode. Peringatan analisis kode tercantum di jendela Daftar Kesalahan . Anda dapat mengklik dua kali peringatan untuk menavigasi ke kode sumber yang berisi masalah, dan Anda dapat melihat informasi tambahan dan kemungkinan koreksi untuk peringatan dengan menggunakan menu kontekstual Perlihatkan Bantuan Kesalahan . Untuk informasi selengkapnya tentang Analisis Kode, lihat Menganalisis Kode Database untuk Meningkatkan Kualitas Kode.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk