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