Visual Studio Bağlan ed Services kullanarak uygulamanıza Azure Cosmos DB ekleme

Visual Studio ile, Bağlan Ed Services özelliğini kullanarak aşağıdakilerden herhangi birini Azure Cosmos DB'ye bağlayabilirsiniz:

• .NET Framework konsol uygulaması
• ASP.NET Model-Görünüm Denetleyicisi (MVC) (.NET Framework)
• ASP.NET Core
• .NET Core (konsol uygulaması, WPF, Windows Forms, sınıf kitaplığı dahil)
• .NET Core Çalışan Rolü
• Azure İşlevleri
• Evrensel Windows Platformu Uygulaması
• Xamarin
• Cordova

Bağlı hizmet işlevi, projenize tüm gerekli başvuruları ve bağlantı kodunu ekler ve yapılandırma dosyalarınızı uygun şekilde değiştirir.

Not

Bu konu, Windows üzerinde Visual Studio için geçerlidir. Mac için Visual Studio için bkz. Mac için Visual Studio'da Bağlan hizmetler.

Önkoşullar

• Azure iş yükünün yüklü olduğu Visual Studio.
• Desteklenen türlerden birinin projesi
• Azure hesabı. Azure hesabınız yoksa Visual Studio aboneleri için Azure avantajlarınızı etkinleştirin veya ücretsiz deneme sürümüne kaydolun.

Bağlan ed Services kullanarak Azure Cosmos DB'ye Bağlan

Not

.NET Framework projeleri için Bağlan Hizmetler kullanıcı arabirimi biraz farklıdır. Farklılıkları görmek için bu sayfanın Visual Studio 2019 sürümüyle karşılaştırın.

1. Projenizi Visual Studio'da açın.

2. Çözüm Gezgini Bağlan Hizmetler düğümüne sağ tıklayın ve bağlam menüsünden Ekle'yi seçerek kullanılabilir hizmetler menüsünü açın.

   

3. Azure Cosmos DB'yi seçin. Bağımlılık Bağlan sayfası görüntülenir. Biri yerel öykünücü, biri kapsayıcıda Azure Cosmos DB Öykünücüsü (Yerel) ve diğeri de canlı Azure Cosmos DB hizmetine bağlanmak için olmak üzere iki seçenek görmeniz gerekir. Yerel öykünücüden başlayarak maliyeti azaltabilir ve erken geliştirmeyi basitleştirebilirsiniz. Daha sonra bu adımları yineleyip diğer seçeneği belirleyerek canlı hizmete geçebilirsiniz.

   

   Azure Cosmos DB Öykünücüsü'ni kullanmayı seçerseniz, projenizin nasıl değiştirildiğini gösteren Değişikliklerin özeti ekranını görmek için İleri'ye tıklayın. Projenize bir NuGet paket başvurusu eklenir ve yerel öykünücünün bağlantı kodu projenize eklenir. Son ekranda Son'a tıkladığınızda öykünücünün kapsayıcısı oluşturulur; çıktı penceresinde görüntü indirme durumunu görürsünüz.

   Azure hizmetine bağlanmak istiyorsanız, sonraki adıma geçin veya henüz oturum açmadıysanız devam etmeden önce Azure hesabınızda oturum açın. Azure hesabınız yoksa ücretsiz denemeye kaydolabilirsiniz.

4. Azure Cosmos DB ekranında mevcut bir Azure Cosmos DB'yi seçin ve İleri'yi seçin.

   Veritabanı oluşturmanız gerekiyorsa sonraki adıma geçin. Aksi takdirde 7. adıma geçin.

   

5. Azure Cosmos DB oluşturmak için:

   1. Ekranın alt kısmındaki Yeni Azure Cosmos DB oluştur'u seçin.

   2. Azure Cosmos DB: Yeni oluştur ekranını doldurun ve Oluştur'u seçin.

      

   3. Azure Cosmos DB'yi Yapılandır iletişim kutusu görüntülendiğinde, yeni veritabanı listede görünür. Listeden yeni veritabanını seçin ve İleri'yi seçin.

6. bağlantı dizesi bir ad girin ve bağlantı dizesi yerel gizli diziler dosyasında mı yoksa Azure Key Vault'ta mı depolanmasını istediğinizi seçin.

   

   bağlantı dizesi gizli dizi olarak eklenir ve uygulama yapılandırmasında kullanılabilir hale getirilir. ASP.NET Core uygulamalarında, nesnesindeki ConfigurationWebApplicationBuild özelliğini kullanarak bu bağlantı dizesi erişebilirsiniz.

7. Değişiklikleri özetleme ekranı, işlemi tamamlarsanız projenizde yapılacak tüm değişiklikleri gösterir. Değişiklikler tamam görünüyorsa Son'u seçin.

   

8. Çözüm Gezgini'da Bağlan Hizmetler düğümüne çift tıklayarak Bağlan Hizmetler sekmesini açın. Bağlantı, Hizmet Bağımlılıkları bölümünün altında görünür:

   

   Eklediğiniz bağımlılığın yanındaki üç noktaya tıklarsanız, sihirbazı yeniden açmak ve bağlantıyı değiştirmek için Bağlan gibi çeşitli seçenekleri görebilirsiniz. Yerel bağımlılıkları başlatma, ayarları değiştirme ve daha fazlasını yapmaya yönelik seçenekleri görmek için pencerenin sağ üst kısmındaki üç noktaya da tıklayabilirsiniz.

9. Varsayılan olarak, kapsayıcıdaki bellek sınırı 2G olarak ayarlanır, ancak normalde Azure Cosmos DB'yi çalıştırmak için daha fazla bellek gerekir. Bunu düzeltmek için çözüm klasörünüzün altındaki klasöre gidin .vs/sd/<GUID>/local . Windows Gezgini'nde, klasörü görmek .vs için gizli dosyaları etkinleştirmeniz gerekebilir. cosmosdb1.docker-compose.yml dosyasını bulun ve açın. 4G veya daha yüksek bir bellek sınırı ayarlayın.

   mem_limit = 4G
   

   Kapsayıcıyı yeni ayar ile yeniden başlatmak için, Bağlan Hizmetler sekmesinin Hizmet Bağımlılıkları bölümünde üç noktaya tıklayın ve Yerel bağımlılıkları başlat'ı seçin.

Not

Azure Cosmos DB için yerel öykünücü, Azure Cosmos DB için geçici lisans kullanan bir temel görüntüye başvurabilir. Kapsayıcı başlatılmazsa Azure Cosmos DB kapsayıcısı için Kapsayıcılar* penceresindeki Günlükler sekmesini denetleyin. BIR PAL süre sonu sorunundan bahsediyorsa, yerel kapsayıcı için en son temel görüntüyü almanız gerekir. Konsol isteminden aşağıdaki komutu çalıştırın: docker pull mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:latest. Lisans düzenli aralıklarla güncelleştirilir ve süresi dolduğunda en yeni kapsayıcıya yenileme işlemi sorunu çözmelidir. Azure Cosmos DB öykünücüsü gitHub deposunda Azure Cosmos DB öykünücüsüyle ilgili sorunları görüntüleyebilir ve bildirebilirsiniz.

Sonraki adımlar

ASP.NET Core'da geliştirme aşamasındaki uygulama gizli dizilerinin Kasa depolamasını izleyerek gizli dizileri güvenli bir şekilde depolamayı öğrenin. Özellikle gizli dizi deposundan bağlantı dizesi okumak için yapılandırma API'sini kullanarak gizli diziyi okuma bölümünde olduğu gibi kod ekleyebilirsiniz. Kod şöyle görünebilir; burada builder ASP.NET Core proje şablonlarındaki Program.cs gösterilen bir örneğidirWebApplicationBuild:

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

Çeşitli CosmosClient yöntemleriyle Azure Cosmos DB işlevselliğine erişim sağlar. örneğine CosmosClientsahip olduktan sonra şu kılavuzu izleyerek bir NoSQL veritabanı oluşturabilirsiniz: .NET kullanarak NoSQL için Azure Cosmos DB'de veritabanı oluşturma.

İlgili içerik

• Azure Cosmos DB ürün sayfası
• Azure Cosmos DB belgeleri
• Bağlan hizmetler (Mac için Visual Studio)
• ASP.NET Core'da bağımlılık ekleme