Partilhar via


elemento fetch

O elemento raiz de uma consulta FetchXml.

Saiba como consultar dados usando FetchXml.

Example

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

Attributes

Nome Necessário? Description
aggregate Não Valor booleano para especificar que a consulta retorna valores agregados. Saiba mais sobre como agregar dados
aggregatelimit Não Defina um limite abaixo do limite padrão de 50.000 registros agregados. Saiba mais sobre limites agregados
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 de paginação
datasource Não Ao usar a retenção de dados de longo prazo do Dataverse, defina datasource como 'retained' para indicar que a consulta é apenas para linhas retidas. Saiba mais sobre a retenção de dados de longo prazo do Dataverse
distinct Não Valor booleano para especificar que linhas duplicadas não sejam incluídas nos resultados. Saiba mais sobre como retornar resultados distintos
latematerialize Não Valor booleano para direcionar a consulta a ser dividida em partes menores e remontar os resultados antes de retorná-los. O uso latematerialize pode melhorar o desempenho de algumas consultas de longa duração. Saiba mais sobre como usar a consulta Late Materialize.
no-lock Não Configuração herdada para evitar 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 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 de 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 de paginação
returntotalrecordcount Não Valor booleano 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.
Este valor não pode exceder 5.000.
Não use top junto com os pageatributos , countou returntotalrecordcount .
Saiba mais sobre como limitar o número de linhas
useraworderby Não Valor booleano para especificar que a classificação de dados da 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 as colunas de escolha usando os valores do 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. Só é permitida uma entidade.

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 estiver definida, separe-as por vírgulas.

options='HashJoin,DisableRowGoal'
Opção de consulta Dica do SQL Server
ForceOrder Ordem de Força
DisableRowGoal Dica: DISABLE_OPTIMIZER_ROWGOAL
EnableOptimizerHotfixes Dica: ENABLE_QUERY_OPTIMIZER_HOTFIXES
LoopJoin Junção de loop
MergeJoin Mesclar Ingresso
HashJoin Hash Junte-se
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