Inicio rápido: Creación de una aplicación Xamarin.Forms con el SDL de .NET y la API de Azure Cosmos DB para MongoDB

1. En Windows, abra un símbolo del sistema o, en Mac, abra Terminal, cree una nueva carpeta denominada git-samples y, a continuación, cierre la ventana.

   md "C:\git-samples"
   

   mkdir '$home\git-samples\
   

2. Abra una ventana de terminal de Git, como git bash y utilice el comando cd para cambiar a la nueva carpeta para instalar la aplicación de ejemplo.

   cd "C:\git-samples"
   

3. Ejecute el comando siguiente para clonar el repositorio de ejemplo. Este comando crea una copia de la aplicación de ejemplo en el equipo.

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

Si no desea usar git, también puede descargar el proyecto como un archivo ZIP

Revisión del código

Este paso es opcional. Si está interesado en aprender cómo se crean los recursos de base de datos en el código, puede revisar los siguientes fragmentos de código. En caso contrario, puede ir directamente a Actualización de la cadena de conexión.

Todos los fragmentos de código siguiente se toman de la clase MongoService, que se encuentra en la ruta de acceso siguiente: src/TaskList.Core/Services/MongoService.cs.

• Inicialice Mongo Client.

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

• Recupere una referencia a la base de datos y la colección. El SDK de .NET de MongoDB creará automáticamente tanto la base de datos como la colección si todavía no existen.

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

• Recupere todos los documentos como una lista.

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

• Consulta de documentos determinados.

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

• Cree una tarea e insértela en la colección.

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

• Actualice una tarea de una colección.

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

• Elimine una tarea de una colección.

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

Actualización de la cadena de conexión

Ahora vuelva a Azure Portal para obtener la información de la cadena de conexión y cópiela en la aplicación.

1. En Azure Portal, en la cuenta de Azure Cosmos DB, en el panel de navegación izquierdo, haga clic en Cadena de conexión y en Claves de lectura y escritura. Usará los botones de copia que están en el lado derecho de la pantalla para copiar la cadena de conexión principal en los pasos siguientes.

2. Abra el archivo APIKeys.cs en el directorio Helpers (Aplicaciones auxiliares) del proyecto TaskList.Core.

3. Copie el valor de la cadena de conexión principal del portal (con el botón de copia) y conviértalo en el valor del campo ConnectionString en el archivo APIKeys.cs.

4. Quite &replicaSet=globaldb de la cadena de conexión. Obtendrá un error en tiempo de ejecución si no quita ese valor de la cadena de consulta.

Ya ha actualizado la aplicación con toda la información que necesita para comunicarse con Azure Cosmos DB.

Ejecución la aplicación

Visual Studio 2019

1. En Visual Studio, haga clic con el botón derecho en cada proyecto en el Explorador de soluciones y, después, haga clic en Administrar paquetes NuGet.
2. Haga clic en Restore all NuGet packages (Restaurar todos los paquetes NuGet).
3. Haga clic con el botón derecho en TaskList.Android y seleccione Establecer como proyecto de inicio.
4. Presione F5 para iniciar la depuración de la aplicación.
5. Si quiere ejecutar en iOS, primero asegúrese de que la máquina esté conectada a un equipo Mac (aquí hay algunas instrucciones sobre cómo hacerlo).
6. Haga clic con el botón derecho en el proyecto TaskList.iOS y seleccione Establecer como proyecto de inicio.
7. Haga clic en F5 para iniciar la depuración de la aplicación.

Visual Studio para Mac

1. En la lista desplegable de plataforma, seleccione TaskList.iOS o TaskList.Android, en función de la plataforma en que quiere realizar la ejecución.
2. Presione cmd+Entrar para empezar a depurar la aplicación.

Revisión de los SLA en Azure Portal

Azure Portal supervisa el rendimiento, capacidad de almacenamiento, disponibilidad, latencia y coherencia de su cuenta de Cosmos DB. Los gráficos de las métricas asociadas con un Acuerdo de Nivel de Servicio (SLA) de Azure Cosmos DB muestran el rendimiento real en comparación con el valor de este acuerdo. Este conjunto de métricas hace que la supervisión de los Acuerdos de Nivel de Servicio sea transparente.

Para revisar las métricas y los Acuerdos de Nivel de Servicio:

1. Seleccione Métricas en el menú de navegación de la cuenta de Cosmos DB.

2. Seleccione una pestaña como Latencia y seleccione un período de tiempo a la derecha. Compare las líneas Real y SLA de los gráficos.

   

3. Revise las métricas de las otras pestañas.

Limpieza de recursos

Cuando haya terminado tanto con la aplicación como con la cuenta de Azure Cosmos DB, puede eliminar los recursos de Azure que creó para no tener más gastos. Para eliminar los recursos:

1. En la barra de búsqueda de Azure Portal, busque y seleccione Grupos de recursos.

2. En la lista, seleccione el grupo de recursos que creó para este inicio rápido.

   

3. En la página Información general del grupo de recursos, seleccione Eliminar grupo de recursos.

   

4. En la ventana siguiente, escriba el nombre del grupo de recursos que desea eliminar y, después, seleccione Eliminar.

Pasos siguientes

En esta guía de inicio rápido, ha aprendido a crear una cuenta de Azure Cosmos DB y ejecutar una aplicación Xamarin.Forms con la API para MongoDB. Ahora puede importar datos adicionales en la cuenta de Cosmos DB.

¿Intenta planear la capacidad para una migración a Azure Cosmos DB? Para ello, puede usar información sobre el clúster de bases de datos existente.

• Si lo único que sabe es el número de núcleos virtuales y servidores del clúster de bases de datos existente, lea sobre el cálculo de unidades de solicitud mediante núcleos o CPU virtuales.
• Si conoce las velocidades de solicitud típicas para la carga de trabajo de la base de datos actual, lea sobre la estimación de las unidades de solicitud mediante la herramienta de planeamiento de capacidad de Azure Cosmos DB.