In diesem Dokument finden Sie eine Anleitung dazu, wie Sie in Knowledge Catalog nach Datenassets suchen.
Hinweis
Bevor Sie eine Suche durchführen, müssen Sie sicherstellen, dass Ihnen die erforderlichen Rollen zugewiesen wurden und Sie die erforderliche API aktiviert haben.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Suchen nach Einträgen und zum Aufrufen von Suchergebnissen im Knowledge Catalog benötigen:
-
Nach Einträgen suchen:
- Dataplex Catalog Admin (
roles/dataplex.catalogAdmin) für das Projekt, das für die Suche verwendet wird - Dataplex Catalog Editor (
roles/dataplex.catalogEditor) für das Projekt, das für die Suche verwendet wird - Dataplex Catalog-Betrachter (
roles/dataplex.catalogViewer) für das Projekt, das für die Suche verwendet wird
- Dataplex Catalog Admin (
-
Metadaten für BigQuery-Datasets und -Tabellen suchen:
BigQuery-Metadatenbetrachter (
roles/bigquery.metadataViewer) für das Dataset oder die Tabelle -
Nach benutzerdefinierten Einträgen suchen:
Dataplex Catalog Viewer (
roles/dataplex.catalogViewer) für das Projekt, das für die Suche verwendet wird
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Berechtigungen auf Asset-Ebene
Die Suchergebnisse sind unabhängig vom ausgewählten Projekt auf Ihre Zugriffsebene beschränkt. Wenn Sie ein Asset im Knowledge Catalog finden möchten, benötigen Sie die entsprechenden Leseberechtigungen für diese Ressource im zugrunde liegenden Quellsystem.
Wenn Sie beispielsweise eine BigQuery-Tabelle suchen möchten, benötigen Sie die Rolle roles/bigquery.metadataViewer. Wenn Sie eine Cloud SQL-Instanz suchen möchten, benötigen Sie die entsprechenden Cloud SQL-Berechtigungen. Weitere Informationen finden Sie unter Suchbereich.
API aktivieren
Dataplex API aktivieren
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen
Nach Ressourcen suchen
Console
So suchen Sie nach Ressourcen:
Rufen Sie in der Google Cloud Console die Seite Suchen im Knowledge Catalog auf.
Wenn Sie die Aufforderung Suche in natürlicher Sprache ausprobieren sehen, klicken Sie darauf. Standardmäßig ist die Suche in natürlicher Sprache ausgewählt.
Geben Sie im Feld Mit der Suche in natürlicher Sprache projektübergreifend nach Ressourcen suchen Ihre Anfrage ein und klicken Sie dann auf die Eingabetaste.
Wenn Sie die Suche eingrenzen möchten, klicken Sie auf Filter.
- Filter in mehreren Abschnitten werden mit dem logischen Operator
ANDausgewertet. - Mehrere Filter in einem Abschnitt werden mit dem logischen Operator
ORausgewertet.
Folgende Filter sind verfügbar:
- Umfang: Sie können in der gesamten Organisation (Standard), im aktuellen Projekt oder nur nach mit Sternchen markierten Ressourcen suchen. Weitere Informationen finden Sie unter Suchbereich.
- Systeme: Der Google Cloud Dienst, zu dem die Ressource gehört, z. B. BigQuery. Das Knowledge Catalog-System enthält Eintragsgruppen.
- Projekte: die Projekte, in denen gesucht werden soll.
- Typ: Der Ressourcentyp, z. B. BigQuery-Verbindung, Cloud Storage-Bucket oder Datenbank. Je nach Ressourcentyp können Sie auch nach Untertyp filtern, z. B. nach Verbindungstyp oder SQL-Dialekt.
- Standorte auswählen: die Standorte, an denen gesucht werden soll.
- Datasets auswählen: Die Suchergebnisse sind auf BigQuery-Ressourcen beschränkt, die zu den ausgewählten BigQuery-Datasets gehören. Geben Sie im Feld Zum Filtern eingeben den Namen des Datasets ein.
- Aspekttypen: Die Aspekttypen des Knowledge Catalog, die mit der Ressource verknüpft sind, nach der Sie suchen. Wenn Sie nach Aspektwerten filtern möchten, klicken Sie auf Nach Aspekttypwerten filtern und wählen Sie die Werte aus.
- Filter in mehreren Abschnitten werden mit dem logischen Operator
Wenn Sie weitere Informationen zur gesuchten Ressource aufrufen möchten, klicken Sie in den Suchergebnissen auf den Ressourcennamen, um die Detailseite des Eintrags zu öffnen.
Google Cloud CLI
Verwenden Sie den Befehl gcloud dataplex entries search, um nach Ressourcen zu suchen:
gcloud dataplex entries search 'foo' \ --project=PROJECT_ID \ --semantic-search
Ersetzen Sie PROJECT_ID durch die ID des Google Cloud -Projekts.
C#
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog C# API.
Richten Sie zur Authentifizierung bei Knowledge Catalog die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog Go API.
Richten Sie zur Authentifizierung bei Knowledge Catalog die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog Java API.
Richten Sie zur Authentifizierung bei Knowledge Catalog die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog Node.js API.
Richten Sie zur Authentifizierung bei Knowledge Catalog die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
PHP
PHP
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für PHP in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog PHP API.
Richten Sie zur Authentifizierung bei Knowledge Catalog die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog Python API.
Richten Sie zur Authentifizierung bei Knowledge Catalog die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.