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. No se trata de la documentación de comandos de base de datos ni de controladores específicos de lenguajes de programación, como 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 administrado 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 los casos, conviene dejar la división de fragmentos a los procesos automatizados de MongoDB. Sin embargo, al implementar inicialmente un clúster fragmentado, puede resultar beneficioso dividir 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 } )