Typdefinitionen (Entity SQL)

  • Artikel

Eine Typdefinition wird in der Deklarationsanweisung einer Entity SQL-Inlinefunktion verwendet.

Bemerkungen

Die Deklarationsanweisung für eine Inlinefunktion besteht aus dem FUNKTIONS-Schlüsselwort gefolgt von dem Bezeichner, der den Funktionsnamen darstellt (z. B. „MyAvg“) gefolgt von einer Parameterdefinitionsliste in Klammern (z. B. „dues Collection(Decimal)“).

Die Parameterdefinitionsliste besteht aus 0 (null) oder mehreren Parameterdefinitionen. Jede Parameterdefinition besteht aus einem von einer Typdefinition (z. B. "Auflistung (Decimal)") gefolgten Bezeichner (der Name des Parameters der Funktion, z. B. "Gebühren").

Dies sind die zulässigen Typdefinitionen:

  • Der Typ des Bezeichners (z. B. "Int32" oder "AdventureWorks.Order").

  • Das COLLECTION-Schlüsselwort, das von einer anderen Typdefinition in Klammern gefolgt wird (z. B. "Collection(AdventureWorks.Order)").

  • Das von einer Liste von Eigenschaftendefinitionen in Klammern (z. B. "Row(x AdventureWorks.Order))" gefolgte ROW-Schlüsselwort. Eigenschaftendefinitionen besitzen Formate wie z. B. „identifier type_definition, identifier type_definition, ...“.

  • Das vom Typ des Bezeichners in Klammern (z. B. "Ref(AdventureWorks.Order)") gefolgte REF-Schlüsselwort. Der REF-Typdefinitionsoperator erfordert einen Entitätstyp als Argument. Sie können keinen primitiven Typ als Argument angeben.

Sie können Typdefinitionen auch schachteln (z. B., "Collection(Row(x Ref(AdventureWorks.Order)))").

Die Typdefinitionsoptionen lauten folgendermaßen:

  • IdentifierName supported_type oder

  • IdentifierName COLLECTION(type_definition) oder

  • IdentifierName ROW(property_definition) oder

  • IdentifierName REF(supported_entity_type)

Die Eigenschaftendefinitionsoption ist IdentifierName type_definition.

Unterstützte Typen sind alle Typen im aktuellen Namespace. Diese schließen sowohl primitive Typen als auch Entitätstypen ein.

Unterstützte Entitätstypen verweisen im aktuellen Namespace nur auf Entitätstypen. Sie schließen keine primitiven Typen ein.

Beispiele

Im folgenden Beispiel wird eine einfache Typdefinition dargestellt.

USING Microsoft.Samples.Entity
Function MyRound(p1 EDM.Decimal) AS (
   Round(p1)
)
MyRound(CAST(1.7 as EDM.Decimal))

Dies ist ein Beispiel für eine COLLECTION-Typdefinition.

USING Microsoft.Samples.Entity
Function MyRound(p1 Collection(EDM.Decimal)) AS (
   Select Round(p1) from p1
)
MyRound({CAST(1.7 as EDM.Decimal), CAST(2.7 as EDM.Decimal)})

Dies ist ein Beispiel für eine ROW-Typdefinition.

USING Microsoft.Samples.Entity
Function MyRound(p1 Row(x EDM.Decimal)) AS (
   Round(p1.x)
)
select MyRound(row(a as x)) from {CAST(1.7 as EDM.Decimal), CAST(2.7 as EDM.Decimal)} as a

Dies ist ein Beispiel für eine REF-Typdefinition.

USING Microsoft.Samples.Entity
Function UnReference(p1 Ref(AdventureWorks.Order)) AS (
   Deref(p1)
)
select Ref(x) from AdventureWorksEntities.SalesOrderHeaders as x

Siehe auch