Menyambungkan ke database di Visual Studio

Langkah-langkah dalam artikel ini memperlihatkan cara menyambungkan ke sumber data di Visual Studio IDE. Sumber data dapat berupa database lokal, layanan data online, atau database yang .mdfdibuka dari file. Anda dapat bekerja langsung dengan data Anda di Visual Studio. Anda dapat menjalankan kueri, mengedit data, membuat dan mengedit tabel dan properti skema lainnya, mengedit prosedur dan fungsi tersimpan, pemicu, dan sebagainya. Fungsi-fungsi ini independen dari bahasa pemrograman atau versi .NET yang Anda gunakan.

Jika Anda bekerja dengan database Access (.accdb file), lihat Menyambungkan ke database Access di aplikasi .NET Framework.

Penjelajah Server dan SQL Server Object Explorer

Anda dapat membuka koneksi ke database atau layanan, atau database LocalDB yang dibuka dari .mdf file, dan menampilkan dan mengedit tabel dan baris data, dengan menggunakan Server Explorer atau SQL Server Object Explorer. Fungsionalitas jendela ini tumpang tindih hingga batas tertentu. Perbedaan dasarnya adalah:

  • Penjelajah Server

    Diinstal secara default di Visual Studio. Dapat digunakan untuk menguji koneksi dan melihat database SQL Server, database lain yang memiliki penyedia ADO.NET yang terinstal, dan beberapa layanan Azure. Juga menunjukkan objek tingkat rendah seperti penghitung kinerja sistem, log peristiwa, dan antrean pesan. Jika sumber data tidak memiliki penyedia ADO.NET, sumber data tidak akan muncul di sini, tetapi Anda masih dapat menggunakannya dari Visual Studio dengan menyambungkan secara terprogram.

  • SQL Server Object Explorer

    Diinstal dengan SQL Server Data Tools dan terlihat di bawah menu Tampilan . Jika Anda tidak melihatnya di sana, buka Program dan Fitur di Panel Kontrol, temukan Visual Studio, lalu pilih Ubah untuk menjalankan ulang penginstal setelah memilih kotak centang untuk Alat Data SQL Server. Gunakan SQL Server Object Explorer untuk melihat database SQL (jika mereka memiliki penyedia ADO.NET), membuat database baru, memodifikasi skema, membuat prosedur tersimpan, mengambil string koneksi, melihat data, dan banyak lagi. Database SQL yang tidak memiliki penyedia ADO.NET yang terinstal tidak akan muncul di sini, tetapi Anda masih dapat menyambungkannya secara terprogram.

Menambahkan koneksi di Server Explorer

Untuk membuat koneksi ke database, klik ikon Sambungkan ke Database di Server Explorer, atau klik kanan di Server Explorer pada simpul Koneksi Data dan pilih Tambahkan Koneksi. Dari sini, Anda bisa membuka koneksi ke database LocalDB yang dibuka dari file .mdf, menyambungkan ke database di server lain, layanan SharePoint, atau layanan Azure.

Cuplikan layar memperlihatkan ikon Sambungkan ke Database Server Explorer.

Ini memunculkan dialog Pilih Sumber Data :

Cuplikan layar yang memperlihatkan dialog Pilih Sumber Data.

Pilih sumber data dan pilih Lanjutkan untuk melanjutkan ke dialog Tambahkan Koneksi . Di sini, kami telah memasukkan nama instans SQL Server LocalDB, (localdb)\MSSqlLocalDB, yang biasanya diinstal dengan Visual Studio.

Jika Anda tidak memiliki akses ke database lain, dan Anda tidak melihat LocalDB terinstal, Anda dapat menginstal LocalDB melalui Alat Penginstal Visual Studio, sebagai bagian dari beban kerja Penyimpanan dan pemrosesan data , beban kerja ASP.NET dan pengembangan web , atau sebagai komponen individual. Lihat Mengubah Visual Studio.

Cuplikan layar memperlihatkan ikon Sambungkan ke Database Server Explorer.

Ini memunculkan kotak dialog Tambahkan Koneksi . Di sini, kami telah memasukkan nama instans SQL Server LocalDB, (localdb)\MSSqlLocalDB, yang biasanya diinstal dengan Visual Studio.

Jika Anda tidak memiliki akses ke database lain, dan Anda tidak melihat LocalDB terinstal, Anda dapat menginstal LocalDB melalui Alat Penginstal Visual Studio, sebagai bagian dari beban kerja Penyimpanan dan pemrosesan data , beban kerja ASP.NET dan pengembangan web , atau sebagai komponen individual. Lihat Mengubah Visual Studio.

Cuplikan layar kotak dialog Tambahkan Koneksi Baru.

Di Visual Studio 2022 versi 17.8 dan yang lebih baru, dialog menyertakan dua opsi baru (Enkripsi dan Sertifikat Server Kepercayaan) yang masuk ke string koneksi dan memengaruhi pengaturan keamanan yang digunakan untuk koneksi Anda. Opsi ini mendukung fitur keamanan yang lebih ketat dari driver database Microsoft.Data.SqlClient 4.0. Lihat Perubahan perilaku enkripsi dan validasi sertifikat.

Praktik keamanan yang direkomendasikan adalah menggunakan enkripsi dan menginstal sertifikat di server untuk itu. Lihat Enkripsi dan validasi sertifikat. Untuk menolak keamanan yang ditingkatkan ini, atur Enkripsi ke Opsional (Salah).

Jika Anda tidak mengatur Enkripsi ke opsional dengan Visual Studio 17.8 atau yang lebih baru, yang menggunakan Microsoft.Data.SqlClient versi 4.0, enkripsi akan default ke wajib. Ini adalah perubahan signifikan dari perilaku pada versi-versi sebelumnya. Jika Anda tidak memiliki sertifikat yang valid atau tidak memilih Sertifikat Server Kepercayaan, Anda mendapatkan pesan kesalahan berikut:

Enkripsi diaktifkan pada koneksi ini, tinjau SSL dan konfigurasi sertifikat Anda untuk SQL Server target, atau aktifkan 'Percayai sertifikat server' dalam dialog koneksi.

Informasi tambahan

Sambungan berhasil dibuat dengan server, tetapi kemudian terjadi kesalahan selama proses masuk. (penyedia: Penyedia SSL, kesalahan: 0 - Rantai sertifikat dikeluarkan oleh otoritas yang tidak tepercaya.) (Microsoft SQL Server)

Cuplikan layar kotak dialog Tambahkan Koneksi Baru.

Di Visual Studio 2022 versi 17.8 dan yang lebih baru, dialog menyertakan dua opsi baru (Enkripsi dan Sertifikat Server Kepercayaan) yang masuk ke string koneksi dan memengaruhi pengaturan keamanan yang digunakan untuk koneksi Anda. Opsi ini mendukung fitur keamanan yang lebih ketat dari driver database Microsoft.Data.SqlClient 4.0. Lihat Perubahan perilaku enkripsi dan validasi sertifikat.

Praktik keamanan yang direkomendasikan adalah menggunakan enkripsi dan menginstal sertifikat di server untuk itu. Lihat Enkripsi dan validasi sertifikat. Untuk menolak keamanan yang ditingkatkan ini, atur Enkripsi ke Opsional (Salah).

Jika Anda tidak mengatur Enkripsi ke opsional dengan Visual Studio 17.8 atau yang lebih baru, yang menggunakan Microsoft.Data.SqlClient versi 4.0, enkripsi akan default ke wajib. Ini adalah perubahan signifikan dari perilaku pada versi-versi sebelumnya. Jika Anda tidak memiliki sertifikat yang valid atau tidak memilih Sertifikat Server Kepercayaan, Anda mendapatkan pesan kesalahan berikut:

Enkripsi diaktifkan pada koneksi ini, tinjau SSL dan konfigurasi sertifikat Anda untuk SQL Server target, atau aktifkan 'Percayai sertifikat server' dalam dialog koneksi.

Informasi tambahan

Sambungan berhasil dibuat dengan server, tetapi kemudian terjadi kesalahan selama proses masuk. (penyedia: Penyedia SSL, kesalahan: 0 - Rantai sertifikat dikeluarkan oleh otoritas yang tidak tepercaya.) (Microsoft SQL Server)

Jenis autentikasi

Anda dapat memilih dari berbagai jenis autentikasi yang mencakup berbagai skenario. Untuk detailnya, lihat Jenis autentikasi.

Di Visual Studio 17.8 dan yang lebih baru, nama opsi autentikasi untuk koneksi SQL telah diperbarui untuk mencerminkan perubahan nama dari Direktori Aktif ke Microsoft Entra.

Cuplikan layar memperlihatkan jenis autentikasi untuk Visual Studio 17.8 dan yang lebih baru.

Di Visual Studio 17.8 dan yang lebih baru, nama opsi autentikasi untuk koneksi SQL telah diperbarui untuk mencerminkan perubahan nama dari Direktori Aktif ke Microsoft Entra.

Cuplikan layar memperlihatkan jenis autentikasi untuk Visual Studio 17.8 dan yang lebih baru.

Membuka file database MDF

File adalah .mdf singkatan dari File Database Master dan merupakan database SQL yang dikemas ke dalam file. File-file ini memiliki yang terkait .ldf (File Database Log) yang berisi log untuk database tersebut. Anda bisa membuat database baru yang disimpan dalam .mdf file dengan menambahkan item Database berbasis Layanan ke proyek Anda. Lihat Membuat database dan menambahkan tabel.

Jika Anda sudah memiliki .mdf file dalam proyek, Anda bisa mengklik dua kali atau klik kanan dan memilih Buka untuk membukanya di Server Explorer.

Untuk membuka .mdf file yang tidak ada di proyek Anda di Penjelajah Server Visual Studio, ikuti langkah-langkah berikut:

  1. Dalam kotak dialog Tambahkan Koneksi , di bawah Sumber Data, pilih File Database Microsoft SQL Server (SqlClient).

  2. Gunakan tombol Telusuri untuk menemukan dan memilih file database master (.mdf file), atau masukkan jalur dalam kotak Nama file database .

    Cuplikan layar memperlihatkan kotak dialog Tambahkan Koneksi, menyambungkan ke file SQL Database.

    Cuplikan layar memperlihatkan kotak dialog Tambahkan Koneksi, menyambungkan ke file SQL Database.

  3. Pilih metode autentikasi.

  4. Uji koneksi, dan jika berhasil, pilih OK. Sebuah simpul untuk database terbuka di dalam Server Explorer.

Mengubah penyedia

Jika sumber data bukan yang Anda inginkan, klik tombol Ubah untuk memilih sumber data baru atau penyedia data ADO.NET baru. Penyedia baru mungkin meminta kredensial Anda, tergantung pada cara Anda mengonfigurasinya.

Nota

Jika Anda menggunakan Visual Studio 2022 atau yang lebih baru untuk menyambungkan ke penyedia data OLEDB atau ODBC, Anda harus mengetahui bahwa Visual Studio 2022 atau yang lebih baru adalah proses 64-bit.

Ini berarti beberapa alat data di Visual Studio tidak akan dapat tersambung ke database OLEDB atau ODBC menggunakan penyedia data 32-bit. Ini termasuk penyedia data OLEDB Microsoft Access 32-bit serta penyedia 32-bit pihak ketiga lainnya.

Jika Anda perlu mempertahankan aplikasi 32-bit yang terhubung ke OLEDB atau ODBC, Anda masih akan dapat membangun dan menjalankan aplikasi dengan Visual Studio 2022 dan yang lebih baru. Namun, jika Anda perlu menggunakan salah satu Alat Data Visual Studio seperti Penjelajah Server, Wizard Sumber Data, atau Perancang Himpunan Data, Anda harus menggunakan versi Visual Studio yang lebih lama yang masih merupakan proses 32-bit. Versi terakhir Visual Studio yang merupakan proses 32-bit adalah Visual Studio 2019.

Jika Anda berencana mengonversi proyek menjadi proses 64-bit, Anda harus memperbarui koneksi data OLEDB dan ODBC untuk menggunakan penyedia data 64-bit.

Jika aplikasi Anda menggunakan database Microsoft Access, dan dapat mengonversi proyek menjadi 64-bit, disarankan agar Anda menggunakan Mesin database Microsoft Access 64-bit, juga disebut Access Connectivity Engine (ACE). Silakan lihat Penyedia OLE DB untuk Jet dan driver ODBC hanya versi 32-bit untuk informasi lebih lanjut.

Jika Anda menggunakan penyedia data pihak ketiga, sebaiknya sambungkan dengan vendor Anda untuk melihat apakah mereka menawarkan penyedia 64-bit sebelum mengonversi proyek menjadi 64-bit.

Cuplikan layar memperlihatkan cara mengubah penyedia data ADO.NET.

Cuplikan layar memperlihatkan cara mengubah penyedia data ADO.NET.

Menguji koneksi

Setelah Anda memilih sumber data, klik Uji Koneksi. Jika tidak berhasil, Anda harus memecahkan masalah berdasarkan dokumentasi vendor.

Cuplikan layar memperlihatkan kotak pesan Uji Koneksi berhasil.

Jika pengujian berhasil, Anda siap untuk membuat sumber data, yang merupakan istilah Visual Studio yang benar-benar berarti model data yang didasarkan pada database atau layanan yang mendasar.

Menyambungkan menggunakan SQL Server Object Explorer

Pengalaman ini mungkin lebih mudah jika Anda menggunakan SQL Server Object Explorer, yang memberi Anda dialog yang menyediakan lebih banyak bantuan dalam menemukan database yang tersedia secara lokal, di jaringan lokal, dan di langganan Azure Anda, dan menyediakan riwayat pilihan yang baru digunakan.

Untuk mengakses dialog sambungkan dari SQL Server Object Explorer, klik tombol toolbar Tambahkan SQL Server.

Cuplikan layar tombol Tambahkan SQL Server di SQL Server Object Explorer.

Dialog Sambungkan muncul. Pilih lokal, jaringan, atau Azure SQL Server Anda, pilih database, berikan kredensial, dan pilih Sambungkan.

Cuplikan layar dialog SQL Server Object Explorer Connect.

Jika Anda perlu mengatur pengaturan lain dalam string koneksi, Anda dapat menggunakan tautan Tingkat Lanjut , yang memunculkan semua pengaturan. Misalnya, untuk menyambungkan ke database LocalDB yang didasarkan pada file MDF, pilih Tingkat Lanjut lalu atur properti Lampirkan Nama File DB.

Cuplikan layar memperlihatkan pengaturan Tingkat Lanjut.

Setelah Anda selesai menyiapkan koneksi, server dan database diperlihatkan di jendela SQL Server Object Explorer.

Cuplikan layar memperlihatkan pesan Tersambung berhasil.

Dari sana, Anda dapat menelusuri database, menulis dan menjalankan kueri, mengedit data, prosedur dan fungsi tersimpan, dan melakukan tindakan lain secara langsung di Visual Studio.

Menyambungkan menggunakan SQL Server Object Explorer

Pengalaman ini mungkin lebih mudah jika Anda menggunakan SQL Server Object Explorer, yang memberi Anda dialog yang menyediakan lebih banyak bantuan dalam menemukan database yang tersedia secara lokal, di jaringan lokal, dan di langganan Azure Anda, dan menyediakan riwayat pilihan yang baru digunakan.

Untuk mengakses dialog sambungkan dari SQL Server Object Explorer, klik tombol toolbar Tambahkan SQL Server.

Cuplikan layar tombol Tambah SQL Server pada SQL Server Object Explorer

Kotak dialog sambungan muncul. Pilih lokal, jaringan, atau Azure SQL Server Anda, pilih database, berikan kredensial, dan pilih Sambungkan.

Cuplikan layar dialog SQL Server Object Explorer Connect.

Jika Anda perlu mengatur pengaturan lain dalam string koneksi, Anda dapat menggunakan tautan Tingkat Lanjut , yang memunculkan semua pengaturan. Misalnya, untuk menyambungkan ke database LocalDB yang didasarkan pada file MDF, pilih Tingkat Lanjut lalu atur properti Lampirkan Nama File DB.

Cuplikan layar memperlihatkan pengaturan Tingkat Lanjut.

Setelah Anda selesai menyiapkan koneksi, server dan database diperlihatkan di jendela SQL Server Object Explorer.

Cuplikan layar memperlihatkan pesan Tersambung berhasil.

Dari sana, Anda dapat menelusuri database, menulis dan menjalankan kueri, mengedit data, prosedur dan fungsi tersimpan, dan melakukan tindakan lain secara langsung di Visual Studio.

Langkah selanjutnya

Jika Anda menggunakan .NET Framework (bukan .NET Core atau .NET 5 atau yang lebih baru), dan Formulir Windows atau WPF, Anda dapat menggunakan jendela Sumber Data , misalnya, untuk menyiapkan pengikatan data untuk kontrol di Formulir Windows dan Aplikasi WPF, lihat Menambahkan sumber data baru. Alat-alat ini dirancang untuk memungkinkan Anda membuat aplikasi Windows dengan cepat yang perlu memungkinkan pengguna untuk memasukkan, menampilkan, dan memanipulasi data.

Jika Anda menggunakan .NET 5 atau yang lebih baru, .NET Core atau ASP.NET Core, Anda dapat menyambungkan aplikasi Anda ke database menggunakan Connected Services. Dengan menggunakan Connected Services, Anda dapat dengan mudah menggunakan database pengembangan lokal, yang dihosting oleh SQL LocalDB, SQL Server yang berjalan dalam kontainer, atau instans SQL Server lokal, lalu beralih ke Azure SQL Database saat Anda siap untuk menyebarkan ke cloud. Untuk .NET 5 atau yang lebih baru, .NET Core dan ASP.NET Core, Anda harus mempertimbangkan untuk menggunakan Entity Framework Core sebagai kerangka kerja database Anda.