cursor.comment() (método mongosh)

Definição

cursor.comment()

Importante

Método mongosh

Esta página documenta um método mongosh. Esta não é a documentação para um driver específico de idioma, como Node.js.

Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.

Adiciona um campo comment à query.

cursor.comment() tem a seguinte sintaxe:

cursor.comment( <string> )

comment() tem o seguinte parâmetro:

Parâmetro	Tipo	Descrição
comment	string	O comentário a aplicar à query.

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

• MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

• MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

• MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Comportamento

comment() associa uma string de comentário à operação de localização. Isso pode facilitar o rastreamento de uma query específica nas seguintes saídas de diagnóstico:

• O system.profile

• O componente de registro QUERY

• db.currentOp()

Consulte configurar verbosidade de registro para o registro mongod , o tutorial de implantação de banco de dados ou o comando db.currentOp() .

Exemplo

A seguinte operação anexa um comentário a uma query na collection restaurants :

db.restaurants.find(   { "borough" : "Manhattan" }).comment( "Find all Manhattan restaurants" )

Exemplos de saída

{   "op" : "query",   "ns" : "guidebook.restaurant",   "query" : {      "find" : "restaurant",      "filter" : {         "borough" : "Manhattan"      },      "comment" : "Find all Manhattan restaurants"   },   ...}

2015-11-23T13:09:16.202-05:00 I COMMAND  [conn1]   command guidebook.restaurant command: find {      find: "restaurant",      filter: { "borough" : "Manhattan" },      comment: "Find all Manhattan restaurants"   }   ...

db.restaurants.find(   { "borough" : "Manhattan" }).comment("Find all Manhattan restaurants")

{   "inprog" : [      {         "host" : "198.51.100.1:27017",         "desc" : "conn3",         "connectionId" : 3,         ...
         "op" : "query",         "ns" : "test.$cmd",         "command" : {            "find" : "restaurants",            "filter" : {               "borough" : "Manhattan"            },            "comment" : "Find all Manhattan restaurants",            "$db" : "test"         },         "numYields" : 0,         ...      }   ],   "ok" : 1}