Data Catalog Suchsyntaxreferenz

Azure Data Catalog ist ein vollständig verwalteter Dienst, der in Microsoft Azure gehostet wird und als Registrierungssystem und Ermittlungssystem für Unternehmensdatenquellen dient. Azure Data Catalog verfügt über Funktionen, die es technischen und nicht technischen Benutzern ermöglichen, Datenquellen zu ermitteln, zu verstehen und zu nutzen.

Ein wichtiger Aspekt der Datenermittlung ist die Möglichkeit, nach Datenquellen zu suchen, die in Azure Data Catalog registriert wurden. Azure Data Catalog verfügt über eine leistungsstarke Suchsyntax, mit der Benutzer problemlos Abfragen erstellen können, die die von den Benutzern benötigten Daten zurückgeben.

Übersicht über die Suchsyntax

Azure Data Catalog Suchvorgänge ähneln denen, die von Microsoft Windows und Microsoft Outlook verwendet werden, und sollten den Benutzern dieser Tools vertraut sein.

Abfragetechniken

Verfahren	Verwendung	Beispiel
Standardsuche	Standardsuche mit mindestens einem Suchbegriff. Als Ergebnisse werden alle Ressourcen zurückgegeben, bei denen eine beliebige Eigenschaft mit den angegebenen Begriffen übereinstimmt.	sales data
Eigenschaftsbasierte Suche	Es werden nur Datenquellen zurückgegeben, bei denen der Suchbegriff mit der angegebenen Eigenschaft übereinstimmt.	name:finance
Boolesche Operatoren	Die Suche wird mithilfe von booleschen Vorgängen erweitert oder eingegrenzt.	finance NOT corporate
Gruppierung mit Klammern	Teile der Abfrage werden mithilfe von Klammern gruppiert, um eine logische Isolierung zu erzielen (insbesondere in Verbindung mit booleschen Operatoren).	name:finance AND (tags:tag1 OR tags:tag2)
Vergleichsoperatoren	Für Eigenschaften mit numerischen Datentypen und Datumsdatentypen können andere Vergleiche als Gleichheit verwendet werden.	creationTime>"11/05/2014"

Abgleichs-, Vergleichs- und boolesche Operatoren

Schlüsselwort/Symbol	Beispiele	Funktion
:	experts:user@domain.com tags:tag1	Verwenden Sie die Eigenschaftsdefinition, und geben Sie nur die Objekte zurück, bei denen eine bestimmte Eigenschaft den durchsuchten Text enthält. Die Semantik für die Abfrage ist "Prefix Match".
=	name=Sales name="Soft Drink Sales"	Ermöglicht dem Benutzer, eine genaue Übereinstimmung anzugeben. Nur die Objekte, die die -Eigenschaft mit genau dem Wert des Suchbegriffs enthalten, werden zurückgegeben.
<>	experts<>user1 tags<>tag2	Operator "Nicht gleich". Gibt nur die Ressourcen zurück, die nicht über den in der Suchabfrage angegebenen Wert verfügen.
""	"social security"	Sucht Nach Elementen, die den genauen Ausdruck sozialversicherungssicher enthalten. Es gibt einen Sonderfall für die Verwendung von Anführungszeichen. Wenn Anführungszeichen mit Eigenschaftsbereich verwendet werden, ist die Semantik gruppieren, aber nicht genau. In diesem Fall entspricht das Verhalten dem zweimalen Angeben der benannten Eigenschaft. Beispiel: name:"social security" findet alle Vermögenswerte, die eine Namenseigenschaft mit dem Wort social enthalten, oder eine Namenseigenschaft mit dem Wort Sicherheit darin.
()	(tags:tag1 AND tags:tag2) OR (name:sales AND database:salesfy15)	Sucht Nach Elementen, die tag1 und tag2 enthalten oder den Namen sales in der Datenbank salesfy15 haben. Wird in der Regel in Verbindung mit booleschen Operatoren verwendet.
>,>=	timestamp>"11/05/2014"	Sucht Nach Elementen mit einem geänderten Datum nach dem 11.05.2014.
<,<=	timestamp<"11/05/2014"	Sucht Nach Elementen mit einem Datum vor dem 11.05.2014.
NICHT	social NOT security	Sucht Nach Elementen, die soziale, aber keine Sicherheit enthalten.
AND	social AND security	Sucht nach Elementen, die soziale und sicherheitsrelevante Elemente enthalten.
oder	social OR security	Sucht Nach Elementen, die soziale oder sicherheitsrelevante Elemente enthalten.
Hsa:	has:tags has:description	Lassen Sie das Filtern zu, und geben Sie nur die Ressourcen zurück, bei denen eine bestimmte Eigenschaft festgelegt ist (oder wenn die Eigenschaft eine Auflistung darstellt - sie enthält mindestens ein Element).

Notizen

Präfixsemantik

Standardmäßig werden alle Suchvorgänge in Azure Data Catalog mit einer Technik namens Prefix Match Semantics durchgeführt. Dies bedeutet, dass jeder Suchbegriff eine Übereinstimmung am Anfang der Eigenschaften des Medienobjekts beginnt.

Betrachten Sie beispielsweise zwei fiktive Objekte, die in Azure Data Catalog mit den folgenden Namen registriert sind:

• SalesData
• Zitate für Verkäufer

Bei der Suche nach "Sales" werden beide Ressourcen zurückgegeben, da ihre Namen beide mit dem Wort "Sales" beginnen. Zukünftige Versionen von Azure Data Catalog unterstützung für genaue Übereinstimmungsoperatoren.

Eigenschaftenbezogene Suchvorgänge

Die Azure Data Catalog-Abfragegrammatik unterstützt die Bereichsdefinition von Eigenschaften. In der aktuellen Vorschau wird bei den Eigenschaftenbereichen die Groß-/Kleinschreibung beachtet. Dies bedeutet, dass die tatsächliche Groß-/Kleinschreibung der -Eigenschaft in der Suchabfrage mit dem wert im Index übereinstimmen muss, damit die Abfrage funktioniert.

Suchen nach ungültigen Eigenschaften (Eigenschaften, die nicht vorhanden sind) führen zu einem Fehler.

Anführungszeichen verhalten sich bei Verwendung von Eigenschaftsbereich auf besondere Weise. Anführungszeichen in jedem anderen Kontext geben die genaue Formulierung an. Wenn jedoch Anführungszeichen im Bereich von Eigenschaften verwendet werden, wird die Semantik gruppiert. Führt z. B. eine Freitextsuche durch, name:"Sales Products" die nach dem Inhalt der Namenseigenschaft nach "Sales" oder "Products" sucht. Daher ist die Semantik von name:"Sales Products" genau identisch mit name:Sales name:Products.

Das allgemeine Prinzip für Eigenschaftsnamen in durchsuchbaren Eigenschaften ist camel-case, d. h., dass der erste Buchstabe Kleinbuchstaben ist und dann jeder der ersten Buchstaben Großbuchstaben ist.

Die nützlichsten Eigenschaften sind unten aufgeführt.

Eigenschaft	Verwendung	Beispiel
name	Sucht nach Elementen, bei denen der Suchbegriff im Namen der Datenquelle angezeigt wird.	name:finance
description	Sucht nach Elementen, bei denen der Suchbegriff in der Beschreibung der Datenquelle angezeigt wird.	description:finance
objectType	Sucht Nach Elementen eines bestimmten Objekttyps, z. B. Tabelle, Ansicht oder KPI	objectType:table
sourceType	Sucht Elemente eines bestimmten Datenquellentyps, z. B. SQL Server oder mehrdimensional SQL Server Analysis Services	sourceType:"tabular"
tags	Sucht nach Elementen, bei denen der Suchbegriff in den Datenquellentags angezeigt wird.	tags:finance
timestamp	Sucht Elemente basierend auf dem Datum und der Uhrzeit der letzten Änderung ihrer Metadaten.	timestamp:>"11/05/2014"
lastRegisteredTime	Sucht Elemente basierend auf dem Datum und der Uhrzeit der Metadatenregistrierung.	lastRegisteredTime:>"11/05/2014"
friendlyName	Sucht nach Elementen, bei denen der Suchbegriff im Anzeigenamen der Datenquelle angezeigt wird.	friendlyName: finance
Experten	Findet Elemente, bei denen der Datenquellenexperte mit dem Suchbegriff übereinstimmt.	experts:user@example.com experts:user
termName	Sucht nach Elementen, bei denen der Suchbegriff in geschäftsspezifischen Glossarbegriffen angezeigt wird, die auf das Datenobjekt angewendet werden	termName:marketing

Sie können auch die folgenden Eigenschaftennamen zusammen mit dem Filter "has:" verwenden, um zu überprüfen, wo für Ressourcen bestimmte Eigenschaften festgelegt sind.

Eigenschaft	Verwendung	Beispiel
Vorschau	Sucht nach Elementen, die eine Vorschau enthalten	has:preview
Dokumentation	Sucht nach Elementen, die Dokumentation enthalten	has:documentation
tableDataProfiles	Sucht nach Elementen mit einem Tabellenprofil (Größe, Anzahl der Zeilen usw.)	has:tableDataProfiles
columnsDataProfiles	Sucht nach Elementen, die über ein Spaltendatenprofil verfügen (Anzahl unterschiedlicher Werte, min, max usw.)	has:columnsDataProfiles

Suchbeispiele

In den folgenden Abschnitten finden Sie einige Suchbeispiele.

Zurückgeben aller Ressourcen mit "Sales" im Namen

name:sales

Zurückgeben aller nach dem 20.04.2015 registrierten Vermögenswerte, die "Verkäufe" in jeder Immobilie enthalten

sales AND lastRegisteredTime>"4/20/2015"

Zurückgeben aller Ressourcen, die Verkäufe in einer Beliebigen Immobilie enthalten und die nicht über das Tag "Q1FY2013" verfügen

sales AND tags<>"Q1FY2013"

Zurückgeben aller Ressourcen, denen keine Experten oder Dokumentation zugewiesen sind

not has:experts and not has:documentation