Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

getShardMap (comando de base de datos)

getShardMap

getShardMap devuelve la siguiente información sobre su clúster:

  • Los nombres de tus particiones y del set de réplicas del servidor de configuración.

  • Nombres de host y cadenas de conexión para los nodos que conforman las particiones del clúster y el set de réplicas del servidor de configuración

Debe usar la base de datos admin para ejecutar getShardMap.

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

db.runCommand("getShardMap")

Aquí tienes un ejemplo de la salida que devuelve el comando:

{ map: { shard01: 'shard01/localhost:27018,localhost:27019,localhost:27020', shard02: 'shard02/localhost:27021,localhost:27022,localhost:27023', shard03: 'shard03/localhost:27024,localhost:27025,localhost:27026', config: 'configRepl/localhost:27027' }, hosts: { 'localhost:27026': 'shard03', 'localhost:27020': 'shard01', 'localhost:27021': 'shard02', 'localhost:27024': 'shard03', 'localhost:27022': 'shard02', 'localhost:27018': 'shard01', 'localhost:27025': 'shard03', 'localhost:27019': 'shard01', 'localhost:27023': 'shard02', 'localhost:27027': 'config' }, connStrings: { 'shard01/localhost:27018,localhost:27019,localhost:27020': 'shard01', 'shard02/localhost:27021,localhost:27022,localhost:27023': 'shard02', 'shard03/localhost:27024,localhost:27025,localhost:27026': 'shard03', 'configRepl/localhost:27027': 'config' }, ok: 1, '$clusterTime': { clusterTime: Timestamp({ t: 1760637565, i: 2 }), signature: { hash: Binary.createFromBase64('AAAAAAAAAAAAAAAAAAAAAAAAAAA=', 0), keyId: Long('0') } }, operationTime: Timestamp({ t: 1760637565, i: 2 })}

El comando devuelve los siguientes campos:

Campo
Descripción

"map"

Lista de particiones en el clúster, el servidor de configuración del clúster y el nombre de host y puerto de cada nodo en el clúster.

"hosts"

Lista de nombres de host y puertos de los nodos del clúster y de las particiones o servidores de configuración a los que se asignan.

"connStrings"

Lista de cadenas de conexión para los nodos agrupados según la partición o el servidor de configuración al que pertenece el nodo.

Para obtener más comandos de particionado, consulta Comandos de particionado.