mongosh
Métodos
Nesta página
Observação
JavaScript no MongoDB
Embora esses métodos usem JavaScript, a maioria das interações com o MongoDB não usa JavaScript, mas usa umdriver idiomático na linguagem do aplicativo de interação.
Observação
Para obter detalhes sobre um método específico, incluindo sintaxe e exemplos, clique no link para a página de referência do método.
Métodos de índice de pesquisa do Atlas Search
Os índices do Atlas Search permitem consultar dados no Atlas Search. Os índices do Atlas Search permitem pesquisa de consulta de texto de alto desempenho, mapeando termos de pesquisa para os documentos que contêm esses termos.
Use os métodos a seguir para gerenciar índices do Atlas Search.
Importante
Os métodos a seguir só podem ser executados em implantações hospedadas no MongoDB Atlas e exigem uma camada do cluster do Atlas de pelo menos M10.
Nome | Descrição |
---|---|
Criar um índice Atlas Search numa colecção especificada. | |
Exclui um índice de Pesquisa do Atlas existente. | |
Retorna informações sobre Atlas Search indexes em uma coleção especificada. | |
Atualiza um índice existente do Atlas Search. |
Métodos de processamento de fluxo do Atlas
O Atlas Stream Processing permite executar operações de agregação em fluxos de dados contínuos usando o mesmo modelo de dados Realm e API de query que você usa com dados em repouso.
Use os métodos a seguir para gerenciar os processadores de fluxo:
Importante
Os métodos seguintes só podem ser executados em implantações hospedadas no MongoDB Atlas.
Nome | Descrição |
---|---|
Cria um processador de fluxo. | |
Lista todas as conexões existentes no registro de conexões da instância atual de processamento de fluxos. | |
Lista todos os processadores de fluxo existentes na instância de processamento de fluxo atual. | |
Cria um processador de fluxo efêmero. | |
Exclui um processador de fluxo existente. | |
Retorna uma array de resultados amostrados de um processador de fluxo atualmente em execução. | |
Inicia um processador de fluxo existente. | |
Retorna estatísticas resumindo um processador de fluxo existente. | |
Interrompe um processador de fluxo atualmente em execução. |
collection
Nome | Descrição |
---|---|
Calcula métricas para avaliar uma chave de fragmento. | |
Fornece acesso ao pipeline de agregação. | |
Fornece funcionalidade de operação para gravação em massa. | |
Envolve compactStructuredEncryptionData para retornar um objeto que indica sucesso ou erro. | |
Configura a amostragem de consulta para uma coleção. | |
Envolve count para retornar uma contagem do número de documentos em uma coleção ou uma visualização. | |
Constrói um índice em uma coleção. | |
Constrói um ou mais índices em uma coleção. | |
Retorna o tamanho da coleção. Envolve o campo size na saída de collStats . | |
Exclui um único documento em uma coleção. | |
Exclui vários documentos em uma coleção. | |
Gera uma array de documentos com valores distintos para o campo especificado. | |
Remove a coleção especificada do banco de dados. | |
Remove um índice especificado em uma coleção. | |
Remove todos os índices de uma coleção. | |
Removido. Use db.collection.createIndex() . | |
Envolve count para retornar uma contagem aproximada de documentos em uma coleção ou uma visualização. | |
Retorna informações sobre a execução de consultas de vários métodos. | |
Executa uma consulta em uma coleção ou uma visualização e retorna um objeto do cursor. | |
Modifica atomicamente e retorna um único documento. | |
Executa uma consulta e retorna um único documento. | |
Localiza um único documento e o exclui. | |
Localiza um único documento e o substitui. | |
Localiza um único documento e o atualiza. | |
Retorna uma array de documentos que descrevem os índices existentes em uma coleção. | |
Para coleções em clusters fragmentados, db.collection.getShardDistribution() informa dados de distribuição de partes. | |
Método de diagnóstico interno para cluster fragmentado. | |
Oculta um índice do planejador de consulta. | |
Insere um novo documento em uma coleção. | |
Insere vários novos documentos em uma coleção. | |
Informa se uma coleção é uma coleção limitada. | |
Retorna estatísticas de latência para uma coleção. | |
Executa agregação de dados no estilo map-reduce. | |
Reconstrói todos os índices existentes em uma coleção. | |
Exclui documentos de uma coleção. | |
Altera o nome de uma coleção. | |
Substitui um único documento em uma coleção. | |
Informa sobre o estado de uma coleção. Fornece um wrapper em torno do collStats . | |
Informa o tamanho total usado pela coleção em bytes. Fornece um wrapper ao redor do campo storageSize da saída collStats . | |
Relata o tamanho total usado pelos índices em uma coleção. Fornece um wrapper ao redor do campo totalIndexSize da saída collStats . | |
Indica o tamanho total de uma coleção, abrangendo todos os documentos e índices associados. | |
Exibe um índice do planejador de consultas. | |
Modifica um único documento em uma coleção. | |
Modifica vários documentos em uma coleção. | |
Estabelece um fluxo de mudança em uma coleção. | |
Executa operações de diagnóstico em uma coleção. |
Cursor
Nome | Descrição |
---|---|
Adiciona sinalizadores específicos do protocolo de conexão que modificam o comportamento da consulta. | |
Permite que o MongoDB use arquivos temporários no disco para armazenar dados
que excedam o limite de memória do sistema de 100 megabytes durante o processamento
de uma operação de classificação por bloqueio. | |
Permite que operações db.collection.find() em uma coleção fragmentada retornem resultados parciais, em vez de um erro, se um ou mais fragmentos consultados não estiverem disponíveis. | |
Controla o número de documentos que o MongoDB retornará ao cliente em uma única mensagem de rede. | |
Feche um cursor e libere os recursos do servidor associado. | |
Retorna true se o cursor estiver fechado. | |
Especifica o agrupamento do cursor retornado por db.collection.find() . | |
Adicione um comentário à consulta para permitir o rastreamento nos registros e na coleção system.profile. | |
Modifica o cursor para retornar o número de documentos no conjunto de resultados, em vez de retornar os documentos em si. | |
Informa sobre o plano de execução da consulta para um cursor. | |
Aplica uma função JavaScript para cada documento em um cursor. | |
Retorna "verdadeiro" se o cursor tiver documentos e eles puderem ser iterados. | |
Força o MongoDB a usar um índice específico para uma consulta. | |
Retorna true se o cursor estiver fechado e não houver objetos restantes no lote. | |
Calcula o total de documentos no cursor através da busca e iteração do conjunto de resultados no lado do cliente. | |
Restringe o tamanho do conjunto de resultados de um cursor. | |
Aplica uma função em cada documento em um cursor e coleta os resultados em uma array. | |
Especifica um limite do índice superior exclusivo para um cursor. Para uso com cursor.hint() | |
Especifica um limite de tempo cumulativo em milissegundos para operações de processamento em um cursor. | |
Especifica um limite do índice inferior inclusivo para um cursor. Para uso com cursor.hint() | |
Retorna o próximo documento em um cursor. | |
Instrui o servidor para evitar fechar um cursor automaticamente após um período de inatividade. | |
Retorna o número de documentos deixados no lote do cursor atual. | |
Configura o cursor para exibir os resultados em um formato de leitura fácil.
| |
Especifica uma referência de leitura para uma operação find() . | |
Especifica uma preferência de leitura para um cursor para controlar como o cliente direciona as consultas para um conjunto de réplicas. | |
Modifica o cursor para retornar as chaves de índice em vez dos documentos. | |
Adiciona um campo de ID do mecanismo de armazenamento interno a cada documento retornado pelo cursor. | |
Retorna um cursor que só começa a retornar resultados após pular ou ignorar vários documentos. | |
Retorna os resultados seguindo uma ordem específica de classificação. | |
Marca o cursor como rastreável. Válido somente para cursores acima de
coleções limitadas. | |
Retorna uma array com todos os documentos obtidos pelo cursor. |
Database
Nome | Descrição |
---|---|
Executa um comando no banco de dados do admin . | |
Executa o pipeline admin/diagnóstico que não requer uma collection subjacente. | |
Retorna informações de ajuda para um comando de banco de dados. | |
Cria uma nova collection ou uma visualização. Normalmente usado para criar uma capped collection. | |
Cria uma visualização. | |
Informa as operações atuais em andamento. | |
Remove o banco de dados atual. | |
Libera as gravações em disco e bloqueia o banco de dados para evitar operações de gravação e auxiliar nas operações de backup. Envolve fsync . | |
Permite que gravações continuem em um banco de dados bloqueado com db.fsyncLock() . | |
Retorna uma coleção ou objeto de visualização. Usado para acessar coleções com nomes inválidos em mongosh . | |
Retorna informações de collection para todas as collections e visualizações no banco de dados atual. | |
Lista todas as collections e visualizações no banco de dados atual. | |
Retorna os níveis de verbosidade da mensagem de registro. | |
Retorna o objeto de conexão Mongo() para a conexão atual. | |
Retorna o nome do banco de dados atual. | |
Retorna um documento que reflete o nível de perfilamento atual e o seu limite. | |
Retorna um documento com estatísticas de replicação. | |
Fornece acesso ao banco de dados especificado. | |
Retorna um documento que relata o estado do conjunto de réplicas. | |
Exibe descrições de métodos de objeto db comuns. | |
Retorna um documento com informações sobre o sistema em que MongoDB é executado. Envolve hostInfo | |
Termina uma operação especificada. | |
Exibe uma lista de comandos comuns de banco de dados. | |
Obsoleto. Termina uma sessão autenticada. | |
Imprime estatísticas de cada collection. Envolve db.collection.stats() . | |
Imprime um relatório do status do conjunto de réplicas sob a perspectiva do primário. | |
Imprime o status do conjunto de réplicas sob a perspectiva dos secundários. | |
Imprime um relatório da configuração de fragmentação e as faixas de chunks. | |
Removido no MongoDB 5.0. Redefine o último status de erro. | |
Executa rotação de certificado TLS online. Envoltórios rotateCertificates . | |
Executa um comando do banco de dados. | |
Retorna um documento que exibe os parâmetros de compilação para a instância do mongod . Wraps buildInfo . | |
Retorna um documento com informações sobre o tempo de execução usado para iniciar a instância MongoDB. Envolve getCmdLineOpts . | |
Retorna um documento que fornece uma visão geral do estado do processo do banco de dados. | |
Define um único nível de verbosidade de mensagem de registro. | |
Modifica o nível atual do perfil do banco de dados. | |
Retorna um documento que informa o estado do banco de dados atual. | |
Retorna a versão da instância mongod . | |
Abre um cursor de change stream para que um banco de dados informe todas as suas collections fora do sistema system . Não pode ser aberto nos bancos de dados admin , local ou config . |
Cache do plano de consulta
Nome | Descrição |
---|---|
Retorna uma interface para acessar o objeto de cache do plano de consulta e os métodos associados do PlanCache para uma coleção. | |
Limpa todo o cache dos planos de consulta para uma coleção. Acessível por meio do objeto de cache do plano de uma coleção específica, ou seja, db.collection.getPlanCache().clear() . | |
Limpa os planos de consulta em cache para a forma de consulta especificada. Acessível por meio do objeto de cache do plano de uma coleção específica, ou seja, db.collection.getPlanCache().clearPlansByQuery() | |
Exibe os métodos disponíveis para o cache do plano de consulta de uma coleção. Acessível por meio do objeto de cache do plano de uma coleção específica, ou seja, db.collection.getPlanCache().help() . | |
Retorne as informações do cache de planos para uma coleção específica. Acessível por meio do objeto de cache do plano de uma coleção específica, ou seja, db.collection.getPlanCache().list() . |
Operação de gravação em massa
Nome | Descrição |
---|---|
Inicializa um construtor de operações Bulk() para uma lista ordenada de operações. | |
Inicializa um construtor de operações Bulk() para uma lista não ordenada de operações. | |
Construtor de operações em massa. | |
Executa uma série de operações em massa. | |
Especifica a condição de consulta para uma atualização ou uma operação de remoção. | |
Define os filtros para selecionar os elementos da array que serão atualizados em uma operação update ou updateOne . | |
Define o agrupamento para a condição de consulta. | |
Adiciona uma operação de exclusão de vários documentos a uma lista de operações. | |
Adiciona uma única operação de exclusão de documento a uma lista de operações. | |
Especifica o índice a ser usado para a operação de atualização/substituição. | |
Um alias para Bulk.find.delete() . | |
Um alias para Bulk.find.deleteOne() . | |
Adiciona uma operação de substituição de documento único a uma lista de operações. | |
Adiciona uma única operação de atualização de documento a uma lista de operações. | |
Adiciona uma operação de atualização multi a uma lista de operações. | |
Especifica upsert: true para uma operação de atualização. | |
Retorna uma array de operações de gravação executadas no objeto de operações Bulk() . | |
Adiciona uma operação de inserção a uma lista de operações. | |
Retorna um documento JSON que contém o número de operações e lotes no objeto de operações Bulk() . | |
Retorna os resultados de Bulk.toJSON() como uma string. |
Gerenciamento de usuários
Nome | Descrição |
---|---|
Autentica um usuário para um banco de dados. | |
Altera a senha de um usuário existente. | |
Cria um novo usuário. | |
Remove um único usuário. | |
Exclui todos os usuários associados a um banco de dados. | |
Retorna informações sobre o usuário especificado. | |
Retorna informações sobre todos os usuários associados a um banco de dados. | |
Concede uma função e seus privilégios para um usuário. | |
Preterido. Remove um usuário de um banco de dados. | |
Remove uma função de um usuário. | |
Atualiza os dados do usuário. | |
Solicita a senha como uma alternativa para definir senhas diretamente em vários métodos mongosh de autenticação/gerenciamento de usuários. |
Gerenciamento de funções
Nome | Descrição |
---|---|
Cria uma função e especifica seus privilégios. | |
Exclui uma função definida pelo usuário. | |
Exclui todas as funções definidas pelo usuário associados a um banco de dados. | |
Retorna informações para a função especificada. | |
Retorna informações para todas as funções definidas pelo usuário em um banco de dados. | |
Atribui privilégios a uma função definida pelo usuário. | |
Remove os privilégios especificados de uma função definida pelo usuário. | |
Especifica funções a partir dos quais uma função definida pelo usuário herda privilégios. | |
Remove as funções herdadas de uma função. | |
Atualiza uma função definida pelo usuário. |
Replicação
Nome | Descrição |
---|---|
Adiciona um membro a um conjunto de réplicas. | |
Adiciona um árbitro a um conjunto de réplicas. | |
Retorna o documento de configuração do conjunto de réplicas. | |
Impede que o membro atual busque a eleição como primário por um período de tempo. | |
Retorna textos básicos de ajuda para funções do conjunto de réplicas. | |
Inicia um novo conjunto de réplicas. | |
Imprime um relatório formatado do status do conjunto de réplicas da perspectiva do primary. | |
Imprime um relatório formatado do status do conjunto de réplicas da perspectiva dos secundários. | |
Reconfigura um conjunto de réplicas aplicando um novo objeto de configuração do conjunto de réplicas. | |
Remove um nó de um conjunto de réplicas. | |
Retorna um documento com informações sobre o estado do conjunto de réplicas. | |
Define o nó específico com o qual este nó do conjunto de réplicas se sincronizará, substituindo a lógica de escolha de destino de sincronização padrão. |
Fragmentação
Nome | Descrição |
---|---|
Aborta uma operação de refragmentação Novidades na versão 5.0. | |
Adiciona um fragmento a um cluster fragmentado. | |
Este método faz aliases para sh.addShardToZone() . | |
Associa um fragmento a uma zona. Oferece suporte à configuração de zonas em clusters fragmentados. | |
Este método faz aliases para sh.updateZoneKeyRange() . | |
Retorna informações sobre se as partes de uma coleção fragmentada estiverem balanceadas. | |
Força uma operação de refragmentação para bloquear gravações e concluir. Novidades na versão 5.0. | |
Desativa o balanceamento em uma única coleção em um banco de dados fragmentado. Não afeta o balanceamento de outras coleções em um cluster fragmentado. | |
Ativa o processo de balanceamento de coleções fragmentadas se ele foi desativado anteriormente usando sh.disableBalancing() . | |
Desabilita mesclagens automáticas de partes para um namespace. Novidades na versão 7.0. | |
Desabilita a divisão automática do cluster fragmentado. A partir do MongoDB 6.0.3, a divisão automática de partes não é executada. Isso se deve a melhorias na política de balanceamento. Os comandos de divisão automática ainda existem, mas não executam uma operação. | |
Habilita mesclagens automáticas de partes para um namespace. Novidades na versão 7.0. | |
Habilita a divisão automática para o cluster fragmentado. A partir do MongoDB 6.0.3, a divisão automática de partes não é executada. Isso se deve a melhorias na política de balanceamento. Os comandos de divisão automática ainda existem, mas não executam uma operação. | |
Cria um banco de dados. | |
Retorna um valor booleano indicando se o balanceador está ativo no momento. | |
Retorna informações de distribuição de dados sobre coleções fragmentadas. | |
Este método faz aliases para sh.removeRangeFromZone() . | |
Remove uma associação entre uma faixa de chaves de fragmento e uma zona. Oferece suporte à configuração de zonas em clusters fragmentados. | |
Retorna o texto de ajuda para os métodos sh . | |
Retorna um documento descrevendo o status do balanceador. | |
Migra uma parte em um cluster fragmentado. | |
Este método é um alias para sh.removeShardFromZone() . | |
Remove a associação entre um fragmento e uma zona. Use para gerenciar a fragmentação de zonas. | |
Inicia uma operação de refragmentação para alterar a chave de fragmento de uma coleção, mudando a distribuição de seus dados. Novidades na versão 5.0. | |
Ativa a fragmentação de uma coleção. | |
Divide uma parte existente em duas partes usando um valor específico da chave de fragmento como ponto de divisão. | |
Divide uma parte existente que contém um documento correspondente a uma consulta em duas partes aproximadamente iguais. | |
Habilita o AutoMerger. Novidades na versão 7.0. | |
Habilita o balanceador e aguarda o início do balanceamento. | |
Relatórios sobre o status de um agrupamento compartilhado, como db.printShardingStatus() . | |
Desabilita o AutoMerger. Novidades na versão 7.0. | |
Desabilita o balanceador e aguarda a conclusão de qualquer balanceamento em andamento. | |
Interno. Aguarde até que o estado do balanceador mude. | |
Interno. Aguarde até que o balanceador pare de funcionar. | |
Interno. Aguarda uma mudança no estado de ping de um dos mongos no cluster fragmentado. | |
Associa uma faixa de chaves de fragmento a uma zona. Oferece suporte à configuração de zonas em clusters fragmentados. | |
Retorna o valor hasheado para a entrada. |
Construtores
Nome | Descrição |
---|---|
Cria um objeto binário a partir de um valor base64. | |
Cria um objeto binário a partir de um valor hexadecimal. | |
Retorna um objeto de dados binários. | |
Adiciona um wrapper ao redor do conjunto de resultados de Bulk.execute() . | |
Cria um objeto de data. Por padrão, cria um objeto de data, incluindo a data atual. | |
Retorna um objeto de dados binários. | |
Retorna um ObjectId. | |
Cria um ObjectId a partir de um valor base64. | |
Cria um ObjectId a partir de um valor hexadecimal. | |
Retorna a parte do registro de data/hora de um ObjectId. | |
Exibe a representação de string de um ObjectId. | |
Converte uma string hexadecimal de 32 bytes no subtipo UUID BSON. | |
Adiciona um wrapper ao redor do conjunto de resultados dos métodos de gravação. |
Conexão
Nome | Descrição |
---|---|
Conecta-se a uma instância do MongoDB e ao banco de dados específico nesta instância. | |
Cria um novo objeto de conexão. | |
Retorna um objeto do banco de dados. | |
Retorna o modo de preferência de leitura atual para a conexão do MongoDB. | |
Retorna o conjunto de tags da preferência de leitura para a conexão do MongoDB. | |
Habilita ou desabilita a consistência causal no objeto de conexão. | |
Define a preferência de leitura para a conexão do MongoDB. | |
Inicia uma sessão no objeto de conexão. | |
Abre um cursor do fluxo de alterações para que uma implantação informe todas as suas coleções não system em todos os seus bancos de dados, exceto a admin interna, local , e os bancos de dados config . | |
O objeto da sessão. | |
O objeto de opções da sessão. |
Criptografia no nível de campo do cliente
Observação
Os métodos de criptografia de nível de campo do lado do cliente mongosh
exigem uma conexão de banco de dados com a criptografia de nível de campo do lado do cliente ativada. Se a conexão atual do banco de dados não tiver sido iniciada com a criptografia em nível de campo do lado do cliente ativada, faça o seguinte:
Use o construtor
Mongo()
domongosh
para estabelecer uma conexão com as opções necessárias de criptografia de nível de campo no lado do cliente. O métodoMongo()
é compatível com os seguintes provedores de serviço de gerenciamento de chaves (KMS) para o gerenciamento da chave mestra do cliente (CMK):ou
Utilize as
mongosh
opções da linha de comando para estabelecer uma conexão com as opções exigidas. As opções de linha de comando são compatíveis apenas com o provedor Amazon Web Services KMS para gerenciamento da chave mestra do cliente.
Nome | Descrição |
---|---|
Retorna o objeto cofre de chaves da conexão do MongoDB atual. | |
Um alias para KeyVault.createKey() . | |
Cria uma chave de criptografia de dados para uso na criptografia no nível do campo no lado do cliente. | |
Exclui a chave de criptografia de dados especificada do cofre de chaves. | |
Recupera a chave de criptografia de dados especificada do cofre de chaves. | |
Recupera todas as chaves no cofre de chaves. | |
Associa um nome alternativo de uma chave à chave de criptografia de dados especificada. | |
Um alias para KeyVault.addKeyAlternateName() . | |
Remove um nome alternativo de uma chave da chave de criptografia de dados especificada. | |
Um alias para KeyVault.removeKeyAlternateName() . | |
Recupera chaves com o nome alternativo de chave especificado. | |
Descriptografa várias chaves de dados e as criptografa novamente. | |
Retorna o objeto de criptografia do cliente para oferecer suporte à criptografia/descriptografia explícita de campos. | |
Cria uma coleção com campos criptografados. | |
Criptografa um campo usando uma chave de criptografia de dados especificada e o algoritmo de criptografia. | |
Descriptografa um campo usando a chave de criptografia de dados associada e o algoritmo de criptografia. |