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
Dataplex Catalog sucht nach den folgenden Assets:
- BigQuery-Tabellen in
test_bq_dataset
mit dem AspektMy aspect type 1
- BigQuery-Tabellen in
test_bq_dataset
mit dem AspektMy aspect type 2
- BigQuery-Ansichten in
test_bq_dataset
mit dem AspektMy aspect type 1
- BigQuery-Ansichten in
test_bq_dataset
mit dem AspektMy 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.
Nach Datenassets suchen
Console
So suchen Sie nach Daten-Assets:
Rufen Sie in der Google Cloud Console die Seite der Dataplex-Suche auf.
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.
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.
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 deskeyword:term
-Filter. Sie können auch die booleschen OperatorenAND
undOR
verwenden um Suchausdrücke zu kombinieren. Die OperatorenAND
,OR
undNOT
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.
Rufen Sie in der Google Cloud Console die Seite der Dataplex-Suche auf.
Wählen Sie Dataplex Catalog als Suchmodus aus.
Geben Sie den Namen eines Eintrags in das Suchfeld ein.
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
- Suchsyntax für Dataplex Catalog lesen.
- Weitere Informationen zu Dataplex Catalog.
- Weitere Informationen zum Anreichern von Einträgen mit Metadaten mithilfe von Aspekten
- Einträge verwalten und benutzerdefinierte Quellen aufnehmen