Menambahkan koneksi ke database Azure SQL

Dengan Visual Studio Koneksi ed Services, Anda dapat terhubung ke Azure SQL Database, emulator lokal (misalnya, selama pengembangan), atau database SQL Server lokal. Untuk SQL Server lokal, lihat Koneksi ke database.

Dengan Visual Studio, Anda dapat terhubung dari salah satu jenis proyek berikut dengan menggunakan fitur Koneksi ed Services:

• Inti ASP.NET
• .NET Core (termasuk aplikasi konsol, WPF, Formulir Windows, pustaka kelas)
• Peran Pekerja .NET Core
• Azure Functions
• Aplikasi konsol .NET Framework
• ASP.NET Model-View-Controller (MVC) (.NET Framework)
• Aplikasi Universal Windows Platform

Fungsionalitas layanan terhubung menambahkan semua referensi dan kode koneksi yang diperlukan ke proyek, dan memodifikasi file konfigurasi Anda dengan tepat.

Prasyarat

• Visual Studio dengan beban kerja Azure diinstal.
• Proyek dari salah satu jenis yang didukung
• Akun Azure. Jika Anda tidak memiliki akun Azure, aktifkan manfaat Azure Anda untuk pelanggan Visual Studio atau daftar untuk uji coba gratis.

Menyambungkan Azure SQL Database menggunakan Connected Services

1. Buka proyek Anda di Visual Studio.

2. Di Penjelajah Solusi, klik kanan simpul Layanan Koneksi, dan, dari menu konteks, pilih Tambahkan untuk membuka menu layanan yang tersedia.

   

3. Pilih Database SQL Server. Halaman Koneksi ke dependensi muncul. Anda akan melihat beberapa opsi:

   • SQL Server Express LocalDB, penawaran SQL Database bawaan yang diinstal dengan Visual Studio
   • Database SQL Server pada kontainer lokal di komputer Anda
   • SQL Server Database, SQL Server lokal di jaringan lokal
   • Azure SQL Database, untuk SQL Database yang berjalan sebagai layanan Azure

   Anda dapat mengurangi biaya dan menyederhanakan pengembangan awal dengan memulai dengan database lokal. Anda dapat bermigrasi ke layanan langsung di Azure nanti dengan mengulangi langkah-langkah ini dan memilih opsi lain. Jika Anda membuat database secara lokal yang ingin Anda buat ulang di Azure, Anda bisa memigrasikan database Anda ke Azure pada saat itu.

   

   Jika Anda ingin menyambungkan ke layanan Azure, lanjutkan ke langkah berikutnya, atau jika Anda belum masuk, masuk ke akun Azure Anda sebelum melanjutkan. Jika Anda tidak memiliki akun Azure, Anda dapat mendaftar untuk coba gratis.

4. Di layar Konfigurasikan Azure SQL Database, pilih Azure SQL Database yang sudah ada, dan pilih Berikutnya.

   Jika Anda perlu membuat komponen baru, lanjutkan ke langkah berikutnya. Jika tidak, lewati ke langkah 7.

   

5. Untuk membuat database Azure SQL:

   1. Pilih Buat Baru dengan tanda plus hijau.

   2. Isi Azure SQL Database: Buat layar baru, dan pilih Buat.

      

   3. Saat layar Konfigurasikan Azure SQL Database ditampilkan, database baru muncul dalam daftar. Pilih database baru dalam daftar, dan pilih Berikutnya.

6. Masukkan nama string koneksi, atau pilih default, dan pilih apakah Anda ingin string koneksi disimpan dalam file rahasia lokal, atau di Azure Key Vault.

   

7. Layar Ringkasan perubahan menunjukkan semua modifikasi yang akan dilakukan pada proyek jika Anda menyelesaikan proses. Jika perubahan terlihat OK, pilih Selesai.

   

   Jika diminta untuk mengatur aturan firewall, pilih Ya.

   

8. Di Penjelajah Solusi, klik dua kali pada simpul Layanan Koneksi untuk membuka tab Layanan yang Koneksi. Koneksi muncul di bawah bagian Dependensi Layanan:

   

   Jika Anda mengklik tiga titik di samping dependensi yang Anda tambahkan, Anda bisa melihat berbagai opsi seperti Koneksi untuk membuka kembali wizard dan mengubah koneksi. Anda juga dapat mengklik tiga titik di kanan atas jendela untuk melihat opsi untuk memulai dependensi lokal, mengubah pengaturan, dan lainnya.

Mengakses string koneksi

Pelajari cara menyimpan rahasia dengan aman dengan mengikuti penyimpanan rahasia aplikasi Brankas dalam pengembangan di ASP.NET Core. Secara khusus, untuk membaca string koneksi dari penyimpanan rahasia, Anda dapat menambahkan kode seperti dalam Membaca rahasia melalui API konfigurasi. Lihat juga Injeksi dependensi di ASP.NET Core.

Migrasi Kerangka Kerja Entitas

Mungkin lebih mudah untuk bekerja dengan penyimpanan data lokal selama pengembangan awal, tetapi dengan Entity Framework Core, ketika Anda siap untuk pindah ke cloud, Anda dapat menggunakan dukungan Visual Studio untuk migrasi Kerangka Kerja Entitas untuk memindahkan database Anda, atau menggabungkan perubahan dengan penyimpanan data jarak jauh. Lihat Gambaran umum migrasi.

Pada tab Koneksi ed Services, Anda dapat menemukan perintah migrasi dengan mengklik tiga titik, seperti yang ditunjukkan pada cuplikan layar:

Perintah tersedia di sana untuk membuat migrasi baru, menerapkannya secara langsung, atau menghasilkan skrip SQL yang menerapkan migrasi.

Menambahkan migrasi

Saat perubahan model data diperkenalkan, Anda dapat menggunakan alat Entity Framework Core untuk menambahkan migrasi terkait yang menjelaskan dalam kode pembaruan yang diperlukan untuk menjaga skema database tetap sinkron. Entity Framework Core membandingkan model saat ini dengan rekam jepret model lama untuk menentukan perbedaan, dan menghasilkan file sumber migrasi. File ditambahkan ke proyek Anda, biasanya dalam folder bernama Migrasi dan dapat dilacak di kontrol sumber proyek Anda seperti file sumber lainnya.

Saat Anda memilih opsi ini, Anda diminta untuk memberikan nama kelas konteks yang mewakili skema database yang ingin Anda migrasikan.

Perbarui database

Setelah migrasi dibuat, migrasi dapat diterapkan ke database. Entity Framework memperbarui database dan skema Anda dengan perubahan yang ditentukan dalam kode migrasi. Saat Anda memilih opsi ini, Anda diminta untuk memberikan nama kelas konteks yang mewakili skema database yang ingin Anda migrasikan.

Skrip SQL yang dibuat

Cara yang disarankan untuk menyebarkan migrasi ke database produksi adalah dengan menghasilkan skrip SQL. Keuntungan dari strategi ini meliputi:

• Skrip SQL dapat ditinjau untuk akurasi; ini penting karena menerapkan perubahan skema pada database produksi adalah operasi yang berpotensi berbahaya yang dapat melibatkan kehilangan data.
• Dalam beberapa kasus, skrip dapat disetel agar sesuai dengan kebutuhan spesifik database produksi.
• Skrip SQL dapat digunakan bersama dengan teknologi penyebaran, dan bahkan dapat dihasilkan sebagai bagian dari proses CI Anda.
• Skrip SQL dapat disediakan untuk DBA, dan dapat dikelola dan diarsipkan secara terpisah.

Saat Anda menggunakan opsi ini, Anda akan dimintai kelas konteks database dan lokasi untuk file skrip.

Buka di SQL Server Object Explorer

Untuk kenyamanan, perintah ini memungkinkan Anda melompat ke SQL Server Object Explorer, sehingga Anda dapat melihat tabel dan entitas database lainnya, dan bekerja langsung dengan data Anda. Lihat Penjelajah objek.

Langkah berikutnya

Anda dapat melanjutkan mulai cepat untuk Azure SQL Database, tetapi alih-alih memulai dari awal, Anda dapat memulai setelah koneksi awal disiapkan. Jika Anda menggunakan Entity Framework, Anda dapat memulai di Menambahkan kode untuk menyambungkan ke Azure SQL Database. Jika Anda menggunakan SqlClient atau ADO.NET kelas data, Anda dapat memulai di Menambahkan kode untuk menyambungkan ke Azure SQL Database.

Kode Anda tidak akan sama persis dengan apa yang digunakan dalam mulai cepat, yang menggunakan cara yang berbeda untuk mendapatkan string koneksi. string koneksi adalah rahasia dan disimpan dengan aman seperti yang dijelaskan dalam penyimpanan Brankas rahasia aplikasi dalam pengembangan di ASP.NET Core. Secara khusus, untuk membaca string koneksi dari penyimpanan rahasia, Anda dapat menambahkan kode seperti dalam Membaca rahasia melalui API konfigurasi. Dalam proyek ASP.NET Core, string koneksi yang dibuat oleh Koneksi ed Services tersedia dalam objek konfigurasi. Anda dapat mengaksesnya dengan properti di WebApplicationBuilder kelas (builder dalam banyak templat proyek), seperti dalam contoh berikut:

var connection = builder.Configuration["ConnectionStrings:ConnectionString1"];

Konten terkait

• Halaman produk Azure SQL Database
• Dokumentasi Azure SQL Database
• Layanan tersambung (Visual Studio untuk Mac)