Docs Menu
Docs Home
/ /

db.collection.getShardDistribution() (método mongosh)

Importante

Método mongosh

Esta página documenta una Método mongosh. Esta no es la documentación de un controlador específico del lenguaje, como Node.js.

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

db.collection.getShardDistribution()

Imprime las estadísticas de distribución de datos para un colecciónfragmentada

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 M0 y Flex. Para obtener más información, consulta 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.

El método getShardDistribution() tiene la siguiente forma:

db.collection.getShardDistribution()

Nota

El comportamiento de getShardDistribution() cambió en la versión 2.3.3 de MongoDB Shell:

  • A partir de la versión de MongoDB 2.3.3 Shell, getShardDistribution() solo contiene datos fragmentados regulares y no tiene en cuenta los documentos huérfanos.

  • Antes de la versión 2.3.3 de MongoDB Shell, getShardDistribution() contabilizaba tanto los datos fragmentados regulares como los documentos huérfanos pendientes de eliminación. Si la colección contiene documentos huérfanos, getShardDistribution() podría indicar que la colección está desequilibrada, incluso si está equilibrada en cuanto a datos regulares. El fragmento que contiene datos huérfanos tiene más documentos y mayor tamaño de datos, pero el mismo número de fragmentos que otros fragmentos.

Lo siguiente es una muestra de salida para la distribución de una colección particionada:

Shard shard01 at shard01/localhost:27018
{
data: '38.14MB',
docs: 1000003,
chunks: 2,
'estimated data per chunk': '19.07B',
'estimated docs per chunk': 500001
}
---
Shard shard02 at shard02/localhost:27019
{
data: '38.14B',
docs: 999999,
chunks: 3,
'estimated data per chunk': '12.71B',
'estimated docs per chunk': 333333
}
---
Totals
{
data: '76.29B',
docs: 2000002,
chunks: 5,
'Shard shard01': [ '50 % data', '50 % docs in cluster', '40B avg obj size on shard' ],
'Shard shard02': [ '49.99 % data', '49.99 % docs in cluster', '40B avg obj size on shard' ]
}
Shard shard01 at <host-a> {
data: <size-a>,
docs: <count-a>,
chunks: <number of chunks-a>,
'estimated data per chunk': <size-a>/<number of chunks-a>,
'estimated docs per chunk': <count-a>/<number of chunks-a>
}
---
Shard shard02 at <host-b>
{
data: <size-b>,
docs: <count-b>,
chunks: <number of chunks-b>,
'estimated data per chunk': <size-b>/<number of chunks-b>,
'estimated docs per chunk': <count-b>/<number of chunks-b>
}
---
Totals
{
data: <stats.size>,
docs: <stats.count>,
chunks: <calc total chunks>,
Shard shard01: [ <estDataPercent-a> % data, <estDocPercent-a> % docs in cluster, stats.shards[ <shard-a> ].avgObjSize avg obj size on shard ],
Shard shard02: [ <estDataPercent-b> % data, <estDocPercent-b> % docs in cluster, stats.shards[ <shard-b> ].avgObjSize avg obj size on shard ]
}

La información de salida muestra:

Salida
Descripción

<shard-x>

Una cadena que contiene el nombre de la partición.

<host-x>

Una cadena que contiene el nombre o los nombres del host.

<size-x>

Un número que incluye el tamaño de los datos, incluida la unidad de medida (por ejemplo, b, Mb).

<count-x>

Un número que informa la cantidad de documentos en el fragmento.

<number of chunks-x>

Un número que informa la cantidad de fragmentos en el fragmento.

<size-x>/<number of chunks-x>

Un valor calculado que refleja el tamaño de datos estimado por fragmento para el fragmento, incluida la unidad de medida (por ejemplo, b, Mb).

<count-x>/<number of chunks-x>

Un valor calculado que refleja la cantidad estimada de documentos por fragmento para el fragmento.

<stats.size>

Un valor que informa el tamaño total de los datos en la colección fragmentada, incluida la unidad de medida.

<stats.count>

Un valor que informa el número total de documentos en la colección fragmentada.

<calc total chunks>

Un número calculado que indica la cantidad de fragmentos de todos los fragmentos. Por ejemplo:

<calc total chunks> = <number of chunks-a> + <number of chunks-b>

<estDataPercent-x>

Un valor calculado que refleja, para cada fragmento, el tamaño de los datos como porcentaje del tamaño total de la colección. Por ejemplo:

<estDataPercent-x> = <size-x>/<stats.size>

<estDocPercent-x>

Un valor calculado que refleja, para cada fragmento, el número de documentos como porcentaje del total de documentos de la colección. Por ejemplo:

<estDocPercent-x> = <count-x>/<stats.count>

stats.shards[ <shard-x> ].avgObjSize

Un número que refleja el tamaño promedio del objeto, incluida la unidad de medida, para el fragmento.

Después de un apagado incorrecto de un mongod usando el motor de almacenamiento Wired Tiger, las estadísticas de conteo y tamaño informadas por db.collection.getShardDistribution() pueden ser inexactas.

La cantidad de deriva depende del número de operaciones de inserción, actualización o eliminación realizadas entre el último punto de control y el apagado no limpio. Los puntos de control suelen ocurrir cada 60 segundos. Sin embargo, las instancias mongod que se ejecutan con configuraciones --syncdelay no por defecto pueden tener puntos de control más o menos frecuentes.

Ejecuta validate en cada colección en el mongod para restaurar las estadísticas después de un apagado no limpio.

Después de un apagado no limpio:

Volver

db.collection.getIndexes

En esta página