DocumentDB SQL - Operadores

Um operador é uma palavra reservada ou um caractere usado principalmente em uma cláusula SQL WHERE para executar operação (ões), como comparações e operações aritméticas. O DocumentDB SQL também oferece suporte a uma variedade de expressões escalares. Os mais comumente usados sãobinary and unary expressions.

Os seguintes operadores SQL são atualmente suportados e podem ser usados em consultas.

Operadores de comparação SQL

A seguir está uma lista de todos os operadores de comparação disponíveis na gramática SQL do Banco de Dados de Documentos.

S.No.	Operadores e descrição
1	= Verifica se os valores de dois operandos são iguais ou não. Se sim, a condição se torna verdadeira.
2	!= Verifica se os valores de dois operandos são iguais ou não. Se os valores não forem iguais, a condição se torna verdadeira.
3	<> Verifica se os valores de dois operandos são iguais ou não. Se os valores não forem iguais, a condição se torna verdadeira.
4	> Verifica se o valor do operando esquerdo é maior que o valor do operando direito. Se sim, a condição se torna verdadeira.
5	< Verifica se o valor do operando esquerdo é menor que o valor do operando direito. Se sim, a condição se torna verdadeira.
6	>= Verifica se o valor do operando esquerdo é maior ou igual ao valor do operando direito. Se sim, a condição se torna verdadeira.
7	<= Verifica se o valor do operando esquerdo é menor ou igual ao valor do operando direito. Se sim, a condição se torna verdadeira.

Operadores lógicos SQL

A seguir está uma lista de todos os operadores lógicos disponíveis na gramática SQL do Banco de Dados de Documentos.

S.No.	Operadores e descrição
1	AND O operador AND permite a existência de várias condições na cláusula WHERE de uma instrução SQL.
2	BETWEEN O operador BETWEEN é usado para pesquisar valores que estão dentro de um conjunto de valores, dados o valor mínimo e o valor máximo.
3	IN O operador IN é usado para comparar um valor a uma lista de valores literais que foram especificados.
4	OR O operador OR é usado para combinar várias condições na cláusula WHERE de uma instrução SQL.
5	NOT O operador NOT inverte o significado do operador lógico com o qual é usado. Por exemplo, NOT EXISTS, NOT BETWEEN, NOT IN, etc. Este é um operador de negação.

Operadores aritméticos SQL

A seguir está uma lista de todos os operadores aritméticos disponíveis na gramática SQL do DocumentDB.

S.No.	Operadores e descrição
1	+ Addition - Adiciona valores em qualquer lado do operador.
2	- Subtraction - Subtrai o operando à direita do operando à esquerda.
3	* Multiplication - Multiplica os valores em cada lado do operador.
4	/ Division - Divide o operando à esquerda pelo operando à direita.
5	% Modulus - Divide o operando à esquerda pelo operando à direita e retorna o restante.

Consideraremos os mesmos documentos também neste exemplo. A seguir está oAndersenFamily 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 
}

A seguir está o 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 
}

A seguir está o 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 
}

Vamos dar uma olhada em um exemplo simples em que um operador de comparação é usado na cláusula WHERE.

Nesta consulta, na cláusula WHERE, a condição (WHERE f.id = "WakefieldFamily") é especificada e irá recuperar o documento cujo id é igual a WakefieldFamily.

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

Quando a consulta acima for executada, ela retornará o documento JSON completo para WakefieldFamily, conforme mostrado na saída a seguir.

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

Vamos dar uma olhada em outro exemplo em que a consulta recuperará os dados das crianças cuja nota é maior que 5.

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

Quando a consulta acima for executada, ela recuperará o seguinte sub-documento, conforme mostrado na saída.

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

↰ Previous page Next page ↱