TOP (Entity SQL)

La cláusula SELECT puede tener una subcláusula TOP opcional después del modificador opcional ALL/DISTINCT. La subcláusula TOP especifica que sólo se devolverá el primer conjunto de filas del resultado de la consulta.

[ TOP (n) ]

Argumentos

  • n
    Expresión numérica que especifica el número de filas que se va a devolver. n puede ser un literal numérico único o un parámetro único.

Comentarios

La expresión TOP debe ser un literal numérico único o un parámetro único. Si se utiliza un literal constante, el tipo de literal debe poderse promocionar implícitamente a Edm.Int64 (byte, int16, int32 o int64, o cualquier tipo de proveedor que se asigna a un tipo que se puede promocionar a Edm.Int64) y su valor debe ser igual o mayor que cero. De lo contrario, se producirá una excepción. Si un parámetro se utiliza como una expresión, el tipo de parámetro también debe poderse promocionar implícitamente a Edm.Int64, pero no habrá ninguna validación del valor de parámetro real durante la compilación porque los valores de parámetro se enlazan en tiempo de ejecución.

El siguiente es un ejemplo de expresión TOP constante:

select distinct top(10) c.a1, c.a2 from T as a

El siguiente es un ejemplo de expresión TOP constante con parámetros:

select distinct top(@topParam) c.a1, c.a2 from T as a

TOP es no determinista a menos que la consulta esté ordenada. Si necesita un resultado determinista, utilice las subcláusulas SKIP y LIMIT en la cláusula ORDER BY. TOP y SKIP/LIMIT se excluyen mutuamente.

Vea también

Referencia

SELECT (Entity SQL)
SKIP (Entity SQL)
LIMIT (Entity SQL)
ORDER BY (Entity SQL)

Conceptos

Referencia de Entity SQL