cursor.returnKey()

項目一覧

定義
互換性
動作
例

定義

cursor.returnKey()

重要

mongosh メソッド

このページでは、mongosh メソッドについて記載しています。これは Node.js などの言語固有のドライバーのドキュメントではありません。

MongoDB API ドライバーについては、各言語の MongoDB ドライバードキュメントを参照してください。

Tip

$metaは、インデックスが使用されている場合にインデックスキーメタデータを返すためにキーワード"indexKey"をサポートしています。 { $meta: "indexKey" }cursor.returnKey()よりもの使用が優先されます。

カーソルを変更して、ドキュメントではなくインデックスキーを返します。

cursor.returnKey()の形式は次のとおりです。

cursor.returnKey()

次の値を返します。	変更された結果セットを持つがアタッチされている`returnKey()` カーソル。This allows for additional cursor modifiers to be chained.

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージドサービスです

注意

このコマンドは、すべての MongoDB Atlas クラスターでサポートされています。すべてのコマンドに対する Atlas のサポートについては、「サポートされていないコマンド」を参照してください。

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

動作

クエリがインデックスを使用して読み取り操作を実行しない場合、カーソルは空のドキュメントを返します。

例

restaurantsコレクションには、次のスキーマを持つドキュメントが含まれています。

{
   "_id" : ObjectId("564f3a35b385149fc7e3fab9"),
   "address" : {
      "building" : "2780",
      "coord" : [
         -73.98241999999999,
         40.579505
      ],
      "street" : "Stillwell Avenue",
      "zipcode" : "11224"
   },
   "borough" : "Brooklyn",
   "cuisine" : "American ",
   "grades" : [
      {
         "date" : ISODate("2014-06-10T00:00:00Z"),
         "grade" : "A",
         "score" : 5
      },
      {
         "date" : ISODate("2013-06-05T00:00:00Z"),
         "grade" : "A",
         "score" : 7
      }
   ],
   "name" : "Riviera Caterer",
   "restaurant_id" : "40356018"
}

コレクションには、デフォルトの_idインデックスに加えて 2 つのインデックスがあります。

{
   "v" : 1,
   "key" : {
      "_id" : 1
   },
   "name" : "_id_",
   "ns" : "guidebook.restaurant"
},
{
   "v" : 1,
   "key" : {
      "cuisine" : 1
   },
   "name" : "cuisine_1",
   "ns" : "guidebook.restaurant"
},
{
   "v" : 1,
   "key" : {
      "_fts" : "text",
      "_ftsx" : 1
   },
   "name" : "name_text",
   "ns" : "guidebook.restaurant",
   "weights" : {
      "name" : 1
   },
   "default_language" : "english",
   "language_override" : "language",
   "textIndexVersion" : 3
}

次のコードでは、 cursor.returnKey()メソッドを使用して、クエリの実行に使用されたインデックス付きフィールドのみを返します。

var csr = db.restaurant.find( { "cuisine" : "Japanese" } )
csr.returnKey()

これにより、以下が返されます。

{ "cuisine" : "Japanese" }
{ "cuisine" : "Japanese" }
{ "cuisine" : "Japanese" }
{ "cuisine" : "Japanese" }
...

戻る

cursor.readPref

cursor.showRecordId