Share via


elemento fetch

El elemento raíz de una consulta FetchXml.

Aprender a consultar datos mediante FetchXml.

Ejemplo

<fetch>
  <entity name='account' />
</fetch>

Atributos

Name ¿Obligatorio? Descripción
aggregate No Valor booleano para especificar que la consulta devuelve valores agregados. Obtener información acerca de la agregación de datos
aggregatelimit No Establezca un límite por debajo del límite agregado estándar de 50.000 registros. Más información acerca de los límites de agregación
count No Valor entero positivo para especificar el número de registros que se devolverán en una página. Obtenga más información sobre los resultados de paginación
datasource No Cuando use la retención de datos de Dataverse a largo plazo, establezca datasource en 'retained' para indicar que la consulta es solo para filas retenidas. Más información sobre la retención de datos a largo plazo de Dataverse
distinct No Valor booleano para especificar que las filas duplicadas no se incluyan en los resultados. Más información sobre la devolución de resultados distintos
latematerialize No Valor booleano para dividir la consulta en partes más pequeñas y volver a ensamblar los resultados antes de devolverlos. El uso de latematerialize podría mejorar el rendimiento de algunas consultas de larga duración. Más información sobre el uso de la consulta de materialización tardía.
no-lock No Configuración heredada para evitar bloqueos compartidos en registros. Ya no es necesario.
options No Un valor de cadena para aplicar una o más optimizaciones de SQL. Ver Opciones
page No Valor entero positivo para especificar el número de página a devolver. Obtenga más información sobre los resultados de paginación.
paging-cookie No Valor de cadena de una página anterior de datos para que la recuperación de la siguiente página de datos sea más eficiente. Obtenga más información sobre los resultados de paginación.
returntotalrecordcount No Valor booleano para especificar si se devuelve el número total de registros que coinciden con los criterios. Aprenda cómo contar filas mediante FetchXml
top No Valor entero positivo para especificar el número de registros que se devolverán.
Este valor no puede superar 5000.
No use top junto con los atributos page, count o returntotalrecordcount.
Más información sobre cómo limitar el número de filas
useraworderby No Valor booleano para especificar que la clasificación de datos de la columna de elección debe Usar el modo Orden sin procesar por. Esto ordena las opciones de elección por el valor entero. Sin esto, el valor predeterminado es ordenar las columnas de opciones utilizando los valores de las etiquetas de opciones.

Elementos secundarios

Nombre Repeticiones Descripción
entidad 1 Especifica el elemento secundario de un elemento de fetch, el 'elemento principal' de la consulta. Solo se permite una entidad.

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).

Opciones

Importante

Aplique estas opciones únicamente cuando lo recomiende el soporte técnico de Microsoft. El uso incorrecto de estas opciones puede dañar el rendimiento de una consulta.

Utilice estos valores con el atributo options para especificar sugerencias de SQL Server para aplicar a la consulta. Cuando se configura más de una opción, sepárelas con comas.

options='OptimizeForUnknown,DisableRowGoal,Recompile'
Opción FetchXML Sugerencia de SQL Server
OptimizeForUnknown Optimizar para desconocido
ForceOrder Forzar orden
DisableRowGoal Sugerencia: DISABLE_OPTIMIZER_ROWGOAL
EnableOptimizerHotfixes Sugerencia: ENABLE_QUERY_OPTIMIZER_HOTFIXES
LoopJoin Combinación de bucle
MergeJoin Combinación de mezcla
HashJoin Combinación hash
NO_PERFORMANCE_SPOOL NO_PERFORMANCE_SPOOL
ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS Sugerencia: ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS

Más información: Sugerencias (Transact-SQL) - Consulta