Référence Entity SQL
Cette section contient des articles de référence sur Entity SQL. Cet article récapitule et regroupe les opérateurs Entity SQL par catégorie.
Opérateurs arithmétiques
Les opérateurs arithmétiques effectuent des opérations mathématiques sur deux expressions d'au moins un type numérique. Le tableau ci-dessous répertorie les opérateurs arithmétiques Entity SQL :
| Opérateur | Utilisation |
|---|---|
| + (Ajout) | Addition. |
| / (Diviser) | Division. |
| % (Modulo) | Retourne le reste d'une division. |
| * (Multiplication) | Multiplication. |
| - (Négatif) | Négation. |
| - (Soustraction) | Soustraction. |
Fonctions canoniques
Les fonctions canoniques sont prises en charge par tous les fournisseurs de données et peuvent être utilisées par toutes les technologies de requête. Le tableau ci-dessous répertorie les fonctions canoniques :
| Fonction | Type |
|---|---|
| Fonctions canoniques Entity SQL d'agrégation | Décrit les fonctions canoniques d’agrégation d’Entity SQL. |
| Fonctions mathématiques canoniques | Décrit les fonctions canoniques mathématiques d’Entity SQL. |
| Fonctions de chaînes canoniques | Décrit les fonctions canoniques liées aux chaînes d’Entity SQL. |
| Fonctions de date et d'heure canoniques | Décrit les fonctions canoniques de date et d’heure Entity SQL. |
| Fonctions de chaînes canoniques au niveau du bit | Décrit les fonctions canoniques au niveau du bit d’Entity SQL. |
| Autres fonctions canoniques | Décrit les fonctions qui ne sont pas considérées comme des fonctions au niveau du bit, des fonctions de date/heure, des fonctions de chaîne, des fonctions mathématiques ni des fonctions d'agrégation. |
Opérateurs de comparaison
Des opérateurs de comparaison sont définis pour les types suivants : Byte, Int16, Int32, Int64, Double, Single, Decimal, String, DateTime, Date, Time, DateTimeOffset. La promotion de type implicite intervient pour les opérandes avant application de l’opérateur de comparaison. Les opérateurs de comparaison produisent toujours des valeurs booléennes. Lorsque au moins l’un des opérandes est null, le résultat est null.
L'égalité et l'inégalité sont définies pour tout type d'objet qui possède une identité, comme le type Boolean. Les objets non primitifs possédant une identité sont considérés comme égaux s'ils partagent la même identité. Le tableau ci-dessous répertorie les opérateurs de comparaison Entity SQL :
| Opérateur | Description |
|---|---|
| = (Égal à) | Compare l'égalité de deux expressions. |
| > (Supérieur à) | Compare deux expressions pour déterminer si la valeur de l'expression de gauche est supérieure à celle de l'expression de droite. |
| >= (Supérieur à ou égal à) | Compare deux expressions pour déterminer si la valeur de l'expression de gauche est supérieure ou égale à celle de l'expression de droite. |
| IS [NOT] NULL | Détermine si une expression de requête a la valeur NULL. |
| < (Inférieur à) | Compare deux expressions pour déterminer si la valeur de l'expression de gauche est inférieure à celle de l'expression de droite. |
| <= (Inférieur ou égal à) | Compare deux expressions pour déterminer si la valeur de l'expression de gauche est inférieure ou égale à celle de l'expression de droite. |
| [NOT] BETWEEN | Détermine si une expression a pour résultat une valeur contenue dans une plage spécifiée. |
| \!= (Différent de) | Compare deux expressions pour déterminer si l’expression de gauche est différente de l’expression de droite. |
| [NOT] LIKE | Détermine si une chaîne de caractères donnée correspond à un modèle spécifié. |
Opérateurs logiques et opérateurs d’expression CASE
Les opérateurs logiques testent le caractère vrai ou faux d'une condition. L'expression CASE évalue un ensemble d'expressions booléennes pour déterminer le résultat. Le tableau ci-dessous répertorie les opérateurs logiques et d’expression CASE :
| Opérateur | Description |
|---|---|
| && (AND logique) | AND logique. |
| ! (NOT logique) | NOT logique. |
| || (OR logique) | OR logique. |
| CASE | Évalue un ensemble d'expressions booléennes pour déterminer le résultat. |
| THEN | Résultat d’une clause WHEN lorsqu’elle a la valeur true. |
Opérateurs de requête
Les opérateurs de requête permettent de définir des expressions de requête qui retournent des données d'entité. Le tableau ci-dessous répertorie les opérateurs de requête :
| Opérateur | Utilisation |
|---|---|
| FROM | Spécifie la collection qui est utilisée dans les instructions SELECT. |
| GROUP BY | Spécifie les groupes dans lesquels doivent être placés les objets qui sont retournés par une expression de requête (SELECT). |
| GroupPartition | Retourne une collection de valeurs d'argument, projetées en dehors de la partition de groupe à laquelle l'agrégat est associé. |
| HAVING | Indique un critère de recherche pour un groupe ou une fonction d'agrégation. |
| LIMIT | Utilisé avec la clause ORDER BY pour effectuer une pagination physique. |
| ORDER BY | Spécifie l’ordre de classement qui est utilisé sur les objets retournés dans une instruction SELECT. |
| SELECT | Spécifie les éléments dans la projection qui sont retournés par une requête. |
| SKIP | Utilisé avec la clause ORDER BY pour effectuer une pagination physique. |
| TOP | Spécifie que seul le premier ensemble de lignes sera retourné à partir du résultat de la requête. |
| WHERE | Filtre de manière conditionnelle les données qui sont retournées par une requête. |
Opérateurs de référence
Une référence est un pointeur logique (clé étrangère) vers une entité spécifique dans un jeu d'entités spécifique. Entity SQL prend en charge les opérateurs suivants pour construire, déconstruire et parcourir les références :
| Opérateur | Utilisation |
|---|---|
| CREATEREF | Crée les références à une entité dans un jeu d'entités. |
| DEREF | Déréférence une valeur de référence et génère le résultat de ce déréférencement. |
| KEY | Extrait la clé d'une référence ou d'une expression d'entité. |
| NAVIGATE | Vous permet de naviguer sur la relation d'un type d'entité jusqu'à un autre |
| REF | Retourne une référence à une instance d'entité. |
Opérateurs de jeu
Entity SQL fournit diverses opérations Set performantes. Cela inclut les opérateurs Set qui sont similaires aux opérateurs Transact-SQL, tels qu’UNION, INTERSECT, EXCEPT et EXISTS. Entity SQL prend également en charge des opérateurs pour l’élimination des doublons (SET), les tests d’appartenance (IN) et les jointures (JOIN). Le tableau ci-dessous répertorie les opérateurs set d’Entity SQL :
| Opérateur | Utilisation |
|---|---|
| ANYELEMENT | Extrait un élément d'une collection à valeurs multiples. |
| EXCEPT | Retourne une collection de valeurs distinctes à partir de l’expression de requête située du côté gauche de l’opérande EXCEPT, qui ne sont pas retournées à partir de l’expression de requête située à droite de l’opérande EXCEPT. |
| [NOT] EXISTS | Détermine si une collection est vide. |
| FLATTEN | Convertit une collection de collections en collection plane. |
| [NOT] IN | Détermine si une valeur correspond à une valeur incluse dans une collection. |
| INTERSECT | Retourne une collection de valeurs distinctes qui sont retournées par les expressions de requête tant à gauche qu'à droite de l'opérande INTERSECT. |
| OVERLAPS | Détermine si deux collections ont des éléments en commun. |
| SET | Permet de convertir une collection d’objets en un ensemble en produisant une nouvelle collection dans laquelle tous les éléments en double ont été supprimés. |
| UNION | Combine les résultats de deux requêtes, ou plus, en une collection unique. |
Opérateurs de type
Entity SQL propose des opérations qui permettent la création, l’interrogation et la manipulation du type d’une expression (valeur). Le tableau ci-dessous répertorie les opérateurs qui permettent d’utiliser les types :
| Opérateur | Utilisation |
|---|---|
| CAST | Convertit une expression d'un type de données à un autre. |
| COLLECTION | Utilisé dans une opération FUNCTION pour déclarer une collection de types d’entités ou de types complexes. |
| IS [NOT] OF | Détermine si le type d'une expression appartient au type spécifié ou à l'un de ses sous-types. |
| OFTYPE | Retourne une collection d'objets à partir d'une expression de requête d'un type spécifique. |
| Constructeur de type nommé | Permet de créer des instances de types d'entités ou de types complexes. |
| MULTISET | Crée une instance d'un multiensemble à partir d'une liste de valeurs. |
| ROW | Construit des enregistrements anonymes structurellement typés à partir d'une ou plusieurs valeurs. |
| TREAT | Traite un objet d'un type de base déterminé en tant qu'objet du type dérivé spécifié. |
Autres opérateurs
Le tableau suivant répertorie d’autres opérateurs Entity SQL :
| Opérateur | Utilisation |
|---|---|
| + (Concaténation de chaîne) | Utilisé pour concaténer des chaînes dans Entity SQL. |
| . (accès aux membres) | Permet d'accéder à la valeur d'une propriété ou d'un champ d'une instance de type de modèle conceptuel structurel. |
| -- (commentaire) | Inclure des commentaires Entity SQL. |
| FUNCTION | Définit une fonction incluse qui peut être exécutée dans une requête Entity SQL. |