Naslaginformatie over de zoeksyntaxis van Data Catalog
Azure Data Catalog is een volledig beheerde service die wordt gehost in Microsoft Azure en fungeert als een registratiesysteem en detectiesysteem voor zakelijke gegevensbronnen. Azure Data Catalog heeft mogelijkheden waarmee technische en niet-technische gebruikers gegevensbronnen kunnen detecteren, begrijpen en gebruiken.
Een belangrijk aspect van gegevensdetectie is de mogelijkheid om te zoeken naar gegevensbronnen die zijn geregistreerd in Azure Data Catalog. Azure Data Catalog heeft een krachtige zoeksyntaxis waarmee gebruikers eenvoudig query's kunnen maken die de gegevens retourneren die de gebruikers nodig hebben.
Overzicht van zoeksyntaxis
Azure Data Catalog zoekopdrachten is vergelijkbaar met de zoekopdrachten die worden gebruikt door Microsoft Windows en Microsoft Outlook en die bekend moeten zijn bij gebruikers van deze hulpprogramma's.
Query-technieken
| Techniek | Gebruik | Voorbeeld |
|---|---|---|
| Basiszoekopdrachten | Basiszoekopdrachten met behulp van een of meer zoektermen. De resultaten die worden opgehaald, zijn assets die wat betreft een willekeurige eigenschap overeenkomen met een of meer van de opgegeven voorwaarden. | sales data |
| Bereik van eigenschap definiëren | Alleen gegevensbronnen retourneren waarvan de zoekterm overeenkomt met de opgegeven eigenschap | name:finance |
| Booleaanse operators | Een zoekopdracht uitbreiden of beperken met booleaanse bewerkingen | finance NOT corporate |
| Groeperen met haakjes | Gebruik haakjes en groepeer delen van de query voor logische isolatie, met name in combinatie met Booleaanse operators | name:finance AND (tags:tag1 OR tags:tag2) |
| Vergelijkingsoperators | Gebruik andere vergelijkingen dan gelijkheid voor eigenschappen die de gegevenstypen numeriek en datum hebben | creationTime>"11/05/2014" |
Overeenkomende, vergelijkings- en Booleaanse operatoren
| Trefwoord/symbool | Voorbeelden | Functie |
|---|---|---|
| : | experts:user@domain.com tags:tag1 |
Gebruik eigenschapsbereik en retourneer alleen de assets waarvoor een bepaalde eigenschap de tekst bevat die wordt doorzocht. De semantiek voor de query is 'voorvoegselovereenkomst'. |
| = | name=Sales name="Soft Drink Sales" |
Hiermee kan de gebruiker een exacte overeenkomst opgeven. Alleen de assets die de eigenschap met exact de waarde van de zoekterm bevatten, worden geretourneerd. |
| <> | experts<>user1 tags<>tag2 |
Operator 'Niet gelijk aan'. Retourneert alleen de assets die niet de waarde hebben die wordt aangegeven in de zoekquery. |
| "" | "social security" |
Hiermee vindt u items die de exacte zin sociale zekerheid bevatten. Er is één speciaal geval voor het gebruik van aanhalingstekens. Als aanhalingstekens worden gebruikt met eigenschapsbereik, worden de semantiek gegroepeerd, maar niet exact. In dit geval is het gedrag hetzelfde als het tweemaal opgeven van de benoemde eigenschap. Voorbeeld: naam:"sociale zekerheid" zoekt naar assets met een naameigenschap met het woord sociaal of een naameigenschap met het woord beveiliging erin. |
| () | (tags:tag1 AND tags:tag2) OR (name:sales AND database:salesfy15) |
Hiermee vindt u items die tag1 en tag2 bevatten of die de naam verkoop in database salesfy15 hebben. Meestal gebruikt in combinatie met booleaanse operators |
| >,>= | timestamp>"11/05/2014" |
Hiermee vindt u items met een wijzigingsdatum na 05-11-2014. |
| <,<= | timestamp<"11/05/2014" |
Hiermee vindt u items met een datum vóór 11/05/2014. |
| NOT | social NOT security |
Hiermee vindt u items die wel sociale netwerken bevatten, maar geen beveiliging. |
| EN | social AND security |
Hiermee vindt u items die sociale netwerken en beveiliging bevatten. |
| OF | social OR security |
Hiermee vindt u items die een sociale of sociale zekerheid bevatten. |
| Hsa: | has:tags has:description |
Hiermee staat u filteren toe en retourneert u alleen de assets waarvoor een bepaalde eigenschap is ingesteld (of, als de eigenschap een verzameling vertegenwoordigt, bevat deze ten minste één element). |
Notities
Semantiek van voorvoegsel
Standaard worden alle zoekopdrachten in Azure Data Catalog uitgevoerd met behulp van een techniek genaamd Semantiek voorvoegselovereenkomst. Dit betekent dat elke zoekterm een overeenkomst begint aan het begin van de eigenschappen van de asset.
Neem bijvoorbeeld twee fictieve assets die zijn geregistreerd in Azure Data Catalog met de volgende namen:
- SalesData
- Offertes verkoper
Een zoekopdracht naar 'verkoop' retourneert beide activa, omdat hun namen beide beginnen met het woord 'verkoop'. Toekomstige releases van Azure Data Catalog bevatten ondersteuning voor operators voor exacte overeenkomsten.
Zoekopdrachten in bereik van eigenschap
Azure Data Catalog query grammatica biedt ondersteuning voor eigenschapsbereik. In de huidige preview zijn de eigenschapsbereiken hoofdlettergevoelig. Dit betekent dat de query alleen werkt als de werkelijke hoofdletters van de eigenschap in de zoekquery overeenkomen met de inhoud van de index.
Zoekopdrachten op ongeldige eigenschappen (eigenschappen die niet bestaan) resulteren in een fout.
Aanhalingstekens gedragen zich op een speciale manier bij het gebruik van eigenschapsbereik. Aanhalingstekens in een andere context geven de exacte formulering aan. Wanneer echter aanhalingstekens worden gebruikt in eigenschapsbereik, wordt de semantiek gegroepeerd. Voert bijvoorbeeld een zoekopdracht in vrije tekst uit op name:"Sales Products" de inhoud van de naameigenschap op zoek naar 'Verkoop' of 'Producten'. Daarom is de semantiek van: name:"Sales Products" precies hetzelfde als name:Sales name:Products.
Het algemene principe voor eigenschapsnamen in Doorzoekbare eigenschappen is camel-case, wat betekent dat de eerste letter kleine letters is en dat vervolgens elk van de eerste letters hoofdletters zijn.
Hieronder vindt u de nuttigste eigenschappen.
| Eigenschap | Gebruik | Voorbeeld |
|---|---|---|
| naam | Items zoeken waar de zoekterm wordt weergegeven in de naam van de gegevensbron | name:finance |
| beschrijving | Items zoeken waarvoor de zoekterm wordt weergegeven in de beschrijving van de gegevensbron | description:finance |
| objectType | Hiermee vindt u items van een specifiek objecttype, zoals tabel, weergave of KPI | objectType:table |
| Sourcetype | Hiermee vindt u items van een specifiek gegevensbrontype, zoals SQL Server of SQL Server Analysis Services multidimensionaal | sourceType:"tabular" |
| tags | Items zoeken waar de zoekterm wordt weergegeven in de gegevensbrontags | tags:finance |
| tijdstempel | Items zoeken op basis van de datum en tijd waarop de metagegevens het laatst zijn gewijzigd | timestamp:>"11/05/2014" |
| lastRegisteredTime | Items zoeken op basis van de datum en tijd waarop de metagegevens zijn geregistreerd | lastRegisteredTime:>"11/05/2014" |
| Friendlyname | Items zoeken waarvoor de zoekterm wordt weergegeven in de beschrijvende naam van de gegevensbron | friendlyName: finance |
| Deskundigen | Items zoeken waarvan de gegevensbronexpert overeenkomt met de zoekterm | experts:user@example.com experts:user |
| termName | Items zoeken waar de zoekterm wordt weergegeven in zakelijke woordenlijsttermen die zijn toegepast op de gegevensasset | termName:marketing |
U kunt ook de volgende eigenschapsnamen samen met het filter 'has:' gebruiken om te controleren waar voor assets specifieke eigenschappen zijn ingesteld.
| Eigenschap | Gebruik | Voorbeeld |
|---|---|---|
| trailers | Items zoeken die een voorbeeld bevatten | has:preview |
| documentatie | Items zoeken die documentatie bevatten | has:documentation |
| tableDataProfiles | Hiermee vindt u items met een tabelprofiel (grootte, aantal rijen, enzovoort) | has:tableDataProfiles |
| columnsDataProfiles | Hiermee vindt u items met een kolomgegevensprofiel (aantal afzonderlijke waarden, min, max, enzovoort) | has:columnsDataProfiles |
Zoekvoorbeelden
In de volgende secties ziet u enkele voorbeelden van zoeken.
Retourneer alle activa met 'verkoop' in de naam
name:sales
Retourneer alle activa die zijn geregistreerd na 20-4-2015 die 'verkoop' in een onroerend goed bevatten
sales AND lastRegisteredTime>"4/20/2015"
Alle activa retourneren die verkopen in een onroerend goed bevatten en die niet de tag Q1FY2013 hebben
sales AND tags<>"Q1FY2013"
Alle assets retourneren waaraan geen experts of documentatie zijn toegewezen
not has:experts and not has:documentation