Azure Cosmos DB の MongoDB 用 API を使用してデータのクエリを実行する

適用対象: MongoDB 用 Azure Cosmos DB API

Azure Cosmos DB の MongoDB 用 API では、MongoDB のクエリがサポートされています。

この記事に含まれるタスクは次のとおりです。

  • MongoDB シェルを使用して Cosmos データベースに格納されているデータのクエリを実行する

まずは、このドキュメントの例を使用したり、MongoDB シェルでの Azure Cosmos DB に対するクエリの実行に関するビデオを見ることから始めます。

サンプル ドキュメント

この記事のクエリは、次のサンプル ドキュメントを使用します。

{
  "id": "WakefieldFamily",
  "parents": [
      { "familyName": "Wakefield", "givenName": "Robin" },
      { "familyName": "Miller", "givenName": "Ben" }
  ],
  "children": [
      {
        "familyName": "Merriam", 
        "givenName": "Jesse", 
        "gender": "female", "grade": 1,
        "pets": [
            { "givenName": "Goofy" },
            { "givenName": "Shadow" }
        ]
      },
      { 
        "familyName": "Miller", 
         "givenName": "Lisa", 
         "gender": "female", 
         "grade": 8 }
  ],
  "address": { "state": "NY", "county": "Manhattan", "city": "NY" },
  "creationDate": 1431620462,
  "isRegistered": false
}

サンプル クエリ 1

上記の家族に関するサンプル ドキュメントに対して、次のクエリは ID フィールドが WakefieldFamily と一致するドキュメントを返します。

クエリ

db.families.find({ id: "WakefieldFamily"})

結果

{
    "_id": "ObjectId(\"58f65e1198f3a12c7090e68c\")",
    "id": "WakefieldFamily",
    "parents": [
      {
        "familyName": "Wakefield",
        "givenName": "Robin"
      },
      {
        "familyName": "Miller",
        "givenName": "Ben"
      }
    ],
    "children": [
      {
        "familyName": "Merriam",
        "givenName": "Jesse",
        "gender": "female",
        "grade": 1,
        "pets": [
          { "givenName": "Goofy" },
          { "givenName": "Shadow" }
        ]
      },
      {
        "familyName": "Miller",
        "givenName": "Lisa",
        "gender": "female",
        "grade": 8
      }
    ],
    "address": {
      "state": "NY",
      "county": "Manhattan",
      "city": "NY"
    },
    "creationDate": 1431620462,
    "isRegistered": false
}

サンプル クエリ 2

次のクエリでは、家族のすべての子が返されます。

クエリ

db.families.find( { id: "WakefieldFamily" }, { children: true } )

結果

{
    "_id": "ObjectId("58f65e1198f3a12c7090e68c")",
    "children": [
      {
        "familyName": "Merriam",
        "givenName": "Jesse",
        "gender": "female",
        "grade": 1,
        "pets": [
          { "givenName": "Goofy" },
          { "givenName": "Shadow" }
        ]
      },
      {
        "familyName": "Miller",
        "givenName": "Lisa",
        "gender": "female",
        "grade": 8
      }
    ]
}

サンプル クエリ 3

次のクエリでは、登録されているすべての家族が返されます。

クエリ

db.families.find( { "isRegistered" : true })

結果

ドキュメントは返されません。

サンプル クエリ 4

次のクエリでは、登録されていないすべての家族が返されます。

クエリ

db.families.find( { "isRegistered" : false })

結果

{
    "_id": ObjectId("58f65e1198f3a12c7090e68c"),
    "id": "WakefieldFamily",
    "parents": [{
        "familyName": "Wakefield",
        "givenName": "Robin"
    }, {
        "familyName": "Miller",
        "givenName": "Ben"
    }],
    "children": [{
        "familyName": "Merriam",
        "givenName": "Jesse",
        "gender": "female",
        "grade": 1,
        "pets": [{
            "givenName": "Goofy"
        }, {
            "givenName": "Shadow"
        }]
    }, {
        "familyName": "Miller",
        "givenName": "Lisa",
        "gender": "female",
        "grade": 8
    }],
    "address": {
        "state": "NY",
        "county": "Manhattan",
        "city": "NY"
    },
    "creationDate": 1431620462,
    "isRegistered": false
}

サンプル クエリ 5

次のクエリでは、登録されていない、州が NY のすべての家族が返されます。

クエリ

db.families.find( { "isRegistered" : false, "address.state" : "NY" })

結果

{
    "_id": ObjectId("58f65e1198f3a12c7090e68c"),
    "id": "WakefieldFamily",
    "parents": [{
        "familyName": "Wakefield",
        "givenName": "Robin"
    }, {
        "familyName": "Miller",
        "givenName": "Ben"
    }],
    "children": [{
        "familyName": "Merriam",
        "givenName": "Jesse",
        "gender": "female",
        "grade": 1,
        "pets": [{
            "givenName": "Goofy"
        }, {
            "givenName": "Shadow"
        }]
    }, {
        "familyName": "Miller",
        "givenName": "Lisa",
        "gender": "female",
        "grade": 8
    }],
    "address": {
        "state": "NY",
        "county": "Manhattan",
        "city": "NY"
    },
    "creationDate": 1431620462,
    "isRegistered": false
}

サンプル クエリ 6

次のクエリでは、子が 8 年生のすべての家族が返されます。

クエリ

db.families.find( { children : { $elemMatch: { grade : 8 }} } )

結果

{
    "_id": ObjectId("58f65e1198f3a12c7090e68c"),
    "id": "WakefieldFamily",
    "parents": [{
        "familyName": "Wakefield",
        "givenName": "Robin"
    }, {
        "familyName": "Miller",
        "givenName": "Ben"
    }],
    "children": [{
        "familyName": "Merriam",
        "givenName": "Jesse",
        "gender": "female",
        "grade": 1,
        "pets": [{
            "givenName": "Goofy"
        }, {
            "givenName": "Shadow"
        }]
    }, {
        "familyName": "Miller",
        "givenName": "Lisa",
        "gender": "female",
        "grade": 8
    }],
    "address": {
        "state": "NY",
        "county": "Manhattan",
        "city": "NY"
    },
    "creationDate": 1431620462,
    "isRegistered": false
}

サンプル クエリ 7

次のクエリでは、子の配列サイズが 3 のすべての家族が返されます。

クエリ

db.Family.find( {children: { $size:3} } )

結果

子が 2 人より多い家族はないため、返される結果はありません。 パラメーターが 2 の場合のみ、このクエリは成功し、ドキュメント全体を返します。

次のステップ

このチュートリアルでは、次の手順を行いました。

  • Azure Cosmos DB の MongoDB 用 API を使用してクエリを実行する方法を理解しました。

次のチュートリアルに進んで、データをグローバルに分散する方法について学習できます。