Referência rápida do Entity SQL

Este tópico fornece uma referência rápida às consultas Entity SQL. As consultas neste tópico são baseadas no modelo de vendas da AdventureWorks.

Literais

String

Existem literais de cadeia de caracteres Unicode e não-Unicode. As cadeias de caracteres Unicode são precedidas de N. Por exemplo, N'hello'.

A seguir está um exemplo de um literal de cadeia de caracteres não-Unicode:

'hello'
--same as
"hello"

Saída:

DateTime

Nos literais DateTime, as partes de data e hora são obrigatórias. Não há valores padrão.

Exemplo:

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

Saída:

Número inteiro

Os literais inteiros podem ser do tipo Int32 (123), UInt32 (123U), Int64 (123L) e UInt64 (123UL).

Exemplo:

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

Saída:

Outro

Outros literais suportados pelo Entity SQL são Guid, Binary, Float/Double, Decimal e null. Literais nulos no Entity SQL são considerados compatíveis com todos os outros tipos no modelo conceitual.

Type Construtores

LINHA

ROW constrói um valor anônimo, estruturalmente tipado (registro) como em: ROW(1 AS myNumber, 'Name' AS myName).

Exemplo:

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

Saída:

MULTISET

MULTISET constrói coleções, tais como:

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

Exemplo:

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

Saída:

Object

Named Type Constructor constrói (nomeado) objetos definidos pelo usuário, como person("abc", 12).

Exemplo:

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

Saída:

Referências

REFª

REF cria uma referência a uma instância de tipo de entidade. Por exemplo, a consulta a seguir retorna referências a cada entidade Order no conjunto de entidades Orders:

SELECT REF(o) AS OrderID FROM Orders AS o

Saída:

O exemplo a seguir usa o operador de extração de propriedade (.) para acessar uma propriedade de uma entidade. Quando o operador de extração de propriedade é usado, a referência é automaticamente desreferenciada.

Exemplo:

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

Saída:

DEREF

DEREF desreferencia um valor de referência e produz o resultado dessa desreferência. Por exemplo, a consulta a seguir produz as entidades Order para cada Order no conjunto de entidades Orders: SELECT DEREF(o2.r) FROM (SELECT REF(o) AS r FROM LOB.Orders AS o) AS o2..

Exemplo:

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

Saída:

CREATEREF E CHAVE

CREATEREF cria uma referência passando uma chave. KEY extrai a parte chave de uma expressão com referência de tipo.

Exemplo:

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

Saída:

Funções

Canónico

O namespace para funções canônicas é Edm, como em Edm.Length("string"). Não é necessário especificar o namespace, a menos que outro namespace seja importado e contenha uma função com o mesmo nome de uma função canônica. Se dois namespaces tiverem a mesma função, o usuário deverá especificar o nome completo.

Exemplo:

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

Saída:

Específico do provedor da Microsoft

As funções específicas do provedor da Microsoft estão no SqlServer namespace.

Exemplo:

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

Saída:

Espaços de nomes

USING especifica namespaces usados em uma expressão de consulta.

Exemplo:

using SqlServer; LOWER('AA');

Saída:

Paginação

A paginação pode ser expressa declarando uma subcláusula SKIP e LIMIT para a cláusula ORDER BY .

Exemplo:

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

Saída:

Agrupamento

GROUPING BY especifica grupos nos quais os objetos retornados por uma expressão de consulta (SELECT) devem ser colocados.

Exemplo:

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

Saída:

Navegação

O operador de navegação de relacionamento permite que você navegue sobre o relacionamento de uma entidade (de fim) para outra (de fim). NAVIGATE usa o tipo de relacionamento qualificado como <namespace>.<nome> do tipo de relacionamento. Navigate retorna Ref<T> se a cardinalidade do fim for 1. Se a cardinalidade do fim for n, a Ref<T>> da coleção<será devolvida.

Exemplo:

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

Saída:

SELECIONE O VALOR E SELECIONE

SELECIONAR VALOR

O Entity SQL fornece a cláusula SELECT VALUE para ignorar a construção de linha implícita. Apenas um item pode ser especificado em uma cláusula SELECT VALUE. Quando tal cláusula é usada, nenhum wrapper de linha é construído em torno dos itens na cláusula SELECT, e uma coleção da forma desejada pode ser produzida, por exemplo: SELECT VALUE a.

Exemplo:

SELECT VALUE p.Name FROM AdventureWorksEntities.Product AS p

Saída:

SELECIONAR

Entity SQL também fornece o construtor de linha para construir linhas arbitrárias. SELECT usa um ou mais elementos na projeção e resulta em um registro de dados com campos, por exemplo: SELECT a, b, c.

Exemplo:

SELECT p.Name, p.ProductID FROM AdventureWorksEntities.Product como p Saída:

EXPRESSÃO DE CASO

A expressão de caso avalia um conjunto de expressões booleanas para determinar o resultado.

Exemplo:

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

Saída:

Consulte também

• Referência SQL de entidade
• Visão geral do SQL de entidade