In Dataplex Catalog nach Daten-Assets suchen

Verwenden Sie die Suche in Dataplex Catalog, um nach Daten-Assets wie BigQuery-Datasets, Cloud SQL-Instanzen und anderen zu suchen. Weitere Informationen zu den Google Cloud-Assets, die in Dataplex Catalog unterstützt werden, finden Sie unter Unterstützte Google Cloud-Quellen.

Suchbereich

In den Suchergebnissen in Dataplex Catalog werden Ihre Berechtigungen für die entsprechenden Ressourcen in Quellsystemen berücksichtigt.

Wenn Sie beispielsweise Lesezugriff auf BigQuery-Metadaten auf ein Objekt haben, wird dieses Objekt in den Dataplex Catalog-Suchergebnissen angezeigt. Wenn Sie Zugriff auf eine BigQuery-Tabelle haben, aber nicht auf das Dataset, das diese Tabelle enthält, wird die Tabelle in der Dataplex Catalog-Suche weiterhin wie erwartet angezeigt.

Die Suchergebnisse enthalten nur Ressourcen, die zum selben VPC-SC-Perimeter wie das Projekt gehören, in dem die Suche ausgeführt wird. Wenn Sie die Google Cloud Console verwenden, ist dies das Projekt, das in der Console ausgewählt wird.

Weitere Informationen zu IAM-Rollen von Dataplex Catalog finden Sie unter Dataplex-IAM-Rollen.

Einschränkungen der Trefferquote bei der Suche

Dataplex Catalog-Suchanfragen garantieren keinen vollständigen Recall. Ergebnisse, die Ihrer Abfrage entsprechen, werden möglicherweise selbst auf nachfolgenden Ergebnisseiten nicht zurückgegeben. Außerdem können zurückgegebene (und nicht zurückgegebene) Ergebnisse variieren, wenn Sie Suchanfragen wiederholen.

Nach Datum getrennte Tabellen

Dataplex Catalog fasst nach Datum fragmentierte Tabellen zu einem einzigen logischen Eintrag zusammen. Dieser Eintrag hat das gleiche Schema wie der Tabellen-Shard mit dem aktuellsten Datum. Der Eintrag bezieht sich auf die Zugriffsebene des Datasets, zu dem er gehört. Die Dataplex Catalog-Suche zeigt diese logischen Einträge nur an, wenn Sie Zugriff auf das Dataset haben, in dem sie enthalten sind. Einzelne datumsfragmentierte Tabellen sind in der Dataplex Catalog-Suche nicht sichtbar, auch wenn sie in Dataplex Catalog vorhanden sind und getaggt werden können.

Filter

Mit Filtern können Sie die Suchergebnisse eingrenzen. Alle Filter sind in Abschnitten gruppiert:

  • Systeme wie BigQuery, Cloud SQL und andere. Das Dataplex-System enthält benutzerdefinierte Einträge.
  • Unter Aspekte (Tags) werden alle Aspekte aufgelistet, die Ihnen zur Verfügung stehen.
  • Unter Projekt werden alle Projekte aufgelistet, die Ihnen zur Verfügung stehen.
  • Typaliasse zur Beschreibung von Ressourcentypen wie Datenbanken, Datasets, Modelle, Tabellen, Ansichten, Dienste und benutzerdefinierte Typen.
  • Datasets stammen aus BigQuery.

Sie können Filter aus mehreren Bereichen kombinieren, um Assets zu finden, die mindestens einer Bedingung aus jedem ausgewählten Bereich entsprechen. Mehrere Filter, die in einem einzelnen Abschnitt ausgewählt werden, werden mit dem logischen Operator OR ausgewertet.

Sehen Sie sich beispielsweise die Filterkombination in der folgenden Abbildung an (zum Vergrößern auf das Bild klicken). Diese Suchfilter sind ausgewählt: Systeme BigQuery, Typaliasse table und view, Aspekte My aspect type 1 und My aspect type 2, Projekt my-test-project und Datasets test_bq_dataset.

Suchfilter mit Mehrfachauswahl.

Dataplex Catalog sucht nach den folgenden Assets:

  • BigQuery-Tabellen in test_bq_dataset mit dem Aspekt My aspect type 1
  • BigQuery-Tabellen in test_bq_dataset mit dem Aspekt My aspect type 2
  • BigQuery-Ansichten in test_bq_dataset mit dem Aspekt My aspect type 1
  • BigQuery-Ansichten in test_bq_dataset mit dem Aspekt My aspect type 2

Nach Aspektwert filtern

Mit den Filtern vom Typ Aspects können Sie Assets abfragen, die mit einer bestimmten Vorlage getaggt wurden. Über das Menü Anpassen können Sie die Ergebnisse weiter verfeinern und nach bestimmten Aspektwerten filtern. Die Filterbedingungen für Aspektwerte hängen vom Datentyp des jeweiligen Aspektfelds ab. Für die Felder datetime und number können Sie beispielsweise ein bestimmtes Datum oder einen Zeitraum angeben.

Filtersichtbarkeit

Die Filter Systeme, Typaliasse, Projekt und Datasets werden abhängig von der aktuellen Abfrage im Feld Suchen angezeigt.

Hinweise

Führen Sie die folgenden Schritte aus, bevor Sie nach Daten-Assets suchen.

Erforderliche Rollen

Die Suchergebnisse in Dataplex Catalog werden Ihrer Rolle entsprechend eingeschränkt. Wenn Sie in Dataplex Catalog nach einem Asset suchen möchten, benötigen Sie Berechtigungen für den Zugriff auf die entsprechende Ressource im Quellsystem. Weitere Informationen finden Sie im Abschnitt Suchbereich in diesem Dokument.

Wenn Sie beispielsweise nach BigQuery-Datasets, -Tabellen, -Ansichten und -Modellen suchen möchten, benötigen Sie die entsprechenden Berechtigungen für diese Einträge. Weitere Informationen finden Sie unter BigQuery-Berechtigungen. In der folgenden Liste werden die mindestens erforderlichen Berechtigungen beschrieben:

  • Zum Suchen nach einer Tabelle benötigen Sie die Berechtigung bigquery.tables.get für diese Tabelle.
  • Um nach einem Dataset zu suchen, benötigen Sie die Berechtigung bigquery.tables.get für dieses Dataset.
  • Zum Suchen nach Metadaten für ein Dataset oder eine Tabelle benötigen Sie die Rolle „BigQuery-Metadatenbetrachter“ (roles/bigquery.metadataViewer).

Ein weiteres Beispiel: Wenn Sie nach Cloud SQL-Instanzen, Datenbanken, Schemas, Tabellen und Ansichten suchen möchten, benötigen Sie die entsprechenden Berechtigungen für diese Einträge. Weitere Informationen finden Sie unter Cloud SQL-Rollen und -Berechtigungen.

Zum Suchen nach benutzerdefinierten Einträgen benötigen Sie die Rolle „ Dataplex Catalog Viewer“ (roles/dataplex.catalogViewer).

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

API aktivieren

Dataplex API aktivieren.

Aktivieren Sie die API

Nach Datenassets suchen

Console

So suchen Sie nach Daten-Assets:

  1. Rufen Sie in der Google Cloud Console die Seite der Dataplex-Suche auf.

    Zur Suche

  2. Wählen Sie unter Suchplattform auswählen die Option Dataplex-Katalog als Suchmodus aus.

    Wenn Sie Dataplex Catalog auswählen, können Sie im Metadatenspeicher von Dataplex Catalog suchen. Wenn Sie Data Catalog auswählen, können Sie Ihr Data Catalog-Repository durchsuchen, wenn Sie bereits Data Catalog-Nutzer sind.

  3. Geben Sie eine Abfrage in das Suchfeld ein oder verfeinern Sie die Suchparameter im Bereich Filter.

    Sie können die folgenden Filter manuell hinzufügen:

    • Projektfilter hinzufügen: Klicken Sie unter Projekt auf Projekt hinzufügen. Suchen Sie nach einem bestimmten Projekt, wählen Sie das Projekt aus und klicken Sie dann auf Öffnen.
    • Aspekttypfilter hinzufügen: Klicken Sie unter Aspekte auf das Menü Weitere Aspekttypen hinzufügen. Suchen Sie nach einer bestimmten Vorlage, wählen Sie sie aus und klicken Sie auf OK.

  4. Optional: Zusätzlich zu den verfügbaren Assets können Sie nach Daten-Assets suchen, die in Google Cloud öffentlich verfügbar sind. Wählen Sie dazu Öffentliche Datasets einschließen aus.

Beachten Sie beim Erstellen einer Suchanfrage die folgenden Tipps:

  • Setzen Sie den Suchausdruck in Anführungszeichen, wenn er Leerzeichen enthält. Beispiel: "search terms"

  • Sie können einem Keyword NOT voranstellen, um es der logischen Negation des Filters keyword:term zu entsprechen. Sie können auch die booleschen Operatoren AND und OR verwenden, um Suchausdrücke zu kombinieren. Bei den Operatoren AND, OR und NOT wird die Groß- und Kleinschreibung nicht berücksichtigt.

    Beispielsweise listet NOT column:term alle Spalten mit Ausnahme der Spalten auf, die mit dem angegebenen Begriff übereinstimmen. Eine Liste der Schlüsselwörter und anderen Begriffe, die Sie in einem Dataplex Catalog-Suchausdruck verwenden können, finden Sie unter Suchsyntax.

gcloud

Verwenden Sie den Befehl gcloud dataplex entries search, um nach Datenassets zu suchen.

REST

Mit der Methode searchEntries können Sie nach Daten-Assets suchen.

Details eines Eintrags ansehen

Console

Verwenden Sie die Dataplex Catalog-Suche, um die Details eines Eintrags anzusehen.

  1. Rufen Sie in der Google Cloud Console die Seite der Dataplex-Suche auf.

    Zur Suche

  2. Wählen Sie Dataplex Catalog als Suchmodus aus.

  3. Geben Sie den Namen eines Eintrags in das Suchfeld ein.

  4. Klicken Sie auf den Eintrag.

    Die Seite mit den Eintragsdetails wird geöffnet. Die Seite enthält die folgenden Abschnitte:

    • Eintragsdetails: Umfasst Informationen wie Eintragstyp, System, Plattform, vollständig qualifizierter Name, Erstellungszeit, Zeitpunkt der letzten Änderung, Beschreibung und Ordner.
    • Übersicht: eine Übersicht über den Eintrag, falls verfügbar.
    • Aspekte: die erforderlichen und optionalen Aspekte, die für den Eintrag festgelegt wurden. Weitere Informationen finden Sie unter Kategorien von Aspekten.

gcloud

Die Details eines Eintrags können Sie mit dem Befehl gcloud dataplex entries lookup aufrufen.

REST

Zum Aufrufen der Details eines Eintrags verwenden Sie die Methode lookupEntry.

Nächste Schritte