Entity SQL クイック リファレンス
このトピックでは、Entity SQL クエリのクイック リファレンスを提供します。 このトピックのクエリでは、AdventureWorks Sales Model が使用されています。
リテラル
String
Unicode と非 Unicode の文字列リテラルがあります。 Unicode 文字列は先頭に N が付きます。たとえば、N'hello' のようになります。
非 Unicode 文字列リテラルの例を次に示します。
'hello'
--same as
"hello"
Output:
| [値] |
|---|
| hello |
DateTime
DateTime リテラルでは、日付部分と時刻部分の両方が必須です。 既定値はありません。
例:
DATETIME '2006-12-25 01:01:00.000'
--same as
DATETIME '2006-12-25 01:01'
Output:
| [値] |
|---|
| 12/25/2006 1:01:00 AM |
整数型
整数リテラルには Int32 (123) 型、UInt32 (123U) 型、Int64 (123L) 型、および UInt64 (123UL) 型があります。
例:
--a collection of integers
{1, 2, 3}
Output:
| [値] |
|---|
| 1 |
| 2 |
| 3 |
その他
Entity SQL でサポートされているその他のリテラルは、Guid、Binary、Float/Double、Decimal、および null です。 Entity SQL の NULL リテラルは、概念モデルのその他すべての型と互換性があると見なされます。
型コンストラクター
ROW
ROW では、ROW(1 AS myNumber, 'Name' AS myName). のように、構造的に型付けされた匿名のレコード値が作成されます。
例:
SELECT VALUE row (product.ProductID AS ProductID, product.Name
AS ProductName) FROM AdventureWorksEntities.Product AS product
Output:
| ProductID | 名前 |
|---|---|
| 1 | Adjustable Race |
| 879 | All-Purpose Bike Stand |
| 712 | AWC Logo Cap |
| ... | ... |
MULTISET
MULTISET では、次のようなコレクションが作成されます。
MULTISET(1,2,2,3) --same as-{1,2,2,3}.
例:
SELECT VALUE product FROM AdventureWorksEntities.Product AS product WHERE product.ListPrice IN MultiSet (125, 300)
Output:
| ProductID | 名前 | ProductNumber | … |
|---|---|---|---|
| 842 | Touring-Panniers, Large | PA-T100 | … |
Object
名前付きの型コンストラクターでは、person("abc", 12) のように、名前付きのユーザー定義オブジェクトが作成されます。
例:
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
Output:
| SalesOrderDetailID | CarrierTrackingNumber | OrderQty | ProductID | ... |
|---|---|---|---|---|
| 1 | 4911-403C-98 | 1 | 776 | ... |
| 2 | 4911-403C-98 | 3 | 777 | ... |
| ... | ... | ... | ... | ... |
関連項目
REF
REF では、エンティティ型のインスタンスへの参照が作成されます。 たとえば、次のクエリは、Orders エンティティ セットの各 Order エンティティへの参照を返します。
SELECT REF(o) AS OrderID FROM Orders AS o
Output:
| [値] |
|---|
| 1 |
| 2 |
| 3 |
| ... |
次の例では、プロパティ抽出演算子 (.) を使用して、エンティティのプロパティにアクセスします。 プロパティ抽出演算子を使用すると、参照は自動的に逆参照されます。
例:
SELECT VALUE REF(p).Name FROM
AdventureWorksEntities.Product AS p
Output:
| [値] |
|---|
| Adjustable Race |
| All-Purpose Bike Stand |
| AWC Logo Cap |
| ... |
DEREF
DEREF では、参照値が逆参照されて、その逆参照の結果が生成されます。 たとえば、次のクエリは、SELECT DEREF(o2.r) FROM (SELECT REF(o) AS r FROM LOB.Orders AS o) AS o2 のように、Orders エンティティ セットの各 Order について Order エンティティを生成します。
例:
SELECT VALUE DEREF(REF(p)).Name FROM
AdventureWorksEntities.Product AS p
Output:
| [値] |
|---|
| Adjustable Race |
| All-Purpose Bike Stand |
| AWC Logo Cap |
| ... |
CREATEREF と KEY
CREATEREF では、キーを渡す参照が作成されます。 KEY では、型参照を持つ式のキー部分が抽出されます。
例:
SELECT VALUE Key(CreateRef(AdventureWorksEntities.Product, row(p.ProductID)))
FROM AdventureWorksEntities.Product AS p
Output:
| ProductID |
|---|
| 980 |
| 365 |
| 771 |
| ... |
関数
正規
正規関数の名前空間は Edm で、Edm.Length("string") のように使用されます。 正規関数と同じ名前の関数を含んでいる別の名前空間がインポートされない限り、名前空間を指定する必要はありません。 2 つの名前空間に同じ関数が存在する場合は、ユーザーは完全な名前を指定する必要があります。
例:
SELECT Length(c. FirstName) AS NameLen FROM
AdventureWorksEntities.Contact AS c
WHERE c.ContactID BETWEEN 10 AND 12
Output:
| NameLen |
|---|
| 6 |
| 6 |
| 5 |
Microsoft プロバイダー固有
Microsoft プロバイダー固有の関数は、SqlServer 名前空間にあります。
例:
SELECT SqlServer.LEN(c.EmailAddress) AS EmailLen FROM
AdventureWorksEntities.Contact AS c WHERE
c.ContactID BETWEEN 10 AND 12
Output:
| EmailLen |
|---|
| 27 |
| 27 |
| 26 |
名前空間
USING では、クエリ式で使用する名前空間を指定します。
例:
using SqlServer; LOWER('AA');
Output:
| [値] |
|---|
| aa |
ページング
ページングは、ORDER BY 句に対して SKIP および LIMIT サブ句を宣言することによって表すことができます。
例:
SELECT c.ContactID as ID, c.LastName AS Name FROM
AdventureWorks.Contact AS c ORDER BY c.ContactID SKIP 9 LIMIT 3;
Output:
| ID | 名前 |
|---|---|
| 10 | Adina |
| 11 | Agcaoili |
| 12 | Aguilar |
グループ化
GROUPING BY では、クエリ (SELECT) 式によって返されるオブジェクトをグループ化するよう指定します。
例:
SELECT VALUE name FROM AdventureWorksEntities.Product AS P
GROUP BY P.Name HAVING MAX(P.ListPrice) > 5
Output:
| name |
|---|
| LL Mountain Seat Assembly |
| ML Mountain Seat Assembly |
| HL Mountain Seat Assembly |
| ... |
ナビゲーション
リレーションシップ ナビゲーション操作を使用すると、開始側のエンティティと終了側のエンティティ間のリレーションシップをナビゲートできます。 NAVIGATE では、<名前空間>.<リレーションシップ型名> として修飾されるリレーションシップ型が取得されます。 終了側のカーディナリティが 1 の場合、Ref<T> が返されます。 終了側のカーディナリティが n の場合、Collection<Ref<T>> が返されます。
例:
SELECT a.AddressID, (SELECT VALUE DEREF(v) FROM
NAVIGATE(a, AdventureWorksModel.FK_SalesOrderHeader_Address_BillToAddressID) AS v)
FROM AdventureWorksEntities.Address AS a
Output:
| AddressID |
|---|
| 1 |
| 2 |
| 3 |
| ... |
SELECT VALUE AND SELECT
SELECT VALUE
Entity SQL には、暗黙の行の構築をスキップする SELECT VALUE 句が用意されています。 SELECT VALUE 句には 1 つの項目のみを指定できます。 このような句を使用した場合、SELECT 句内の項目には row ラッパーは構築されず、SELECT VALUE a などの目的の構造を持つコレクションを作成できます。
例:
SELECT VALUE p.Name FROM AdventureWorksEntities.Product AS p
Output:
| 名前 |
|---|
| Adjustable Race |
| All-Purpose Bike Stand |
| AWC Logo Cap |
| ... |
SELECT
Entity SQL には、任意の行を構築するための行コンストラクターも用意されています。 SELECT は、投影内の 1 つまたは複数の要素、および SELECT a, b, c などのフィールドを持つデータ レコードの結果を取得します。
例:
SELECT p.Name, p.ProductID FROM AdventureWorksEntities.Product as p Output:
| 名前 | ProductID |
|---|---|
| Adjustable Race | 1 |
| All-Purpose Bike Stand | 879 |
| AWC Logo Cap | 712 |
| ... | ... |
CASE 式
CASE 式では、一連のブール式が評価されて結果が判定されます。
例:
CASE WHEN AVG({25,12,11}) < 100 THEN TRUE ELSE FALSE END
Output:
| [値] |
|---|
| true |