FetchXml クエリのルート要素。
FetchXml を使用してデータのクエリを実行する方法について説明します。
Example
<fetch>
<entity name='account' />
</fetch>
Attributes
| 名前 | 必須ですか？ | Description |
|---|---|---|
aggregate |
いいえ | クエリが集計値を返すように指定するブール値。 データの集計について |
aggregatelimit |
いいえ | 標準の 50,000 レコード集計制限を下回る制限を設定します。 集計制限について |
count |
いいえ | ページで返されるレコードの数を指定する正の整数値。 ページングの結果について |
datasource |
いいえ | Dataverse の長期データ保有期間を使用する場合は、 datasource を 'retained' に設定して、クエリが保持される行のみを対象とすることを示します。
Dataverse の長期的なデータ保有期間の詳細 |
distinct |
いいえ | 重複する行を結果に含めないことを指定するブール値。 個別の結果を返す方法の詳細 |
latematerialize |
いいえ | クエリをより小さな部分に分割し、結果を返す前に再アセンブルするように指示するブール値。
latematerializeを使用すると、実行時間の長いクエリのパフォーマンスが向上する場合があります。
詳細については、Late Materialize クエリの使用に関するページを参照してください。 |
no-lock |
いいえ | レコードの共有ロックを防ぐための従来の設定。 不要です。 |
options |
いいえ | 1 つ以上の SQL 最適化を適用する文字列値。 オプション を見る |
page |
いいえ | 返すページ番号を指定する正の整数値。 ページングの結果について |
paging-cookie |
いいえ | データの次のページの取得をより効率的にするために、データの前のページからの文字列値。 ページングの結果について |
returntotalrecordcount |
いいえ | 条件に一致するレコードの合計数を返すかどうかを指定するブール値。 FetchXml を使用して行をカウントする方法について説明します |
top |
いいえ | 返されるレコードの数を指定する正の整数値。 この値は 5,000 を超えることはできません。 page、count、またはreturntotalrecordcount属性と共にtopを使用しないでください。行数の制限の詳細 |
useraworderby |
いいえ | 選択肢列データの並べ替えで 生順序モードを使用 するように指定するブール値。 これにより、選択オプションが整数値で並べ替えられます。 これを使用しない場合、既定では、選択肢ラベルの値を使用して選択肢列を並べ替えます。 |
子要素
| 名前 | Occurrences | Description |
|---|---|---|
| エンティティ | 1 | フェッチ要素の子 要素 (クエリの "親エンティティ") を指定します。 許可されるエンティティは 1 つだけです。 |
オプション
Important
これらのオプションは、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 |