db.collection.getShardDistribution()

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

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 controlador específicos del lenguaje de programación.

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

Para obtener la documentación del shell heredado, consulte la documentación de la versión correspondiente de MongoDB mongo 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 fragmentada.

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.

Sintaxis

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

db.collection.getShardDistribution()

Tip

particionado

Salida

Salida de muestra

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 una cadena que contiene el nombre del fragmento.
<host-x> es una cadena que contiene el nombre(s) del host.
<size-x> es un número que incluye el tamaño de los datos, incluida la unidad de medida (por ejemplo, b, Mb).
<count-x> es un número que informa la cantidad de documentos en el fragmento.
<number of chunks-x> es un número que informa la cantidad de fragmentos en el fragmento.
<size-x>/<number of chunks-x> es 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> es un valor calculado que refleja la cantidad estimada de documentos por fragmento para el fragmento.
<stats.size> es un valor que informa el tamaño total de los datos en la colección fragmentada, incluida la unidad de medida.
<stats.count> es un valor que informa el número total de documentos en la colección fragmentada.
<calc total chunks> es un número calculado que informa la cantidad de fragmentos de todos los fragmentos, por ejemplo:
```
<calc total chunks> = <number of chunks-a> + <number of chunks-b>
```
<estDataPercent-x> es un valor calculado que refleja, para cada fragmento, 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 fragmento, la cantidad de documentos como porcentaje de la cantidad total de documentos de 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, para el fragmento.

Volver

db.collection.getIndexes

db.collection.getShardVersion