getShardMap
Nesta página
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 é 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
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,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. |
Saiba mais
Para mais comandos de fragmentação, consulte Comandos de fragmentação.