db.shutdownServer() (método mongosh)

Alterado na versão 5.0.

db.shutdownServer()

Desliga o processo atualmongodoumongosde forma limpa e segura. Você deve executar a operaçãodb.shutdownServer()no banco de dados admin.

db.shutdownServer() tem esta sintaxe:

db.shutdownServer({
  force: <boolean>,
  timeoutSecs: <int>
})

O método utiliza estes campos:

Campo	Descrição
força	Opcional. Especifique `true` para forçar o encerramento de `mongod` ou `mongos` . O desligamento forçado interrompe quaisquer operações em andamento no `mongod` ou `mongos` e pode resultar em comportamento inesperado. Você pode pausar e retomar as construções de índices em andamento usando.`force` `db.shutdownServer()` Consulte em Membros do conjunto de réplicas para mais informações.
timeoutSecs	Opcional. A partir do MongoDB 5.0, `mongod` e `mongos` entram em um período de desativação para permitir que quaisquer operações de banco de dados em andamento sejam concluídas antes de serem encerradas. Se um `mongod` primário receber uma solicitação de desligamento, o primário: Tentativas de descer para um secundário. Se a redução falhar e a: `shutdown` O `db.shutdownServer()` comando ou foi executado, somente continua`mongod` as etapas de desligamento se o campo de força for verdadeiro ou um `SIGTERM` o sinal foi enviado para `mongod`, `mongod` sempre continua as etapas de desligamento. Entra no período de inatividade. Termina todas as operações restantes do banco de dados. Desliga. Para uma solicitação de desligamento secundária ou `mongosmongod`, o período de desligamento é inserido depois que um desligamento foi solicitado. O período de silêncio é especificado por: campotimeoutSecs se um `shutdown` comando ou foi executado, ou `db.shutdownServer()` parâmetro de servidor `shutdownTimeoutMillisForSignaledShutdown` se um sinal `SIGTERM` foi enviado para `mongod`, ou Parâmetro do servidor do `mongosShutdownTimeoutMillisForSignaledShutdown` se um sinal do `SIGTERM` foi enviado para `mongos`. Os clientes não podem abrir novas conexões com um `mongod` ou `mongos` que está sendo desligado. timeoutSecs especifica um período de tempo em segundos. O padrão é: 15 segundos começando no MongoDB 5.0. 10 segundos nas versões MongoDB anteriores a 5.0. `mongod` utiliza timeoutSecs como segue: Se o nó atual for o nó primário de um conjunto de réplicas, `mongod` aguardará um período de até o número de segundos especificado pelo campo timeoutSecs para que um nó elegível recupere o atraso antes de reduzir o nó primário. Para obter detalhes sobre o tempo de atualização, consulte atraso de replicação. Se o nó atual estiver no estado `SECONDARY` após deixar de ser primário, qualquer tempo restante especificado em timeoutSecs será usado para um período de inatividade, o que permite que as operações existentes sejam concluídas. Novas operações são enviadas para outros nós do conjunto de réplicas. A partir do 5.0 MongoDB, `mongos` usa timeoutSecs como um período de inatividade, que permite a conclusão das operações existentes. Novas operações são enviadas para outros nós . Nas versões do MongoDB `mongos` anteriores 5 0a., é desligado imediatamente e não`mongos` usa timeoutSecs.

Campo

Descrição

força

Opcional. Especifique true para forçar o encerramento de mongod ou mongos . O desligamento forçado interrompe quaisquer operações em andamento no mongod ou mongos e pode resultar em comportamento inesperado.

Você pode pausar e retomar as construções de índices em andamento usando.force db.shutdownServer() Consulte em Membros do conjunto de réplicas para mais informações.

timeoutSecs

Opcional.

A partir do MongoDB 5.0, mongod e mongos entram em um período de desativação para permitir que quaisquer operações de banco de dados em andamento sejam concluídas antes de serem encerradas.

Se um mongod primário receber uma solicitação de desligamento, o primário:

Tentativas de descer para um secundário.

Se a redução falhar e a:
- shutdown O db.shutdownServer() comando ou foi executado, somente continuamongod as etapas de desligamento se o campo de força for verdadeiro ou um
- SIGTERM o sinal foi enviado para mongod, mongod sempre continua as etapas de desligamento.
Entra no período de inatividade.
Termina todas as operações restantes do banco de dados.
Desliga.

Para uma solicitação de desligamento secundária ou mongosmongod, o período de desligamento é inserido depois que um desligamento foi solicitado.

O período de silêncio é especificado por:

campotimeoutSecs se um shutdown comando ou foi executado, ou db.shutdownServer()
parâmetro de servidor shutdownTimeoutMillisForSignaledShutdown se um sinal SIGTERM foi enviado para mongod, ou
Parâmetro do servidor do mongosShutdownTimeoutMillisForSignaledShutdown se um sinal do SIGTERM foi enviado para mongos.

Os clientes não podem abrir novas conexões com um mongod ou mongos que está sendo desligado.

timeoutSecs especifica um período de tempo em segundos. O padrão é:

15 segundos começando no MongoDB 5.0.
10 segundos nas versões MongoDB anteriores a 5.0.

mongod utiliza timeoutSecs como segue:

Se o nó atual for o nó primário de um conjunto de réplicas, mongod aguardará um período de até o número de segundos especificado pelo campo timeoutSecs para que um nó elegível recupere o atraso antes de reduzir o nó primário. Para obter detalhes sobre o tempo de atualização, consulte atraso de replicação.
Se o nó atual estiver no estado SECONDARY após deixar de ser primário, qualquer tempo restante especificado em timeoutSecs será usado para um período de inatividade, o que permite que as operações existentes sejam concluídas. Novas operações são enviadas para outros nós do conjunto de réplicas.

A partir do 5.0 MongoDB, mongos usa timeoutSecs como um período de inatividade, que permite a conclusão das operações existentes. Novas operações são enviadas para outros nós . Nas versões do MongoDB mongos anteriores 5 0a., é desligado imediatamente e nãomongos usa timeoutSecs.

Esta operação fornece um invólucro para o comando shutdown.

Compatibilidade

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

Importante

Este comando não é aceito em clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, 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

Comportamento

Para um mongod iniciado com autenticação em sistemas autogerenciados, você deve executar db.shutdownServer() em uma conexão autenticada.Consulte Controle de acesso para obter mais informações.

Para ummongodiniciado sem autenticação em sistemas autogerenciados, você deve executardb.shutdownServer()de um cliente conectado à interface localhost. Por exemplo, executemongoshcom a opção--host "127.0.0.1"na mesma máquina host que omongod.

`db.shutdownServer()` em Membros do Conjunto de Réplica

db.shutdownServer() falhará se o membro do mongod conjunto de réplicas estiver executando determinadas operações, como compilações de índice. Você pode especificar force: true para salvar o progresso da construção do índice no disco. O recupera a compilação do índice quando é reiniciado e continua a partir do checkpoint salvo.mongod

Desligando o conjunto de réplicas primário, secundário ou `mongos`

A partir do MongoDB 5.0, mongod e mongos entram em um período de desativação para permitir que quaisquer operações de banco de dados em andamento sejam concluídas antes de serem encerradas.

Se um mongod primário receber uma solicitação de desligamento, o primário:

Tentativas de descer para um secundário.

Se a redução falhar e a:
- shutdown O db.shutdownServer() comando ou foi executado, somente continuamongod as etapas de desligamento se o campo de força for verdadeiro ou um
- SIGTERM o sinal foi enviado para mongod, mongod sempre continua as etapas de desligamento.
Entra no período de inatividade.
Termina todas as operações restantes do banco de dados.
Desliga.

Para uma solicitação de desligamento secundária ou mongosmongod, o período de desligamento é inserido depois que um desligamento foi solicitado.

O período de silêncio é especificado por:

campotimeoutSecs se um shutdown comando ou foi executado, ou db.shutdownServer()
parâmetro de servidor shutdownTimeoutMillisForSignaledShutdown se um sinal SIGTERM foi enviado para mongod, ou
Parâmetro do servidor do mongosShutdownTimeoutMillisForSignaledShutdown se um sinal do SIGTERM foi enviado para mongos.

Os clientes não podem abrir novas conexões com um mongod ou mongos que está sendo desligado.

timeoutSecs especifica um período de tempo em segundos. O padrão é:

15 segundos começando no MongoDB 5.0.
10 segundos nas versões MongoDB anteriores a 5.0.

mongod utiliza timeoutSecs como segue:

Se o nó atual for o nó primário de um conjunto de réplicas, mongod aguardará um período de até o número de segundos especificado pelo campo timeoutSecs para que um nó elegível recupere o atraso antes de reduzir o nó primário. Para obter detalhes sobre o tempo de atualização, consulte atraso de replicação.
Se o nó atual estiver no estado SECONDARY após deixar de ser primário, qualquer tempo restante especificado em timeoutSecs será usado para um período de inatividade, o que permite que as operações existentes sejam concluídas. Novas operações são enviadas para outros nós do conjunto de réplicas.

Aviso

O desligamento forçado do primário pode resultar na rollback de quaisquer gravações ainda não replicadas para um secundário.

Controle de acesso

Para executar odb.shutdownServer()em ummongodaplicando a Autenticação em Sistemas Autogerenciados, o usuário autenticado deve ter o privilégio dodb.shutdownServer(). Por exemplo, um usuário com a função integradahostManagertem as permissões apropriadas.

Exemplos

Desligue um `mongod`

db.getSiblingDB("admin").shutdownServer()

Forçar o desligamento de um `mongod`

db.getSiblingDB("admin").shutdownServer({ "force" : true })

Desligue um primário `mongod` com tempo limite maior

db.getSiblingDB("admin").shutdownServer({ "timeoutSecs": 60 })

Voltar

db.setProfilingLevel

db.stats