mongo
Referência rápida do shell
Nesta página
Aviso
O documento a seguir pertence ao shell mongo
, incluído no Download do MongoDB Server. Para obter informações sobre o novo MongoDB Shell (mongosh
), consulte a documentação do mongosh.
Para entender as diferenças entre as duas conchas, consulte Comparação da shell mongo
e mongosh
.
mongo
histórico de comandos shell
Você pode recuperar comandos anteriores emitidos na shell mongo
com as teclas de seta para cima e para baixo. O histórico de comandos é armazenado no arquivo ~/.dbshell
. Consulte .dbshell para mais informações.
Opções de linha de comando
O shell mongo
pode ser iniciado com diversas opções. Consulte a página de shell do mongo para obter detalhes sobre todas as opções disponíveis.
A tabela a seguir exibe algumas opções comuns para mongo
:
Opção | Descrição |
---|---|
Mostrar opções de linha de comando | |
Inicie o shell Para se conectar mais tarde, consulte Abrir novas conexões. | |
Usado em conjunto com um arquivo JavaScript (ou seja, <file.js>) para continuar no shell Consulte o arquivo JavaScript para obter um exemplo. |
Auxiliares de comando
O shell mongo
fornece várias ajudas. A tabela a seguir exibe alguns métodos e comandos de ajuda comuns:
Métodos e comandos de ajuda | Descrição |
---|---|
help | Mostrar ajuda. |
Mostra ajuda para métodos de banco de dados. | |
Mostrar ajuda sobre métodos de coleção. O <collection> pode ser o nome de uma coleção existente ou de uma coleção não existente. | |
show dbs | Imprima uma lista de todos os bancos de dados no servidor. A operação corresponde ao comando |
use <db> | Mudar banco de dados atual para <db> . A variável de shell mongo db está definida para o banco de dados atual. |
show collections | Imprima uma lista de todas as coleções do banco de dados atual. |
show users | Imprima uma lista de usuários para o banco de dados atual. |
show roles | Imprima uma lista de todos os papéis, definidos pelo usuário e embutidos, para o banco de dados atual. |
show profile | Imprima as cinco operações mais recentes que levaram 1 milissegundos ou mais. Consulte a documentação sobre o analisador de banco de dados para obter mais informações. |
show databases | Imprima uma lista de todos os bancos de dados disponíveis. A operação corresponde ao comando |
load() | Execute um arquivo JavaScript. Consulte Escrever scripts para o shell mongo para obter mais informações. |
Operações básicas de shell JavaScript
O shell mongo
fornece uma API JavaScript para operações de banco de dados.
Na shell mongo
, db
é a variável que faz referência ao banco de dados atual. A variável é definida automaticamente para o banco de dados padrão test
ou é definida quando você usa o use <db>
para alternar o banco de dados atual.
A tabela a seguir exibe algumas operações JavaScript comuns:
Operações do Banco de Dados JavaScript | Descrição | ||
---|---|---|---|
Se estiver executando no modo seguro, autentique o usuário. | |||
coll = db.<collection> | Defina uma coleção específica no banco de dados atual para uma variável
Você pode executar operações no
| ||
Localiza todos os documentos na coleção e retorna um cursor. Consulte o Consulte Iterar um cursor no | |||
Insira um novo documento na coleção. | |||
Insira vários novos documentos na coleção. | |||
Atualizar um único documento existente na coleção. | |||
Atualize vários documentos existentes na coleção. | |||
Exclua um único documento da collection. | |||
Exclua documentos da collection. | |||
Descarta ou remove completamente a coleção. | |||
Criar um novo índice na collection se o índice não existir; caso contrário, a operação não terá efeito. | |||
Retorne uma referência a outro banco de dados usando essa mesma conexão sem alternar explicitamente o banco de dados atual. Isso permite queries entre bancos de dados. |
Para obter mais informações sobre como executar operações na shell, consulte:
Atalhos de teclado
O shell mongo
fornece a maioria dos atalhos de teclado semelhantes aos encontrados no shell bash
ou no Emacs. Para algumas funções, o mongo
fornece múltiplas vinculações de chave, para acomodar vários paradigmas conhecidos.
A tabela a seguir enumera as teclas suportadas pelo shell mongo
:
Toque de tecla | Função |
---|---|
Seta para cima | história anterior |
Seta para baixo | Next-history |
Início | início de linha |
End | end-of-line |
Tab | autocompletar |
Seta para a esquerda | caractere inverso |
Seta para a direita | caractere direto |
ctrl-seta para a esquerda | palavra de trás para frente |
ctrl-seta para a direita | palavra avançada |
Seta para a esquerda | palavra de trás para frente |
Seta para a direita | palavra avançada |
ctrl-A | início de linha |
ctrl-B | caracteres inversos |
ctrl-C | saída-shell |
ctrl-D | delete-char (ou sair do shell) |
ctrl-E | end-of-line |
ctrl-F | forward-char |
ctrl-G | abortar |
ctrl-J | accept-line |
ctrl-K | kill-line |
ctrl-L | tela limpa |
ctrl-M | accept-line |
ctrl-N | Next-history |
ctrl-P | história anterior |
ctrl-R | verse-search-history |
ctrl-S | forward-search-history |
ctrl-T | transpose-chars |
ctrl-U | unix-line-discard |
ctrl-W | unix-word-rubout |
Ctrl-Y | puxar |
ctrl-Z | Suspender (o controle de tarefas funciona no Linux) |
ctrl-H (ou seja, Backspace) | back-delete-char |
ctrl-I (ou seja, Tab) | completo |
Meta-B | palavra de trás para frente |
Meta-C | palavras maiúsculas |
Meta-D | palavra final |
Meta-F | palavra avançada |
Meta-L | downcase-word |
Meta-U | upcase-word |
Meta-Y | ianque-pop |
Meta-[Backspace] | back-kill-word |
Meta-< | início da história |
Meta-> | fim da história |
Consultas
No shell mongo
, execute operações de leitura usando os métodos find()
e findOne()
.
O método find()
retorna um objeto do cursor que o shell mongo
itera para imprimir documentos na tela. Por padrão, mongo
imprime o primeiro 20. O shell mongo
solicitará ao usuário "Type it
" para continuar iterando os próximos resultados 20 .
A tabela a seguir fornece algumas operações de leitura comuns no shell mongo
:
Ler operações | Descrição | ||
---|---|---|---|
Encontre os documentos que correspondam aos critérios O exemplo a seguir seleciona os documentos na collection
Para obter mais informações sobre como especificar os critérios | |||
Encontre documentos que correspondam aos critérios O exemplo a seguir seleciona todos os documentos da collection, mas retorna apenas o campo
Para obter mais informações sobre como especificar o | |||
Retornar resultados no O exemplo a seguir seleciona todos os documentos da collection e retorna os resultados classificados pelo campo
| |||
Retornar os documentos que correspondem aos critérios <query> no <sort order> especificado. | |||
Limite o resultado a <n> linhas. Altamente recomendado se você precisar de apenas um determinado número de linhas para obter o melhor desempenho. | |||
Ignorar <n> resultados. | |||
Retorna o número total de documentos na coleção. | |||
Consulte a documentação de documentos de query para obter mais informações e exemplos. Consulte Operadores de Query e Projeção para especificar outros operadores de query.
Métodos de verificação de erros
O método de escrita de shell mongo
integra a Write Concern diretamente na execução do método e retorna um objeto WriteResult()
que contém os resultados da operação, incluindo quaisquer erros de escrita e erros de write concern.
Auxiliares de comandos administrativos
A tabela a seguir lista alguns métodos comuns para dar suporte à administração do banco de dados:
Métodos de administração de banco de dados JavaScript | Descrição |
---|---|
Obtenha a lista de todas as collections no banco de dados atual. | |
Descarta o banco de dados atual. |
Consulte também métodos administrativos do banco de dados para obter uma lista completa dos métodos.
Abrindo conexões adicionais
Você pode criar novas conexões dentro do shell mongo
.
A tabela a seguir exibe os métodos para criar as conexões:
Métodos de criação de conexão JavaScript | Descrição | ||
---|---|---|---|
| Abra uma nova conexão do banco de dados. | ||
| Abra uma conexão com um novo servidor usando Utilize o método |
Consulte também Abrir novas conexões para obter mais informações sobre a abertura de novas conexões a partir do shell mongo
.
Diversos
A tabela a seguir exibe alguns métodos diversos:
Método | Descrição |
---|---|
Object.bsonsize(<document>) | Imprime o tamanho BSON de um <document> em bytes |
Recursos adicionais
Considere o seguinte material de referência que aborda o shell mongo
e sua interface:
Além disso, o repositório de código fonte do MongoDB inclui um diretório jstests que contém vários scripts de shell mongo
.