Administración de una cuenta de Azure Cosmos DB mediante Azure Portal

SE APLICA A: NoSQL MongoDB Cassandra Gremlin Table

En este artículo, se describe cómo administrar varias tareas en una cuenta de Azure Cosmos DB mediante Azure Portal. Azure Cosmos DB también se puede administrar con otros clientes de administración, incluidos Azure PowerShell, CLI de Azure, plantillas de Azure Resource Manager, Bicep y Terraform.

Sugerencia

La API de administración para Azure Cosmos DB o el plano de control no están diseñados para grandes volúmenes de solicitudes como el resto del servicio. Para más información, consulte Límites del servicio del plano de control

Requisitos previos

None

Crear una cuenta

Siga estos pasos:

  1. En el menú de Azure Portal o en la página principal, seleccione Crear un recurso.

  2. Busque Azure Cosmos DB. Seleccione Crear>Azure Cosmos DB.

  3. En la página Crear una cuenta de Azure Cosmos DB, seleccione la opción Crear en la sección Azure Cosmos DB for NoSQL.

    Azure Cosmos DB proporciona varias API:

    • NoSQL, para datos de documento
    • PostgreSQL
    • MongoDB, para datos de documento
    • Apache Cassandra
    • Tabla
    • Apache Gremlin, para datos de grafo

    Para obtener más información sobre la API para NoSQL, consulte Bienvenido a Azure Cosmos DB.

  4. En la página Crear una cuenta de Azure Cosmos DB, especifique la configuración básica de la nueva cuenta de Azure Cosmos DB.

    Configuración valor Descripción
    Subscription Nombre de suscripción Seleccione la suscripción de Azure que quiere usar para esta cuenta de Azure Cosmos DB.
    Grupo de recursos Definición de un nombre de grupo de recursos Seleccione un grupo de recursos o seleccione Crear nuevo y escriba un nombre único para el grupo de recursos nuevo.
    Nombre de cuenta Un nombre único Escriba un nombre para identificar la cuenta de Azure Cosmos DB. Dado que documents.azure.com se anexa al nombre que se proporciona para crear el identificador URI, debe usar un nombre único. El nombre solo puede contener letras minúsculas, números y el carácter de guion (-). Debe tener entre 3 y 44 caracteres.
    Location Región más cercana a los usuarios Seleccione una ubicación geográfica para hospedar la cuenta de Azure Cosmos DB. Use la ubicación más cercana a los usuarios para que puedan acceder de la forma más rápida posible a los datos.
    Capacity mode (Modo de capacidad) Rendimiento aprovisionado o Sin servidor Seleccione Provisioned throughput (Rendimiento aprovisionado) para crear una cuenta en modo de rendimiento aprovisionado. Seleccione Serverless (Sin servidor) para crear una cuenta en modo sin servidor.
    Aplicar el descuento del nivel Gratis de Azure Cosmos DB Aplicar o No aplicar Con el nivel Gratis de Azure Cosmos DB, recibe los primeros 1000 RU/s y 25 GB de almacenamiento gratis en una cuenta. Más información acerca del nivel Gratis.
    Límite del rendimiento total de la cuenta Seleccionado o no Limite la cantidad total de rendimiento que se puede aprovisionar en esta cuenta. Este límite evita cargos inesperados relacionados con el rendimiento aprovisionado. Puede actualizar o quitar este límite después de crear la cuenta.

    Puede tener una cuenta de Azure Cosmos DB de nivel gratis por cada suscripción de Azure y debe optar por recibirla al crear la cuenta. Si no ve la opción para aplicar el descuento por nivel Gratis, significa que el nivel Gratis ya se habilitó en otra cuenta de la suscripción.

    Captura de pantalla que muestra la página Crear cuenta de Azure Cosmos DB.

    Nota

    Las siguientes opciones no están disponibles si selecciona Serverless (Sin servidor) en Capacity mode (Modo de capacidad):

    • Aplicación de descuento por nivel Gratis
    • Límite del rendimiento total de la cuenta
  5. En la pestaña Distribución global, configure los detalles siguientes. Puede dejar los valores predeterminados para este inicio rápido:

    Configuración valor Descripción
    Redundancia geográfica Deshabilitar Habilite o deshabilite la distribución global en su cuenta. Para ello, debe emparejar su región con una región de par. Puede agregar más regiones a su cuenta más adelante.
    Escrituras en varias regiones Deshabilitar La funcionalidad de escrituras en varias regiones le permite aprovechar el rendimiento aprovisionado para sus bases de datos y contenedores de todo el mundo.
    Zonas de disponibilidad Deshabilitar Las zonas de disponibilidad le ayudan a mejorar aún más la disponibilidad y la resistencia de una aplicación.

    Nota

    Las siguientes opciones no están disponibles si selecciona Sin servidor en Modo de capacidad en la página anterior Básico:

    • Redundancia geográfica
    • Escrituras en varias regiones
  6. De manera opcional, puede configurar más detalles en las pestañas siguientes:

    • Funciones de red. Configure el acceso desde una red virtual.
    • Directiva de copia de seguridad. Configure una directiva de copia de seguridad periódica o continua.
    • Cifrado. Use una clave administrada por el servicio o una clave administrada por el cliente.
    • Etiquetas. Las etiquetas son pares nombre-valor que permiten categorizar los recursos y ver una facturación consolidada mediante la aplicación de la misma etiqueta en varios recursos y grupos de recursos.
  7. Seleccione Revisar + crear.

  8. Revise la configuración de la cuenta y seleccione Crear. La operación de creación de la cuenta tarda unos minutos. Espere hasta que la página del portal muestre Se completó la implementación .

    Captura de pantalla que muestra que se completó la implementación.

  9. Seleccione Ir al recurso para ir a la página de la cuenta de Azure Cosmos DB.

    Captura de pantalla que muestra la página de cuenta de Azure Cosmos DB.

Incorporación o eliminación de regiones de una cuenta de base de datos

Sugerencia

Cuando se agrega una nueva región, todos los datos deben replicarse por completo y estar confirmados en la nueva región antes de que la región se marque como disponible. La cantidad de tiempo que tarda esta operación depende de la cantidad de datos almacenados en la cuenta. Si hay una operación asincrónica de escalado del rendimiento en curso, la operación de escalado vertical del rendimiento se pausa y se reanuda automáticamente cuando se completa la operación de agregar o quitar región.

  1. Inicie sesión en el portal de Azure.

  2. Vaya a la cuenta de Azure Cosmos DB y seleccione Replicación global de datos en el menú del recurso.

  3. Para agregar regiones, seleccione los hexágonos del mapa con la etiqueta + correspondiente a la región (o regiones) deseada. Otra forma de agregar una región es seleccionar la opción + Agregar región y elegir una región en el menú desplegable.

  4. Para quitar regiones, desactive una o varias regiones del mapa; para ello, seleccione los hexágonos azules con marcas de verificación. También puede seleccionar el icono de "Papelera" (🗑) junto a la región en el lado derecho.

  5. Seleccione Aceptar para guardar los cambios.

    Captura de pantalla del menú Replicar datos globalmente, con una región resaltada.

    En el modo de escritura de una sola región, no se puede eliminar la región de escritura. Debe realizar la conmutación por error a otra región antes de poder eliminar la región de escritura actual.

    En el modo de escritura de varias regiones, puede agregar o quitar cualquier región, siempre que tenga al menos una región.

    Configuración de varias regiones de escritura

    Abra la pestaña Replicar datos globalmente y seleccione Habilitar para habilitar las escrituras en varias regiones. Después de habilitar las escrituras en varias regiones, todas las regiones de lectura que actualmente tiene en la cuenta se convertirán en regiones de lectura y escritura.

    Captura de pantalla del menú Replicar datos globalmente, con las opciones Configuración de regiones y Guardar resaltadas.

Habilitación de la conmutación por error administrada por el servicio en una cuenta de Azure Cosmos DB

La opción de conmutación por error administrada por el servicio permite que Azure Cosmos DB conmute por error en la región con la prioridad mayor sin acción del usuario si una región deja de estar disponible. Cuando la conmutación por error administrada por el servicio está habilitada, es posible modificar la prioridad de región. Su cuenta debe tener dos o más regiones para habilitar la conmutación por error administrada por el servicio.

  1. En la cuenta de Azure Cosmos DB, abra el panel Replicar datos globalmente.

  2. En la parte superior del panel, seleccione Conmutación por error administrada por el servicio.

    Captura de pantalla que muestra el menú Replicar datos globalmente.

  3. En el panel Conmutación por error administrada por el servicio, asegúrese de que la opción Habilitar conmutación por error administrada por el servicio esté establecida en ON.

  4. Seleccione Guardar.

    Captura de pantalla del menú del portal Conmutación por error administrada por el servicio.

Establecimiento de las prioridades de la conmutación por error para la cuenta de Azure Cosmos DB

Una vez que una cuenta de Azure Cosmos DB se configura para la conmutación por error administrada por el servicio, es posible modificar la prioridad de la conmutación por error para las regiones.

Importante

No se puede modificar la región de escritura (prioridad de conmutación por error de cero) cuando la cuenta está configurada para la conmutación por error administrada por el servicio. Para cambiar la región de escritura, debe deshabilitar la conmutación por error administrada por el servicio y realizar una conmutación por error manual.

  1. En la cuenta de Azure Cosmos DB, abra el panel Replicar datos globalmente.

  2. En la parte superior del panel, seleccione Conmutación por error administrada por el servicio.

    Captura de pantalla que muestra el menú Replicar datos globalmente.

  3. En el panel Conmutación por error administrada por el servicio, asegúrese de que la opción Habilitar conmutación por error administrada por el servicio esté establecida en ON.

  4. Para modificar la prioridad de la conmutación por error, arrastre las regiones de lectura mediante los tres puntos del lado izquierdo de la fila que aparecen al mantener el puntero sobre ellos.

  5. Seleccione Guardar.

    Captura de pantalla del menú del portal Conmutación por error administrada por el servicio.

Realización de una conmutación por error manual en una cuenta de Azure Cosmos DB

Importante

La cuenta de Azure Cosmos DB debe estar configurada para la conmutación por error manual para que esta operación se realice correctamente.

Nota:

Si realiza una operación de conmutación por error manual mientras hay una operación asincrónica de escalado del rendimiento en curso, la operación de escalado vertical del rendimiento se pausa. Se reanuda automáticamente cuando se completa la operación de conmutación por error. Para más información, consulte Procedimientos recomendados para escalar el rendimiento aprovisionado (RU/s).

Advertencia

En caso de interrupción de una región de escritura, donde la cuenta de Azure Cosmos DB promueve una región secundaria para que sea la nueva región de escritura primaria a través de la conmutación por error administrada por el servicio, la región de escritura original no se volverá a promover como región de escritura automáticamente una vez que se recupere. Es su responsabilidad asignar la región recuperada de nuevo como la región de escritura mediante PowerShell, la CLI de Azure o Azure Portal (una vez que sea seguro hacerlo, como se ha descrito anteriormente).

  1. Vaya a la cuenta de Azure Cosmos DB y abra el menú Replicar datos globalmente.

  2. En la parte superior del menú, seleccione Conmutación por error manual.

    Captura de pantalla que muestra el menú Replicar datos globalmente.

  3. En el menú Conmutación por error manual, seleccione la nueva región de escritura. Active la casilla de verificación para indicar que comprende que esta opción cambia la región de escritura.

  4. Para desencadenar la conmutación por error, seleccione Aceptar.

    Captura de pantalla del menú Conmutación por error manual del portal.