次の方法で共有


KeyQL エディターを使用して検索クエリを作成する

重要

従来の電子情報開示エクスペリエンスは 、2025 年 8 月 31 日に廃止されました。 この廃止には、従来のコンテンツ検索、クラシック電子情報開示 (Standard)、クラシック電子情報開示 (Premium) が含まれます。 これらのオプションは、Microsoft Purview ポータルのエクスペリエンス オプションとしては使用できません。

特定の短期的な移行シナリオでこれらのレガシ機能を使用するときに Microsoft と直接作業する場合を除き、Microsoft Purview ポータル新しい電子情報開示エクスペリエンスのガイダンスを使用してください。

Microsoft Purview eDiscovery ツール検索のキーワード照会言語 (KeyQL) クエリ オプションでは、コンテンツ検索、Microsoft Purview eDiscovery (Standard)、電子情報開示 (Premium)。 エディターでクエリを入力すると、サポートされている検索可能なプロパティと条件のオートコンプリートが提供され、標準のプロパティと条件でサポートされている値の一覧が提供されます。 たとえば、クエリで kind 電子メール プロパティを指定した場合、エディターには、選択できるサポートされている値の一覧が表示されます。 KeyQL エディターには、検索を実行する前に修正できる潜在的なクエリ エラーもリアルタイムで表示されます。 何より、標準条件ビルダーのキーワードと条件カードを使用してクエリを手動で作成することなく、複雑なクエリをエディターに直接貼り付けることができます。

KeyQL エディターを使用する主な利点を次に示します。

  • ガイダンスを提供し、検索クエリを最初から作成するのに役立ちます。
  • 長く複雑なクエリをすばやくエディターに直接貼り付けることができます。 たとえば、対立する弁護士から複雑なクエリを受け取った場合は、条件ビルダーを使用する必要なく、KeyQL エディターに貼り付けることができます。
  • 潜在的なエラーをすばやく識別し、問題を解決する方法に関するヒントを表示します。

KeyQL エディターは、電子情報開示 (Standard) と電子情報開示 (Premium) でクエリベースの保留を作成するときにも使用できます。

KeyQL エディターの表示

電子情報開示検索を作成または編集する場合、KeyQL エディターを表示および使用するオプションは、検索またはコレクション ワークフローの [条件] ページにあります。

コンテンツ検索と電子情報開示のKeyQL エディター (Standard)

コンテンツ検索と電子情報開示のKeyQL エディター (Standard)

電子情報開示 (Premium) のKeyQL エディター

電子情報開示 (Premium) のKeyQL エディター

KeyQL エディターの使用

次のセクションでは、KeyQL エディターが提案を提供し、潜在的なエラーを検出する方法の例を示します。

検索プロパティと演算子のオートコンプリート

KeyQL エディターで検索クエリの入力を開始すると、選択できるサポートされている検索プロパティ (プロパティ制限とも呼ばれます) の自動補完候補がエディターに表示されます。 サポートされているプロパティの一覧を表示するには、少なくとも 2 文字を入力する必要があります。この 2 文字で始まるプロパティの一覧を表示します。 たとえば、次のスクリーンショットは、 Seで始まる推奨される検索プロパティを示しています。

KeyQL エディターでサポートされているプロパティが提案される

さらに、エディターは、完全なプロパティ名を入力するときにサポートされている演算子 ( :=<>など) の一覧も提供します。 たとえば、次のスクリーンショットは、 Date プロパティに推奨される演算子を示しています。

KeyQL エディターで演算子が提案される

サポートされている検索プロパティと演算子の詳細については、「 電子情報開示のキーワード クエリと検索条件」を参照してください。

プロパティ値の候補

KeyQL エディターでは、一部のプロパティの値の候補が提供されます。 たとえば、次のスクリーンショットは、 Kind プロパティの推奨値を示しています。

KeyQL エディターでは、一部のプロパティの値が提案されます

また、 FromToRecipientsParticipantsなど、電子メール受信者のプロパティを入力すると、エディターによってユーザーの一覧が表示されます (UPN 形式)。

KeyQL エディターは、受信者の電子メール プロパティにユーザーを提案します

潜在的なエラーの検出

KeyQL エディターは、検索クエリで発生する可能性のあるエラーを検出し、エラーの原因を示すヒントを提供して、エラーの解決に役立ちます。 エディターは、プロパティに対応する操作または値がない場合に発生する可能性のあるエラーも示します。 クエリの潜在的なエラーは赤いテキストで強調表示され、エラーの説明と考えられる修正が [ 潜在的なエラー ] ドロップダウン セクションに表示されます。

重要

入れ子になった引用符は、KeyQL エディターではサポートされていません。

たとえば、次のクエリを KeyQL エディターに貼り付けた場合、4 つの潜在的なエラーが検出されます。

エディター KeyQLエラー検出

この場合、潜在的なエラー ヒントを使用して、クエリのトラブルシューティングと修正を行うことができます。

詳細

  • 条件ビルダーとKeyQL エディターを切り替えることができます。 たとえば、条件ビルダーを使用して [キーワード] ボックスと複数の条件カードを使用してクエリを構成する場合は、結果のクエリを KeyQL エディターに表示できます。 ただし、KeyQL エディターで複雑なクエリ (キーワードと条件を含む) を作成した場合、結果のクエリは条件ビルダーで表示するときに [キーワード] ボックスにのみ表示されます。

  • KeyQL エディターに複雑なクエリを貼り付けると、エディターは潜在的なエラーを検出し、エラーを解決するための考えられる解決策を提案します。