Suchsyntax für Dataplex Catalog

In diesem Dokument wird die Syntax für Dataplex-Suchanfragen beschrieben. Vorher dieses Dokument lesen, ist es wichtig, dass Sie die Konzepte Dataplex Catalog wie Dateneinträge, Aspekte, Aspekttypen, Eintragsgruppen und Eintragstypen. Weitere Informationen finden Sie unter Dataplex-Katalog – Übersicht

So starten Sie eine Dataplex Catalog-Suchabfrage in der Rufen Sie in der Google Cloud Console die Dataplex-Seite Suche auf und Wählen Sie Dataplex Catalog als Suchmodus aus.

Zur Suche

Weitere Informationen finden Sie unter Suchen Sie in Dataplex Catalog nach Daten-Assets.

In ihrer einfachsten Form besteht eine Dataplex Catalog-Suchabfrage aus Prädikats zu verstehen. Ein solches Prädikat kann mit mehreren Metadaten übereinstimmen:

  • Teilstring eines Namens, eines Anzeigenamens oder einer Beschreibung eines Daten-Assets
  • Teilstring des Typs eines Daten-Assets
  • Eine Teilzeichenfolge eines Spaltennamens (oder Name der verschachtelten Spalte) im Schema einer Daten Asset
  • Ein Teilstring einer Projekt-ID
  • String aus einer Übersichtsbeschreibung

Das Prädikat foo stimmt beispielsweise mit den folgenden Entitäten überein:

  • Daten-Asset mit dem Namen „foo.bar“
  • Daten-Asset mit dem Anzeigenamen Foo Bar
  • Datenasset mit der Beschreibung This is the foo script
  • Daten-Asset mit dem genauen Typ „foo“
  • Spalte foo_bar im Schema eines Datenassets
  • Verschachtelte Spalte foo_bar im Schema eines Datenassets
  • Projekt prod-foo-bar
  • Daten-Asset mit einer Übersicht, die das Wort „foo“ enthält

Qualifizierte Prädikate

Sie können ein Prädikat qualifizieren, indem Sie ihm einen Schlüssel voranstellen, der die Übereinstimmung mit einem bestimmten Metadatenelement:

  • Ein Gleichheitszeichen (=) beschränkt die Suche auf eine genaue Übereinstimmung.
  • Ein Doppelpunkt (:) nach dem Schlüssel entspricht dem Prädikat entweder einem Teilstring oder einem Token innerhalb des Werts in den Suchergebnissen.

Bei der Tokenisierung wird der Textfluss in eine Reihe von Tokens aufgeteilt, Token, das normalerweise einem einzelnen Wort entspricht.

Beispiel:

  • name:foo zum Auswählen von Entitäten mit Namen, die den Teilstring foo enthalten, z. B. foo1 und barfoo.
  • description:foo zum Auswählen von Entitäten mit dem Token foo in der Beschreibung wie bar und foo.
  • location=foo gleicht Daten-Assets an einem bestimmten Standort mit foo als den Standortnamen.

Die Prädikatsschlüssel type, system, location und orgid unterstützen nur die Qualifier für genaue Übereinstimmung (=) und nicht für Teilstring-Qualifier (:). Beispiel: type=foo oder orgid=number.

Dataplex Catalog unterstützt die folgenden Qualifizierer:

Kennzeichner Beschreibung
name:x Führt zu Übereinstimmung von x mit einem Teilstring der Daten-Asset-ID.
displayname:x Führt zu Übereinstimmung von x mit einem Teilstring des Anzeigenamens des Daten-Assets.
column:x Stimmt mit x als Teilstring des Spaltennamens (oder verschachtelt) überein. Spaltenname) im Schema des Daten-Assets ein.
description:x Führt zu Übereinstimmung von x mit einem Token in der Beschreibung des Daten-Assets.
label:bar Gleicht BigQuery-Daten-Assets mit einem Label ab (mit einigen Wert) und der Labelschlüssel hat bar als Teilstring.
label=bar Gleicht BigQuery-Daten-Assets mit einem Label (mit ein Wert) und der Labelschlüssel ist bar als String.
label:bar:x Gleicht x als Teilstring im Wert eines Labels mit Schlüssel bar, der an ein BigQuery-Daten-Asset angehängt ist.
label=foo:bar Gleicht BigQuery-Daten-Assets ab, bei denen der Schlüssel gleich foo und der Schlüsselwert ist bar.
label.foo=bar Gleicht BigQuery-Daten-Assets ab, bei denen der Schlüssel gleich foo und der Schlüsselwert ist bar.
label.foo Gleicht BigQuery-Daten-Assets mit einem Label ab, dessen Schlüssel entspricht foo als String.
type=TYPE Gleicht Daten-Assets eines bestimmten Eintragstyps oder deren Typalias ab.
projectid:bar Gleicht Daten-Assets in Google Cloud-Projekten ab, die mit bar als Teilstring in der ID.
parent:x Stimmt mit x als Teilstring des hierarchischen Pfades eines Daten-Asset. Der übergeordnete Pfad ist ein fully_qualified_name von der übergeordneten Ressource.
orgid=number Gleicht Daten-Assets in einer Google Cloud-Organisation mit Den genauen ID-Wert von number
system=SYSTEM Gleicht Daten-Assets aus einem angegebenen System ab.
location=LOCATION

Gleicht Daten-Assets an einem angegebenen Standort mit einem genauen Namen ab. Beispielsweise stimmt location=us-central1 mit gehosteten Assets überein in Iowa.

BigQuery Omni-Assets unterstützen diesen Qualifizierer mithilfe der Methode BigQuery Omni-Standortname. Beispiel: location=aws-us-east-1 stimmt mit BigQuery Omni überein in Nord-Virginia.

createtime

Damit finden Sie Daten-Assets, die in, vor oder nach einem bestimmten Datum oder Uhrzeit.

Beispiel:

  • createtime:2019-01-01 stimmt mit Daten-Assets überein, die erstellt wurden am 01.01.2019.
  • createtime<2019-02 stimmt mit den erstellten Daten-Assets überein vor 01.02.2019T00:00:00.
  • createtime>2019-02 stimmt mit den erstellten Daten-Assets überein nach 01.02.2019T00:00:00.

Zeitstempelformat: YYYY-MM-DDThh:mm:ss

Alle Zeitstempel müssen in GMT angegeben sein. Zeitzonen werden nicht unterstützt. Teilweise Zeitstempel, Bindestrich (-) Datumstrennzeichen und Schrägstrich (/) Datumstrennzeichen werden unterstützt.

Beispiel:

  • 2010-10-22T05:36:24
  • 2010-10-22T05:36
  • 2010-10-22T05
  • 2010-10-22
  • 2010-10
  • 2010
  • 2010/10/22
updatetime

Findet Daten-Assets, die innerhalb, vor oder nach einem bestimmten Datum oder Uhrzeit.

Beispiel:

  • updatetime:2019-01-01 stimmt mit Daten-Assets überein, die aktualisiert wurden am 01.01.2019.
  • updatetime<2019-02 Übereinstimmungen mit aktualisierten Daten-Assets vor 01.02.2019T00:00:00.
  • updatetime>2019-02 Übereinstimmungen mit aktualisierten Daten-Assets nach 01.02.2019T00:00:00.

Zeitstempelformat: YYYY-MM-DDThh:mm:ss

Alle Zeitstempel müssen in GMT angegeben sein. Zeitzonen werden nicht unterstützt. Teilweise Zeitstempel, Bindestrich (-) Datumstrennzeichen und Schrägstrich (/) Datumstrennzeichen werden unterstützt.

Beispiel:

  • 2010-10-22T05:36:24
  • 2010-10-22T05:36
  • 2010-10-22T05
  • 2010-10-22
  • 2010-10
  • 2010
  • 2010/10/22
fully_qualified_name:x Stimmt mit x als Teilstring von fully_qualified_name überein.
fully_qualified_name=x Stimmt mit x als fully_qualified_name überein.

Verwenden Sie die folgende Abfrage, um anhand der angehängten Aspekte nach Einträgen zu suchen Syntax.

Kennzeichner Beschreibung
aspect:x Stimmt mit x als Teilstring des vollständigen Pfads zum Aspekt überein Typ eines Aspekts, der an den Eintrag angehängt ist, im Format projectid.location.ASPECT_TYPE_ID
aspect=x Stimmt mit x als vollständigen Pfad zum Aspekt überein Typ eines Aspekts, der an den Eintrag angehängt ist, im Format projectid.location.ASPECT_TYPE_ID
aspect:xOPERATORvalue

Sucht nach Feldwerten für Aspekte. Stimmt mit x als Teilstring überein des vollständigen Pfads zum Aspekttyp und Feldnamen eines Aspekts, der an den Eintrag angehängt wird, im Format projectid.location.ASPECT_TYPE_ID.FIELD_NAME

Die Liste der unterstützten Operatoren hängt vom Feldtyp im -Aspekt:

  • String: = (genau passend) und : (Teilstring)
  • Alle Zahlentypen: =, :, <, >, <= >=, =>, =<
  • Enum: =
  • Datetime: Wie für Zahlen, aber die zu vergleichenden Werte als Datum- und Uhrzeitangaben statt als Zahlen behandelt
  • Boolescher Wert: =

Nur Felder der obersten Ebene des Aspekts können durchsucht werden.

Beispielsweise stimmen alle folgenden Abfragen mit Einträgen überein, bei denen der Wert des Felds is-enrolled im employee-info Aspekt ist true. Andere Einträge, die mit dem Teilstring übereinstimmen werden ebenfalls zurückgegeben.

  • aspect:example-project.us-central1.employee-info.is-enrolled=true
  • aspect:example-project.us-central1.employee=true
  • aspect:employee=true

Logische Operatoren

Eine Abfrage kann aus mehreren Prädikaten mit logischen Operatoren bestehen. Wenn Sie keine einen Operator angeben, wird das logische AND impliziert. Beispiel: foo bar gibt Entitäten, die sowohl dem Prädikat foo als auch dem Prädikat bar entsprechen.

Logischer AND und logischer OR werden unterstützt. Beispiel: foo OR bar

Sie können ein Prädikat mit dem Präfix - (Bindestrich) oder NOT negieren. Beispiel: -name:foo gibt Entitäten mit Namen zurück, die nicht mit dem Prädikat foo übereinstimmen.

Logische Operatoren unterscheiden nicht zwischen Groß- und Kleinschreibung. Beispielsweise sind sowohl or als auch OR akzeptabel.

Abgekürzte Syntax

Es ist auch eine abgekürzte Suchsyntax verfügbar, bei der | (senkrechter Strich) für OR-Operatoren und , (Komma) für AND-Operatoren.

Um beispielsweise nach Einträgen in einem von vielen Projekten zu suchen, können Sie den OR verwenden. können Sie die folgende abgekürzte Syntax verwenden:

projectid:(id1|id2|id3|id4)

Dieselbe Suche ohne Verwendung der abgekürzten Syntax sieht so aus:

projectid:id1 OR projectid:id2 OR projectid:id3 OR projectid:id4

So suchen Sie nach Einträgen mit übereinstimmenden Spaltennamen:

  • UND: column:(name1, name2, name3)
  • ODER: column:(name1|name2|name3)

Diese abgekürzte Syntax funktioniert für die qualifizierte Prädikate mit Ausnahme von label.

Nächste Schritte