Inicio rápido: Cree una cuenta de Azure Cosmos DB for NoSQL mediante Azure Portal.

  • Artículo

SE APLICA A: NoSQL

En este inicio rápido, crea una nueva cuenta de Azure Cosmos DB for NoSQL mediante el Azure Portal. Después, use la experiencia del Explorador de datos en el Azure Portal para crear una base de datos y un contenedor que configure todas las opciones necesarias. Por último, agregue datos de ejemplo al contenedor y emita una consulta básica.

Requisitos previos

Crear una cuenta

Empiece por crear una cuenta de Azure Cosmos DB for NoSQL

  1. Inicie sesión en Azure Portal (https://portal.azure.com).

  2. Introduzca Azure Cosmos DB en la barra de búsqueda global.

    Captura de pantalla de la barra de búsqueda global en el Azure Portal.

  3. En Servicios, seleccione Azure Cosmos DB.

    Captura de pantalla de la opción de Azure Cosmos DB seleccionada en el menú de búsqueda.

  4. En el panel de Azure Cosmos DB, seleccione Crear y, después, Azure Cosmos DB for NoSQL.

    Captura de pantalla de la opción Crear dentro del panel de un servicio de Azure.

    Captura de pantalla del panel de selección de API de Azure Cosmos DB con la API para NoSQL resaltada.

  5. En el panel Aspectos básicos, configure las siguientes opciones y, a continuación, seleccione Revisar y crear:

    Valor
    Suscripción Seleccione su suscripción a Azure.
    Grupo de recursos Cree un grupo de recursos nuevo o seleccione uno existente
    Account Name Proporcione un nombre único global.
    Zonas de disponibilidad Deshabilitar
    Ubicación Seleccione una región de Azure compatible para su suscripción

    Captura de pantalla del panel

    Sugerencia

    Puede dejar cualquier opción con sus valores predeterminados. También puede configurar la cuenta para limitar el rendimiento total de la cuenta a 1000 unidades de solicitud por segundo (RU/s) y habilitar el nivel gratis para minimizar los costes.

  6. En el panel Revisar y crear, espere a que la validación de la cuenta finalice correctamente y seleccione Crear.

    Captura de pantalla del paso de validación de recursos en la experiencia de creación.

  7. El portal va automáticamente al panel Implementación . Espere a que la implementación se complete.

    Captura de pantalla del panel de implementación con una implementación actualmente pendiente.

  8. Una vez completada la implementación, seleccione Ir al recurso para ir a la nueva cuenta de Azure Cosmos DB for NoSQL.

    Captura de pantalla de un recurso totalmente implementado con la opción

Creación de una base de datos y un contenedor

A continuación, se usará el Explorador de datos para crear una base de datos y un contenedor en el portal.

  1. En el panel de recursos de la cuenta, seleccione Explorador de datos en el menú de servicio.

    Captura de pantalla de la opción Explorador de datos en el menú de servicio de la cuenta

  2. En Explorador de datos, seleccione la opción Nuevo contenedor.

    Captura de pantalla de la opción Nuevo contenedor en el Explorador de datos.

  3. En el cuadro de diálogo Nuevo contenedor, configure los siguientes valores y seleccione Aceptar:

    Valor
    Base de datos Crear nuevo
    Id. de base de datos cosmicworks
    Uso compartido del rendimiento entre contenedores No seleccionar
    Id. de contenedor employees
    Clave de partición department/name
    Rendimiento del contenedor (escalado automático) Autoscale
    Número máximo de RU/s de contenedor 1000

    Captura de pantalla del cuadro de diálogo para crear una nueva base de datos y un contenedor con las opciones especificadas rellenadas.

  4. Cree un nuevo archivo denominado demo.bicepparam o (demo.bicepparam).

  5. Observe la base de datos y el contenedor recién creados en la jerarquía del Explorador de datos.

    Captura de pantalla de la jerarquía del Explorador de datos con un contenedor de base de datos presente.

    Sugerencia

    Opcionalmente, puede expandir el nodo de contenedor para observar propiedades adicionales y opciones de configuración.

Añadir y consultar datos de ejemplo

Por último, use el Explorador de datos para crear un artículo de muestreo y, a continuación, emita una consulta básica al contenedor.

  1. Expanda el nodo del contenedor empleados en el árbol del Explorador de datos. A continuación, seleccione la opción Elementos.

    Captura de pantalla de la opción

  2. En el menú del Explorador de datos, seleccione Nuevo elemento.

    Captura de pantalla de la opción

  3. Ahora, inserte el siguiente JSON para un nuevo elemento en el contenedor empleados y, a continuación, seleccione Guardar:

    {
  "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "name": {
    "first": "Kai",
    "last": "Carter"
  },
  "email": "<kai@adventure-works.com>",
  "department": {
    "name": "Logistics"
  }
}

    Captura de pantalla del contenido JSON de un nuevo elemento dentro del Explorador de datos.

  4. En el menú del Explorador de datos, seleccione Nueva consulta SQL.

    Captura de pantalla que muestra la opción de

  5. Ahora, inserte la siguiente consulta NoSQL para obtener todos los elementos del departamento de logistics mediante una búsqueda que no distingue mayúsculas de minúsculas. A continuación, la consulta da formato a la salida como un objeto JSON estructurado. Para ejecutar la consulta, seleccione ejecutar consulta.

    SELECT VALUE {
    "name": CONCAT(e.name.last, " ", e.name.first),
    "department": e.department.name,
    "emailAddresses": [
        e.email
    ]
}
FROM
    employees e
WHERE
    STRINGEQUALS(e.department.name, "logistics", true)

    Captura de pantalla del texto de la consulta NoSQL en el Explorador de datos.

  6. Observe la salida de la matriz JSON de la consulta.

    [
  {
    "name": "Carter Kai",
    "department": "Logistics",
    "emailAddresses": [
      "kai@adventure-works.com"
    ]
  }
]

    Captura de pantalla de los resultados de la ejecución de la consulta NoSQL anterior en el Explorador de datos.

Contenido relacionado