Entity SQL-Kurzreferenz

  • Artikel

Dieses Thema enthält eine Kurzübersicht 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 ein „N“ vorangestellt, beispielsweise N'hello'.

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

'hello'
--same as
"hello"

Ausgabe:

Wert
hello

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:

Wert
12/25/2006 1:01:00 AM

Integer

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:

Wert
1
2
3

Sonstiges

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 konzeptionellen Modell kompatibel aufgefasst.

Typkonstruktoren

ROW

ROW 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:

ProductID Name
1 Adjustable Race
879 All-Purpose Bike Stand
712 AWC Logo Cap
... ...

MULTISET

MULTISET 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:

ProductID Name ProductNumber …
842 Touring-Panniers, Large PA-T100 …

Object

Benannter Typkonstruktor erstellt (benannte) benutzerdefinierte Objekte wie 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:

SalesOrderDetailID CarrierTrackingNumber OrderQty ProductID ...
1 4911-403C-98 1 776 ...
2 4911-403C-98 3 777 ...
... ... ... ... ...

Referenzen

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:

Wert
1
2
3
...

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:

Wert
Adjustable Race
All-Purpose Bike Stand
AWC Logo Cap
...

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:

Wert
Adjustable Race
All-Purpose Bike Stand
AWC Logo Cap
...

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:

ProductID
980
365
771
...

Functions

Canonical

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:

NameLen
6
6
5

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:

EmailLen
27
27
26

Namespaces

USING gibt in einem Abfrageausdruck verwendete Namespaces an.

Beispiel:

using SqlServer; LOWER('AA');

Ausgabe:

Wert
aa

Paging

Paging kann durch Deklarieren einer SKIP- und LIMIT-Unterklausel in der ORDER BY-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:

id Name
10 Adina
11 Agcaoili
12 Aguilar

Gruppierung

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:

name
LL Mountain Seat Assembly
ML Mountain Seat Assembly
HL Mountain Seat Assembly
...

Der Beziehungsnavigationsoperator ermöglicht die Navigation der Beziehung von einer Entität (an einem Ende) zu einer anderen Entität (am anderen Ende). NAVIGATE akzeptiert den Beziehungstyp, qualifiziert als <Namespace>.<Beziehungstypname>. „Navigate“ gibt „Ref<T>“ zurück, wenn die Kardinalität des „to“-Endes „1“ ist. Wenn die Kardinalität des „to“-Endes „n“ beträgt, 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:

AddressID
1
2
3
...

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:

Name
Adjustable Race
All-Purpose Bike Stand
AWC Logo Cap
...

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.: .

Beispiel:

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

Name ProductID
Adjustable Race 1
All-Purpose Bike Stand 879
AWC Logo Cap 712
... ...

CASE EXPRESSION

Der CASE-Ausdruck wertet eine Reihe von booleschen Ausdrücken aus, um das Ergebnis zu bestimmen.

Beispiel:

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

Ausgabe:

Wert
true

Siehe auch