Entity SQL-Kurzreferenz

Dieses Thema enthält eine Kurzreferenz zu Entity SQL -Abfragen. Die Abfragen in diesem Thema basieren auf dem AdventureWorks Sales-Modell.

Literale

String

Es gibt Zeichenfolgenliterale, die aus Unicode-, und solche, die aus Nicht-Unicode-Zeichen bestehen. Unicode-Zeichenfolgen wird "N" vorangestellt. Beispiel: N'hello'.

Im Folgenden ist ein Beispiel für ein nicht-Unicode-Zeichenfolgenliteral abgebildet:

'hello'
--same as
"hello"

Ausgabe:

DateTime

In DateTime-Literalen sind sowohl das Datum als auch die Uhrzeit erforderlich. Es gibt keine Standardwerte.

Beispiel:

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

Ausgabe:

Ganzzahl

Ganzzahlige Literale können vom Typ Int32 (123), UInt32 (123U), Int64 (123L) und UInt64 (123UL) sein.

Beispiel:

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

Ausgabe:

Sonstige

Andere von Entity SQL unterstützte Literale sind Guid, Binary, Float/Double, Decimal und NULL. NULL-Literale werden in Entity SQL als mit allen anderen Typen im kozeptionellen Modell kompatibel aufgefasst.

Typkonstruktoren

ROW

ROW (Entity SQL) Erstellt einen anonymen, strukturell typisierten (Datensatz-)Wert wie im folgenden Beispiel: ROW(1 AS myNumber, ‘Name’ AS myName).

Beispiel:

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

Ausgabe:

MULTISET

MULTISET (Entity SQL) erstellt Auflistungen, z. B.:

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

Beispiel:

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

Ausgabe:

Object

Konstruktor benannter Typen (Entity SQL) erstellt (benannte) benutzerdefinierte Objekte, z. B. person("abc", 12).

Beispiel:

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

Ausgabe:

Verweise

REF

REF erstellt einen Verweis auf eine Entitätstypinstanz. Die folgende Abfrage gibt beispielsweise einen Verweis auf jede Order-Entität in der Orders-Entitätenmenge zurück:

SELECT REF(o) AS OrderID FROM Orders AS o

Ausgabe:

Im folgenden Beispiel wird der Eigenschaftsextrahierungsoperator (.) für den Zugriff auf eine Eigenschaft einer Entität verwendet. Bei der Verwendung des Eigenschaftsextraktionsoperators wird der Verweis automatisch dereferenziert.

Beispiel:

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

Ausgabe:

DEREF

DEREF dereferenziert einen Verweiswert und erstellt das Ergebnis dieser Dereferenzierung. Die folgende Abfrage erstellt beispielsweise die Order-Entitäten für jede Bestellung in der Orders-Entitätenmenge: SELECT DEREF(o2.r) FROM (SELECT REF(o) AS r FROM LOB.Orders AS o) AS o2.

Beispiel:

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

Ausgabe:

CREATEREF UND KEY

CREATEREF erstellt einen Verweis, der einen Schlüssel übergibt. KEY extrahiert den Schlüsselteil eines Ausdrucks mit Typverweis.

Beispiel:

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

Ausgabe:

Funktionen

Kanonische Funktionen

Der Namespace für kanonische Funktionen ist Edm, wie in Edm.Length("string"). Der Namespace muss nur dann angegeben werden, wenn ein anderer Namespace importiert wurde, der eine Funktion mit dem gleichen Namen wie eine kanonische Funktion enthält. Wenn zwei Namespaces über die gleiche Funktion verfügen, sollte der Benutzer den vollständigen Namen angeben.

Beispiel:

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

Ausgabe:

Microsoft-anbieterspezifische Funktionen

Microsoft-anbieterspezifische Funktionen befinden sich im SqlServer-Namespace.

Beispiel:

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

Ausgabe:

Namespaces

USING gibt in einem Abfrageausdruck verwendete Namespaces an.

Beispiel:

using SqlServer; LOWER('AA');

Ausgabe:

Paging

Paging kann durch Deklarieren einer SKIP-Unterklausel und einer LIMIT-Unterklausel in der ORDER BY (Entity SQL)-Klausel erreicht werden.

Beispiel:

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

Ausgabe:

Gruppieren

GROUPING BY gibt Gruppen an, in die von einem Abfrageausdruck (SELECT) zurückgegebene Objekte platziert werden sollen.

Beispiel:

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

Ausgabe:

Navigation

Der Beziehungsnavigationsoperator ermöglicht die Navigation der Beziehung von einer Entität (an einem Ende) zu einer anderen Entität (am anderen Ende). NAVIGATE wird der Beziehungstyp als <Namespace>.<Beziehungstypname> qualifiziert übergeben. Navigate gibt Ref<T> zurück, wenn die Kardinalität des anderen Endes "1" ist. Wenn die Kardinalität des anderen Endes "n" ist, wird die Collection<Ref<T>> zurückgegeben.

Beispiel:

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

Ausgabe:

SELECT VALUE UND SELECT

SELECT VALUE

Entity SQL stellt die SELECT VALUE-Klausel bereit, um die implizite Zeilenkonstruktion zu überspringen. In einer SELECT VALUE-Klausel kann nur ein Element angegeben werden. Wenn diese Klausel verwendet wird, wird kein Zeilen-Wrapper für die Elemente in der SELECT-Klausel erstellt, und eine Auflistung der gewünschten Form kann erstellt werden, beispielsweise SELECT VALUE a.

Beispiel:

SELECT VALUE p.Name FROM AdventureWorksEntities.Product as p

Ausgabe:

SELECT

Entity SQL stellt auch den Zeilenkonstruktor zum Erstellen beliebiger Zeilen bereit. SELECT werden ein oder mehrere Elemente in der Projektion übergeben, und das Ergebnis ist ein Datensatz mit Feldern, z. B.: SELECT a, b, c.

Beispiel:

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

CASE EXPRESSION

case expression wertet eine Reihe von booleschen Ausdrücken aus, um das Ergebnis zu ermitteln.

Beispiel:

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

Ausgabe:

Siehe auch

Konzepte

Entity SQL-Referenz
Übersicht über Entity SQL