Aide-mémoire Entity SQL

Cette rubrique fournit un aide-mémoire sur les requêtes Entity SQL. Les requêtes de cette rubrique sont basées sur le modèle de vente Adventure Works Sales Model.

Littéraux

String

Les chaînes de caractères littérales peuvent être au format Unicode ou non-Unicode. Les chaînes Unicode sont précédées de N. Par exemple, N'hello'.

Exemple de littéral de chaîne non-Unicode :

'hello'
--same as
"hello"

Sortie :

DateTime

Dans les littéraux DateTime, les parties date et heure sont obligatoires. Il n'y a pas de valeurs par défaut.

Exemple :

DATETIME '2006-12-25 01:01:00.000'
--same as
DATETIME '2006-12-25 01:01'

Sortie :

Integer

Les littéraux d'entiers peuvent être de type Int32 (123), UInt32 (123U), Int64 (123L) et UInt64 (123UL).

Exemple :

--a collection of integers
{1, 2, 3}

Sortie :

Autres

Les autres littéraux pris en charge par Entity SQL sont Guid, Binary, Float/Double, Decimal et la valeur null. Les littéraux NULL dans Entity SQL sont considérés compatibles avec tous les autres types dans le modèle conceptuel.

Constructeurs de type

ROW

ROW construit une valeur anonyme, structurellement typée (enregistrement) comme dans : ROW(1 AS myNumber, 'Name' AS myName).

Exemple :

SELECT VALUE row (product.ProductID AS ProductID, product.Name
    AS ProductName) FROM AdventureWorksEntities.Product AS product

Sortie :

MULTISET

MULTISET construit des collections, telles que :

MULTISET(1,2,2,3) --same as-{1,2,2,3}.

Exemple :

SELECT VALUE product FROM AdventureWorksEntities.Product AS product WHERE product.ListPrice IN MultiSet (125, 300)

Sortie :

Object

Constructeur de type nommé construit des objets définis par l’utilisateur (nommés), tels que person("abc", 12).

Exemple :

SELECT VALUE AdventureWorksModel.SalesOrderDetail (o.SalesOrderDetailID, o.CarrierTrackingNumber, o.OrderQty,
o.ProductID, o.SpecialOfferID, o.UnitPrice, o.UnitPriceDiscount,
o.rowguid, o.ModifiedDate) FROM AdventureWorksEntities.SalesOrderDetail
AS o

Sortie :

References

REF

REF crée une référence à une instance de type entité. Par exemple, la requête suivante retourne les références à chaque entité Order dans le jeu d'entités Orders :

SELECT REF(o) AS OrderID FROM Orders AS o

Sortie :

L'exemple suivant utilise l'opérateur d'extraction de propriété (.) pour accéder à une propriété d'entité. Lors de l'utilisation de l'opérateur d'extraction de propriété, la référence est automatiquement supprimée.

Exemple :

SELECT VALUE REF(p).Name FROM
    AdventureWorksEntities.Product AS p

Sortie :

DEREF

DEREF supprime une valeur de référence et génère le résultat de ce déréférencement. Par exemple, la requête suivante génère les entités Order pour chaque élément Order du jeu d'entités Orders : SELECT DEREF(o2.r) FROM (SELECT REF(o) AS r FROM LOB.Orders AS o) AS o2.

Exemple :

SELECT VALUE DEREF(REF(p)).Name FROM
    AdventureWorksEntities.Product AS p

Sortie :

CREATEREF et KEY

CREATEREF crée une référence qui passe une clé. KEY extrait la partie clé d’une expression avec la référence de type.

Exemple :

SELECT VALUE Key(CreateRef(AdventureWorksEntities.Product, row(p.ProductID)))
    FROM AdventureWorksEntities.Product AS p

Sortie :

Fonctions

Canonical

L’espace de noms des fonctions canoniques est Edm, comme dans Edm.Length("string"). Vous n'avez pas besoin de spécifier l'espace de noms sauf si un autre espace de noms est importé et qu'il contient une fonction portant le même nom qu'une fonction canonique. Si deux espaces de noms partagent la même fonction, l’utilisateur doit spécifier le nom complet.

Exemple :

SELECT Length(c. FirstName) AS NameLen FROM
    AdventureWorksEntities.Contact AS c
    WHERE c.ContactID BETWEEN 10 AND 12

Sortie :

Spécifiques au fournisseur Microsoft

Les fonctions spécifiques au fournisseur Microsoft figurent dans l’espace de noms SqlServer.

Exemple :

SELECT SqlServer.LEN(c.EmailAddress) AS EmailLen FROM
    AdventureWorksEntities.Contact AS c WHERE
    c.ContactID BETWEEN 10 AND 12

Sortie :

Espaces de noms

USING spécifie les espaces de noms utilisés dans une expression de requête.

Exemple :

using SqlServer; LOWER('AA');

Sortie :

Pagination

La pagination peut s’effectuer en déclarant des sous-clauses SKIP et LIMIT de la clause ORDER BY.

Exemple :

SELECT c.ContactID as ID, c.LastName AS Name FROM
    AdventureWorks.Contact AS c ORDER BY c.ContactID SKIP 9 LIMIT 3;

Sortie :

Regroupement

GROUPING BY spécifie des groupes dans lesquels doivent être placés les objets retournés par une expression de requête (SELECT).

Exemple :

SELECT VALUE name FROM AdventureWorksEntities.Product AS P
    GROUP BY P.Name HAVING MAX(P.ListPrice) > 5

Sortie :

Navigation

L'opérateur de navigation de relations vous permet de parcourir la relation entre une entité (terminaison From) et une autre entité (terminaison To). NAVIGATE accepte le type de relation qualifié comme <espace de noms>.<nom du type de relation>. Navigate retourne Ref<T> si la cardinalité de la terminaison To est 1. Si la cardinalité de la terminaison To est n, la valeur retournée est Collection<Ref<T>>.

Exemple :

SELECT a.AddressID, (SELECT VALUE DEREF(v) FROM
    NAVIGATE(a, AdventureWorksModel.FK_SalesOrderHeader_Address_BillToAddressID) AS v)
    FROM AdventureWorksEntities.Address AS a

Sortie :

SELECT VALUE et SELECT

SELECT VALUE

Entity SQL fournit la clause SELECT VALUE pour ignorer la construction de ligne implicite. Un seul élément peut être spécifié dans une clause SELECT VALUE. Lorsqu’une telle clause est utilisée, aucun wrapper de ligne n’est construit autour des éléments de la clause SELECT et une collection de la forme souhaitée peut être générée, par exemple : SELECT VALUE a.

Exemple :

SELECT VALUE p.Name FROM AdventureWorksEntities.Product AS p

Sortie :

SELECT

Entity SQL fournit également le constructeur de ligne pour construire des lignes arbitraires. SELECT extrait un ou plusieurs éléments de la projection et produit un enregistrement de données avec des champs, par exemple : SELECT a, b, c.

Exemple :

SELECT p.Name, p.ProductID FROM AdventureWorksEntities.Product as p Output:

Expression CASE

L’expression CASE évalue un ensemble d’expressions booléennes pour déterminer le résultat.

Exemple :

CASE WHEN AVG({25,12,11}) < 100 THEN TRUE ELSE FALSE END

Sortie :

Voir aussi

• Référence Entity SQL
• Vue d'ensemble d'Entity SQL