fetch 요소

FetchXml 쿼리의 루트 요소입니다.

FetchXml을 사용하여 데이터를 쿼리하는 방법을 알아봅니다.

Example

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

Attributes

이름	필수?	Description
aggregate	아니오	쿼리가 집계 값을 반환하도록 지정하는 부울 값입니다. 데이터 집계에 대해 알아보기
aggregatelimit	아니오	표준 50,000 레코드 집계 제한 이하로 제한을 설정합니다. 집계 제한에 대해 알아보기
count	아니오	페이지에서 반환할 레코드 수를 지정하는 양의 정수 값입니다. 페이징 결과에 대해 알아보기
datasource	아니오	Dataverse 장기 데이터 보존을 사용하는 경우 쿼리가 보존된 행에만 해당함을 나타내도록 'retained' 설정합니다datasource. Dataverse 장기 데이터 보존에 대해 자세히 알아보기
distinct	아니오	중복 행이 결과에 포함되지 않도록 지정하는 부울 값입니다. 고유한 결과를 반환하는 방법에 대해 자세히 알아보기
latematerialize	아니오	쿼리를 더 작은 부분으로 분할하고 결과를 반환하기 전에 다시 어셈블하도록 지시하는 부울 값입니다. 사용하면 latematerialize 일부 장기 실행 쿼리의 성능이 향상될 수 있습니다. Late Materialize 쿼리를 사용하는 방법에 대해 자세히 알아봅니다.
no-lock	아니오	레코드에 대한 공유 잠금을 방지하기 위한 레거시 설정입니다. 더 이상 필요하지 않습니다.
options	아니오	하나 이상의 SQL 최적화를 적용할 문자열 값입니다. 옵션 참조
page	아니오	반환할 페이지 번호를 지정하는 양의 정수 값입니다. 페이징 결과에 대해 알아보기
paging-cookie	아니오	데이터의 다음 페이지를 보다 효율적으로 검색할 수 있도록 이전 데이터 페이지의 문자열 값입니다. 페이징 결과에 대해 알아보기
returntotalrecordcount	아니오	조건과 일치하는 총 레코드 수가 반환되는지 여부를 지정하는 부울 값입니다. FetchXml을 사용하여 행 수를 계산하는 방법 알아보기
top	아니오	반환할 레코드 수를 지정하는 양의 정수 값입니다. 이 값은 5,000을 초과할 수 없습니다. 또는 countreturntotalrecordcount 특성과 page함께 사용하지 top 마세요. 행 수 제한에 대해 자세히 알아보기
useraworderby	아니오	선택 열 데이터 정렬을 지정하는 부울 값은 원시 순서 기준 모드를 사용해야 합니다. 그러면 선택 옵션이 정수 값으로 정렬됩니다. 이 값이 없으면 기본값은 선택 레이블 값을 사용하여 선택 열을 정렬하는 것입니다.

자식 요소

이름	발생	Description
실체	1	fetch 요소의 자식 요소인 쿼리의 '부모 엔터티'를 지정합니다. 하나의 엔터티만 허용됩니다.

Options

중요합니다

Microsoft 기술 지원에서 권장하는 경우에만 이러한 옵션을 적용합니다. 이러한 옵션을 잘못 사용하면 쿼리 성능이 손상됩니다.

특성과 함께 이러한 값을 사용하여 쿼리에 options 적용할 SQL Server 힌트를 지정합니다. 둘 이상의 옵션이 설정되면 쉼표로 구분합니다.

options='HashJoin,DisableRowGoal'

쿼리 옵션	SQL Server 힌트
ForceOrder	강제 순서
DisableRowGoal	힌트: DISABLE_OPTIMIZER_ROWGOAL
EnableOptimizerHotfixes	힌트: ENABLE_QUERY_OPTIMIZER_HOTFIXES
LoopJoin	루프 조인
MergeJoin	병합 조인
HashJoin	해시 조인
NO_PERFORMANCE_SPOOL	NO_PERFORMANCE_SPOOL
ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS	힌트: ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS

추가 정보: 힌트(Transact-SQL) - 쿼리