Usare l'editor KQL per compilare query di ricerca

L'opzione di query KQL (Keyword Query Language) nella ricerca degli strumenti di Microsoft Purview eDiscovery fornisce commenti e indicazioni quando si compilano query di ricerca in Ricerca contenuto, Microsoft Purview eDiscovery (Standard) ed eDiscovery (Premium). Quando si immettono query nell'editor, fornisce il completamento automatico per le proprietà e le condizioni ricercabili supportate e fornisce elenchi di valori supportati per le proprietà e le condizioni standard. Ad esempio, se si specifica la kind proprietà email nella query, l'editor presenterà un elenco di valori supportati che è possibile selezionare. L'editor KQL visualizza anche potenziali errori di query in tempo reale che è possibile correggere prima di eseguire la ricerca. Soprattutto, è possibile incollare query complesse direttamente nell'editor senza dover compilare manualmente query usando le parole chiave e le schede delle condizioni nel generatore di condizioni standard.

Ecco i vantaggi principali dell'uso dell'editor KQL:

  • Fornisce indicazioni e consente di creare query di ricerca da zero.
  • Consente di incollare rapidamente query lunghe e complesse direttamente nell'editor. Ad esempio, se si riceve una query complessa da un consulente opposto, è possibile incollarla nell'editor KQL invece di dover usare il generatore di condizioni.
  • Identifica rapidamente i potenziali errori e visualizza suggerimenti su come risolvere i problemi.

L'editor KQL è disponibile anche quando si creano blocchi basati su query in eDiscovery (Standard) ed eDiscovery (Premium).

Consiglio

Se non si è un cliente E5, usare la versione di valutazione delle soluzioni Microsoft Purview di 90 giorni per esplorare in che modo funzionalità aggiuntive di Purview possono aiutare l'organizzazione a gestire le esigenze di sicurezza e conformità dei dati. Iniziare ora dall'hub delle versioni di valutazione Portale di conformità di Microsoft Purview. Informazioni dettagliate sull'iscrizione e le condizioni di valutazione.

Visualizzazione dell'editor KQL

Quando si crea o si modifica una ricerca di eDiscovery, l'opzione per visualizzare e usare l'editor KQL si trova nella pagina Condizioni della ricerca guidata o delle raccolte.

Editor KQL in Ricerca contenuto ed eDiscovery (Standard)

Editor KQL in Ricerca contenuto ed eDiscovery (Standard)

Editor KQL in eDiscovery (Premium)

Editor KQL in eDiscovery (Premium)

Uso dell'editor KQL

Le sezioni seguenti illustrano esempi di come l'editor KQL fornisce suggerimenti e rileva potenziali errori.

Completamento automatico di proprietà e operatori di ricerca

Quando si inizia a immettere una query di ricerca nell'editor KQL, nell'editor viene visualizzato il completamento automatico suggerito delle proprietà di ricerca supportate (dette anche restrizioni delle proprietà) che è possibile selezionare. È necessario digitare almeno due caratteri per visualizzare un elenco di proprietà supportate che iniziano con questi due caratteri. Ad esempio, lo screenshot seguente mostra le proprietà di ricerca suggerite che iniziano con Se.

L'editor KQL suggerisce le proprietà supportate

Inoltre, l'editor suggerisce anche di fornire un elenco di operatori supportati ( ad :esempio , = e <>) quando si digita un nome di proprietà completo. Ad esempio, lo screenshot seguente mostra gli operatori suggeriti per la Date proprietà .

L'editor KQL suggerisce gli operatori

Per altre informazioni sulle proprietà e sugli operatori di ricerca supportati, vedere Query con parole chiave e condizioni di ricerca per eDiscovery.

Suggerimenti per i valori delle proprietà

L'editor KQL fornisce suggerimenti per i possibili valori di alcune proprietà. Ad esempio, lo screenshot seguente mostra i valori suggeriti per la Kind proprietà .

L'editor KQL suggerisce i valori per alcune proprietà

L'editor suggerisce anche un elenco di utenti (in formato UPN) quando si digitano le proprietà del destinatario della posta elettronica, ad Fromesempio , ToRecipients e Participants.

L'editor KQL suggerisce agli utenti le proprietà di posta elettronica del destinatario

Rilevamento di potenziali errori

L'editor KQL rileva potenziali errori nelle query di ricerca e fornisce un suggerimento su cosa causa l'errore per risolvere l'errore. L'editor indica anche un potenziale errore quando una proprietà non ha un'operazione o un valore corrispondente. I potenziali errori nella query sono evidenziati in testo rosso e le spiegazioni e le possibili correzioni per l'errore vengono visualizzate nella sezione a discesa Potenziali errori .

Importante

Le virgolette annidate non sono supportate nell'editor KQL.

Ad esempio, se la query seguente è stata incollata nell'editor KQL, verranno rilevati quattro potenziali errori.

Rilevamento degli errori dell'editor KQL

In questo caso, è possibile usare i potenziali hint di errore per risolvere i problemi e correggere la query.

Ulteriori informazioni

  • È possibile passare dal generatore di condizioni all'editor KQL. Ad esempio, se si usa il generatore di condizioni per configurare una query usando la casella Parole chiave e più schede condizione, è possibile visualizzare la query risultante nell'editor KQL. Tuttavia, se si crea una query complessa (con parole chiave e condizioni) nell'editor KQL, la query risultante viene visualizzata solo nella casella Parole chiave quando viene visualizzata nel generatore di condizioni.

  • Se si incolla una query complessa nell'editor KQL, l'editor rileva potenziali errori e suggerisce possibili soluzioni per risolvere gli errori.