快速入门：使用 .NET SDK 和 Azure Cosmos DB 的 API for MongoDB 构建 Xamarin.Forms 应用

1. 在 Windows 上打开命令提示符，或在 Mac 上打开终端，创建名为 git-samples 的新文件夹，然后关闭窗口。

   md "C:\git-samples"
   

   mkdir '$home\git-samples\
   

2. 打开诸如 git bash 之类的 git 终端窗口，并使用 cd 命令更改为要安装示例应用的新文件夹。

   cd "C:\git-samples"
   

3. 运行下列命令，克隆示例存储库。 此命令在计算机上创建示例应用程序的副本。

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

如果不想使用 git，也可以下载 ZIP 文件格式的项目

查看代码

此步骤是可选的。 如果有意了解如何使用代码创建数据库资源，可以查看以下代码片段。 否则，可以直接跳转到更新连接字符串。

以下代码片段全部摘自 MongoService 类，可在以下路径找到：src/TaskList.Core/Services/MongoService.cs。

• 初始化 Mongo 客户端。

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

• 检索对数据库和集合的引用。 如果它们尚不存在，MongoDB.NET SDK 会自动创建该数据库和集合。

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

• 以列表形式检索所有文档。

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

• 查询特定文档。

  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;
  }
  

• 创建任务并将其插入到集合中。

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

• 更新集合中的任务。

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

• 从集合中删除任务。

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

更新连接字符串

现在返回到 Azure 门户，获取连接字符串信息，并将其复制到应用。

1. 在 Azure 门户的 Azure Cosmos DB 帐户的左侧导航栏中，单击“连接字符串”，然后单击“读写密钥”。 在后续步骤中，将使用屏幕右侧的复制按钮复制“主连接字符串”。

2. 打开 TaskList.Core 项目的 Helpers 目录中的 APIKeys.cs 文件。

3. 从门户复制“主连接字符串”值（使用复制按钮），并将其设置为 APIKeys.cs 文件中 ConnectionString 字段的值。

4. 从连接字符串中删除 &replicaSet=globaldb。 如果不从查询字符串中删除该值，则会出现运行时错误。

   重要

   必须从连接字符串的查询字符串中删除 &replicaSet=globaldb 键值对，避免运行时错误。

   现已使用与 Azure Cosmos DB 进行通信所需的所有信息更新应用。

运行应用程序

Visual Studio 2019

1. 在 Visual Studio 中，右键单击解决方案资源管理器中的每个项目，并单击“管理 NuGet 包”。
2. 单击“还原所有 NuGet 包”。
3. 右键单击“TaskList.Android”，并选择“设为启动项目”。
4. 按 F5 开始调试应用程序。
5. 如果想要在 iOS 上运行，首先请将计算机连接到 Mac（参阅操作说明）。
6. 右键单击“TaskList.iOS”项目，并选择“设为启动项目”。
7. 单击 F5 开始调试应用程序。

Visual Studio for Mac

1. 在平台下拉列表中，根据使用的平台选择“TaskList.iOS”或“TaskList.Android”。
2. 按 cmd+Enter 开始调试应用程序。

在 Azure 门户中查看 SLA

Azure 门户可监视 Azure Cosmos DB 帐户吞吐量、存储、可用性、延迟和一致性。 与 Azure Cosmos DB 服务级别协议 (SLA) 关联的指标的图表显示与实际性能相比的 SLA 值。 此套指标使得监视 SLA 十分透明。

若要查看指标和 SLA，请执行以下操作：

1. 请在 Azure Cosmos DB 帐户的导航菜单中选择“指标”。

2. 选择一个选项卡，如“延迟”，然后选择右侧的时间范围。 比较图表上的“实际”和“SLA”线。

   

3. 查看其他选项卡上的指标。

清理资源

执行完应用和 Azure Cosmos DB 帐户的操作以后，可以删除所创建的 Azure 资源，以免产生更多费用。 若要删除资源，请执行以下操作：

1. 在 Azure 门户的“搜索”栏中，搜索并选择“资源组” 。

2. 从列表中选择为本快速入门创建的资源组。

   

3. 在资源组“概览”页上，选择“删除资源组” 。

   

4. 在下一窗口中输入要删除的资源组的名称，然后选择“删除” 。

后续步骤

本快速入门已介绍如何创建 Azure Cosmos DB 帐户和使用 API for MongoDB 运行 Xamarin.Forms 应用。 现在可以将其他数据导入 Cosmos DB 帐户。

尝试为迁移到 Azure Cosmos DB 进行容量规划？ 可以使用有关现有数据库群集的信息进行容量规划。

• 如果只知道现有数据库群集中的 vCore 和服务器数量，请阅读使用 vCore 或 vCPU 估算请求单位
• 若知道当前数据库工作负载的典型请求速率，请阅读使用 Azure Cosmos DB 容量计划工具估算请求单位