Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Gestionar los límites de query de procesamiento de datos de Atlas Data Federation

Puedes limitar la cantidad de datos que Atlas Data Federation procesa en tus instancias federadas de base de datos para controlar los costos. Para limitar la cantidad de datos procesados, puedes configurar límites de consulta por instancia federada de base de datos y para todas las instancias federadas de bases de datos en tu Proyecto. Los límites de query que configures solo se aplican a los costos de procesamiento de datos y no se aplican a otros costos de Atlas Data Federation, como la recuperación y transferencia de datos.

Puedes configurar un límite por query, por día, por semana y por mes por proyecto y por instancia de base de datos federada. Atlas Data Federation considera cada límite de cada tipo como independiente de otros límites configurados. Si configuras el mismo tipo de límite para el Proyecto y para una instancia federada de base de datos dentro del Proyecto, Atlas Data Federation hará cumplir el límite más restrictivo de los dos. Los valores límite deben estar entre 1GiB (1024^3 bytes) y 1EiB.

Por defecto, Atlas Data Federation establece un límite de 100 TB en la cantidad de datos procesados por mes para todas las instancias federadas de bases de datos nuevas.

Nota

Atlas Data Federation aplica el límite del proyecto por almacenamiento de objetos en la nube. Por ejemplo, supongamos que tiene 2 instancia federada de base de datos, una en Amazon Web Services y otra en Azure. Atlas Data Federation permite escaneos de hasta 100TB por instancia federada de base de datos para un total de 200TB para el Proyecto.

Cuando la cantidad de datos procesados alcanza el monto límite configurado, Atlas Data Federation deja de procesar datos para la query que ha alcanzado el límite si el tipo de límite es por query. Para los límites de otros tipos, Atlas Data Federation no ejecuta ninguna nueva consulta hasta que el límite se restablece según el tipo de límite configurado. Es decir, Atlas Data Federation no ejecuta ninguna query nueva hasta:

  • El siguiente día calendario comenzará a las 00:00 UTC para el tipo de límite de por día.

  • La próxima semana calendario, comenzando el lunes a las 00:00 UTC para el tipo de límite de por semana.

  • El siguiente mes calendario comenzará el primer día (1) del mes a las 00:00 UTC para el tipo de límite de por mes.

Si configuras el mismo tipo de límite para tanto el Proyecto como las instancias federadas de base de datos en el Proyecto, pero con diferentes cantidades de límite para el Proyecto y las instancias federadas de base de datos en el Proyecto, se aplican los siguientes casos:

  • Si Atlas Data Federation alcanza el monto límite del Proyecto antes de alcanzar el monto límite para cualquier instancia federada de base de datos en el Proyecto, Atlas Data Federation permite que todas las consultas en ejecución contra todas las instancias federadas de base de datos en el Proyecto se completen.

  • Si Atlas Data Federation no alcanza el monto límite para el proyecto, pero alcanza el monto límite establecido para cualquier instancia de base de datos federada en el proyecto, Atlas Data Federation permite que todas las queries en curso contra esa instancia de base de datos federada se completen, pero no ejecuta ninguna nueva query contra esa instancia de base de datos federada. Atlas Data Federation continúa ejecutando queries en otras instancias federadas de base de datos en el Proyecto hasta alcanzar el monto límite establecido para el Proyecto. Cuando Atlas Data Federation alcanza el límite de proyecto, permite que se completen todas las queries en curso en todas las instancias federadas de base de datos del proyecto, pero no ejecuta queries nuevas en instancias federadas de base de datos.

Atlas Data Federation muestra una advertencia en la Interfaz de Usuario de Atlas cuando Atlas Data Federation alcanza el límite de procesamiento de datos. Además, puedes configurar Atlas Data Federation para terminar las consultas que superen el límite CUANTO ANTES cuando Atlas Data Federation alcance el límite, en lugar de permitir que las consultas en ejecución se completen.

Si configura Atlas Data Federation para cancelar las query que excedan el límite, Atlas Data Federation intenta cancelar las query cuando alcance el límite aplicable. Mientras Atlas Data Federation intenta finalizar la query, Atlas Data Federation podría superar el límite ligeramente. Atlas Data Federation no devuelve ningún resultado y solo devuelve un error con el código de error ResourceExhausted (402). Sin embargo, verá cargos por procesamiento de datos por la cantidad de datos que Atlas Data Federation procesó antes de alcanzar el límite.

Si configura el mismo tipo de límite tanto para el Proyecto como para las instancias federadas de base de datos del Proyecto, pero con diferentes cantidades de límite y configuraciones de finalización de query, Atlas Data Federation finaliza la query solo cuando la cantidad de datos que Atlas Data Federation procesa alcanza la cantidad de límite que asoció con la finalización de query.

Ejemplo

Supongamos un límite de proyecto de 100 GB por semana con finalización habilitada y un límite de instancia de base de datos federada de 60 GB por semana con finalización deshabilitada.

  • Cuando una o más consultas contra la instancia federada de base de datos alcanzan el límite de 60 GB, Atlas Data Federation termina todas las consultas en ejecución contra la instancia federada de base de datos y no ejecuta nuevas consultas. Atlas Data Federation continúa ejecutando todas las consultas en ejecución y nuevas en otras instancias federadas de bases de datos en el proyecto hasta que Atlas Data Federation alcance el límite del proyecto de 100 GB.

  • Cuando una o más queries alcanzan el límite de 100 GB para el Proyecto, Atlas Data Federation no ejecuta nuevas queries y termina todas las queries en todas las instancias federadas de base de datos en el Proyecto.

Para agregar, editar o borrar los límites de query, debe tener Project Owner acceso al proyecto. Los usuarios con Organization Owner acceso deben agregarse como Project Owner al Proyecto antes de agregar, editar o borrar límites de queries.

Para ver los límites de las query, debe tener acceso Project Read Only al Proyecto o un rol con más acceso.

Puedes configurar límites en la cantidad de datos procesados para tus consultas desde la línea de comando de Atlas Atlas CLI, la interfaz de usuario Atlas UI y la API.

Para crear un nuevo límite de consulta de Data Federation mediante Atlas CLI, ejecute el siguiente comando:

atlas dataFederation queryLimits create <name> [options]

Para aprender más sobre la sintaxis del comando y los parámetros, consulta la documentación de Atlas CLI para atlas dataFederation queryLimits create.

Puedes ver los límites del Proyecto y de la instancia federada de base de datos en las consultas desde Atlas CLI, API y Interfaz de Usuario de Atlas. También puede ver la cantidad de datos que Atlas Data Federation procesa por instancia por día.

Para listar los límites de query de Data Federation de tu Proyecto usando el Atlas CLI, ejecutar el siguiente comando:

atlas dataFederation queryLimits list [options]

Para devolver los detalles del límite de consulta de Data Federation que se especifica usando la Atlas CLI, ejecuta el siguiente comando:

atlas dataFederation queryLimits describe <name> [options]

Para aprender más sobre la sintaxis y los parámetros de los comandos anteriores, consulta la documentación de la CLI de Atlas para atlas dataFederation queryLimits list y atlas dataFederation queryLimits describe.

Tip

Consulte: Enlaces relacionados

Puedes editar los límites del proyecto y por instancia de base de datos federada desde la Interfaz de Usuario de Atlas y API.

1
  1. Inicie sesión en MongoDB Atlas.

  2. Selecciona la opción Data Federation en la barra de navegación de la izquierda.

2

La página Data Federation Query Limits muestra las acciones que puedes realizar en el límite correspondiente en la columna Actions.

3
4

Puedes modificar cualquiera de los siguientes ajustes:

Nombre de campo
Descripción
Limit Amount

Especifique la cantidad de datos en MB, GB o TB para limitar. Se aplica lo siguiente si el nuevo monto límite es más restrictivo que cualquier otro límite del mismo tipo en otro nivel:

  • Si Atlas Data Federation aún no ha alcanzado el nuevo límite, Atlas Data Federation comienza a ejecutar nuevas queries y reinicia cualquier query terminada. Para obtener más información, consulta ¿Qué sucede cuando Atlas Data Federation alcanza el límite de datos?

  • Si Atlas Data Federation ya ha alcanzado el nuevo límite, Atlas Data Federation no ejecuta nuevas query, pero permite que todas las query en curso se completen si la terminación de query está deshabilitada. Si has habilitado la terminación de query, Atlas Data Federation termina todas las query en ejecución. Para obtener más información, consulta ¿Qué sucede cuando habilitas la terminación de query?

Terminate Queries

Activa la opción para permitir la terminación de consultas. No puede habilitar la terminación de queries para el tipo de límite Por consulta porque para este tipo de límite, Atlas Data Federation intentará terminar cada query tan pronto como alcance el límite por defecto. Si activas la terminación de consultas para cualquier otro tipo, Atlas Data Federation termina las consultas en ejecución que han alcanzado el límite. Si desactivas la terminación, Atlas Data Federation no reiniciará ninguna query terminada ni terminará cualquier nueva query o query en ejecución cuando Atlas Data Federation alcance el monto límite. En su lugar, sus consultas en ejecución podrán completarse y escanear datos adicionales.

Para aprender más, vea ¿Qué sucede cuando habilita la terminación de query?.

5

Puedes eliminar un proyecto o el límite por instancia federada de base de datos desde el Atlas CLI, Atlas Interfaz de Usuario y la API.

Para remover el límite de query de Data Federation especificado de tu Proyecto utilizando la Atlas CLI, ejecutar el siguiente comando:

atlas dataFederation queryLimits delete <name> [options]

Para aprender más sobre la sintaxis del comando y los parámetros, consulta la documentación de Atlas CLI para atlas dataFederation queryLimits delete.