Menu Docs
Página inicial do Docs
/
MongoDB Shell

mongosh Ajuda

Nesta página

  • Ajuda da linha de comando
  • mongosh Ajuda da Shell
  • Ajuda do Banco de Dados
  • Ajuda de coleção
  • Ajuda do cursor
  • Ajuda da classe BSON
  • Auxiliares de comando

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.

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

Para ver a lista de comandos disponíveis no console do mongosh, digite help dentro de um console mongosh em execução:

help

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

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.

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.
...

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

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
}

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.

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érie temporal ou uma visualização somente leitura.

managementFeedback [view]
survey
weather [time-series]
system.buckets.weather
system.views

No exemplo anterior:

  • managementFeedback é uma visualização

  • weather é uma série temporal

  • survey é uma coleção

  • system.buckets.weather é uma coleção gerada pelo sistema que suporta a série temporal weather

  • system.views é uma coleção gerada pelo sistema que suporta visualizações em outras coleções

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.
...

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

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
}

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.

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

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.

Observação

show dbs é sinônimo de show databases.

show log <name>

Exibe o último segmento da memória de login para o nome do registrador especificado. Se você não especificar um <name>, o comando padrão será global.

Para mostrar registros do startupWarning, execute:

show log startupWarnings
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.
← Notas de versão