/ /

Comandos de base de datos

particionado

Docs Home

Desarrollo

Comandos de base de datos

particionado

listShards (comando de base de datos)

Definición

listShards: La listShards El comando devuelve una lista de las particiones configuradas en un clúster. listShards solo está disponible en mongos instancias y debe emitirse contra la base de datos admin.

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

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 comando tiene la siguiente sintaxis:

db.runCommand(
  {
    listShards: 1
  }
)

Campos de comandos

El comando toma los siguientes campos:

Campo	Tipo	Descripción
`listShards`	entero	`1` solicita una lista de particiones configuradas.
`filter`	Documento	Especifica un filtro para las particiones en los documentos devueltos. Nuevo en la versión 8.3.
`filter.draining`	booleano	Los filtros devuelven documentos basados en si los fragmentos están drenando. Cuando se configure en `true`, el comando devuelve un arreglo de las particiones que están siendo drenadas por el balanceador. Cuando se establece en `false`, el comando devuelve un arreglo de todas las particiones que no están siendo drenadas por el balanceador. Cuando no está seleccionado, el comando devuelve todas las particiones, sin importar su estado de vaciado. Nuevo en la versión 8.3.

Campos de salida

listShards devuelve un documento que incluye:

Un shards campo que contiene un arreglo de documentos, cada uno describiendo uno de las particiones. Cada documento puede contener los siguientes campos:

Campo	Descripción
`_id`	Nombre de la partición.
`host`	Nombre de host de la partición. Si la partición es un set de réplicas, `host` enumera el nombre de host de cada instancia mongod en el set de réplicas.
`draining`	Si `true`, indica que se han invocado los comandos `startShardDraining` o `removeShard` para esta partición y se encuentra en proceso de apagado.
`tags`	Lista de zonas a las que pertenece la partición.
`state`	Campo interno utilizado durante la secuencia addShard (comando de base de datos) para garantizar que se completen todos los pasos y la configuración necesarios para agregar la partición al clúster.

El campo de estado ok, el campo operationTime y el campo $clusterTime para la operación. Para obtener detalles sobre estos campos, ver Response.

Ejemplo

La siguiente operación ejecuta listShards contra la base de datos mongos admin:

db.adminCommand({ listShards: 1 })

El siguiente documento es un ejemplo de la salida de un comando listShards:

{
  "shards": [
    {
      "_id": "shard01",
      "host": "shard01/host1:27018,host2:27018,host3:27018",
      "state": 1
    },
    {
      "_id": "shard02",
      "host": "shard02/host4:27018,host5:27018,host6:27018",
      "tags": [ "NYC" ],
      "state": 1
    },
    {
      "_id": "shard03",
      "host": "shard03/host7:27018,host8:27018,host9:27018",
      "state": 1
    }
  ],
  "ok": 1,
  "$clusterTime" : {
     "clusterTime" : Timestamp(1510716515, 1),
     "signature" : {
        "hash" : BinData(0,"B2ViX7XLzFLS5Fl9XEuFXbwKIM4="),
        "keyId" : Long("6488045157173166092")
     }
  },
  "operationTime" : Timestamp(1510716515, 1)
}

Volver

isdbgrid

fusionarTodosLosFragmentosEnShard