mongosh
Ajuda
Nesta página
Este documento fornece uma visão geral da ajuda disponível em mongosh
.
Dica
Ao acessar a ajuda no mongosh
, você pode utilizar os sintaxes .help()
e .help
intercambiáveis.
Ajuda da linha de comando
Para visualizar as opções para executar o executável do mongosh
e conectar a uma implantação, utilize a opção --help
a partir da linha de comando:
mongosh --help
mongosh
Ajuda da Shell
Para ver a lista de comandos disponíveis no console do mongosh
, digite help
dentro de um console mongosh
em execução:
help
Ajuda do Banco de Dados
Você pode visualizar informações de nível do banco de dados de dentro do console do mongosh
:
Por padrão, mongosh
mostra o banco de dados atual no prompt. Você também pode visualizar o banco de dados atual executando o comando db
:
db
Mostrar bancos de dados disponíveis
Para visualizar a lista de bancos de dados disponíveis para você no servidor, utilize o comando show dbs
:
show dbs
show databases
é um alias para show dbs
.
Dica
A lista de bancos de dados será alterada dependendo de suas autorizações de acesso. Para mais informações sobre restrições de acesso para ver bancos de dados, consulte listDatabases
.
Mostrar métodos do banco de dados
Para ver a lista de métodos de banco de dados que você pode usar no objeto db
, execute db.help()
:
db.help()
A saída se assemelha à seguinte lista abreviada:
Database Class: getMongo Returns the current database connection getName Returns the name of the DB getCollectionNames Returns an array containing the names of all collections in the current database. getCollectionInfos Returns an array of documents with collection information, i.e. collection name and options, for the current database. runCommand Runs an arbitrary command on the database. adminCommand Runs an arbitrary command against the admin database. ...
Mostrar ajuda para um método específico de banco de dados
Para ver a ajuda para um método de banco de dados específico no mongosh
, digite o db.<method name>
, seguido por .help
ou .help()
. O exemplo a seguir retorna ajuda para o método db.adminCommand()
:
db.adminCommand.help()
A saída se assemelha ao seguinte:
db.adminCommand({ serverStatus: 1 }): Runs an arbitrary command against the admin database. For more information on usage: https://www.mongodb.com/pt-br/docs/manual/reference/method/db.adminCommand
Mostrar detalhes de uso adicionais para um método de banco de dados
Para ver mais informações de uso de um método de banco de dados no mongosh
, digite o db.<method name>
sem os parênteses (()
). O exemplo a seguir retorna detalhes sobre o método db.adminCommand()
:
db.adminCommand
A saída se assemelha ao seguinte:
[Function: adminCommand] AsyncFunction { apiVersions: [ 1, Infinity ], serverVersions: [ '3.4.0', '999.999.999' ], returnsPromise: true, topologies: [ 'ReplSet', 'Sharded', 'LoadBalanced', 'Standalone' ], returnType: { type: 'unknown', attributes: {} }, deprecated: false, platforms: [ 0, 1, 2 ], isDirectShellCommand: false, acceptsRawInput: false, shellCommandCompleter: undefined, help: [Function (anonymous)] Help }
Ajuda de coleção
Você pode visualizar informações de nível de coleção de dentro do console do mongosh
.
Esses métodos de ajuda aceitam um nome de coleção, <collection>
, mas você também pode usar o termo genérico, "coleção" ou até mesmo uma coleção que não existe.
Listar Coleções no Banco de Dados Atual
Para visualizar a lista de coleções no banco de dados atual, utilize o comando show collections
:
show collections
A saída show collections
indica se uma coleção é uma coleção de séries temporais ou uma visualização somente leitura.
managementFeedback [view] survey weather [time-series] system.buckets.weather system.views
No exemplo anterior:
managementFeedback
é uma visualizaçãoweather
é uma série temporalsurvey
é uma coleçãosystem.buckets.weather
é uma coleção gerada pelo sistema que suporta a série temporalweather
system.views
é uma coleção gerada pelo sistema que suporta visualizações em outras coleções
Mostrar métodos de coleção
Para ver a lista de métodos disponíveis em objetos de coleção, utilize o método db.<collection>.help()
:
db.collection.help()
<collection>
pode ser o nome de uma coleção existente ou inexistente.
A saída se assemelha à seguinte lista abreviada:
Collection Class: aggregate Calculates aggregate values for the data in a collection or a view. bulkWrite Performs multiple write operations with controls for order of execution. count Returns the count of documents that would match a find() query for the collection or view. countDocuments Returns the count of documents that match the query for a collection or view. deleteMany Removes all documents that match the filter from a collection. deleteOne Removes a single document from a collection. ...
Mostrar ajuda para um método de coleção específico
Para visualizar ajuda para um método de coleção específico no mongosh
, utilize db.<collection>.<method name>
, seguido por .help
ou .help()
.
O exemplo a seguir mostra a ajuda de db.collection.insertOne()
:
db.collection.insertOne.help()
A saída se assemelha ao seguinte:
db.collection.insertOne(document, options): Inserts a document into a collection. For more information on usage: https://www.mongodb.com/pt-br/docs/manual/reference/method/db.collection.insertOne
Mostrar detalhes adicionais para um método de coleção
Para ver detalhes adicionais de um coleção, digite o nome do método, db.<collection>.<method>
, sem o parêntese (()
).
O exemplo a seguir retorna detalhes sobre o método insertOne()
:
db.collection.insertOne
A saída se assemelha ao seguinte:
[Function: insertOne] AsyncFunction { apiVersions: [ 1, Infinity ], serverVersions: [ '3.2.0', '999.999.999' ], returnsPromise: true, topologies: [ 'ReplSet', 'Sharded', 'LoadBalanced', 'Standalone' ], returnType: { type: 'unknown', attributes: {} }, deprecated: false, platforms: [ 0, 1, 2 ], isDirectShellCommand: false, acceptsRawInput: false, shellCommandCompleter: undefined, help: [Function (anonymous)] Help }
Ajuda do cursor
Para modificar operações de leitura que usam find()
, use métodos de cursor.
Para listar os métodos de manuseio do modificador e cursor disponíveis, utilize o comando db.collection.find().help()
:
db.collection.find().help()
Esta chamada de ajuda aceita um nome de coleção, <collection>
, mas você também pode usar o termo genérico, "coleção", ou até mesmo uma coleção que não existe.
Alguns métodos úteis para lidar com cursores são:
hasNext()
verificar se o cursor tem mais documentos.next()
retornar o próximo documento e move a posição do cursor para frente por um.forEach(<function>)
aplica o<function>
a cada documento retornado pelo cursor.
Para obter uma lista dos métodos de cursor disponíveis, consulte Cursor.
Ajuda da classe BSON
mongosh
fornece métodos de ajuda para classes BSON. Os métodos de ajuda fornecem uma breve visão geral da classe BSON e um link com mais informações.
Para acessar a ajuda para classes BSON, execute o .help()
no nome da classe ou em uma instância instantânea da classe:
<BSON class>.help() // or <BSON class>().help()
Por exemplo, para visualizar a ajuda da classe ObjectId
BSON, execute um dos seguintes comandos:
ObjectId.help()
ObjectId().help()
mongosh
retorna a mesma saída para ambos os métodos .help()
:
The ObjectId BSON Class: For more information on usage: https://mongodb.github.io/node-mongodb-native/3.6/api/ObjectID.html
mongosh
fornece métodos de ajuda para as seguintes classes BSON:
BinData
Code
DBRef
MinKey
MaxKey
NumberDecimal
NumberInt
NumberLong
ObjectId
Symbol
(Obsoleto)Timestamp
Auxiliares de comando
mongosh
fornece os seguintes métodos e comando de banco de dados para envolver determinados comandos do banco de dados e obter informações sobre sua implantação:
Métodos e comandos de ajuda | Descrição | |
---|---|---|
db.help() | Exibir ajuda para métodos de banco de dados. | |
db.<collection>.help() | Exibir 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. | |
help | Exibir ajuda. | |
show collections | Exibe uma lista de todas as coleções do banco de dados atual. | |
show dbs | Exibe uma lista de todos os bancos de dados no servidor.
| |
show log <name> | Exibe o último segmento da memória de login para o nome do registrador especificado. Se você não especificar um Para mostrar registros do
| |
show logs | Exiba os nomes dos criadores de registros acessíveis. Consulte Recuperar registros de shell. | |
show profile | Exiba as cinco operações mais recentes que levaram 1 milissegundos ou mais. Consulte a documentação sobre o analisadores de banco de dados para obter mais informações. | |
show roles | Exibe uma lista de todos os papéis, definidos pelo usuário e incorporados, para o banco de dados atual. | |
show tables | Exibe uma lista de coleções no banco de dados atual. Consulte show
collections . | |
show users | Exibe uma lista de usuários do banco de dados atual. |