informazioni di riferimento sulla sintassi di ricerca Data Catalog
Azure Data Catalog è un servizio completamente gestito ospitato in Microsoft Azure che funge da sistema di registrazione e sistema di individuazione per le origini dati aziendali. Azure Data Catalog offre funzionalità che consentono agli utenti tecnici e non tecnici di individuare, comprendere e usare origini dati.
Un aspetto fondamentale dell'individuazione dei dati è la possibilità di cercare origini dati registrate in Azure Data Catalog. Azure Data Catalog ha una sintassi di ricerca potente che consente agli utenti di compilare facilmente query che restituiscono i dati necessari agli utenti.
Panoramica della sintassi di ricerca
Le ricerche di Azure Data Catalog sono simili a quella usata da Microsoft Windows e Microsoft Outlook e che devono essere familiari agli utenti di questi strumenti.
Tecniche di query
| Tecnica | Uso | Esempio |
|---|---|---|
| Ricerca di base | Ricerca di base utilizzando uno o più termini di ricerca. I risultati sono gli asset che corrispondono alle proprietà di uno o più termini specificati. | sales data |
| Ambito della proprietà | Restituire solo le origini di dati dove il termine di ricerca corrisponde alla proprietà specificata | name:finance |
| Operatori booleani | Ampliare o restringere una ricerca utilizzando operazioni booleane | finance NOT corporate |
| Raggruppamento con parentesi | Utilizzare le parentesi per raggruppare parti della query per ottenere l'isolamento logico, soprattutto in combinazione con gli operatori booleani | name:finance AND (tags:tag1 OR tags:tag2) |
| Operatori di confronto | Utilizzare confronti invece di uguaglianze per le proprietà che hanno dati di tipo numero e data | creationTime>"11/05/2014" |
Operatori di corrispondenza, confronto e booleani
| Parola chiave/simbolo | Esempio | Funzione |
|---|---|---|
| : | experts:user@domain.com tags:tag1 |
Usare l'ambito della proprietà e restituire solo gli asset in cui una determinata proprietà contiene il testo da cercare. La semantica per la query è "corrispondenza prefisso". |
| = | name=Sales name="Soft Drink Sales" |
Consente all'utente di specificare una corrispondenza esatta. Verranno restituiti solo gli asset che contengono la proprietà con esattamente il valore del termine di ricerca. |
| <> | experts<>user1 tags<>tag2 |
Operatore "Non uguale a". Restituirà solo gli asset che non hanno il valore indicato nella query di ricerca. |
| "" | "social security" |
Trova elementi che contengono la frase esatta della sicurezza sociale. C'è un caso speciale per usare virgolette. Se le virgolette vengono usate con l'ambito della proprietà, la semantica è raggruppata ma non esatta. In questo caso il comportamento è uguale a quello di specificare la proprietà denominata due volte. Esempio: name:"social security" trova gli asset che dispongono di una proprietà name con la parola social in esso o una proprietà name con la parola sicurezza. |
| () | (tags:tag1 AND tags:tag2) OR (name:sales AND database:salesfy15) |
Trova gli elementi che contengono tag1 e tag2 o hanno il nome vendite nel database salesfy15. In genere usato insieme agli operatori booleani |
| >,>= | timestamp>"11/05/2014" |
Trova elementi con una data modificata dopo il 11/05/2014. |
| <,<= | timestamp<"11/05/2014" |
Trova elementi con data precedente al 11/05/2014. |
| NOT | social NOT security |
Trova elementi che contengono socialità, ma non sicurezza. |
| AND | social AND security |
Trova elementi che contengono previdenza sociale e sicurezza. |
| OR | social OR security |
Trova elementi che contengono previdenza sociale o sicurezza. |
| ha: | has:tags has:description |
Consentire il filtro e restituire solo gli asset in cui è impostata una determinata proprietà o se la proprietà rappresenta una raccolta, contiene almeno un elemento. |
Note
Semantica del prefisso
Per impostazione predefinita, tutte le ricerche in Azure Data Catalog vengono eseguite usando una tecnica denominata Semantica di corrispondenza prefisso. Ciò significa che qualsiasi termine di ricerca inizia una corrispondenza all'inizio delle proprietà dell'asset.
Ad esempio, prendere in considerazione due asset fittizi registrati in Azure Data Catalog con i nomi seguenti:
- SalesData
- Virgolette salesman
Una ricerca "vendite" restituisce entrambi questi asset, poiché i nomi iniziano entrambi con la parola "vendite". Le versioni future di Azure Data Catalog includono il supporto per gli operatori di corrispondenza esatta.
Ricerche con ambito proprietà
La grammatica di query di Azure Data Catalog supporta l'ambito della proprietà. Nell'anteprima corrente gli ambiti delle proprietà sono distinzione tra maiuscole e minuscole. Ciò significa che per il funzionamento della query, l'effettivo maiuscolo della proprietà nella query di ricerca deve corrispondere a ciò che si trova nell'indice.
Le ricerche sulle proprietà non valide (proprietà che non esistono) generano un errore.
Le virgolette si comportano in modo speciale quando si usa l'ambito della proprietà. Le virgolette in qualsiasi altro contesto indicano la formulazione esatta. Tuttavia, quando le virgolette vengono usate nell'ambito della proprietà, la semantica è raggruppata. Ad esempio, name:"Sales Products" esegue una ricerca di testo libero cercando il contenuto della proprietà name che cerca "Sales" o "Products". Pertanto, la semantica di: name:"Sales Products" è esattamente la stessa name:Sales name:Productsdi .
Il principio generale per i nomi delle proprietà in Proprietà ricercabili è camel-case, il che significa che la prima lettera è minuscola e quindi ognuna delle prime lettere della parola è maiuscola.
Di seguito sono elencate le proprietà più utili.
| Proprietà | Uso | Esempio |
|---|---|---|
| name | Trova gli elementi in cui viene visualizzato il termine di ricerca nel nome dell'origine dati | name:finance |
| description | Trova elementi in cui viene visualizzato il termine di ricerca nella descrizione dell'origine dati | description:finance |
| objectType | Trova elementi di un tipo di oggetto specifico, ad esempio tabella, visualizzazione o KPI | objectType:table |
| sourceType | Trova elementi di un tipo di origine dati specifico, ad esempio SQL Server o SQL Server Analysis Services multidimensionale | sourceType:"tabular" |
| tags | Trova gli elementi in cui viene visualizzato il termine di ricerca nei tag di origine dati | tags:finance |
| timestamp | Trova elementi in base alla data e all'ora in cui i metadati sono stati modificati più di recente | timestamp:>"11/05/2014" |
| lastRegisteredTime | Trova elementi in base alla data e all'ora di registrazione dei metadati | lastRegisteredTime:>"11/05/2014" |
| friendlyName | Trova elementi in cui viene visualizzato il termine di ricerca nel nome descrittivo dell'origine dati | friendlyName: finance |
| Esperti | Trova gli elementi in cui l'esperto dell'origine dati corrisponde al termine di ricerca | experts:user@example.com experts:user |
| termName | Trova gli elementi in cui il termine di ricerca viene visualizzato nei termini del glossario aziendale applicati all'asset dei dati | termName:marketing |
È anche possibile usare i nomi delle proprietà seguenti insieme al filtro "has:" per verificare dove sono impostate le proprietà specifiche.
| Proprietà | Uso | Esempio |
|---|---|---|
| Anteprime | Trova gli elementi che contengono l'anteprima | has:preview |
| documentazione | Trova elementi che contengono la documentazione | has:documentation |
| tableDataProfiles | Trova elementi con profilo di tabella (dimensioni, numero di righe e così via) | has:tableDataProfiles |
| columnsDataProfiles | Trova elementi con profilo dati di colonna (numero di valori distinti, min, max e così via) | has:columnsDataProfiles |
Esempi di ricerca
Le sezioni seguenti illustrano alcuni esempi di ricerca.
Restituire tutti gli asset con "sales" nel nome
name:sales
Restituire tutti gli asset registrati dopo il 20/4/2015 che includono "vendite" in qualsiasi proprietà
sales AND lastRegisteredTime>"4/20/2015"
Restituire tutti gli asset che includono le vendite in qualsiasi proprietà e che non hanno il tag Q1FY2013
sales AND tags<>"Q1FY2013"
Restituire tutti gli asset a cui non sono assegnati esperti né documentazione
not has:experts and not has:documentation