Página inicial do Docs

/ /

Fragmentação

Página inicial do Docs

/ /

Comandos de banco de dados

Fragmentação

Página inicial do Docs

Desenvolvimento

Referência

Comandos de banco de dados

Fragmentação

getShardMap (comando de banco de dados)

getShardMap

getShardMap retorna as seguintes informações sobre seu cluster:

Os nomes dos seus shards e do conjunto de réplicas do servidor de configuração
Nomes de host e string de conexão para os nós que compõem os shards do cluster e o conjunto de réplicas do servidor de configuração

Você deve usar o banco de dados admin para executar getShardMap.

Compatibilidade

Esse comando está disponível em implantações hospedadas nos seguintes ambientes:

MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

Importante

Esse comando não é suportado em clusters M0 e Flex. Para obter mais informações, consulte Comandos não suportados.

MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Sintaxe

O comando tem a seguinte sintaxe:

db.runCommand("getShardMap")

documento de saída

Aqui está um exemplo da saída que o comando retorna:

 {
   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 })
}

O comando retorna os seguintes campos:

Campo	Descrição
`"map"`	Lista de fragmentos no cluster, o servidor de configuração do cluster e o nome do host e a porta de cada nó no cluster.
`"hosts"`	Lista de nomes de hosts e portas para os nós do cluster e os shards ou servidor de configuração para os quais eles mapeiam.
`"connStrings"`	Lista de connection strings para os nós agrupados pelo shard ou servidor de configuração ao qual o nó pertence.

Saiba mais

Para mais comandos de fragmentação, consulte Comandos de fragmentação.

Voltar

flushRouterConfig

isdbgrade