定義
cursor.comment()重要
mongosh メソッド
このページでは、
mongoshメソッドが文書化されます。これは Node.js などの言語固有のドライバーのドキュメントではありません。MongoDB API ドライバーについては、各言語の MongoDB ドライバー ドキュメントを参照してください。
クエリに
commentフィールドを追加します。cursor.comment()の構文は次のとおりです。cursor.comment( <string> ) comment()には、次のパラメーターがあります。Parameterタイプ説明commentstring
クエリに適用するコメント。
互換性
このメソッドは、次の環境でホストされている配置で使用できます。
MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
注意
このコマンドは、すべての MongoDB Atlas クラスターでサポートされています。すべてのコマンドに対する Atlas のサポートについては、「サポートされていないコマンド」を参照してください。
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
動作
comment() は、コメントstringを検索操作に関連付けます。 これにより、次の診断出力で特定のクエリを追跡しやすくなります。
ログ、 データベースプロファイラー mongodチュートリアル 、または コマンドのdb.currentOp() ログの冗長度の構成 を参照してください。
例
次の操作では、 restaurantsコレクションのクエリにコメントを添付します。
db.restaurants.find( { "borough" : "Manhattan" } ).comment( "Find all Manhattan restaurants" )
出力例
system.profile
{ "op" : "query", "ns" : "guidebook.restaurant", "query" : { "find" : "restaurant", "filter" : { "borough" : "Manhattan" }, "comment" : "Find all Manhattan restaurants" }, ... }
mongod log
以下は、 mongodログからの抜粋です。 読みやすくするためにフォーマットされています。
重要
QUERYの冗長レベルは0より大きくなければなりません。 「ログの冗長レベルの構成 」を参照してください
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.currentOp()
たとえば、 mongodインスタンスで次の操作が現在実行されているとします。
db.restaurants.find( { "borough" : "Manhattan" } ).comment("Find all Manhattan restaurants")
db.currentOp()コマンドを実行すると、次の結果が返されます。
{ "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 }