In Dataplex Catalog nach Daten-Assets suchen

Verwenden Sie die Suche in Dataplex Catalog, um nach Daten-Assets wie wie BigQuery-Datasets, Cloud SQL-Instanzen und andere. Weitere Informationen Informationen zu den Google Cloud-Assets, die in Dataplex Catalog, siehe Unterstützte Google Cloud-Quellen.

Suchbereich

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

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

Die Suchergebnisse enthalten nur die Ressourcen, die zum selben VPC-SC gehören Perimeter als Projekt festlegen, in dem die Suche ausgeführt wird. Bei Verwendung des Google Cloud Console ist das Projekt, das in der .

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 nicht zurückgegeben, auch in nachfolgenden Ergebnissen Seiten. Außerdem können zurückgegebene (und nicht zurückgegebene) Ergebnisse variieren, wenn Sie Suchanfragen.

Nach Datum getrennte Tabellen

Dataplex Catalog fasst nach Datum fragmentierte Tabellen in einer einzigen Logeintrag enthält. Dieser Eintrag hat das gleiche Schema wie der Tabellen-Shard mit den meisten letztes 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 auf das Dataset zugreifen können, in dem sie enthalten sind. Einzelne datumsfragmentierte Daten Tabellen sind in der Dataplex Catalog-Suche nicht sichtbar, auch wenn sind sie in Dataplex Catalog vorhanden und können getaggt werden.

Filter

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

  • Systeme wie BigQuery, Cloud SQL und andere. Die 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, die Ressourcentypen beschreiben, z. B. Datenbanken, Datasets, Modellen, Tabellen, Ansichten, Diensten und benutzerdefinierten Typen.
  • Datasets stammen aus BigQuery.

Du kannst Filter aus mehreren Bereichen kombinieren, um Assets zu finden, die mindestens eine Bedingung aus jedem ausgewählten Bereich. Mehrere Filter, die die in einem Abschnitt ausgewählt wurden, werden mit dem logischen Operator OR ausgewertet.

Sehen Sie sich beispielsweise die Filterkombination in der folgenden Abbildung an (Bild klicken) zum Vergrößern). 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 Aspekte können Sie nach Assets abfragen, die mit einem bestimmten Vorlage. Über das Menü Anpassen können Sie die Ergebnisse und nach bestimmten Aspektwerten filtern. Die Filterbedingungen für Aspektwerte hängen von Datentyp dieses Aspektfelds. Zum Beispiel für die datetime und number können Sie ein bestimmtes Datum oder einen Zeitraum angeben.

Filtersichtbarkeit

Die Filter Systeme, Typaliasse, Projekt und Datasets sind wird abhängig von der aktuellen Suchanfrage im Feld Suchen angezeigt.

Hinweise

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

Erforderliche Rollen

In diesem Abschnitt werden die Rollen und Berechtigungen beschrieben, die für die Suche nach Daten erforderlich sind. und auf die Suchergebnisse zugreifen können.

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.

Erforderliche Rollen für die Suche nach Einträgen

Um nach Einträgen zu suchen, benötigen Sie mindestens einen der Dataplex Catalog-IAM-Rollen das für die Suche verwendet wird. Berechtigungen für Suchergebnisse sind die unabhängig vom ausgewählten Projekt überprüft werden sollen.

Erforderliche Rollen für den Zugriff auf Suchergebnisse

Der Umfang der Suchergebnisse in Dataplex Catalog richtet sich nach den Ihre Rolle. Damit Sie in Dataplex Catalog nach einem Asset suchen können, müssen Sie Berechtigungen für den Zugriff auf die entsprechende Ressource im Quellsystem haben. Weitere Informationen finden Sie im Abschnitt Umfang der Suche. in diesem Dokument.

Um beispielsweise nach BigQuery-Datasets, -Tabellen, -Ansichten und Modelle benötigen Sie entsprechende Berechtigungen für diese Einträge. Weitere Informationen Siehe BigQuery-Berechtigungen: In der folgenden Liste werden die mindestens erforderlichen Berechtigungen beschrieben:

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

Ein weiteres Beispiel für die Suche nach Cloud SQL-Instanzen, Datenbanken, Schemas, Tabellen und Ansichten benötigen Sie entsprechende 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).

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 Dataplex Catalog-Metadatenspeicher. Wird ausgewählt Mit Data Catalog können Sie Ihren Data Catalog durchsuchen. Repository, wenn Sie bereits Data Catalog-Nutzer sind.

  3. Geben Sie eine Abfrage in das Suchfeld ein oder verwenden Sie den Bereich Filter, um die Suchparameter verfeinern.

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

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

  4. Optional: Zusätzlich zu den Ihnen verfügbaren Assets können Sie nach die in Google Cloud öffentlich verfügbar sind, indem Sie Öffentliche Datasets einschließen.

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 das Zeichen NOT voranstellen, um es der logischen Negation des keyword:term-Filter. Sie können auch die booleschen Operatoren AND und OR verwenden um Suchausdrücke zu kombinieren. Die Operatoren AND, OR und NOT sind nicht Groß- und Kleinschreibung berücksichtigen.

    Beispiel: NOT column:term listet alle Spalten außer den auf, die übereinstimmen. den angegebenen Begriff. Eine Liste mit Keywords und anderen Begriffen, die in einen Dataplex Catalog-Suchausdruck finden Sie unter Suchsyntax:

gcloud

Um nach Daten-Assets zu suchen, verwenden Sie die gcloud dataplex entries search-Befehl

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: Enthält Informationen wie Eintragstyp, System, Plattform, voll qualifizierter Name, Erstellungszeit, Zeitpunkt der letzten Änderung, die Beschreibung und die Ordner der 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

Um die Details eines Eintrags anzuzeigen, verwenden Sie die gcloud dataplex entries lookup-Befehl

REST

Um die Details eines Eintrags anzuzeigen, verwenden Sie die lookupEntry-Methode.

Nächste Schritte