Limitación del rendimiento total aprovisionado en la cuenta de Azure Cosmos DB

  • Artículo

SE APLICA A: NoSQL MongoDB Cassandra Gremlin Table

Cuando se usa una cuenta de Azure Cosmos DB en modo de rendimiento aprovisionado, la mayoría de los costos normalmente proceden de la cantidad de rendimiento que se ha aprovisionado en la cuenta. En concreto, estos costos se ven directamente influidos por:

  • El número de bases de datos con rendimiento compartido.
  • El número de contenedores con rendimiento dedicado.
  • La cantidad de rendimiento aprovisionado en cada uno de estos recursos.
  • El número de regiones donde la cuenta está disponible.

Puede ser difícil realizar un seguimiento de la cantidad total de rendimiento que se ha aprovisionado en la cuenta, especialmente cuando se empieza a usar Azure Cosmos DB. Esto puede dar lugar a cargos inesperados si esta cantidad acaba superando un presupuesto determinado que no se esperaba superar. Para ayudar a controlar mejor los costos, Azure Cosmos DB permite limitar el rendimiento total aprovisionado en la cuenta.

Nota

Esta característica no está disponible en cuentas sin servidor.

Después de establecer un límite en el rendimiento total de la cuenta, cualquiera de las siguientes operaciones que tenga como resultado la superación de este límite se bloquea y genera un error de manera explícita:

  • Creación de una nueva base de datos con rendimiento compartido.
  • Creación de un nuevo contenedor con rendimiento dedicado.
  • Aumento del rendimiento aprovisionado en un recurso configurado en modo estándar (manual).
  • Aumento del rendimiento máximo aprovisionado en un recurso configurado en modo de escalabilidad automática.
  • Incorporación de una nueva región a la cuenta.

Nota

En el caso de los recursos configurados en modo de escalabilidad automática, es el rendimiento máximo configurado en el recurso el que cuenta para el rendimiento total de la cuenta.

Importante

Una vez que se habilita un límite de rendimiento total en su cuenta, debe pasar un valor de rendimiento explícito al crear nuevos contenedores. Actualmente recibirá un error si intenta crear un contenedor sin rendimiento explícito.

Establecimiento del límite de rendimiento total desde Azure Portal

Nueva cuenta

Al crear una nueva cuenta de Azure Cosmos DB desde el portal, tiene la opción de limitar el rendimiento total de la cuenta:

Captura de pantalla de Azure Portal que muestra cómo limitar el rendimiento total de la cuenta al crear una nueva

Al comprobar esta opción, se limitará el rendimiento total de la cuenta a 1000 RU/s para una cuenta de nivel gratis y 4000 RU/s para una cuenta de nivel normal y no gratuita. Puede cambiar este valor una vez creada la cuenta.

Cuenta existente

En Azure Portal, vaya a la cuenta de Azure Cosmos DB y seleccione Administración de costos en el menú de la izquierda.

Captura de pantalla de Azure Portal que muestra cómo actualizar el rendimiento total de la cuenta en una cuenta existente

En esta sección se muestra un resumen del rendimiento total aprovisionado en la cuenta y se permite configurar el límite de rendimiento total. Están disponibles las tres opciones siguientes:

  • Limitar el rendimiento total aprovisionado de la cuenta a la cantidad incluida en el descuento por nivel gratuito. Esta opción solo está disponible en las cuentas de nivel gratuito y limita el rendimiento total de la cuenta a 1000 RU/s. Al activar esta opción se asegura de no incurrir en ningún cargo por el rendimiento aprovisionado.
  • Permitir que el rendimiento total de la cuenta se aprovisione hasta una cantidad personalizada. Esta opción permite especificar el rendimiento total aprovisionado que no se quiere superar. Como referencia se muestra una estimación de costos mensual correspondiente a la entrada.

    Nota

    Este límite personalizado no puede ser inferior al rendimiento total aprovisionado actualmente en toda la cuenta.

  • Sin límite, permitir que el rendimiento total de la cuenta se aprovisione hasta cualquier cantidad. Esta opción deshabilita el límite.

Establecimiento del límite de rendimiento total mediante programación

Uso de plantillas del Administrador de recursos de Azure

Al crear o actualizar la cuenta de Azure Cosmos DB con Azure Resource Manager, puede configurar el límite de rendimiento total si establece la propiedad properties.capacity.totalThroughputLimit:

{
  "location": "West US",
  "kind": "DocumentDB",
  "properties": {
    "locations": [
      {
        "locationName": "West US",
        "failoverPriority": 0,
        "isZoneRedundant": false
      }
    ],
    "databaseAccountOfferType": "Standard",
    "capacity": {
        "totalThroughputLimit": 2000
    }
  }
}

Establezca esta propiedad en -1 para deshabilitar el límite.

Preguntas más frecuentes

¿Hay situaciones en las que el rendimiento total aprovisionado puede superar el límite?

Azure Cosmos DB exige un rendimiento mínimo de 1 RU/s por GB de datos almacenados. Si ingiere datos cuando ya está en ese mínimo, el rendimiento aprovisionado en los recursos aumentará automáticamente para respetar las 1 RU/s por GB. En este caso, y solo en este caso, el rendimiento total aprovisionado puede superar el límite establecido.

Pasos siguientes