Referencia rápida de Entity SQL
En este tema, se proporciona una referencia rápida a las consultas de Entity SQL. Las consultas de este tema se basan en el modelo AdventureWorks Sales.
Literales
String
Hay literales de cadenas de caracteres Unicode y no Unicode. Las cadenas Unicode van precedidas de una N. Por ejemplo, N'hello'.
A continuación se incluye un ejemplo de un literal de cadena no Unicode:
'hello'
--same as
"hello"
Salida:
| Valor |
|---|
| hello |
DateTime
En los literales DateTime, las partes de fecha y hora son obligatorias. No hay valores predeterminados.
Ejemplo:
DATETIME '2006-12-25 01:01:00.000'
--same as
DATETIME '2006-12-25 01:01'
Salida:
| Valor |
|---|
| 25.12.06 01:01:00 |
Entero
Los literales enteros pueden ser de tipo Int32 (123), UInt32 (123U), Int64 (123L) y UInt64 (123UL).
Ejemplo:
--a collection of integers
{1, 2, 3}
Salida:
| Valor |
|---|
| 1 |
| 2 |
| 3 |
Otros
Los literales Other que admite Entity SQL son Guid, Binary, Float/Double, Decimal y null. Los literales NULL en Entity SQL se consideran compatibles con todos los demás tipos del modelo conceptual.
Constructores de tipos
ROW
ROW construye un valor (registro) escrito de tipo estructural como en: ROW(1 AS myNumber, 'Name' AS myName).
Ejemplo:
SELECT VALUE row (product.ProductID AS ProductID, product.Name
AS ProductName) FROM AdventureWorksEntities.Product AS product
Salida:
| ProductID | Nombre |
|---|---|
| 1 | Adjustable Race |
| 879 | All-Purpose Bike Stand |
| 712 | AWC Logo Cap |
| ... | ... |
MULTISET
MULTISET construye colecciones, como:
MULTISET(1,2,2,3) --same as-{1,2,2,3}.
Ejemplo:
SELECT VALUE product FROM AdventureWorksEntities.Product AS product WHERE product.ListPrice IN MultiSet (125, 300)
Salida:
| ProductID | Nombre | ProductNumber | … |
|---|---|---|---|
| 842 | Touring-Panniers, Large | PA-T100 | … |
Object
El constructor de tipos con nombre construye objetos definidos por el usuario (con nombre), como person("abc", 12).
Ejemplo:
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
Salida:
| SalesOrderDetailID | CarrierTrackingNumber | OrderQty | ProductID | ... |
|---|---|---|---|---|
| 1 | 4911-403C-98 | 1 | 776 | ... |
| 2 | 4911-403C-98 | 3 | 777 | ... |
| ... | ... | ... | ... | ... |
Referencias
REF
REF crea una referencia a una instancia de tipo de entidad. Por ejemplo, la consulta siguiente devuelve referencias a cada entidad Order en el conjunto de entidades Orders:
SELECT REF(o) AS OrderID FROM Orders AS o
Salida:
| Valor |
|---|
| 1 |
| 2 |
| 3 |
| ... |
En el ejemplo siguiente se usa el operador de extracción de propiedades (.) para tener acceso a una propiedad de una entidad. Cuando se utiliza el operador de extracción de propiedades, la referencia se desreferencia automáticamente.
Ejemplo:
SELECT VALUE REF(p).Name FROM
AdventureWorksEntities.Product AS p
Salida:
| Valor |
|---|
| Adjustable Race |
| All-Purpose Bike Stand |
| AWC Logo Cap |
| ... |
DEREF
DEREF desreferencia un valor de referencia y genera el resultado de dicha eliminación. Por ejemplo, la consulta siguiente genera las entidades Order para cada entidad Order en el conjunto de entidades Orders: SELECT DEREF(o2.r) FROM (SELECT REF(o) AS r FROM LOB.Orders AS o) AS o2.
Ejemplo:
SELECT VALUE DEREF(REF(p)).Name FROM
AdventureWorksEntities.Product AS p
Salida:
| Valor |
|---|
| Adjustable Race |
| All-Purpose Bike Stand |
| AWC Logo Cap |
| ... |
CREATEREF y KEY
CREATEREF crea una referencia con el paso de una clave. KEY extrae la parte de clave de una expresión con referencia de tipos.
Ejemplo:
SELECT VALUE Key(CreateRef(AdventureWorksEntities.Product, row(p.ProductID)))
FROM AdventureWorksEntities.Product AS p
Salida:
| ProductID |
|---|
| 980 |
| 365 |
| 771 |
| ... |
Functions
Canonical
El espacio de nombres para las funciones canónicas es Edm, como en Edm.Length("string"). No es necesario especificar el espacio de nombres a no ser que se importe otro espacio de nombres que contenga una función con el mismo nombre que una función canónica. Si dos espacios de nombres tienen la misma función, el usuario debe especificar el nombre completo.
Ejemplo:
SELECT Length(c. FirstName) AS NameLen FROM
AdventureWorksEntities.Contact AS c
WHERE c.ContactID BETWEEN 10 AND 12
Salida:
| NameLen |
|---|
| 6 |
| 6 |
| 5 |
Específicas de proveedores de Microsoft
Las funciones específicas de proveedores de Microsoft están en el espacio de nombres SqlServer.
Ejemplo:
SELECT SqlServer.LEN(c.EmailAddress) AS EmailLen FROM
AdventureWorksEntities.Contact AS c WHERE
c.ContactID BETWEEN 10 AND 12
Salida:
| EmailLen |
|---|
| 27 |
| 27 |
| 26 |
Espacios de nombres
USING especifica los espacios de nombres que se usan en una expresión de consulta.
Ejemplo:
using SqlServer; LOWER('AA');
Salida:
| Valor |
|---|
| aa |
Paginación
La paginación se puede expresar mediante la declaración de las subcláusulas SKIP y LIMIT a la cláusula ORDER BY.
Ejemplo:
SELECT c.ContactID as ID, c.LastName AS Name FROM
AdventureWorks.Contact AS c ORDER BY c.ContactID SKIP 9 LIMIT 3;
Salida:
| id | Nombre |
|---|---|
| 10 | Adina |
| 11 | Agcaoili |
| 12 | Aguilar |
Agrupar
GROUPING BY especifica los grupos en los que se van a colocar los objetos devueltos por una expresión de consulta (SELECT).
Ejemplo:
SELECT VALUE name FROM AdventureWorksEntities.Product AS P
GROUP BY P.Name HAVING MAX(P.ListPrice) > 5
Salida:
| name |
|---|
| LL Mountain Seat Assembly |
| ML Mountain Seat Assembly |
| HL Mountain Seat Assembly |
| ... |
Navegación
El operador de navegación por relaciones permite navegar por la relación de un tipo de entidad (extremo inicial) a otro (extremo final). NAVIGATE toma el tipo de relación calificado como <espacio de nombres>.<nombre de tipo de relación>. Navigate devuelve Ref<T> si la cardinalidad del extremo final es 1. Si la cardinalidad del extremo final es n, se devolverá Collection<Ref<T>>.
Ejemplo:
SELECT a.AddressID, (SELECT VALUE DEREF(v) FROM
NAVIGATE(a, AdventureWorksModel.FK_SalesOrderHeader_Address_BillToAddressID) AS v)
FROM AdventureWorksEntities.Address AS a
Salida:
| AddressID |
|---|
| 1 |
| 2 |
| 3 |
| ... |
SELECT VALUE y SELECT
SELECT VALUE
Entity SQL proporciona la cláusula SELECT VALUE para omitir la creación de filas implícitas. Solo se puede especificar un elemento en una cláusula SELECT VALUE. Cuando se utiliza este tipo de cláusula, no se construye ningún contenedor de filas en torno a los elementos de la cláusula SELECT y se puede generar una colección de la forma deseada, por ejemplo: SELECT VALUE a.
Ejemplo:
SELECT VALUE p.Name FROM AdventureWorksEntities.Product AS p
Salida:
| Nombre |
|---|
| Adjustable Race |
| All-Purpose Bike Stand |
| AWC Logo Cap |
| ... |
SELECT
Entity SQL también proporciona el constructor de filas para construir filas arbitrarias. SELECT toma uno o más elementos en la proyección y devuelve un registro de datos con campos, por ejemplo: SELECT a, b, c.
Ejemplo:
SELECT p.Name, p.ProductID FROM AdventureWorksEntities.Product as p Output:
| Nombre | ProductID |
|---|---|
| Adjustable Race | 1 |
| All-Purpose Bike Stand | 879 |
| AWC Logo Cap | 712 |
| ... | ... |
EXPRESIÓN CASE
La expresión case evalúa un conjunto de expresiones booleanas para determinar el resultado.
Ejemplo:
CASE WHEN AVG({25,12,11}) < 100 THEN TRUE ELSE FALSE END
Salida:
| Valor |
|---|
| true |