db.collection.getShardDistribution()

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

db.collection.getShardDistribution()

Importante

Método mongosh

Este es un método mongosh. Esta no es la documentación de Node.js ni de otros métodos de controladores específicos de lenguajes de programación.

En la mayoría de los casos, los métodos mongosh funcionan de la misma manera que los métodos tradicionales mongo métodos shell. Sin embargo, algunos métodos heredados no están disponibles en mongosh.

Para la documentación heredada de mongo shell, revisa la documentación de la versión correspondiente de MongoDB Server:

Para los controladores de la API de MongoDB, consultar la documentación específica del controlador de MongoDB para cada lenguaje.

Imprime las estadísticas de distribución de datos para una colección particionada.

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 M0, M2, y M5. Para obtener más información, consulte Comandos incompatibles.

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.

Sintaxis

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

db.collection.getShardDistribution()

Tip

particionado

Salida

Muestra de salida

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

Shard shard-a at shard-a/MyMachine.local:30000,MyMachine.local:30001,MyMachine.local:30002
data : 38.14Mb docs : 1000003 chunks : 2
estimated data per chunk : 19.07Mb
estimated docs per chunk : 500001
Shard shard-b at shard-b/MyMachine.local:30100,MyMachine.local:30101,MyMachine.local:30102
data : 38.14Mb docs : 999999 chunks : 3
estimated data per chunk : 12.71Mb
estimated docs per chunk : 333333
Totals
data : 76.29Mb docs : 2000002 chunks : 5
Shard shard-a contains 50% data, 50% docs in cluster, avg obj size on shard : 40b
Shard shard-b contains 49.99% data, 49.99% docs in cluster, avg obj size on shard : 40b

Campos de salida

Shard <shard-a> 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 <shard-b> 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 <shard-a> contains  <estDataPercent-a>% data, <estDocPercent-a>% docs in cluster, avg obj size on shard : stats.shards[ <shard-a> ].avgObjSize
 Shard <shard-b> contains  <estDataPercent-b>% data, <estDocPercent-b>% docs in cluster, avg obj size on shard : stats.shards[ <shard-b> ].avgObjSize

La información de salida muestra:

<shard-x> es un string que contiene el nombre de la partición.
<host-x> es un string que contiene el/los nombre(s) de host.
<size-x> es un número que incluye el tamaño de los datos, incluyendo la unidad de medida (por ejemplo, b, Mb).
<count-x> es un número que informa el número de documentos en la partición.
<number of chunks-x> es un número que indica la cantidad de fragmentos en la partición.
<size-x>/<number of chunks-x> es un valor calculado que refleja el tamaño estimado de los datos por fragmento para la partición, incluida la unidad de medida (por ejemplo. b, Mb).
<count-x>/<number of chunks-x> es un valor calculado que refleja el número estimado de documentos por fragmento para la partición.
<stats.size> es un valor que informa el tamaño total de los datos en la colección particionada, incluida la unidad de medida.
<stats.count> Es un valor que reporta el número total de documentos en la colección particionada.
<calc total chunks> es un número calculado que informa sobre el número de fragmentos de todas las particiones, por ejemplo:
```
<calc total chunks> = <number of chunks-a> + <number of chunks-b>
```
<estDataPercent-x> es un valor calculado que refleja, para cada partición, el tamaño de los datos como porcentaje del tamaño total de los datos de la colección, por ejemplo:
```
<estDataPercent-x> = <size-x>/<stats.size>
```
<estDocPercent-x> es un valor calculado que refleja, para cada partición, el número de documentos como porcentaje del número total de documentos para la colección, por ejemplo:
```
<estDocPercent-x> = <count-x>/<stats.count>
```
stats.shards[ <shard-x> ].avgObjSize es un número que refleja el tamaño promedio del objeto, incluida la unidad de medida, de la partición.

Volver

db.collection.getIndexes

db.collection.getShardVersion