Documentdb-sql-operators

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

DocumentDB SQL-演算子

演算子は、比較や算術演算などの操作を実行するために主にSQL WHERE句で使用される予約語または文字です。 DocumentDB SQLは、さまざまなスカラー式もサポートしています。 最も一般的に使用されるのは、*バイナリ式と単項式*です。

現在、次のSQL演算子がサポートされており、クエリで使用できます。

SQL比較演算子

以下は、DocumentDB SQL文法で使用可能なすべての比較演算子のリストです。

S.No. Operators & Description
1

=

2つのオペランドの値が等しいかどうかを確認します。 はいの場合、条件は真になります。

2

!=

2つのオペランドの値が等しいかどうかを確認します。 値が等しくない場合、条件は真になります。

3

<>

2つのオペランドの値が等しいかどうかを確認します。 値が等しくない場合、条件は真になります。

4

>

左オペランドの値が右オペランドの値より大きいかどうかを確認します。 はいの場合、条件は真になります。

5

<

左オペランドの値が右オペランドの値より小さいかどうかを確認します。 はいの場合、条件は真になります。

6

>=

左オペランドの値が右オペランドの値以上かどうかを確認します。 はいの場合、条件は真になります。

7

左オペランドの値が右オペランドの値以下かどうかを確認します。 はいの場合、条件は真になります。

SQL論理演算子

以下は、DocumentDB SQL文法で使用可能なすべての論理演算子のリストです。

S.No. Operators & Description
1

AND

AND演算子を使用すると、SQLステートメントのWHERE句に複数の条件を含めることができます。

2

BETWEEN

BETWEEN演算子は、最小値と最大値を指定して、値のセット内にある値を検索するために使用されます。

3

IN

IN演算子は、値を指定されたリテラル値のリストと比較するために使用されます。

4

OR

OR演算子は、SQLステートメントのWHERE句で複数の条件を結合するために使用されます。

5

NOT

NOT演算子は、使用される論理演算子の意味を逆にします。 たとえば、NOT EXISTS、NOT BETWEEN、NOT INなど。 これは否定演算子です。

SQL算術演算子

以下は、DocumentDB SQL文法で使用可能なすべての算術演算子のリストです。

S.No. Operators & Description
1

+

追加-演算子の両側に値を追加します。

2

-

減算-右側のオペランドを左側のオペランドから減算します。

3 乗算-演算子の両側の値を乗算します。
4

/

  • Division* -左側のオペランドを右側のオペランドで除算します。
5

%

モジュラス-左側のオペランドを右側のオペランドで除算し、剰余を返します。

この例でも同じドキュメントを検討します。 以下は 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
}

WHERE句で比較演算子を使用する簡単な例を見てみましょう。

比較演算子

このクエリのWHERE句では、(WHERE f.id = "WakefieldFamily")条件が指定され、IDがWakefieldFamilyと等しいドキュメントを取得します。

SELECT *
FROM f
WHERE f.id = "WakefieldFamily"

上記のクエリを実行すると、次の出力に示すように、WakefieldFamilyの完全なJSONドキュメントが返されます。

[
   {
      "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,
      "_rid": "Ic8LAJFujgECAAAAAAAAAA==",
      "_ts": 1450541623,
      "_self": "dbs/Ic8LAA==/colls/Ic8LAJFujgE=/docs/Ic8LAJFujgECAAAAAAAAAA==/",
      "_etag": "\"00000500-0000-0000-0000-567582370000\"",
      "_attachments": "attachments/"
   }
]

クエリがグレードが5より大きい子データを取得する別の例を見てみましょう。

SELECT*
FROM Families.children[0] c
WHERE (c.grade > 5)

上記のクエリが実行されると、出力に示されているように、次のサブドキュメントが取得されます。

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

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

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

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