hızlı başlangıç: .net SDK ve Azure Cosmos DB mongodb için apı 'si ile bir Xamarin. Forms uygulaması oluşturma

1. Windows bir komut istemi açın veya Mac 'te terminali açın, git-samples adlı yeni bir klasör oluşturun ve ardından pencereyi kapatın.

   md "C:\git-samples"
   

   mkdir '$home\git-samples\
   

2. Git Bash gibi bir Git terminal penceresi açın ve örnek uygulamayı yüklemek üzere yeni bir klasör olarak değiştirmek için cd komutunu kullanın.

   cd "C:\git-samples"
   

3. Örnek depoyu kopyalamak için aşağıdaki komutu çalıştırın. Bu komut bilgisayarınızda örnek uygulamanın bir kopyasını oluşturur.

   git clone https://github.com/Azure-Samples/azure-cosmos-db-mongodb-xamarin-getting-started.git
   

Git kullanmak istemiyorsanız projeyi ZIP dosyası olarak da indirebilirsiniz

Kodu gözden geçirin

Bu adım isteğe bağlıdır. Veritabanı kaynaklarının kodda nasıl oluşturulduğunu öğrenmekle ilgileniyorsanız, aşağıdaki kod parçacıklarını gözden geçirebilirsiniz. Aksi durumda, Bağlantı dizenizi güncelleştirme bölümüne atlayabilirsiniz.

Aşağıdaki kod parçacıkları, şu MongoService yolda bulunan sınıfından alınır: src/tasklist. Core/Services/MongoService. cs.

• Mongo İstemcisini başlatın.

  MongoClientSettings settings = MongoClientSettings.FromUrl(new MongoUrl(APIKeys.ConnectionString));
  
  settings.SslSettings = new SslSettings() { EnabledSslProtocols = SslProtocols.Tls12 };
  
  settings.RetryWrites = false;
  
  MongoClient mongoClient = new MongoClient(settings);
  

• Veritabanı ve koleksiyona bir başvuru alın. Mevcut değilse MongoDB .NET SDK'sı otomatik olarak veritabanını ve koleksiyonu oluşturur.

  string dbName = "MyTasks";
  string collectionName = "TaskList";
  
  var db = mongoClient.GetDatabase(dbName);
  
  var collectionSettings = new MongoCollectionSettings 
  {
      ReadPreference = ReadPreference.Nearest
  };
  
  tasksCollection = db.GetCollection<MyTask>(collectionName, collectionSettings);
  

• Tüm belgeleri Liste olarak alın.

  var allTasks = await TasksCollection
                  .Find(new BsonDocument())
                  .ToListAsync();
  

• Belirli belgeleri sorgulayın.

  public async Task<List<MyTask>> GetIncompleteTasksDueBefore(DateTime date)
  {
      var tasks = await TasksCollection
                      .AsQueryable()
                      .Where(t => t.Complete == false)
                      .Where(t => t.DueDate < date)
                      .ToListAsync();
  
      return tasks;
  }
  

• Bir görev oluşturun ve koleksiyona ekleyin.

  public async Task CreateTask(MyTask task)
  {
      await TasksCollection.InsertOneAsync(task);
  }
  

• Bir koleksiyondaki görevi güncelleştirin.

  public async Task UpdateTask(MyTask task)
  {
      await TasksCollection.ReplaceOneAsync(t => t.Id.Equals(task.Id), task);
  }
  

• Bir koleksiyondan bir görevi silin.

  public async Task DeleteTask(MyTask task)
  {
      await TasksCollection.DeleteOneAsync(t => t.Id.Equals(task.Id));
  }
  

Bağlantı dizenizi güncelleştirme

Bu adımda Azure portalına dönerek bağlantı dizesi bilgilerinizi kopyalayıp uygulamaya ekleyin.

1. Azure portalında, Azure Cosmos DB hesabınızın sol taraftaki gezinti menüsünden Bağlantı Dizesi'ne ve ardından Okuma-Yazma Anahtarları'na tıklayın. Ekranın sağ tarafındaki kopyala düğmesini kullanarak sonraki adımlarda bulunan Birincil Bağlantı Dizesini kopyalayın.

2. TaskList.Core projesinin Helpers dizinindeki APIKeys.cs dosyasını açın.

3. Portaldan birincil bağlantı dizesi değerinizi kopyalayın (kopyala düğmesini kullanarak) ve APIKeys.cs dosyanızdaki ConnectionString alanının değeri olarak kullanın.

4. &replicaSet=globaldbBağlantı dizesinden kaldır. Bu değeri sorgu dizesinden kaldırdıysanız bir çalışma zamanı hatası alırsınız.

Bu adımlarla uygulamanıza Azure Cosmos DB ile iletişim kurması için gereken tüm bilgileri eklemiş oldunuz.

Uygulamayı çalıştırma

Visual Studio 2019

1. Visual Studio'nun Çözüm Gezgini bölümünde her bir projeye sağ tıklayın ve ardından NuGet Paketlerini Yönet'e tıklayın.
2. Tüm NuGet paketlerini geri yükle'ye tıklayın.
3. TaskList.Android'e sağ tıklayın ve Başlangıç projesi olarak ayarla'yı seçin.
4. Uygulamada hata ayıklamaya başlamak için F5'e basın.
5. iOS üzerinde çalıştırmak istiyorsanız ilk olarak makinenizin bir Mac'e bağlı olduğundan (talimatlara buradan ulaşabilirsiniz) emin olun.
6. TaskList.iOS projesine sağ tıklayın ve Başlangıç projesi olarak ayarla'yı seçin.
7. Uygulamada hata ayıklamaya başlamak için F5'e basın.

Mac için Visual Studio

1. Platform açılan listesinde çalıştırmak istediğiniz platforma bağlı olarak TaskList.iOS veya TaskList.Android girişini seçin.
2. Uygulamada hata ayıklamaya başlamak için Cmd+Enter tuşlarına basın.

Azure portalında SLA'ları gözden geçirme

Bu Azure portal, Cosmos DB aktarım hızı, depolama alanı, kullanılabilirlik, gecikme süresi ve tutarlılığı izler. Bir Azure Cosmos DB Hizmet Düzeyi Sözleşmesi (SLA) ile ilişkili ölçümler, gerçek performansla karşılaştırıldığında SLA değerini gösterir. Bu ölçüm paketi, SLA'larınızı izlemenizi saydam hale gelir.

Ölçümleri ve SLA'ları gözden geçirmek için:

1. Hesap gezinti Cosmos DB Ölçümler'i seçin.

2. Gecikme süresi gibi bir sekme seçin ve sağdan bir zaman çerçevesi seçin. Grafiklerde Gerçek ve SLA çizgilerini karşılaştırın.

   

3. Diğer sekmelerde ölçümleri gözden geçirme.

Kaynakları temizleme

Uygulama ve hesap hesabınızla Azure Cosmos DB, daha fazla ücret ödemeden oluşturduğunuz Azure kaynaklarını silebilirsiniz. Kaynakları silmek için:

1. Arama Azure portal kaynak grupları için arama ve seçimlerini kullanın.

2. Listeden bu hızlı başlangıç için oluşturduğunuz kaynak grubunu seçin.

   

3. Kaynak grubunun Genel Bakış sayfasında Kaynak grubunu sil'i seçin.

   

4. Sonraki pencerede, silinecek kaynak grubunun adını girin ve Sil'i seçin.

Sonraki adımlar

Bu hızlı başlangıçta Azure Cosmos DB hesabı oluşturmayı ve MongoDB API’sini kullanarak bir Xamarin.Forms uygulamasını çalıştırmayı öğrendiniz. Şimdi Cosmos DB hesabınıza ek veri aktarabilirsiniz.

Azure Cosmos DB bir geçişe yönelik kapasite planlaması yapılmaya çalışılıyor musunuz? Kapasite planlaması için mevcut veritabanı kümeniz hakkında bilgi kullanabilirsiniz.

• Varsa, var olan veritabanı kümenizdeki sanal çekirdek ve sunucu sayısı varsa, sanal çekirdekler veya vCPU 'lar kullanarak istek birimlerini tahmin etme hakkında bilgi edinin
• geçerli veritabanı iş yükünüz için tipik istek hızlarını biliyorsanız, Azure Cosmos DB kapasite planlayıcısı kullanarak istek birimlerini tahmin etme hakkında bilgi edinin