取り込み要素

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 を超えることはできません。
toppagecount、または 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) - クエリ