Forma de los árboles de comandos

El módulo de generación de SQL es responsable de la generación de una consulta SQL back-end específica en función de una expresión determinada del árbol de comandos de consulta de entrada. En esta sección se describen las características, propiedades y estructura de los árboles de comandos de consulta.

Información general de los árboles de comandos de consulta

Un árbol de comandos de consulta es una representación del modelo de objetos de una consulta. Los árboles de comandos de consulta sirven para dos fines:

• Expresar una consulta de entrada que se especifica para Entity Framework .

• Expresar una consulta de salida que se proporciona a un proveedor y describe una consulta para el back-end.

Los árboles de comandos de consulta admiten una semántica más enriquecida que las consultas conformes a SQL:1999, incluso permiten trabajar con colecciones anidadas y operaciones de tipo, como por ejemplo comprobar si una entidad corresponde a un tipo determinado o filtrar conjuntos en función de un tipo.

La propiedad DBQueryCommandTree.Query es la raíz del árbol de expresiones que describe la lógica de la consulta. La propiedad DBQueryCommandTree.Parameters contiene una lista de parámetros que se utilizan en la consulta. El árbol de expresiones está compuesto por objetos DbExpression.

Un objeto DbExpression representa algún cálculo. Entity Framework proporciona varios tipos de expresiones para crear expresiones de consulta, incluidos constantes, variables, funciones, constructores y operadores relacionales estándar como el filtro y la combinación. Cada objeto DbExpression tiene una propiedad ResultType que representa el tipo del resultado generado por la expresión. Este tipo se expresa como TypeUsage.

Formas del árbol de comandos de consulta de salida

Los árboles de comandos de consulta de salida representan consultas relacionales (SQL) y cumplen reglas mucho más estrictas que las que se aplican a los árboles de comandos de consulta. Por lo general contienen estructuras que se traducen con facilidad a SQL.

Los árboles de comandos de entrada se expresan con respecto al modelo conceptual, que admite propiedades de navegación, asociaciones entre entidades y herencia. Los árboles de comandos de salida se expresan con respecto al modelo de almacenamiento. Los árboles de comandos de entrada permiten proyectar colecciones anidadas, pero los árboles de comandos de salida no lo permiten.

Los árboles de comandos de consulta de salida se crean utilizando un subconjunto de los objetos DbExpression disponibles e incluso algunas expresiones en este subconjunto tienen un uso restringido.

Las operaciones de tipo, como por ejemplo comprobar si una expresión determinada es de un tipo concreto o filtrar conjuntos en función de un tipo, no se encuentran en los árboles de comandos de salida.

En los árboles de comandos de salida, solo se usan expresiones que devuelven valores booleanos para las proyecciones y únicamente en predicados de expresiones que requieren un predicado, como una instrucción de filtro o una instrucción CASE.

La raíz de un árbol de comandos de consulta de salida es un objeto DbProjectExpression.

Tipos de expresión que no están presentes en el árbol de comandos de consulta de salida

Los siguientes tipos de expresión no son válidos en un árbol de comandos de consulta de salida y no necesitan ser controlados por proveedores:

DbDerefExpression

DbEntityRefExpression

DbRefKeyExpression

DbIsOfExpression

DbOfTypeExpression

DbRefExpression

DbRelationshipNavigationExpression

DbTreatExpression

Restricciones y notas de las expresiones

Muchas expresiones solo se pueden utilizar de una manera restringida en los árboles de comandos de consulta de salida:

DbFunctionExpression

Se pueden pasar los siguientes tipos de función:

• Funciones canónicas que se reconocen en el espacio de nombres Edm.

• Funciones integradas (almacén) que se reconocen en BuiltInAttribute.

• Funciones definidas por el usuario.

Las funciones canónicas (vea Funciones canónicas (Entity SQL) para obtener más información) se especifican como parte de Entity Framework y los proveedores deben proporcionar implementaciones para las funciones canónicas basadas en estas especificaciones. Las funciones de almacén se basan en las especificaciones del manifiesto de proveedor correspondiente. Las funciones definidas por el usuario se basan en especificaciones de SSDL.

Además, las funciones con el atributo NiladicFunction no tienen ningún argumento y se deben traducir sin el paréntesis al final. Es decir, <nombreDeFunción> en lugar de <nombreDeFunción>().

DbNewInstanceExpression

DbNewInstanceExpression solo se puede producir en los dos casos siguientes:

• Como la propiedad de proyección de DbProjectExpression. Cuando se utiliza de esta forma, se aplican las siguientes restricciones:

  • El tipo de resultado debe ser un tipo de fila.

  • Cada uno de sus argumentos es una expresión que genera un resultado con un tipo primitivo. Normalmente, cada argumento es una expresión escalar, como PropertyExpression en DbVariableReferenceExpression, una invocación de función o un cálculo aritmético de DbPropertyExpression en DbVariableReferenceExpression o una invocación de función. Sin embargo, una expresión que representa una subconsulta escalar también se puede producir en la lista de argumentos para DbNewInstanceExpression. Una expresión que representa una subconsulta escalar es un árbol de expresión que representa una subconsulta que devuelve exactamente una fila y una columna de un tipo primitivo con una raíz de objeto DbElementExperession.

• Con un tipo de valor devuelto de colección, en cuyo caso define una nueva colección de las expresiones proporcionadas como argumentos.

DbVariableReferenceExpression

DbVariableReferenceExpression tiene que ser un elemento secundario del nodo DbPropertyExpression.

DbGroupByExpression

La propiedad Aggregates de DbGroupByExpression solo puede tener elementos de tipo DbFunctionAggregate. No hay ningún otro tipo de agregado.

DbLimitExpression

La propiedad Limite solo puede ser DbConstantExpression o DbParameterReferenceExpression. Además, el valor de la propiedad WithTies es siempre false a partir de la versión 3.5 de .NET Framework.

DbScanExpression

Cuando se utiliza en árboles de comandos de salida, DbScanExpression representa eficazmente una búsqueda en una tabla, una vista o una consulta de almacén, representadas por EnitySetBase::Target.

Si la propiedad de metadatos de consulta de definición del destino no es NULL, representa una consulta, cuyo texto de consulta se proporciona en la propiedad de metadatos del lenguaje (o dialecto) específico del proveedor, tal como se especifica en la definición de esquemas de almacenamiento.

De lo contrario, el destino representa una tabla o una vista. Su prefijo de esquema se encuentra en la propiedad de metadatos "Schema", si no es NULL, o de lo contrario es el nombre del contenedor de entidades. El nombre de tabla o vista es la propiedad de metadatos "Table", si no es NULL, o de lo contrario es la propiedad Name de la base del conjunto de entidades.

Todas estas propiedades proceden de la definición del elemento EntitySet correspondiente en el archivo de definición de esquemas de almacenamiento (SSDL).

Usar tipos primitivos

Cuando se hace referencia a los tipos primitivos en los árboles de comandos de salida, normalmente se hace referencia a ellos en los tipos primitivos del modelo conceptual. Sin embargo, para ciertas expresiones, los proveedores necesitan el tipo primitivo de almacén correspondiente. Entre los ejemplos de estas expresiones se encuentran DbCastExpression y posiblemente DbNullExpression, si el proveedor necesita convertir el valor NULL al tipo correspondiente. En estos casos, los proveedores deben realizar la asignación al tipo de proveedor en función de la clase del tipo primitivo y sus facetas.

Vea también

Conceptos

Generación de SQL