elemento fetch

O elemento raiz de uma consulta FetchXml.

Saiba como consultar dados usando FetchXml.

Example

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

Attributes

Nome	Obrigatório?	Description
aggregate	Não	Valor booliano para especificar que a consulta retorna valores agregados. Saiba mais sobre a agregação de dados
aggregatelimit	Não	Defina um limite abaixo do limite de agregação de registro padrão de 50.000. Saiba mais sobre os limites de agregação
count	Não	Valor inteiro positivo para especificar o número de registros a serem retornados em uma página. Saiba mais sobre os resultados da paginação
datasource	Não	Ao usar a retenção de dados de longo prazo do Dataverse, defina datasource para 'retained' indicar que a consulta é somente para linhas retidas. Saiba mais sobre a retenção de dados de longo prazo do Dataverse
distinct	Não	Valor booliano para especificar que linhas duplicadas não sejam incluídas nos resultados. Saiba mais sobre como retornar resultados distintos
latematerialize	Não	Valor booliano para direcionar a consulta a ser dividida em partes menores e remontar os resultados antes de devolvê-los. O uso latematerialize pode melhorar o desempenho de algumas consultas de execução prolongada. Saiba mais sobre como usar a consulta Late Materialize.
no-lock	Não	Configuração herdada para impedir bloqueios compartilhados em registros. Não é mais necessário.
options	Não	Um valor de cadeia de caracteres para aplicar uma ou mais otimizações de SQL. Ver Opções
page	Não	Valor inteiro positivo para especificar o número de página a ser retornado. Saiba mais sobre os resultados da paginação
paging-cookie	Não	Valor da cadeia de caracteres de uma página anterior de dados para tornar a recuperação da próxima página de dados mais eficiente. Saiba mais sobre os resultados da paginação
returntotalrecordcount	Não	Valor booliano para especificar se o número total de registros correspondentes aos critérios é retornado. Saiba como contar linhas usando FetchXml
top	Não	Valor inteiro positivo para especificar o número de registros a serem retornados. Esse valor não pode exceder 5.000. Não use top junto com os pageatributos ou , countou returntotalrecordcount . Saiba mais sobre como limitar o número de linhas
useraworderby	Não	Valor booliano para especificar que a classificação de dados de coluna de escolha deve usar o modo Ordem Bruta por . Isso classifica as opções de escolha pelo valor inteiro. Sem isso, o padrão é classificar colunas de escolha usando os valores de rótulo de escolha.

Elementos filho

Nome	Ocorrências	Description
entidade	1	Especifica o elemento filho para um elemento fetch, a "entidade pai" para a consulta. Somente uma entidade é permitida.

Opções

Importante

Aplique essas opções somente quando recomendado pelo suporte técnico da Microsoft. O uso incorreto dessas opções pode prejudicar o desempenho de uma consulta.

Use esses valores com o options atributo para especificar dicas do SQL Server a serem aplicadas à consulta. Quando mais de uma opção for definida, separe-as por vírgulas.

options='HashJoin,DisableRowGoal'

Opção de consulta	Dica do SQL Server
ForceOrder	Forçar ordem
DisableRowGoal	Dica: DISABLE_OPTIMIZER_ROWGOAL
EnableOptimizerHotfixes	Dica: ENABLE_QUERY_OPTIMIZER_HOTFIXES
LoopJoin	Junção de loop
MergeJoin	Junção de Mesclagem
HashJoin	Junção de hash
NO_PERFORMANCE_SPOOL	NO_PERFORMANCE_SPOOL
ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS	Dica: ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS

Mais informações: Dicas (Transact-SQL) – Consulta