フィードバック

簡易検索の検索アイテム制限の操作

  • [アーティクル]

注意

エンティティとテーブルの違いがわかりませんか？ Microsoft Dataverse で「開発者: 用語を理解する」を参照してください。

クイック検索は、Dynamics 365 Customer Engagement または Microsoft Dataverse テーブルの既定の検索エクスペリエンスを簡単に設定する方法を実現します。 簡易検索は、1 つのクエリで複数のフィールドに渡って最適化された検索を提供します。 簡易検索を使用すると、クエリの実行中にデータ サービスが次のエラーを返す場合があります。

この検索のレコード数がクイック検索のレコード制限を超えています。

このエラーは、クエリが制限を超えた結果を受け取り、データ サービスのリソース消費が潜在的な停止を引き起こさないように停止されたために発生します。 この記事では、10,000 の検索アイテムの制限の計算方法について説明し、この制限に達しないようにするためのベスト プラクティスを含んでいます。

注意

簡易検索は、次のいずれかのフィルター列を含む FetchXML クエリです: isquickfindquery、isquickfindfields。

検索アイテム制限の計算方法

簡易検索クエリでは 2 つのステージの実行を使用します。 最初のステージでは、簡易検索フィルターおよび提供された検索文字列を使用して、追加のフィルターを適用する前にレコードを収集します。 クエリ エンジンでは、このステージで 10,000 レコードの制限を強制します。

第 2 のステージでは、最初のステージからの結果セットを使用して、関連するレコードまたはセキュリティ フィルターなどの、残りのフィルターを実行します。

次の FetchXML 簡易検索クエリを検討します:

<fetch version='1.0' output-format='xml-platform' mapping='logical'>
  <entity name='account'>
    <attribute name='name' />
    <filter type='or' isquickfindfields='1' overridequickfindrecordlimitenabled='1'>
      <condition attribute='name' operator='like' value='%A%' />
    </filter>
    <filter type='and'>
      <condition attribute='statecode' operator='eq' value='0'/>
    </filter>
  </entity>
</fetch>

クエリ エンジンは、最初に “名前” の条件を実行します。 検索は短い検索文字列でワイルドカードを使用しているため、クエリはその他のフィルターを実行する前に 10k の制限に達します。 第 2 のステージの後に結果セットが 10k 未満のレコードにフィルター処理された場合でも (ステージ コード値を適用するとき)、クエリ エンジンは最初のステージで例外に達し、第 2 のステージに進まないことに注意することが重要です。

検索制限が簡易検索クエリに適用されないとき

クエリ エンジンでは、1 つまたはゼロの検索列を含む簡易検索クエリを、簡易検索としてではなく標準クエリとして扱います。 このようなクエリには、10,000 レコードの制限は適用されません。 1 つまたはそれ以下の条件の簡易検索クエリでは、簡易検索よりも標準クエリとしてより優れたパフォーマンスを実行するからです。

検索制限の例外を回避する

Dynamics 365 Customer Engagement または Dataverse でクイック検索クエリを記述して実行する場合、以下のヒントを使って 10k の検索制限を回避してください:

クエリを実行するときのベスト プラクティス

データのクエリを実行するときに、次のベスト プラクティスが実行される必要があります。

  • 簡易検索クエリ ビューに不要なフィールドを追加することを避ける
  • 汎用なクエリおよび不要なワイルドカードを避けて、クエリをできるだけ正確に保つ

特定の例外クエリ

クエリを一時的にこの制限を超える必要がある場合は、FetchXML クエリを編集して、フィルタXML要素内の 0 に等しい overridequickfindrecordlimitenabled 列の設定を含めます。 この列を使用すると、特定の簡易検索クエリの 10k 制限が無効になります。

組織の上書き

ビジネス組織のクエリが定期的に 10k を超える検索アイテムを返す極端なケースの場合、管理者が Microsoft サポートに連絡して、10k のアイテム制限を無効にするよう要求できます。 制限を無効にすることはお勧めしておらず、誤って使用する場合、リソースの過剰消費および環境全体の停止につながる可能性があります。

関連項目

FetchXML の使用によるクエリの作成

注意

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

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