/ /

Métodos mongosh

particionado

Docs Home

Manual de MongoDB

Referencia

Métodos mongosh

particionado

sh.status()

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 5.0, consulte Procedimientos de actualización de MongoDB.6.0

Definición

sh.status()

Cuando se ejecuta en un La instanciamongosimprime un informe formateado de la configuración de fragmentación y la información sobre los fragmentos existentes en un clúster fragmentado. El comportamiento predeterminado suprime la información detallada de los 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 entre fragmentos, incluso si tiene 20 o más fragmentos, así como la cantidad de fragmentos en cada fragmento. Detalles de instancias activas de mongos. Si `false`, el método muestra: Detalles completos de la distribución de fragmentos entre los fragmentos solo si tiene menos de 20 fragmentos. Si tiene 20 o más fragmentos, el método devuelve un mensaje `too many chunks to print ...` que muestra solo el número de fragmentos en cada fragmento. Solo la versión y el número de instancias de mongos activas. El valor detallado predeterminado 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 fragmentación 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 Balanceador muestra información sobre su estado. Esto proporciona información sobre su funcionamiento actual y puede ser útil para solucionar problemas en un clúster fragmentado desequilibrado.

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 es un identificador para los detalles de la _id versión.

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

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

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

Instanciasactivas `mongos`

Nuevo en la versión 3.2.

sh.status.active-mongoses

Si verbose es false, sh.status.active-mongosesmuestra la versión y el número de lasmongosinstancias activas. Lasmongosinstancias activas sonmongosinstancias a las que se les hizo ping en los últimos 60 segundos.

Si verbose truees, devuelve para cada instancia mongos activa:

Su nombre de host y puerto.
Una matriz de nombres de dominio completos (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 división automática está habilitada actualmente.

Nota

Comenzando en 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 mongo métodos sh.enableBalancing(namespace) y no tienen efecto en la división sh.disableBalancing(namespace) automática.

Fragmentos

sh.status.shards._id: El muestra el nombre del _id fragmento.

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

sh.status.shards.tags: tags El campo muestra todas las etiquetas del fragmento. El campo solo se muestra si el fragmento tiene etiquetas.

sh.status.shards.state

Nuevo en la versión 3.4.

El state muestra:

0 Si el fragmento no es compatible con otros fragmentos.
1 Si el fragmento es compatible con otros fragmentos.

Balanceador

Nota

Comenzando en 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 mongo métodos sh.enableBalancing(namespace) y no tienen efecto en la división sh.disableBalancing(namespace) automática.

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

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

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

sh.status.balancer.failed-balancer-rounds-in-last-5-attempts: failed-balancer-rounds-in-last-5-attempts muestra el número de rondas de balanceo fallidas, de entre las últimas cinco rondas intentadas. Una ronda de balanceo fallará cuando falle la migración de un 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 sh.status() de.

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

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 no iniciadas por el balanceador.

Databases

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

sh.status.databases.partitioned: El indica si la base de datos tiene habilitada la fragmentación.partitioned Si true es, significa que la base de datos tiene habilitada la fragmentación.

sh.status.databases.primary: El primary muestra el fragmento principal de la base de datos.

sh.status.databases.version

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

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

dónde:

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).
Nuevo en la versión 3.2.

sh.status.databases.<collection>.balancing: Indica si el balanceador puede balancear la colección. Si el balanceador está habilitado y el estado true devuelve, incluye esta colección en las operaciones de balanceo. Si el estado false devuelve, indica que el balanceador no balancea los datos de esta colección.
Nuevo en la versión 3.2.

sh.status.databases.<collection>.chunks: chunks enumera todos los fragmentos y la cantidad de fragmentos que residen en cada fragmento.

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

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

El rango de valores de clave de fragmento que definen el fragmento,
El fragmento donde reside el trozo, 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 colección fragmentada, por defecto, muestra la información del fragmento si el número total de fragmentos es menor 20 que. Para mostrar la información cuando tiene 20 o más fragmentos, llame a los métodos con sh.status() el verbose parámetro establecido en, es true sh.status(true)decir,.

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`