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

Esta página documenta un método mongosh. Esta no es la documentación para los comandos de base de datos ni para los drivers específicos de lenguajes, como Nodo.js.

Para el comando de base de datos, consulta el 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

En la mayoría de las circunstancias, se debe dejar la división de fragmentos en los procesos automatizados dentro de MongoDB. Sin embargo, al implementar inicialmente un clúster, puede ser útil dividir previamente manualmente una colección vacía utilizando métodos como 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 } )