Datendomains verwenden

Mit Datendomains in Knowledge Catalog (ehemals Dataplex Universal Catalog) können Sie Suchergebnisse auf bestimmte Geschäftskontexte eingrenzen und Metadaten innerhalb definierter Grenzen finden. Als Nutzer einer Datendomain können Sie die Domainhierarchie durchsuchen, nach Domainressourcen suchen und Domainkontext abrufen, um KI-Agenten zu fundieren.

Hinweis

Bevor Sie eine Suche nach Domain ausführen, müssen Sie die erforderlichen Rollen und APIs aktivieren.

APIs aktivieren

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

Erforderliche Rollen zum Aktivieren von APIs

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 Inhaberrolle (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 Datendomain zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Suchen und Entdecken von Metadaten mithilfe von Datendomains 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 Daten-Domains und ‑Subdomains an einem Standort ansehen.

Ressourcen in einer Datendomain finden

Sie können innerhalb einer Datendomain nach Ressourcen wie BigQuery-Datasets, ‑Tabellen und ‑Datenprodukten suchen und deren Metadaten aufrufen. So suchen Sie nach Ressourcen in einer Domain:

Console

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

    Zur Suche

  2. Klicken Sie auf Natürliche Suche ausprobieren, um die Funktion für die natürliche Suche zu aktivieren.

  3. Klicken Sie auf Filter.

  4. Wählen Sie im Feld Bereich die Option Domain aus der Liste 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 Daten-Domains auf.

    Zu „Daten-Domains“

  2. Wählen Sie im Menü  die Option In 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 Datendomain 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 Suchanfrage-String.
  • DOMAIN_ID: die eindeutige Kennung der Datendomain, 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.

Kontext für Datendomains abrufen

Mit der Methode lookupContext können Sie KI-Agenten im Geschäftskontext Ihrer Datendomains fundieren. Die Methode lookupContext unterstützt Datendomains auf folgende Weise:

  • Kontext für eine Datendomäne. Sie können den Eintrag, der eine Datendomain darstellt, in der Liste resources übergeben. Die Antwort enthält die Metadaten der Datendomain, z. B. die Beschreibung und die übergeordneten Datendomains in der Domainhierarchie.
  • Zugehörigkeit von Daten-Assets zu Datendomains. Wenn Sie Kontext für ein Daten-Asset abrufen, das in einer oder mehreren Datendomains enthalten ist, enthält die Antwort ein dataDomains-Feld, in dem die Datendomains aufgeführt sind, zu denen das Asset gehört. Die Liste beginnt mit der spezifischsten Domain und steigt bis zur Top-Level-Domain auf.

Senden Sie die folgende Anfrage, um den Kontext für eine Datendomain abzurufen:

curl --request POST \
  'https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:lookupContext' \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H 'Content-Type: application/json' \
  -d '{
    "resources": [
      "projects/PROJECT_ID/locations/LOCATION/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION/dataDomains/DATA_DOMAIN_ID"
    ],
    "options": {
      "format": "yaml"
    }
  }'

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, das die Datendomain enthält.
  • PROJECT_NUMBER: die Nummer des Projekts, das die Datendomain enthält.
  • LOCATION: der Standort der Datendomain.
  • DATA_DOMAIN_ID: die ID der Datendomain.

Weitere Informationen zur Methode lookupContext finden Sie unter Kontext für Daten-Assets abrufen.

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 aufzurufen:

  • Suche innerhalb der Domain:Das Dataset wird in Ihren Suchergebnissen angezeigt, da die Domainberechtigungen gelten.
  • Suche außerhalb der Domain:Das Dataset wird nicht in den Suchergebnissen angezeigt. Bei einer allgemeinen Suche gelten keine Domainberechtigungen und Sie haben keinen direkten Zugriff in BigQuery.

Nächste Schritte