Datendomains verwenden

Als Nutzer einer Datendomäne können Sie mit Datendomänen Suchergebnisse auf bestimmte Geschäftskontexte eingrenzen, nach BigQuery-Datasets, -Tabellen und -Datenprodukten suchen und Metadaten innerhalb bestimmter Domänengrenzen ermitteln.

Hinweis

Bevor Sie eine Suche nach Domain durchführen, müssen Sie die erforderlichen Rollen haben und die erforderlichen APIs aktiviert sein.

APIs aktivieren

Aktivieren Sie die Dataplex API, falls sie noch nicht aktiviert ist.

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

API aktivieren

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt oder die Datendomäne zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Suchen und Ermitteln von Metadaten mithilfe von Datendomänen benötigen:

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.

Domainhierarchie durchsuchen

Weitere Informationen zum Durchsuchen der Domainhierarchie finden Sie unter Datendomains und ‑subdomains an einem Standort ansehen.

Ressourcen in einer Datendomain finden

So suchen Sie nach Ressourcen mit einer Domain:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Knowledge Catalog > Suchen auf.

    Zur Suche

  2. Klicken Sie auf Organische Suche ausprobieren, um die Funktion zu aktivieren.

  3. Klicken Sie auf Filter.

  4. Wählen Sie im Feld Bereich in der Liste die Option Domain aus.

  5. Wählen Sie im Feld Domain auswählen die Domain aus, auf die Sie die Ergebnisse eingrenzen möchten. Fügen Sie bei Bedarf weitere Filter hinzu.

Alternativ können Sie die Menüoption In Domain suchen verwenden, um Ressourcen in der Domain zu finden:

  1. Rufen Sie in der Google Cloud Console die Seite Datendomänen auf.

    Zu „Datendomains“

  2. Wählen Sie im Menü  die Option In der Domain suchen aus. Dadurch wird automatisch ein Suchfenster mit dem Filter domain geöffnet.

  3. Über das Suchfeld können Sie nach Ressourcen in der Domain suchen.

REST

Wenn Sie nach Einträgen suchen möchten, die auf eine Datendomäne beschränkt sind, verwenden Sie die Methode projects.locations.searchEntries und geben Sie den Domainpfad im Parameter contexts an.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • LOCATION_ID: Die Region für die Suchanfrage (oder global).
  • QUERY: der Suchanfragestring.
  • DOMAIN_ID: die eindeutige Kennung der Datendomäne, die den Kontext des Suchbereichs definiert.

HTTP-Methode und URL: 

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries

JSON-Text anfordern:

{
  "query": "QUERY",
  "contexts": [ "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" ],
  "semantic_search": true,
  "page_size": 100
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

Beschränkungen

Wenn Sie nach Ressourcen außerhalb des Domainkontexts suchen, z. B. bei einer globalen Suche, gelten die Berechtigungen für die Auffindbarkeit der Domain nicht. Sie sehen nur Ressourcen, auf die Sie im zugrunde liegenden System, z. B. BigQuery, Zugriff haben.

Angenommen, ein BigQuery-Dataset ist in einer Datendomäne enthalten. Sie haben die Rolle Dataplex Data Domain Entry Reader für die Domain, aber keine direkte Berechtigung, das Dataset in BigQuery anzusehen:

  • Suche innerhalb der Domain:Das Dataset wird in den Suchergebnissen angezeigt, weil die Domainberechtigungen gelten.
  • Suche außerhalb der Domain:Der Datensatz wird nicht in den Suchergebnissen angezeigt. Bei einer allgemeinen Suche gelten keine Berechtigungen für Domains und Sie haben keinen direkten Zugriff in BigQuery.

Nächste Schritte