DocumentDB SQL - Operatori

Un operatore è una parola riservata o un carattere utilizzato principalmente in una clausola SQL WHERE per eseguire operazioni, come confronti e operazioni aritmetiche. DocumentDB SQL supporta anche una varietà di espressioni scalari. I più comunemente usati sonobinary and unary expressions.

I seguenti operatori SQL sono attualmente supportati e possono essere utilizzati nelle query.

Operatori di confronto SQL

Di seguito è riportato un elenco di tutti gli operatori di confronto disponibili nella grammatica SQL di DocumentDB.

S.No. Operatori e descrizione
1

=

Controlla se i valori di due operandi sono uguali o meno. Se sì, la condizione diventa vera.

2

!=

Controlla se i valori di due operandi sono uguali o meno. Se i valori non sono uguali, la condizione diventa vera.

3

<>

Controlla se i valori di due operandi sono uguali o meno. Se i valori non sono uguali, la condizione diventa vera.

4

>

Controlla se il valore dell'operando sinistro è maggiore del valore dell'operando destro. Se sì, la condizione diventa vera.

5

<

Verifica se il valore dell'operando sinistro è inferiore al valore dell'operando destro. Se sì, la condizione diventa vera.

6

>=

Controlla se il valore dell'operando sinistro è maggiore o uguale al valore dell'operando destro. Se sì, la condizione diventa vera.

7

<=

Controlla se il valore dell'operando sinistro è minore o uguale al valore dell'operando destro. Se sì, la condizione diventa vera.

Operatori logici SQL

Di seguito è riportato un elenco di tutti gli operatori logici disponibili nella grammatica SQL di DocumentDB.

S.No. Operatori e descrizione
1

AND

L'operatore AND consente l'esistenza di più condizioni nella clausola WHERE di un'istruzione SQL.

2

BETWEEN

L'operatore BETWEEN viene utilizzato per cercare valori che sono all'interno di un insieme di valori, dato il valore minimo e il valore massimo.

3

IN

L'operatore IN viene utilizzato per confrontare un valore con un elenco di valori letterali che sono stati specificati.

4

OR

L'operatore OR viene utilizzato per combinare più condizioni nella clausola WHERE di un'istruzione SQL.

5

NOT

L'operatore NOT inverte il significato dell'operatore logico con cui viene utilizzato. Ad esempio, NOT EXISTS, NOT BETWEEN, NOT IN, ecc. Questo è un operatore di negazione.

Operatori aritmetici SQL

Di seguito è riportato un elenco di tutti gli operatori aritmetici disponibili nella grammatica SQL di DocumentDB.

S.No. Operatori e descrizione
1

+

Addition - Aggiunge valori su entrambi i lati dell'operatore.

2

-

Subtraction - Sottrae l'operando di destra dall'operando di sinistra.

3

*

Multiplication - Moltiplica i valori su entrambi i lati dell'operatore.

4

/

Division - Divide l'operando di sinistra per l'operando di destra.

5

%

Modulus - Divide l'operando di sinistra per l'operando di destra e restituisce il resto.

Considereremo gli stessi documenti anche in questo esempio. Di seguito è riportato il fileAndersenFamily documento.

{ 
   "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 
}

Di seguito è riportato il file SmithFamily documento.

{ 
   "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 
}

Di seguito è riportato il file WakefieldFamily documento.

{ 
   "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 
}

Diamo un'occhiata a un semplice esempio in cui viene utilizzato un operatore di confronto nella clausola WHERE.

In questa query, nella clausola WHERE, viene specificata la condizione (WHERE f.id = "WakefieldFamily") e verrà recuperato il documento il cui ID è uguale a WakefieldFamily.

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

Quando la query precedente viene eseguita, restituirà il documento JSON completo per WakefieldFamily come mostrato nell'output seguente.

[ 
   { 
      "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/" 
   } 
]

Diamo un'occhiata a un altro esempio in cui la query recupererà i dati dei bambini il cui voto è maggiore di 5.

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

Quando la query precedente viene eseguita, recupererà il seguente sottodocumento come mostrato nell'output.

[
   {
      "familyName": "Merriam", 
      "givenName": "Jesse", 
      "gender": "female", 
      "grade": 6, 
		
      "pets": [
         { 
            "givenName": "Charlie Brown", 
            "type": "Dog" 
         }, 
			
         { 
            "givenName": "Tiger", 
            "type": "Cat" 
         }, 
			
         { 
            "givenName": "Princess", 
            "type": "Cat" 
         } 
      ] 
   } 
]