Documentdb-sql-between-keyword

提供:Dev Guides
移動先:案内検索

DocumentDB SQL-Betweenキーワード

BETWEENキーワードは、SQLのような値の範囲に対するクエリを表現するために使用されます。 BETWEENは、文字列または数値に対して使用できます。 DocumentDBとANSI SQLでBETWEENを使用する主な違いは、混合型のプロパティに対して範囲クエリを表現できることです。

たとえば、一部のドキュメントでは、数値として「グレード」があり、他のドキュメントでは文字列である可能性があります。 これらの場合、2つの異なるタイプの結果の比較は「未定義」であり、ドキュメントはスキップされます。

前の例の3つのドキュメントを考えてみましょう。 以下は AndersenFamily ドキュメントです。

{
   "id": "AndersenFamily",
   "lastName": "Andersen",

   "parents": [
      { "firstName": "Thomas", "relationship":  "father" },
      { "firstName": "Mary Kay", "relationship":  "mother" }
   ],

   "children": [
      {
         "firstName": "Henriette Thaulow",
         "gender": "female",
         "grade": 5,
         "pets": [ { "givenName": "Fluffy", "type":  "Rabbit" } ]
      }
   ],

   "location": { "state": "WA", "county": "King", "city": "Seattle" },
   "isRegistered": true
}

以下は SmithFamily ドキュメントです。

{
   "id": "SmithFamily",

   "parents": [
      { "familyName": "Smith", "givenName": "James" },
      { "familyName": "Curtis", "givenName": "Helen" }
   ],

   "children": [
      {
         "givenName": "Michelle",
         "gender": "female",
         "grade": 1
      },

      {
         "givenName": "John",
         "gender": "male",
         "grade": 7,

         "pets": [
            { "givenName": "Tweetie", "type": "Bird" }
         ]
      }
   ],

   "location": {
      "state": "NY",
      "county": "Queens",
      "city": "Forest Hills"
   },

   "isRegistered": true
}

以下は WakefieldFamily ドキュメントです。

{
   "id": "WakefieldFamily",

   "parents": [
      { "familyName": "Wakefield", "givenName": "Robin" },
      { "familyName": "Miller", "givenName": "Ben" }
   ],

   "children": [
      {
         "familyName": "Merriam",
         "givenName": "Jesse",
         "gender": "female",
         "grade": 6,

         "pets": [
            { "givenName": "Charlie Brown", "type": "Dog" },
            { "givenName": "Tiger", "type": "Cat" },
            { "givenName": "Princess", "type": "Cat" }
         ]
      },

      {
         "familyName": "Miller",
         "givenName": "Lisa",
         "gender": "female",
         "grade": 3,

         "pets": [
            { "givenName": "Jake", "type": "Snake" }
         ]
      }
   ],

   "location": { "state": "NY", "county": "Manhattan", "city": "NY" },
   "isRegistered": false
}

クエリを実行して、最初の子供の成績が1〜5(両方を含む)であるすべての家族のドキュメントを返す例を見てみましょう。

Returns Family Documents

以下は、BETWEENキーワードが使用され、次にAND論理演算子が使用されるクエリです。

SELECT *
FROM Families.children[0] c
WHERE c.grade BETWEEN 1 AND 5

上記のクエリを実行すると、次の出力が生成されます。

[
   {
      "givenName": "Michelle",
      "gender": "female",
      "grade": 1
   },

   {
      "firstName": "Henriette Thaulow",
      "gender": "female",
      "grade": 5,

      "pets": [
         {
            "givenName": "Fluffy",
            "type": "Rabbit"
         }
      ]
   }
]

前の例の範囲外のグレードを表示するには、次のクエリに示すようにNOT BETWEENを使用します。

SELECT*
FROM Families.children[0] c
WHERE c.grade NOT BETWEEN 1 AND 5

このクエリが実行されるとき。 次の出力が生成されます。

[
   {
      "familyName": "Merriam",
      "givenName": "Jesse",
      "gender": "female",
      "grade": 6,

      "pets": [
         {
            "givenName": "Charlie Brown",
            "type": "Dog"
         },

         {
            "givenName": "Tiger",
            "type": "Cat"
         },

         {
            "givenName": "Princess",
            "type": "Cat"
         }
      ]
   }
]