/ /

Métodos mongosh

particionado

Docs Home

Manual de MongoDB

Referencia

Métodos mongosh

particionado

sh.status()

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 5.0, consulta el Procedimientos de actualización de MongoDB.6.0

Definición

sh.status()

Cuando se ejecuta en un La instancia mongos imprime un informe formateado de la configuración del particionado y la información relativa a los fragmentos existentes en un clúster. El comportamiento por defecto suprime la información detallada de fragmentos si el número total de fragmentos es mayor o igual a 20.

El método sh.status() tiene el siguiente parámetro:

Parameter	Tipo	Descripción
`verbose`	booleano	opcional. Determina el nivel de verbosidad. Si `true`, el método muestra: Detalles completos de la distribución de fragmentos a través de particiones, incluso si tienes 20 o más fragmentos, así como el número de fragmentos en cada partición. Detalles de instancias mongos activas. Si `false`, el método muestra: Detalles completos de la distribución de fragmentos en particiones sólo si tienes menos de 20 fragmentos. Si tienes 20 o más fragmentos, el método en su lugar devuelve un mensaje `too many chunks to print ...`, mostrando solo la cantidad de fragmentos en cada partición. Solo la versión y el número de instancias de mongos activas. El valor detallado por defecto es `false`.

Tip

db.printShardingStatus()

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

Importante

Este comando no es compatible con los clústeres M,0 M2 y5 M. Para obtener más información, consulte Comandos no compatibles.

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.

Ejemplos de salida

La sección Versión de particionado muestra información sobre la base de datos de configuración:

--- Sharding Status ---
  sharding version: {
   "_id" : <num>,
   "minCompatibleVersion" : <num>,
   "currentVersion" : <num>,
   "clusterId" : <ObjectId>
}

La sección Fragmentos muestra información sobre cada uno. Para cada fragmento, se muestra el nombre, el host y las etiquetas asociadas, si las hay.

shards:
 { "_id" : <shard name1>, "host" : <string>, "tags" : [ <string> ... ], "state" : <num> }
 { "_id" : <shard name2>, "host" : <string>, "tags" : [ <string> ... ], "state" : <num> }
 ...

La sección mongos Instancias activas muestra, de forma predeterminada, información sobre la versión y el recuento de mongos instancias que han estado activas en los últimos 60 segundos:

active mongoses:
  <version> : <num>

Si el método se ejecuta con el verbose parámetro en verdadero, la sección Instancias activas mongos muestra información adicional:

active mongoses:
{  "_id" : "<hostname:port>",  "advisoryHostFQDNs" : [ "<name>" ],  "mongoVersion" : <string>,  "ping" : <ISODate>,  "up" : <long>,  "waiting" : <boolean> }

La división automática muestra información sobre si la división automática está habilitada:

autosplit:
  Currently enabled: <yes|no>

La sección Balancer enumera información sobre el estado del balanceador. Esto proporciona una perspectiva sobre la operación actual del balanceador y puede ser útil para solucionar problemas en un clúster no balanceado.

balancer:
      Currently enabled:  yes
      Currently running:  yes
      Collections with active migrations:
              config.system.sessions started at Fri May 15 2020 17:38:12 GMT-0400 (EDT)
      Failed balancer rounds in last 5 attempts:  0
      Migration Results for the last 24 hours:
             416 : Success
             1 : Failed with error 'aborted', from shardA to shardB

La sección Bases de datos muestra información sobre las bases de datos. Para cada base de datos, se muestra su nombre, si tiene habilitada la fragmentación y su fragmento principal.

databases:
 { "_id" : <dbname1>, "primary" : <string>, "partitioned" : <boolean>, "version": <document> }
 { "_id" : <dbname2>, "primary" : <string>, "partitioned" : <boolean>, "version": <document> }
 ...

La sección Colección Fragmentada proporciona información sobre los detalles de fragmentación de las colecciones fragmentadas. Para cada colección, se muestra la clave de fragmento, el número de fragmentos por fragmento, la distribución de fragmentos entre fragmentos []1 y la información de la etiqueta, si la hay, para el rango de claves de fragmento.

<dbname>.<collection>
   shard key: { <shard key> : <1 or hashed> }
   unique: <boolean>
   balancing: <boolean>
   chunks:
      <shard name1> <number of chunks>
      <shard name2> <number of chunks>
      ...
   { <shard key>: <min range1> } -->> { <shard key> : <max range1> } on : <shard name> <last modified timestamp>
   { <shard key>: <min range2> } -->> { <shard key> : <max range2> } on : <shard name> <last modified timestamp>
   ...
   tag: <tag1>  { <shard key> : <min range1> } -->> { <shard key> : <max range1> }
   ...

Campos de salida

Versión de particionado

sh.status.sharding-version._id: El _id es un identificador para los detalles de la versión.

sh.status.sharding-version.minCompatibleVersion: La minCompatibleVersion es la versión mínima compatible del servidor de configuración.

sh.status.sharding-version.currentVersion: El currentVersion es la versión actual del servidor de configuración.

sh.status.sharding-version.clusterId: El clusterId es la identificación del clúster.

Instanciasactivas `mongos`

Novedad en la versión 3.2.

sh.status.active-mongoses

Si verbose es false, sh.status.active-mongoses muestra la versión y el recuento de las instancias activas de mongos. Las instancias activas mongos son instancias mongos a las que se ha hecho ping en los últimos 60 segundos.

Si verbose truees, devuelve para cada instancia mongos activa:

Su nombre de host y puerto.
Un arreglo de los nombres de dominio totalmente calificados (FQDN) de la instancia.
Su versión MongoDB.
Su fecha y hora de ping más reciente.
Su tiempo de actividad desde el último ping.
Su estado de espera.

active mongoses:
{  "_id" : "<hostname:port>",  "advisoryHostFQDNs" : [ "<name>" ],  "mongoVersion" : <string>,  "ping" : <ISODate>,  "up" : <long>,  "waiting" : <boolean> }
...

Autosplit

sh.status.autosplit: sh.status.autosplit indica si la partición automática está activada actualmente.

Nota

A partir de MongoDB 4.2:

El comandobalancerStarty los métodos auxiliares de shellmongosh.startBalancer()ysh.setBalancerState(true)también habilitan la división automática para el clúster fragmentado.
To disable auto-splitting when the balancer is enabled, you can use sh.disableAutoSplit().
El comandobalancerStopy los métodos auxiliares de shellmongosh.stopBalancer()ysh.setBalancerState(false)también deshabilitan la división automática para el clúster fragmentado.
To enable auto-splitting when the balancer is disabled, you can use sh.enableAutoSplit().

Los métodos mongo sh.enableBalancing(namespace) y sh.disableBalancing(namespace) no afectan la división automática.

Fragmentos

sh.status.shards._id: El _id muestra el nombre de la partición.

sh.status.shards.host: El host muestra la ubicación del host de la partición.

sh.status.shards.tags: El tags muestra todas las etiquetas para la partición. El campo solo se muestra si la partición tiene etiquetas.

sh.status.shards.state

Novedad en la versión 3.4.

El state muestra:

0 si la partición no es consciente de particiones.
1 Si el fragmento es compatible con otros fragmentos.

Balanceador

Nota

A partir de MongoDB 4.2:

El comandobalancerStarty los métodos auxiliares de shellmongosh.startBalancer()ysh.setBalancerState(true)también habilitan la división automática para el clúster fragmentado.
To disable auto-splitting when the balancer is enabled, you can use sh.disableAutoSplit().
El comandobalancerStopy los métodos auxiliares de shellmongosh.stopBalancer()ysh.setBalancerState(false)también deshabilitan la división automática para el clúster fragmentado.
To enable auto-splitting when the balancer is disabled, you can use sh.enableAutoSplit().

Los métodos mongo sh.enableBalancing(namespace) y sh.disableBalancing(namespace) no afectan la división automática.

sh.status.balancer.currently-enabled: currently-enabled indica si el balanceador está actualmente habilitado en el clúster particionado.

sh.status.balancer.currently-running: currently-running indica si el balanceador está actualmente en funcionamiento y, por tanto, equilibrando actualmente el clúster.

sh.status.balancer.collections-with-active-migrations: collections-with-active-migrations muestra los nombres de las colecciones con migraciones activas y especifica cuándo comenzó la migración. Si no hay migraciones activas, este campo no aparecerá en la salida de sh.status().

sh.status.balancer.failed-balancer-rounds-in-last-5-attempts: failed-balancer-rounds-in-last-5-attempts muestra el número de rondas del balanceador que fallaron, de entre las últimas cinco rondas intentadas. Una ronda de balanceador fallará cuando falla una migración de fragmento.

sh.status.balancer.last-reported-error: last-reported-error muestra el mensaje de error más reciente del balanceador. Si no se han producido errores, este campo no aparecerá en la salida de sh.status().

sh.status.balancer.time-of-reported-error: time-of-reported-error proporciona la fecha y hora del error más recientemente reportado.

sh.status.balancer.migration-results-for-the-last-24-hours

migration-results-for-the-last-24-hours muestra el número de migraciones en las últimas 24 horas y los mensajes de error de las migraciones fallidas. Si no ha habido migraciones recientes, migration-results-for-the-last-24-hours No recent migrationsmuestra.

migration-results-for-the-last-24-hours incluye todas las migraciones, incluidas aquellas que no son iniciadas por el balanceador.

Databases

sh.status.databases._id: El _id muestra el nombre de la base de datos.

sh.status.databases.partitioned: El partitioned muestra si la base de datos tiene habilitado el particionado. Si true, la base de datos tiene habilitado el particionado.

sh.status.databases.primary: primary muestra la partición primaria de la base de datos.

sh.status.databases.version

La version muestra la información de la versión de la base de datos:

{  "uuid" : UUID("cc250b66-8638-49f7-a2e8-c6f1220b9d7a"),  "lastMod" : 1 }

donde:

uuid es el identificador de la base de datos.
lastMod es la versión de la base de datos.

Colección particionada

sh.status.databases.<collection>.shard-key: El muestra el documento de especificación de la clave de shard-key fragmento.

sh.status.databases.<collection>.unique: muestra si MongoDB aplica unicidad a los valores de clave de fragmento (es decir, si el índice de clave de fragmento subyacente es unique único).
Novedad en la versión 3.2.

sh.status.databases.<collection>.balancing: Muestra si el balanceador puede equilibrar la colección. Si el equilibrador está activado y este estado devuelve true, el equilibrador incluirá esta colección en las operaciones de equilibrio. Si el estado devuelve false, esto indica que el balanceador no equilibra los datos en esta colección.
Novedad en la versión 3.2.

sh.status.databases.<collection>.chunks: El chunks lista todas las particiones y el número de fragmentos que residen en cada partición.

sh.status.databases.<collection>.chunk-details

El chunk-details lista los detalles de los fragmentos [1]:

El rango de valores de la clave de partición que definen el fragmento,
La partición donde reside el fragmento, y
La última marca de tiempo modificada para el fragmento.

sh.status.databases.<collection>.tag: El enumera los detalles de las etiquetas asociadas con un rango de valores de clave de tag fragmento.

Tip

sh.balancerCollectionStatus()

[1] (1, 2) La sección de la colección particionada, por defecto, muestra la información de fragmentos si el número total de fragmentos es menor a 20. Para mostrar la información cuando tenga 20 fragmentos o más, llame a los métodos sh.status() con el parámetro verbose establecido en true, es decir, sh.status(true).

Volver

sh.startBalancer

sh.stopBalancer

Definición

Tip

Compatibilidad

Importante

Ejemplos de salida

Campos de salida

Versión de particionado

Instanciasactivas mongos

Autosplit

Nota

Fragmentos

Balanceador

Nota

Databases

Colección particionada

Tip

Instanciasactivas `mongos`