次の方法で共有

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

  • [アーティクル]

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

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

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

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

ヒント

E5 のお客様でない場合は、90 日間の Microsoft Purview ソリューション試用版を使用して、Purview の追加機能が組織のデータ セキュリティとコンプライアンスのニーズの管理にどのように役立つかを確認してください。 Microsoft Purview コンプライアンス ポータルのトライアル ハブで今すぐ開始してください。 サインアップと試用期間の詳細については、こちらをご覧ください。

KQL エディターの表示

電子情報開示検索を作成または編集する場合、KQL エディターを表示して使用するオプションは、検索ウィザードまたはコレクション ウィザードの [条件] ページにあります。

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

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

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

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

KQL エディターの使用

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

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

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

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

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

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

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

プロパティ値の候補

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

KQL エディターは、一部のプロパティの値を提案します

エディターでは、電子メール受信者のプロパティ (、 などFromToRecipients) を入力すると、ユーザーの一覧 (UPN 形式) も提案されます。Participants

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

潜在的なエラーの検出

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

重要

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

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

KQL エディターのエラー検出

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

詳細

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

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