Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

getShardMap

Nesta página

  • Compatibilidade
  • Sintaxe
  • Saiba mais
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.

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 é aceito em clusters M0, M2 e M5 ou em instâncias sem servidor. 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

O comando tem a seguinte sintaxe:

db.runCommand("getShardMap")

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

{
map: {
shard01: 'shard01/localhost:27018,localhost:27019,localhost:27020,localhost:27021,localhost:27022',
shard02: 'shard02/localhost:27023,localhost:27024,localhost:27025,localhost:27026,localhost:27027',
shard03: 'shard03/localhost:27028,localhost:27029,localhost:27030,localhost:27031,localhost:27032',
config: 'configRepl/localhost:27033',localhost:27034,localhost:27035,localhost:27036,localhost:27037'
},
hosts: {
'localhost:27021': 'shard01',
'localhost:27022': 'shard01',
'localhost:27028': 'shard03',
'localhost:27026': 'shard02',
'localhost:27020': 'shard01',
'localhost:27032': 'shard03',
'localhost:27027': 'shard02',
'localhost:27024': 'shard02',
'localhost:27018': 'shard01',
'localhost:27019': 'shard01',
'localhost:27031': 'shard03',
'localhost:27025': 'shard02',
'localhost:27029': 'shard03',
'localhost:27023': 'shard02',
'localhost:27030': 'shard03',
'localhost:27033': 'config'
'localhost:27036': 'config'
'localhost:27034': 'config'
'localhost:27037': 'config'
'localhost:27035': 'config'
},
connStrings: {
'shard01/localhost:27018,localhost:27019,localhost:27020,localhost:27021,localhost:27022': 'shard01',
'shard01/localhost:27019,localhost:27020,localhost:27021': 'shard01',
'shard01/localhost:27020,localhost:27021': 'shard01',
'shard01/localhost:27021': 'shard01',
'shard02/localhost:27023,localhost:27024,localhost:27025,localhost:27026,localhost:27027': 'shard02',
'shard02/localhost:27025,localhost:27026,localhost:27027': 'shard02',
'shard02/localhost:27025,localhost:27027': 'shard02',
'shard03/localhost:27028,localhost:27029,localhost:27030,localhost:27031,localhost:27032': 'shard03',
'shard03/localhost:27032': 'shard03',
'configRepl/localhost:27033',localhost:27036,localhost:27034,localhost:27037,localhost:27035': 'config'
},
ok: 1
}

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.

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

Voltar

flushRouterConfig