Datendomains verwenden

Vorschau

Dieses Produkt oder Feature unterliegt den "Nutzungsbedingungen für Pre-GA-Angebote" im Abschnitt "Allgemeine Dienstbedingungen" der Dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Als Nutzer einer Datendomain können Sie Datendomains verwenden, um Suchergebnisse auf bestimmte geschäftliche Kontexte zu beschränken, nach BigQuery-Datasets, -Tabellen und -Datenprodukten zu suchen und Metadaten innerhalb bestimmter Domainbegrenzungen zu finden.

Hinweis

Bevor Sie eine Suche nach Domain durchführen, prüfen Sie, ob Sie die erforderlichen Rollen haben und die erforderlichen APIs aktiviert sind.

APIs aktivieren

Dataplex API aktivieren

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 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 Datendomain zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Suchen und Auffinden von Metadaten mithilfe von Datendomains benötigen:

• Metadaten von Domäneneinträgen zur Auffindung ansehen: Dataplex Data Domain Entry Reader (roles/dataplex.dataDomainEntryReader)
• Domänenkonfigurationen und -bindungen ansehen: Dataplex Data Domain Configuration Viewer (roles/dataplex.dataDomainViewer)

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 Natürliche Suche testen , 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 beschränken 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 Datendomains Seite auf.

   Zu Datendomains

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

3. Verwenden Sie das Suchfeld, um Ressourcen in der Domain zu finden.

REST

Verwenden Sie die Methode projects.locations.searchEntries und geben Sie den Domainpfad im Parameter contexts an, um nach Einträgen zu suchen, die auf eine Datendomain beschränkt sind.

Hinweis: Der Standort im Pfad für searchEntries kann je nach Konfiguration des Such-Back-Ends global (für vollständige Verteilung) oder eine bestimmte Region sein.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die ID Ihres Google Cloud Projekts in.
• LOCATION_ID: die Region für die Suchanfrage (oder global).
• QUERY: der Suchabfragestring.
• 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 der Anfrage:

{
  "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:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries" | Select-Object -Expand Content

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 Datendomain 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, da die Domainberechtigungen gelten.
• Suche außerhalb der Domain:Das Dataset wird in den Suchergebnissen nicht angezeigt. Bei einer allgemeinen Suche gelten keine Domainberechtigungen und Sie haben keinen direkten Zugriff in BigQuery.

Nächste Schritte

• Weitere Informationen zu Datendomains.
• Datendomains erstellen
• Erfahren Sie, wie Sie Datendomainressourcen verwalten.