Visual Studio Bağlı Hizmetler'i kullanarak uygulamanıza Azure Cosmos DB ekleme

  • Makale

Visual Studio ile, Bağlı Hizmetler ö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.

Ö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ğlı Hizmetleri kullanarak Azure Cosmos DB'ye bağlanma

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

  2. Çözüm Gezgini Bağlı Hizmetler düğümüne sağ tıklayın ve bağlam menüsünde Bağlı Hizmet Ekle'yi seçin.

    Bağlı Hizmetler düğümünü görmüyorsanız Proje>Bağlı Hizmetler> Ekle'yi seçin.

  3. Bağlı Hizmetler sekmesinde, Hizmet Bağımlılıkları için + simgesini seçin.

    Hizmet bağımlılığı eklemeyi gösteren ekran görüntüsü.

  4. Bağımlılık Ekle sayfasında Azure Cosmos DB'yi seçin.

    Henüz oturum açmadıysanız Azure hesabınızda oturum açın. Azure hesabınız yoksa ücretsiz denemeye kaydolabilirsiniz.

  5. 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.

    Var olan bir Azure Cosmos DB'nin projeye nasıl ekleneceğini gösteren ekran görüntüsü.

  6. 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.

  7. 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.

  8. 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.

  9. Bağlantı, Bağlı Hizmetler sekmesinin Hizmet Bağımlılıkları bölümünde görünür.

Not

.NET Framework projeleri için Bağlı 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ğlı 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.

    Bağlı Hizmetler bağlam menüsü seçeneklerini gösteren ekran görüntüsü.

    Bağlı Hizmetler düğümünü görmüyorsanız Proje>Bağlı Hizmetler> Ekle'yi seçin.

  3. Azure Cosmos DB'yi seçin. Bağımlılıklara 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 seçimlerini gösteren ekran görüntüsü.

    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 Configuration WebApplicationBuild ö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 bağlı hizmetler sekmesini açmak için Bağlı Hizmetler düğümüne çift tıklayın. Bağlantı, Hizmet Bağımlılıkları bölümünün altında görünür:

    Bağlı hizmeti ekledikten sonra

    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ğlı 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ında uygulama gizli dizilerinin güvenli bir şekilde depolanması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