Menambahkan Azure Cosmos DB ke aplikasi Anda dengan menggunakan Layanan Tersambung Visual Studio

Dengan Visual Studio, Anda dapat menyambungkan salah satu hal berikut ini ke Azure Cosmos DB dengan menggunakan fitur Connected Services:

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

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

Catatan

Topik ini berlaku untuk Visual Studio di Windows. Untuk Visual Studio untuk Mac, lihat Layanan tersambung di Visual Studio untuk Mac.

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 ke Azure Cosmos DB menggunakan Layanan Tersambung

Catatan

Untuk proyek .NET Framework, Koneksi ed Services UI sedikit berbeda. Untuk melihat perbedaannya, bandingkan dengan versi Visual Studio 2019 dari halaman ini.

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 Azure Cosmos DB. Halaman Koneksi ke dependensi muncul. Anda akan melihat dua opsi, satu untuk emulator lokal, Emulator Azure Cosmos DB pada kontainer (Lokal), dan satu untuk menyambungkan ke layanan Azure Cosmos DB langsung. Anda dapat mengurangi biaya dan menyederhanakan pengembangan awal dengan memulai dengan emulator lokal. Anda dapat bermigrasi ke layanan langsung nanti dengan mengulangi langkah-langkah ini dan memilih opsi lainnya.

   

   Jika Anda memilih untuk menggunakan Emulator Azure Cosmos DB, klik Berikutnya untuk melihat layar Ringkasan perubahan, yang menunjukkan bagaimana proyek Anda dimodifikasi. Referensi paket NuGet ditambahkan ke proyek Anda dan kode koneksi untuk emulator lokal ditambahkan ke proyek Anda. Setelah mengeklik Selesai di layar terakhir, kontainer untuk emulator dibuat; Anda akan melihat status unduhan gambar di jendela output.

   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 Azure Cosmos DB, pilih Azure Cosmos DB yang sudah ada, dan pilih Berikutnya.

   Jika Anda perlu membuat database, lanjut ke langkah berikutnya. Jika tidak, lewati ke langkah 7.

   

5. Untuk membuat Azure Cosmos DB:

   1. Pilih Buat Azure Cosmos DB baru di bagian bawah layar.

   2. Isi Azure Cosmos DB: Buat layar baru, dan pilih Buat.

      

   3. Saat dialog Konfigurasikan Azure Cosmos DB ditampilkan, database baru muncul dalam daftar. Pilih database baru dalam daftar, dan pilih Berikutnya.

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

   

   string koneksi ditambahkan sebagai rahasia dan tersedia dalam konfigurasi aplikasi. Di aplikasi ASP.NET Core, Anda dapat mengakses string koneksi ini dengan menggunakan Configuration properti pada WebApplicationBuild objek .

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

   

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.

9. Secara default, batas memori dalam kontainer diatur ke 2G, tetapi biasanya, lebih banyak memori diperlukan untuk menjalankan Azure Cosmos DB. Untuk memperbaikinya, navigasikan ke folder di .vs/sd/<GUID>/local bawah folder solusi Anda. Di Windows Explorer, Anda mungkin harus mengaktifkan file tersembunyi untuk melihat .vs folder. Temukan dan buka file cosmosdb1.docker-compose.yml. Tetapkan batas memori 4G atau lebih tinggi.

   mem_limit = 4G
   

   Untuk memulai ulang kontainer dengan pengaturan baru, di bagian Dependensi Layanan dari tab Layanan yang Koneksi, klik tiga titik, dan pilih Mulai dependensi lokal.

Catatan

Emulator lokal untuk Azure Cosmos DB mungkin mereferensikan gambar dasar yang menggunakan lisensi sementara untuk Azure Cosmos DB. Jika kontainer tidak dimulai, periksa tab Log di jendela Kontainer* untuk kontainer Azure Cosmos DB. Jika menyebutkan masalah kedaluwarsa PAL, Anda perlu mendapatkan gambar dasar terbaru untuk kontainer lokal. Jalankan perintah berikut dari prompt konsol: docker pull mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:latest. Lisensi diperbarui secara berkala, dan ketika kedaluwarsa, refresh ke kontainer terbaru harus menyelesaikan masalah. Anda dapat melihat dan melaporkan masalah untuk emulator Azure Cosmos DB di repositori GitHub emulator Azure Cosmos DB.

Langkah berikutnya

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. Kode mungkin terlihat seperti ini, di mana builder adalah instans WebApplicationBuild yang muncul di Program.cs dalam templat proyek ASP.NET Core:

// New instance of CosmosClient class using a connection string
using CosmosClient client = new(
    connectionString: builder.Configuration["CosmosDBConnectionString"]
);

menyediakan CosmosClient akses ke fungsionalitas Azure Cosmos DB melalui berbagai metodenya. Setelah Anda memiliki instans CosmosClient, Anda dapat membuat database NoSQL dengan mengikuti panduan ini: Membuat database di Azure Cosmos DB untuk NoSQL menggunakan .NET.

Konten terkait

• Halaman produk Azure Cosmos DB
• Dokumentasi Azure Cosmos DB
• Layanan tersambung (Visual Studio untuk Mac)
• Injeksi dependensi di ASP.NET Core