Compartir vía

Cuotas de servicio de Azure Cosmos DB y límites predeterminados

En este artículo se explican las cuotas y límites predeterminados de los recursos de Azure Cosmos DB. Ayuda a administrar las operaciones, el almacenamiento y el rendimiento de forma eficaz.

Operaciones de base de datos y almacenamiento

Después de crear una cuenta de Azure Cosmos DB en su suscripción, puede administrar los datos en su cuenta mediante la creación de bases de datos, contenedores y elementos.

Rendimiento aprovisionado

Asigne el rendimiento en el nivel de contenedor o de base de datos en términos de unidades de solicitud (RU) o unidades de solicitud por segundo (RU/s). En la tabla siguiente se enumeran los límites de almacenamiento y rendimiento por contenedor y base de datos. El almacenamiento hace referencia a la cantidad combinada de almacenamiento de índices y datos.

Recurso Límite
Número máximo de RU por contenedor (modo aprovisionado de rendimiento dedicado) 1 000 000 ¹
Número máximo de RU por base de datos (modo aprovisionado de rendimiento dedicado) 1 000 000 ¹
Número máximo de RU por partición (lógica y física) 10 000
Almacenamiento máximo en todos los elementos por partición (lógica) 20 GB ²
Número máximo de claves de partición (lógicas) distintas Sin límite
Almacenamiento máximo por contenedor Sin límite
Tamaño máximo de datos adjuntos por cuenta (la característica de datos adjuntos está en desuso) 2 GB
Mínimo de RU/s requeridas por 1 GB 1 RU/s

¹ Aumente el número máximo de RU por contenedor o base de datos mediante la presentación de una incidencia de soporte técnico de Azure.

² Para obtener información sobre el procedimiento recomendado para administrar las cargas de trabajo que tienen claves de partición que requieren límites más altos para el almacenamiento o el rendimiento, consulte Crear una clave de partición sintética . Si la carga de trabajo alcanza el límite de particiones lógicas de 20 GB en producción, se recomienda rediseñar la aplicación con una clave de partición diferente como solución a largo plazo. Para darle tiempo a rediseñar la aplicación, solicite un aumento temporal en el límite de claves de partición lógica para la aplicación existente. Presente una incidencia de soporte técnico de Azure y seleccione el tipo de cuota Aumento temporal del tamaño de la clave de partición lógica del contenedor. El fin de solicitar un aumento temporal es una mitigación temporal, no se recomienda como solución a largo plazo, ya que cuando se aumenta el límite, dejan de aplicarse las garantías establecidas en el Acuerdo de Nivel de Servicio. Para quitar la configuración, presente una incidencia de soporte técnico y seleccione el tipo de cuota Restaurar el tamaño predeterminado de la clave de partición lógica del contenedor (20 GB). Puede presentar esta incidencia de soporte técnico después de eliminar los datos para ajustarse al límite de particiones lógicas de 20 GB o rediseñar la aplicación con una clave de partición diferente.

Limites de rendimiento mínimo

Un contenedor de Azure Cosmos DB (o una base de datos de rendimiento compartido) que utilice el rendimiento manual debe tener un rendimiento mínimo de 400 RU/s. A medida que el contenedor crece, Azure Cosmos DB requiere un rendimiento mínimo para asegurarse de que el recurso (base de datos o contenedor) tenga los recursos suficientes para sus operaciones.

Recupere el rendimiento actual y mínimo de un contenedor o una base de datos desde Azure Portal o los kits de desarrollo de software (SDK). Para obtener más información, consulte Asignar rendimiento en contenedores y bases de datos.

El valor mínimo real de RU/s puede variar en función de la configuración de la cuenta. Puede usar métricas de Azure Monitor para ver el historial de rendimiento aprovisionado (RU/s) y el almacenamiento en un recurso.

Rendimiento mínimo en el contenedor

Calcule el rendimiento mínimo en un contenedor mediante esta sección.

Rendimiento manual

Para calcular el valor de RU/s mínimo necesario de un contenedor con un rendimiento manual, busque el valor máximo de:

  • 400 RU/s
  • Almacenamiento actual en GB * 1 RU/s
  • El valor de RU/s más alto que nunca aprovisionado en el contenedor / 100

Por ejemplo, un contenedor se aprovisiona con 400 RU/s y un almacenamiento de 0 GB. Aumente el rendimiento a 50 000 RU/s e importe 20 GB de datos. El valor mínimo de RU/s ahora es MAX(400, 20 * 1 RU/s per GB, 50,000 RU/s / 100) = 500 RU/s. Con el tiempo, el almacenamiento crece a 2000 GB. El valor mínimo de RU/s ahora es MAX(400, 2000 * 1 RU/s per GB, 50,000 / 100) = 2000 RU/s.

Escalabilidad automática del rendimiento

Para calcular el valor mínimo del número máximo de RU/s de escalabilidad automática de un contenedor con un rendimiento de escalabilidad automática, busque el valor máximo de:

  • 1000 RU/s
  • Almacenamiento actual en GB * 10 RU/s
  • El valor de RU/s más alto que nunca aprovisionado en el contenedor / 10

Por ejemplo, tiene un contenedor aprovisionado con 1000 RU/s y 0 GB de almacenamiento. Aumente el rendimiento a 50 000 RU/s e importe 20 GB de datos. El valor mínimo del número máximo de RU/s ahora es MAX(1000, 20 * 10 RU/s per GB, 50,000 RU/s / 10) = 5000 RU/s. Con el tiempo, el almacenamiento crece a 2000 GB. El valor mínimo del número máximo de RU/s ahora es MAX(1000, 2000 * 10 RU/s per GB, 50,000 / 10) = 20 000 RU/s.

Rendimiento mínimo en base de datos de rendimiento compartido

Use esta sección para calcular el rendimiento mínimo en un rendimiento de uso compartido de bases de datos entre contenedores.

Rendimiento manual

Para calcular el valor de RU/s mínimo necesario de una base de datos de rendimiento compartido con un rendimiento manual, busque el valor máximo de:

  • 400 RU/s
  • Almacenamiento actual en GB * 1 RU/s
  • El valor de RU/s más alto que nunca aprovisionado en la base de datos / 100
  • 400 + MAX (cantidad de contenedores: 25, 0) * 100 RU/s

Por ejemplo, tiene una base de datos aprovisionada con 400 RU/s, 15 GB de almacenamiento y 10 contenedores. El valor mínimo de RU/s es MAX(400, 15 * 1 RU/s per GB, 400 / 100, 400 + 0 ) = 400 RU/s. Si hubiera 30 contenedores en la base de datos, el valor mínimo de RU/s sería 400 + MAX(30 - 25, 0) * 100 RU/s = 900 RU/s.

Escalabilidad automática del rendimiento

Para calcular el valor mínimo del número máximo de RU/s de escalabilidad automática necesario de una base de datos de rendimiento compartida con rendimiento de escalabilidad automática, busque el máximo de:

  • 1000 RU/s
  • Almacenamiento actual en GB * 10 RU/s
  • El valor de RU/s más alto que nunca aprovisionado en la base de datos / 10
  • 1000 + MAX (cantidad de contenedores: 25, 0) * 1000 RU/s

Por ejemplo, tiene una base de datos aprovisionada con 1000 RU/s, 15 GB de almacenamiento y 10 contenedores. El valor mínimo del número máximo de RU/s para la base de datos de escalabilidad automática es MAX(1000, 15 * 10 RU/s per GB, 1000 / 10, 1000 + 0 ) = 1000 RU/s. Si hubiera 30 contenedores en la base de datos, el valor mínimo del número máximo de RU/s sería 1000 + MAX(30 - 25, 0) * 1000 RU/s = 5000 RU/s.

En resumen, estos son los límites de RU mínimas aprovisionadas cuando se usa el rendimiento aprovisionado.

Tipo de aprovisionamiento Recurso Límite
Rendimiento manual Número mínimo de RU por contenedor (modo de procesamiento aprovisionado dedicado con procesamiento manual) 400
Rendimiento manual Valor mínimo de RU por base de datos (modo de rendimiento aprovisionado compartido con rendimiento manual) 400 RU/s para los 25 primeros contenedores.
Escalabilidad automática del rendimiento Valor mínimo del número máximo de RU por contenedor (modo de rendimiento aprovisionado dedicado con rendimiento de escalabilidad automática) 1000
Escalabilidad automática del rendimiento Valor mínimo del número máximo de RU por base de datos (modo de rendimiento aprovisionado compartido con rendimiento de escalabilidad automática) 1000 RU/s para los 25 primeros contenedores.

Azure Cosmos DB admite el escalado mediante programación del rendimiento (RU/s) por contenedor o base de datos con los SDK o el portal.

Cada recurso se escala de forma sincrónica e inmediata entre las RU/s mínimas y hasta 100 veces las RU/s mínimas, en función de la configuración actual de RU/s aprovisionadas y de recursos. Si el valor de rendimiento solicitado está fuera del intervalo, el escalado se realiza asincrónicamente. El escalado asincrónico puede tardar entre minutos y horas en completarse, en función del rendimiento solicitado y el tamaño de almacenamiento de datos en el contenedor. Más información.

Sin servidor

Sin servidor permite usar los recursos de Azure Cosmos DB de una forma basada en el consumo. En la tabla siguiente se enumeran los límites de capacidad de ráfaga de rendimiento y almacenamiento por contenedor y base de datos. Estos límites no se pueden aumentar. Asigne cuentas adicionales sin servidor para otras necesidades de almacenamiento.

Recurso Límite
Máximo de RU/s por contenedor 20 000*
Almacenamiento máximo en todos los elementos por partición (lógica) 20 GB
Almacenamiento máximo por contenedor 1 TB (terabyte)

*La disponibilidad máxima de RU/s depende de los datos almacenados en el contenedor. Vea Rendimiento sin servidor

Plano de control

Azure Cosmos DB tiene un proveedor de recursos que le permite crear, actualizar y eliminar recursos en la cuenta de Azure Cosmos DB. El proveedor de recursos interactúa con el nivel general de Administración de recursos de Azure, que es el servicio de implementación y administración para Azure.

Cree y administre recursos de Azure Cosmos DB mediante lo siguiente:

  • Portal de Azure
  • Azure PowerShell
  • CLI de Azure
  • Plantillas JSON o Bicep de Azure Resource Manager
  • API REST de Azure
  • SDK de administración de Azure
  • Terraform
  • Pulumi

También se puede acceder a esta capa de administración desde los SDK del plano de datos de Azure Cosmos DB que se usan en las aplicaciones para crear y administrar recursos dentro de una cuenta. Los SDK del plano de datos también realizan solicitudes de plano de control durante la conexión inicial al servicio para tareas como enumerar bases de datos y contenedores, y solicitar claves de cuenta para la autenticación.

Cada cuenta de Azure Cosmos DB tiene una partición principal que contiene todos los metadatos de la cuenta. También tiene una pequeña cantidad de rendimiento para admitir las operaciones del plano de control. Las solicitudes del plano de control que crean, leen, actualizan o eliminan estos metadatos consumen este rendimiento. Cuando la cantidad de rendimiento consumida por las operaciones del plano de control supera esta cantidad, se limitan las operaciones por velocidad, al igual que las operaciones del plano de datos en Azure Cosmos DB. Pero a diferencia del rendimiento de las operaciones de datos, no se puede aumentar el rendimiento de la partición principal.

Algunas operaciones del plano de control no consumen el rendimiento de la partición principal, como Obtener o Enumerar claves. Pero a diferencia de las solicitudes de datos dentro de la cuenta de Azure Cosmos DB, los proveedores de recursos de Azure no están diseñados para volúmenes de solicitudes elevados. Las operaciones del plano de control que superan los límites documentados en niveles sostenidos durante períodos consecutivos de 5 minutos aquí pueden experimentar limitaciones de solicitudes, así como operaciones erróneas o incompletas en los recursos de Azure Cosmos DB.

Para supervisar las operaciones del plano de control, vaya a la pestaña Información de una cuenta de Azure Cosmos DB. Para más información, vea Supervisión de solicitudes del plano de control. Puede personalizar esta información, usar Azure Monitor y crear un libro para supervisar solicitudes de metadatos y establecer alertas.

Límites de recursos

En la tabla siguiente se enumeran los límites de recursos por suscripción o cuenta.

Recurso Límite
Número máximo de cuentas por suscripción 250 de forma predeterminada ¹
Número máximo de contenedores de bases de datos y por cuenta 500 ²
Rendimiento máximo que una cuenta admite para las operaciones de metadatos 240 RU/s

¹ Los límites predeterminados difieren para los clientes internos de Microsoft. Aumente estos límites mediante la creación de una solicitud de soporte técnico de Azure, hasta un máximo de 1000. Cosmos DB se reserva el derecho de eliminar las cuentas de base de datos vacías, es decir, ninguna base de datos o colecciones. ² Este límite no se puede aumentar. El recuento total incluye tanto bases de datos como contenedores dentro de una cuenta (por ejemplo, 1 base de datos y 499 contenedores, o 250 bases de datos y 250 contenedores).

Límites de solicitud

En la tabla siguiente se enumeran los límites de solicitudes por intervalo de cinco minutos, por cuenta, a menos que se especifique lo contrario.

Operación Límite
Máximo de claves Enumerar u Obtener 500 ¹
Máximo de Crear base de datos y contenedor 500
Máximo de Obtener o enumerar base de datos y contenedor 500 ¹
Máximo de Actualización del rendimiento aprovisionado 25
Máximo de conmutaciones por error regionales 10 (por hora) ²
Número máximo de todas las operaciones (PUT, POST, PATCH, DELETE, GET) no definidas anteriormente 500

¹ Use un cliente singleton para las instancias del SDK y las claves de caché, la base de datos y las referencias de contenedor entre solicitudes durante la vigencia de esa instancia. ² Las conmutaciones por error regionales solo se aplican a las cuentas de escritura de una sola región. Las cuentas de escritura de varias regiones no requieren ni permiten ningún cambio de la región de escritura.

Azure Cosmos DB realiza automáticamente copias de seguridad de los datos a intervalos regulares. Para obtener más información sobre los intervalos y las ventanas de retención de copias de seguridad, consulte Copias de seguridad en línea y restauración de datos a petición en Azure Cosmos DB.

Límites por cuenta

Estos son los límites por cuenta.

Rendimiento aprovisionado

Recurso Límite
Número máximo de contenedores y bases de datos por cuenta 500
Número máximo de contenedores por base de datos con rendimiento compartido 25
Número máximo de regiones Sin límite (todas las regiones de Azure)

Sin servidor

Recurso Límite
Número máximo de contenedores y bases de datos por cuenta 500
Número máximo de regiones 1 (cualquier región de Azure)

Límites de cada contenedor

Según la API que use, un contenedor de Azure Cosmos DB puede representar una colección, una tabla o un grafo. Los contenedores admiten configuraciones para restricciones de clave únicas, procedimientos almacenados, desencadenadores y funciones definidas por el usuario (UDF) y directivas de indexación. En la tabla siguiente se enumeran los límites específicos de las configuraciones dentro de un contenedor.

Recurso Límite
Longitud máxima del nombre de la base de datos o el contenedor 255
Número máximo de procedimientos almacenados por contenedor 100 ¹
Número máximo de UDF por contenedor 50 ¹
Número máximo de claves únicas por contenedor 10 ¹
Número máximo de rutas de acceso por restricción de clave única 16 ¹
Valor máximo de período de vida (TTL) 2,147,483,647

¹ Aumente cualquiera de estos límites por contenedor mediante la creación de una solicitud de soporte técnico de Azure.

Límites por elemento

Un elemento de Azure Cosmos DB puede representar un documento de una colección, una fila de una tabla o un nodo o borde en un grafo, en función de la API que use. En la tabla siguiente, se muestran los límites por elemento de Azure Cosmos DB.

Recurso Límite
Tamaño máximo de un elemento 2 MB (longitud en UTF-8 de la representación JSON) ¹
Longitud máxima del valor de la clave de partición 2048 bytes (101 bytes si la clave de partición grande no está habilitada)
Longitud máxima del valor de id. 1023 bytes
Caracteres permitidos para el valor de id. Se permiten todos los caracteres Unicode del servicio, excepto "/" y "\". ADVERTENCIA: Para obtener la mejor interoperabilidad, SE RECOMIENDA ENCARECIDAMENTE usar solo caracteres ASCII alfanuméricos en el valor de id. Existen limitaciones conocidas en algunas versiones del SDK de Cosmos DB y conectores (Azure Data Factory, Spark, Kafka, etc.) y controladores o bibliotecas HTTP. Estas limitaciones pueden impedir el procesamiento correcto cuando el valor de id. contiene caracteres ASCII no alfanuméricos. Por lo tanto, para aumentar la interoperabilidad, codifique el valor de id. (por ejemplo, mediante Base64 + codificación personalizada de caracteres especiales permitidos en Base64. - si tiene que admitir caracteres ASCII que no sean alfanuméricos en el servicio o aplicación.
Número máximo de propiedades por elemento Ningún límite práctico
Longitud máxima del nombre de la propiedad Ningún límite práctico
Longitud máxima del nombre de la propiedad Ningún límite práctico
Longitud máxima del valor de propiedad de la cadena Ningún límite práctico
Longitud máxima del valor de propiedad numérico IEEE754 de doble precisión de 64 bits
Nivel máximo de anidamiento para objetos o matrices insertados 128
Valor máximo de TTL 2147483647
Precisión e intervalo máximos de números en JSON (para garantizar la interoperabilidad segura) Institute of Electrical and Electronics Engineers (IEEE) 754 binary64

¹ Los tamaños de documento grandes de hasta 16 MB solo se admiten con Azure Cosmos DB for MongoDB. Para más información, vea la documentación de características de MongoDB 4.2.

No hay ninguna restricción en las cargas de elementos (como el número de propiedades o la profundidad de anidamiento), salvo las restricciones de longitud en los valores de identificador y clave de partición y la restricción de tamaño general de 2 MB. Es posible que tenga que configurar la directiva de indexación para contenedores con estructuras de elementos grandes o complejas para reducir el consumo de RU. Consulte Modelado de elementos en Azure Cosmos DB para obtener un ejemplo real y los patrones para administrar elementos de gran tamaño.

Límites por solicitud

Azure Cosmos DB admite operaciones CRUD y de consulta para recursos como contenedores, elementos y bases de datos. También admite solicitudes por lotes transaccionales para los elementos con la misma clave de partición en un contenedor.

Recurso Límite
Tiempo máximo de ejecución para una sola operación (por ejemplo, la ejecución de un procedimiento almacenado o la recuperación de una página de consulta única) 5 segundos
Tamaño máximo de la solicitud (por ejemplo, procedimiento almacenado, CRUD) 2 MB
Tamaño máximo de respuesta (por ejemplo, consulta paginada) 4 MB
Número máximo de operaciones en un lote transaccional 100

Azure Cosmos DB admite desencadenadores durante las escrituras. El servicio permite un desencadenador anterior y un desencadenador posterior por cada operación de escritura.

Cuando una operación de consulta alcanza el límite de tiempo de espera de ejecución o tamaño de respuesta, devuelve una página de resultados y un token de continuación al cliente para reanudar la ejecución. No hay ningún límite práctico en la duración de la ejecución de una sola consulta en páginas o continuaciones.

Azure Cosmos DB usa códigos de autenticación de mensajes basados en hash (HMAC) para la autorización. Use una clave principal para un control de acceso específico a los recursos. Estos recursos pueden incluir contenedores, claves de partición o elementos. En la tabla siguiente se enumeran los límites de los tokens de autorización de Azure Cosmos DB.

Recurso Límite
Tiempo de expiración máximo del token principal 15 minutos
Tiempo de expiración mínimo del token maestro 10 min
Tiempo de expiración máximo del token de recursos 24 h de forma predeterminada ¹
Distorsión máxima del reloj para la autorización del token 15 minutos

¹ Puede aumentarlo mediante la presentación de una incidencia de soporte técnico de Azure.

Límites del rendimiento aprovisionado de escalabilidad automática

Vea el artículo Escalabilidad automática y las Preguntas más frecuentes para obtener una explicación detallada de los límites de rendimiento y almacenamiento con escalabilidad automática.

Recurso Límite
Número máximo de RU/s a los que el sistema se puede escalar Tmax, el número máximo de RU/s de escalabilidad automática establecido por el usuario
Número mínimo de RU/s a los que el sistema se puede escalar 0.1 * Tmax
RU/s actuales a los que se escala el sistema 0.1*Tmax <= T <= Tmax, en función del uso
Número mínimo de RU/s facturables por hora 0.1 * Tmax

La facturación es por hora, en función de las RU/s más altas a las que el sistema se ha escalado durante la hora, o bien 0.1*Tmax, lo que sea mayor.
Valor mínimo del número máximo de RU/s de escalabilidad automática para un contenedor MAX(1000, highest max RU/s ever provisioned / 10, current storage in GB * 10) redondeado hacia arriba a los 1000 RU/s más cercanos
Valor mínimo del número máximo de RU/s de escalabilidad automática para una base de datos MAX(1000, highest max RU/s ever provisioned / 10, current storage in GB * 10, 1000 + (MAX(Container count - 25, 0) * 1000)) redondeado hasta las 1000 RU/s más cercanos.

Si la base de datos tiene más de 25 contenedores, el sistema aumenta el número mínimo de RU/s de escalabilidad automática en 1000 RU/s para cada contenedor adicional. Por ejemplo, si tiene 30 contenedores, el número máximo de RU/s de escalabilidad automática más bajo que puede establecer es de 6000 RU/s (escalado entre 600 y 6000 RU/s).

Límites de la consulta SQL

Azure Cosmos DB admite la consulta de elementos mediante SQL. En la tabla siguiente se describen las restricciones de las instrucciones de consulta, como el número de cláusulas o la longitud de la consulta.

Recurso Límite
Longitud máxima de la consulta SQL 512 KB
Número máximo de instrucciones JOIN por consulta 10¹
Número máximo de UDF por consulta 10 ¹
Número máximo de puntos por polígono 4096
Número máximo de rutas de acceso incluidas de forma explícita por contenedor 1500 ¹
Número máximo de rutas de acceso excluidas de forma explícita por contenedor 1500 ¹
Propiedades máximas de un índice compuesto 8
Número máximo de rutas de acceso en un índice compuesto 100

¹ Puede aumentar estos límites de consulta SQL mediante la creación de una solicitud de soporte técnico de Azure.

Límites específicos de la API para MongoDB

Azure Cosmos DB admite el protocolo de conexión de MongoDB para aplicaciones escritas con MongoDB. Busque los comandos y versiones de protocolo admitidos en Características compatibles y sintaxis de MongoDB.

En la tabla siguiente se enumeran los límites específicos a la compatibilidad con características de MongoDB. Los otros límites de servicio que se mencionan con la API para NoSQL también se aplican a la API para MongoDB.

Recurso Límite
Tamaño máximo de un documento 16 MB (longitud en UTF-8 de la representación JSON) ¹
Tamaño máximo de memoria de consulta de MongoDB (solo se aplica a la versión 3.2 del servidor) 40 MB
Tiempo máximo de ejecución para las operaciones de MongoDB (se aplica a la versión 3.2 del servidor) 15 segundos
Tiempo máximo de ejecución para las operaciones de MongoDB (se aplica a las versiones 3.6 y 4.0 del servidor) 60 segundos
Nivel máximo de anidamiento de objetos o matrices insertados en las definiciones de índice. 6
Tiempo de espera de conexión inactiva para el cierre de la conexión del lado servidor ² 30 minutos
Límite de tiempo para el shell de MongoDB en Azure Portal 120 minutos en un período de 24 horas

¹ Los tamaños de documento grandes hasta 16 MB requieren la habilitación de características en Azure Portal. Más información en la documentación de características.

² Establezca el tiempo de espera de conexión inactiva en la configuración del controlador en 2-3 minutos porque el tiempo de espera predeterminado para Azure LoadBalancer es de 4 minutos. Este tiempo de espera garantiza que un equilibrador de carga intermedio no cierre las conexiones inactivas entre la máquina cliente y Azure Cosmos DB.

Límites de las cuentas de nivel Gratis de Azure Cosmos DB

En la tabla siguiente se enumeran los límites de las cuentas de nivel Gratis de Azure Cosmos DB.

Recurso Límite
Número de cuentas de nivel Gratis por suscripción de Azure 1
Duración del descuento por nivel Gratis Vigencia de la cuenta. Debe participar durante la creación de la cuenta.
Número máximo de RU/s gratis 1000 RU/s
Almacenamiento máximo gratis 25 GB
Número máximo de contenedores en una base de datos de rendimiento compartido 25

Además de la tabla anterior, los límites por cuenta también se aplican a las cuentas del nivel Gratis. Para más información, vea cómo crear una cuenta de nivel Gratis.

Contenido relacionado

  • Last updated on