Sintassi di ricerca di parole chiave

Quando si cercano asset di dati, è possibile usare parole chiave, operatori e query con ambito campo per trovare esattamente i dati necessari. Questo articolo descrive la sintassi di query supportata in modo da poter creare ricerche precise ed efficaci.

Per una panoramica generale della ricerca e dell'esplorazione degli asset di dati, vedere Cercare gli asset di dati in Unified Catalog.

Nota

La sintassi descritta in questo articolo si applica all'esperienza di ricerca degli asset Unified Catalog > Discovery > Data nel portale di Microsoft Purview. I risultati della ricerca vengono filtrati in base alle autorizzazioni, quindi vengono visualizzati solo gli asset a cui si ha accesso. Per altre informazioni sulle autorizzazioni, vedere Cercare gli asset di dati in Unified Catalog.

Riferimento rapido

Nella tabella seguente vengono riepilogate le opzioni di sintassi delle query disponibili nella ricerca Unified Catalog.

Sintassi Esempio Descrizione
Parola chiave customer Cercare la parola chiave in tutti i campi.
Più parole chiave customer sales Cercare gli asset corrispondenti a entrambe le parole. Gli asset corrispondenti a entrambe le parole sono classificati più in alto.
E customer AND sales Entrambi i termini devono essere presenti.
O customer OR sales Entrambi i termini possono essere presenti.
NOT customer NOT draft Deve contenere il primo termine, non deve contenere il secondo.
Frase esatta "sales report" Trova la corrispondenza con la frase esatta in ordine.
Raggruppamento (A OR B) AND C Controllare l'ordine di valutazione.
Ricerca campi name:customer Eseguire ricerche solo all'interno di un campo specifico.
Trova tutte le corrispondenze * o vuoto Restituisce tutti gli asset.

Una singola parola chiave esegue la ricerca in tutti i campi ricercabili nel catalogo, inclusi nome asset, descrizione, nome completo, colonne dello schema, termini del glossario, contatti, classificazioni, attributi personalizzati, raccolte, domini ed etichette di riservatezza.

L'esempio seguente restituisce qualsiasi asset in cui customer viene visualizzato in qualsiasi campo ricercabile:

customer

I risultati vengono classificati in base alla rilevanza. Una corrispondenza esatta nel nome dell'asset ha punteggi superiori a una corrispondenza parziale nella descrizione.

Più parole chiave

Quando si immettono più parole separate da spazi senza un operatore esplicito, la ricerca restituisce gli asset che contengono una qualsiasi delle parole. Gli asset che contengono più parole chiave vengono classificati più in alto nei risultati.

Nell'esempio seguente vengono trovati gli asset che contengono customer, saleso entrambi:

customer sales

Importante

Una ricerca con parole chiave separate da spazi non è la stessa di una ricerca AND. Si considerino le differenze seguenti:

Query Comportamento Risultato di esempio
customer sales Corrisponde a customer OR sales. Asset con entrambi i punteggi più alti. Un asset denominato "Sales Dashboard" corrisponde anche senza "cliente".
customer AND sales Entrambicustomer AND sales deve essere presente. "Sales Dashboard" non corrisponde a meno che non contenga anche "customer".
"customer sales" La frase customer sales esatta deve essere visualizzata in tale ordine. Corrisponde solo se customer è immediatamente seguito da sales.

Operatori booleani

Gli operatori booleani consentono di combinare i termini di ricerca con la logica esplicita. Gli operatori devono essere scritti in lettere maiuscole (AND, OR, NOT).

Operatore AND

Usare l'operatore AND quando tutti i termini devono essere presenti negli asset corrispondenti. I termini non devono essere adiacenti o nello stesso campo.

customer AND sales
azure AND sql AND database

Operatore OR

Usare l'operatore OR quando uno dei termini può essere presente.

customer OR client
sales OR marketing OR operations

OPERATORE NOT

Usare l'operatore NOT per escludere gli asset che contengono un termine specifico.

customer NOT draft
sales NOT internal NOT test

Nell'esempio seguente vengono restituiti gli asset che contengono customer ma non contengono draft:

customer NOT draft

Combinare gli operatori

È possibile concatenare gli operatori in una singola query:

customer AND sales NOT draft

Questa query restituisce gli asset che contengono customer e sales, ma non contengono draft.

Eseguire il wrapping della query tra virgolette doppie per cercare una frase esatta. Le parole devono essere visualizzate nell'ordine specificato e adiacenti l'una all'altra.

"sales report"
"customer data analysis"

Nella tabella seguente viene illustrato come la ricerca di frasi differisce da una ricerca con parole chiave:

Query Corrispondenze Non corrisponde
"sales report" "Riepilogo report vendite Q1" "report sulle vendite" (ordine errato)
"sales report" "Report vendite annuali" "sales quarterly report" (parole non adiacenti)

Usare sales report (senza virgolette) quando si desidera qualsiasi asset che menzioni sales o report. Usare "sales report" (con virgolette) solo gli asset che contengono la frase esatta.

Raggruppamento con parentesi

Le parentesi controllano l'ordine di valutazione, proprio come nelle espressioni matematiche.

(customer OR client) AND sales

Senza parentesi, la precedenza degli operatori può produrre risultati imprevisti. Gli esempi seguenti illustrano come le parentesi modificano l'interpretazione della query:

Query Interpretazione
(customer OR client) AND sales Asset che contengono customer o cliente contengono salesanche .
customer OR (client AND sales) Asset che contengono customero asset che contengono sia client che sales.

È possibile annidare le parentesi per query più complesse:

(A AND B) OR (C AND D) NOT E
((alpha OR beta) AND gamma) NOT delta

Per impostazione predefinita, una parola chiave viene cercata in tutti i campi. La ricerca con ambito campo consente di limitare la ricerca a un campo specifico.

Usare la sintassi fieldName:value o fieldName:"phrase value":

name:customer
classification:Confidential
entityType:azure_sql_table
contact:alice@company.com
name:"sales report"

Campi supportati

I campi seguenti possono essere usati con la field:value sintassi :

Nome del campo Descrizione Esempio
name Nome asset name:customer
qualifiedName Nome completo qualifiedName:sales_db.customers
description Descrizione dell'asset description:quarterly
userDescription Descrizione fornita dall'utente userDescription:important
displayText Visualizzare il testo displayText:customer
entityType Tipo di entità entityType:azure_sql_table
assetType Categoria di asset assetType:Tables
classification Etichette o tag di riservatezza classification:Confidential
endorsement Stato approvazione endorsement:Certified
glossaryType Tipo di glossario glossaryType:AtlasGlossaryTerm
termStatus Stato del termine termStatus:Approved
termTemplate Modello di termine termTemplate:BusinessTerm
glossary Nome glossario glossary:Finance
fileExtension Estensione del file fileExtension:csv
term Termini del glossario assegnati term:Revenue
contact Contatto proprietario o esperto contact:john@company.com
abbreviation Abbreviazione del termine abbreviation:ROI
objectType Tipo di oggetto objectType:Tables
tag Tag tag:important

I nomi dei campi non fanno distinzione tra maiuscole e minuscole. Ad esempio, Name:customer e name:customer producono gli stessi risultati.

Se si usa un nome di campo non incluso nella tabella Campi supportati , il motore di ricerca non restituisce un errore. Considera invece l'intera espressione come una parola chiave senza ambito. Ad esempio, alice AND report:myreport cerca il testo report:myreport letterale AND in tutti i campi, anziché limitare myreport a un campo denominato reportalice .

Importante

Dopo i due punti viene acquisito un solo token di valore. Per cercare un valore multifaccia, usare le virgolette:

Query Comportamento
name:sales report Cerca name , quindi cerca separatamente in tutti i campi report.sales
name:"sales report" Cerca name la frase sales reportesatta .

Campi annidati

Alcuni campi supportati, ad contact esempio e term, rappresentano dati compositi con più proprietà. Ad esempio, un contatto ha un nome visualizzato, un indirizzo di posta elettronica e un ID.

Non è possibile usare la notazione punto per impostare come destinazione una proprietà specifica. Il sistema riconosce solo i nomi di campo di primo livello elencati nella tabella Campi supportati .

Query Supportato Comportamento
contact:Alice Sì Esegue ricerche in tutte le proprietà del contatto (nome visualizzato, indirizzo di posta elettronica, ID).
contact.displayName:Alice No Non riconosciuto come ricerca con ambito campo.
term:Revenue Sì Esegue ricerche in tutte le proprietà dei termini (nome, glossario).
term.name:Revenue No Non riconosciuto come ricerca con ambito campo.

Usare il nome del campo di primo livello. Ad esempio, contact:Alice esegue la ricerca in tutte le proprietà dei contatti e restituisce gli asset in cui tutte le proprietà corrispondono.

Quando si combina una parola chiave semplice con una ricerca con ambito campo, uno spazio non implica AND. Le clausole separate da spazi vengono considerate come OR.

Query Comportamento
alice contact:bob alice Il contatto OR contiene bob.
alice AND contact:bob alice Il contatto AND contiene bob.

Consiglio

Usare sempre operatori espliciti AND o OR quando si combina la ricerca di parole chiave con la ricerca con ambito campo.

Trova la corrispondenza con tutti i risultati

Una query vuota o * restituisce tutti gli asset, in base alle autorizzazioni e ai filtri applicati.

*

Questa opzione è utile come punto di partenza quando si desidera esplorare gli asset usando solo filtri e facet.

Distinzione tra maiuscole e minuscole

La ricerca non fa in genere distinzione tra maiuscole e minuscole. La ricerca di Customer, customero CUSTOMER restituisce gli stessi risultati.

Tuttavia, la combinazione di maiuscole e minuscole e i caratteri speciali nella query di ricerca possono influire sul numero di risultati restituiti. Alcuni campi vengono elaborati dal motore di ricerca, che suddivide i termini in limiti specifici prima della corrispondenza.

Delimitatori di suddivisione dei token

I limiti seguenti determinano la suddivisione di un termine in token separati durante l'indicizzazione e la ricerca:

Delimitatore Input di esempio Token prodotti
Modifica maiuscola (da minuscola a maiuscola) CustomerOrder customer, order, customerorder
Carattere di sottolineatura (_) customer_order customer, order, customer_order
Segno meno (-) customer-order customer, order, customer-order
Punto (.) customer.order customer, order, customer.order
Virgola (,) item1,item2 item1, item2
Due punti (:) db:schema db, schema
Spazi vuoti customer order customer, order
Transizione da lettera a numero version2release version, 2, release
Transizione da numero a lettera 2ndEdition 2, nd, edition

Nota

La suddivisione è cumulativa. Un nome come Customer_Order_Details viene diviso a ogni carattere di sottolineatura e a ogni limite di modifica del caso all'interno di ogni segmento, producendo token come customer, order, details, customer_ordere order_details.

In che modo la combinazione di maiuscole e minuscole influisce sui risultati

Quando la query di ricerca contiene maiuscole e minuscole miste, ad esempio PascalCase o camelCase, il motore di ricerca lo divide in base ai limiti di modifica del caso, producendo più token. Ogni token viene confrontato in modo indipendente, ampliando il set di risultati.

Quando la query è in lettere minuscole, non esistono limiti di modifica delle maiuscole e minuscole su cui dividere, quindi rimane come un singolo token e deve corrispondere come stringa contigua.

L'esempio seguente illustra la differenza:

Query di ricerca Comportamento Effetto sui risultati
CustomerOrder Suddivisione in token: customer, , ordercustomerorder Corrisponde agli asset contenenti customer o order o customerorder. Risultati più ampi.
customerorder Rimane come un token: customerorder Corrisponde solo agli asset contenenti la stringa customerordercontigua. Risultati più ristretti.

Ricerca di frasi e maiuscole/minuscole

La ricerca di frasi tra virgolette interagisce anche con la combinazione di maiuscole e minuscole. Con "CustomerOrder" tra virgolette, i token di query sono ancora customer, order, customerorder, ma poiché si tratta di una ricerca di frasi, i token devono apparire adiacenti e in ordine.

Query frasi Corrispondenze Non corrisponde
"CustomerOrder" CustomerOrder, FAC_Customer_OrderLine (dove customer e order sono token adiacenti) legacy customer database (nessun token adiacente order )
"customerorder" CustomerOrder (indicizzato come contiguo customerorder) FAC_Customer_OrderLine (nessun token contiguo customerorder )

Consigli per l'inserimento di maiuscole e minuscole

  • Per i risultati più ampi, usare la combinazione di maiuscole e minuscole naturale del termine , CustomerOrder ad esempio o SalesReport. La suddivisione delle modifiche maiuscole e minuscole trova corrispondenze parziali.
  • Per i risultati più precisi, usare tutte le lettere minuscole (ad esempio, customerorder) o una ricerca esatta di frasi con virgolette.
  • In caso di dubbi, cercare entrambi i moduli o usare operatori booleani espliciti: CustomerOrder OR customerorder.

Classificazione dei risultati

Quando una ricerca restituisce più risultati, vengono ordinati in base a un punteggio di rilevanza. I fattori seguenti influiscono sulla classificazione, dall'impatto più alto al più basso. La logica di classificazione esatta è soggetta a modifiche man mano che il motore di rilevanza viene continuamente ottimizzato.

Dove si verifica la corrispondenza

Non tutti i campi hanno lo stesso peso. Una corrispondenza nel nome dell'asset è considerata più rilevante di una corrispondenza nella descrizione o in altri campi:

Priorità Tipo di corrispondenza (Match type) Esempio
Highest Corrispondenza esatta sul nome dell'asset Ricerca customers quando l'asset è denominato esattamente customers.
Alto Corrispondenza esatta senza distinzione tra maiuscole e minuscole nel nome Ricerca Customers quando l'asset è denominato customers.
Medio Corrispondenza parziale in base al nome o al nome completo Ricerca customer quando l'asset è denominato CustomerOrderTable.
Standard Corrispondenza in descrizione, testo visualizzato, classificazione, tipo di entità o altri campi Ricerca customer quando la parola viene visualizzata nella descrizione dell'asset.
Lower Corrispondenza in colonne dello schema, termini del glossario, contatti o attributi personalizzati Ricerca customer quando esiste una colonna denominata customer_id nell'asset.

All'interno di ogni livello, gli asset corrispondenti a più token di ricerca hanno un punteggio superiore rispetto agli asset corrispondenti a meno.

Tipo di asset

Gli asset a livello foglia, ad esempio singole tabelle, file e termini del glossario, ricevono un aumento di classificazione rispetto agli asset del contenitore, ad esempio database o account di archiviazione. Quando si cerca sales, una tabella denominata sales_data viene in genere collocata sopra il database che lo contiene.

Completezza dei dati

Gli asset più curati ricevono un aumento di classificazione. Ognuno dei segnali seguenti contribuisce in modo indipendente a un punteggio più alto:

  • Ha una descrizione
  • Ha una o più classificazioni (etichette di riservatezza)
  • Ha assegnato uno o più termini del glossario
  • Ha proprietari o esperti definiti
  • Contiene informazioni sullo schema o sulla colonna
  • Ha attributi personalizzati popolati
  • Ha le etichette di riservatezza applicate

Stato approvazione

Gli asset approvati sono superiori a quelli non approvati. Gli asset alzati di livello ricevono un aumento moderato e gli asset certificati ricevono un aumento che si accumula con Alza di livello quando si applicano entrambi.

Freschezza

Gli asset aggiornati di recente ricevono un leggero aumento di classificazione rispetto a quelli obsoleti. La spinta decade gradualmente.

Segnali di popolarità

I segnali basati sull'utilizzo contribuiscono alla classificazione, tra cui la frequenza di modifica, il punteggio di qualità dei dati e la classificazione utente.

Personalizzazione

Quando esegui una ricerca, gli asset in cui sei elencato come proprietario o esperto ricevono una piccola spinta, rendendo i tuoi asset più facili da trovare.

Rilevamento di parole chiave intelligenti

Il sistema di ricerca riconosce determinate parole chiave e regola la classificazione:

  • my: incrementa gli asset in cui sei un proprietario, un esperto o un editor recente.
  • Parole chiave del tipo di oggetto: la ricerca di una categoria di asset riconosciuta , ad Tablesesempio , Fileso Folders, aumenta gli asset di quel tipo.
  • Parole chiave di classificazione: la ricerca di un termine corrispondente a un nome di classificazione noto (ad PII esempio o Confidential) aumenta gli asset con tale classificazione.

Nota

Quando viene applicato un ordinamento esplicito (ad esempio, ordina in base al nome o all'ora di aggiornamento), l'assegnazione dei punteggi di pertinenza viene usata come tiebreaker solo quando due asset hanno lo stesso valore di ordinamento.

Limiti delle query

Limite Valore
Lunghezza massima parola chiave 1.024 caratteri. Le query più lunghe vengono troncate.

Limitazioni note

Il raggruppamento non è supportato all'interno di una ricerca nei campi. Ad esempio, name:(alice AND bob) la sintassi non è valida. Usare name:alice AND name:bob invece .

Risorse

  • Last updated on