sh.splitAt() (método mongosh)

Definición

sh.splitAt(namespace, query)

Divide un fragmento en el valor de la clave de partición especificado por la query.

Importante

Método mongosh

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as Node.js.

Para el comando de base de datos, consulta el comando split.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

El método toma los siguientes argumentos:

Parameter	Tipo	Descripción
namespace	string	El espacio de nombres (es decir, <database>.<collection>) de la colección particionada que contiene el fragmento a dividir.
query	Documento	Un query que especifica el valor de la clave de partición en el que dividir el fragmento.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

• MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

• MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

• MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Consideración

In most circumstances, you should leave chunk splitting to the automated processes within MongoDB. However, when initially deploying a sharded cluster, it may be beneficial to pre-split manually an empty collection using methods such as sh.splitAt().

Comportamiento

sh.splitAt() divide el fragmento original en dos fragmentos. Un fragmento tiene un rango de claves de partición que comienza con el límite inferior original (inclusive) y termina en el valor de la clave de partición especificado (exclusivo). El otro fragmento tiene un rango de clave de partición que comienza con el valor especificado de la clave de partición (inclusive) como límite inferior y termina en el límite superior original (exclusivo).

Para dividir un fragmento en su punto medio en su lugar, consulta sh.splitFind().

Ejemplo

Para la colección particionada test.foo, el siguiente ejemplo divide un fragmento en el valor de la clave de partición x: 70.

sh.splitAt( "test.foo", { x: 70 } )