mongosh
Métodos
Nesta página
Observação
JavaScript no MongoDB
Embora estes métodos utilizem JavaScript, a maioria das interações com MongoDB não utilizam JavaScript, mas utilizam um driver automático na linguagem da aplicação 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.
collection
Nome | Descrição |
---|---|
Fornece acesso ao pipeline de agregação. | |
Fornece funcionalidade de operação para gravação em massa. | |
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 a divisão automática do cluster fragmentado. | |
Habilita a divisão automática para o cluster fragmentado. | |
Habilita o compartilhamento em um banco de dados específico. | |
Retorna um valor booleano indicando se o balanceador está ativo no momento. | |
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 booleano para relatar se o processo do balanceador está migrando partes no momento. | |
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 balanceador e aguarda o início do balanceamento. | |
Relatórios sobre o status de um agrupamento compartilhado, como db.printShardingStatus() . | |
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 |
---|---|
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 ObjectId. | |
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. |
Nativo
Nome | Descrição |
---|---|
Retorna o conteúdo do arquivo especificado. | |
Altera o diretório de trabalho atual para o caminho especificado. | |
Copia um dbPath local . Para uso interno. | |
Retorna o nome do host do sistema que executa o mongosh . | |
Retorna um documento que relata a quantidade de memória usada pelo shell. | |
Retorna o nome do host do sistema que executa o shell. | |
Retorna um boolean que indica se o mongosh está sendo executado no modo interativo ou no modo de script. | |
Retorna uma array de documentos que fornecem o nome e o tamanho de cada objeto no diretório. | |
Carrega e executa um arquivo JavaScript na shell. | |
Retorna uma lista dos arquivos no diretório atual. | |
O hash md5 do arquivo especificado. | |
Cria um diretório no caminho especificado. | |
Retorna o diretório atual. | |
Sai da sessão de shell atual. | |
Remove o arquivo especificado do sistema de arquivos local. | |
Remove um dbPath local . Para uso interno. | |
Suspende mongosh por um determinado período de tempo. | |
Configura o mongosh para relatar o tempo de operação. | |
Retorna a versão atual da instância mongosh . | |
Retorna true se o shell for executado em um sistema Windows; false se for um sistema Unix ou Linux. | |
Retorna um número aleatório entre 0 e 1 . |
Criptografia no nível de campo do cliente
Observação
Os métodos de criptografia de nível de campo do lado do cliente mongo
exigem uma conexão de reconhecimento de data center com a criptografia de nível de campo do lado do cliente habilitada. Se o reconhecimento de data center atual não foi iniciado com a criptografia de nível de campo do lado do cliente habilitada:
Use o construtor
Mongo()
do shellmongo
para estabelecer uma conexão com as opções de criptografia de nível de campo do lado do cliente necessárias. O métodoMongo()
suporta os seguintes fornecedores de serviço de gerenciamento de chaves (KMS) para gerenciamento da chave mestra do cliente (CMK):ou
Use as opções da linha
mongo
de comando do shell para estabelecer uma conexão com as opções exigidas. As opções de linha de comando são compatíveis apenas com o fornecedor KMS do Amazon Web Services para gerenciamento da chave mestra do cliente.
Nome | Descrição |
---|---|
Retorna o objeto cofre de chaves da conexão do MongoDB atual. | |
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 o diretório de dados especificado do cofre de chaves. | |
Recupera todas as chaves no cofre de chaves. | |
Associa um nome alternativo de chave ao diretório de dados especificado. | |
Remove um nome alternativo de chave do diretório de dados especificado. | |
Recupera chaves com o nome alternativo de chave especificado. | |
Retorna o objeto de criptografia do cliente para oferecer suporte à criptografia/descriptografia explícita de campos. | |
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. |