取り込み要素

  • [アーティクル]

FetchXml クエリのルート要素。

FetchXML を使用してデータをクエリする方法。

例

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

属性

件名 必須? Description
aggregate いいえ クエリが集計値を返すことを指定するブール値です。 集計データについて解説します
aggregatelimit いいえ 標準の 50,000 レコードの合計制限を下回る制限を設定します。 集計制限について解説します
count いいえ ページ内で返すレコード数を指定する正の整数値です。 ページングの詳細情報を確認する
datasource いいえ Dataverse 長期データ保持を使用する場合は、datasource を 'retained' に設定して、クエリが保持される行のみを対象とすることを示します。 Dataverse の長期データ保持について解説します
distinct いいえ 重複行が結果に含まれないように指定するブール値です。 明確な結果の返送についての詳細について解説します
latematerialize いいえ クエリをより小さな部分に分割し、結果を返す前に再組み立てするように指示するブール値です。 latematerialize を使用すると、長時間実行されるクエリのパフォーマンスが向上する場合があります。 遅延マテリアライズ クエリの使用の詳細の詳細について解説します。
no-lock いいえ レコードの共有ロックを防ぐ従来の設定です。 これはもう必要ありません。
options いいえ 1 つ以上の SQL 最適化を適用する文字列値です。 オプション を見る
page いいえ 返すページ番号を指定する正の整数値です。 ページングの詳細情報を確認する
paging-cookie いいえ データの前のページの文字列値を使用して、データの次のページをより効率的に取得します。 ページングの詳細情報を確認する
returntotalrecordcount いいえ 条件に一致するレコードの総数を返すかどうかを指定するブール値です。 FetchXml を使用して行を数える方法について解説します
top いいえ 返すレコード数を指定する正の整数値です。
この値は 5,000 を超えることはできません。
top を page、count、または returntotalrecordcount 属性と一緒に使用しないでください。
行数の制限について解説します
useraworderby いいえ 選択列データの並べ替えで 生の並べ替えを使用する モードを使用することを指定するブール値。 これにより、選択オプションが整数値で並べ替えられます。 これを行わない場合、既定では、選択ラベルの値を使用して選択列をソートします。

子要素

件名 発生回数 プロパティ
エンティティ 6 取り込み要素 の子要素、つまりクエリの「親エンティティ」を指定します。 エンティティは 1 つだけ許可されます。

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。

オプション

重要

これらのオプションは、Microsoft テクニカル サポートによって推奨された場合にのみ適用してください。 これらのオプションを誤って使用すると、クエリのパフォーマンスが損なわれる可能性があります。

これらの値を options 属性とともに使用して、クエリに適用する SQL Server のヒントを指定します。 複数のオプションを設定する場合は、カンマで区切ってください。

options='OptimizeForUnknown,DisableRowGoal,Recompile'
クエリ オプション SQL Server ヒント
OptimizeForUnknown 不明に最適化
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) - クエリ