Datendomains erstellen

Mit Datendomänen und Unterdomänen in Knowledge Catalog (ehemals Dataplex Universal Catalog) können Sie Daten-Assets und ‑Produkte in einer logischen Hierarchie organisieren, die Ihre Geschäftsstruktur widerspiegelt. Nachdem Sie eine Domain erstellt haben, können Sie Identity and Access Management-Rollen und -Berechtigungen zuweisen, um zu steuern, wie Nutzer mit der Domain und ihren Ressourcen interagieren.

Hinweis

Bevor Sie Datendomains erstellen und Domaininhaber zuweisen, müssen Sie die erforderlichen Rollen und APIs aktivieren.

  • Die maximale Verschachtelungstiefe für Domains und Subdomains beträgt fünf Ebenen.
  • Sie können bis zu 50 direkte Subdomains unter einer einzelnen Datendomain erstellen.
  • In einem Projekt können Sie bis zu 100 Domains pro Region haben.
  • In einer Organisation können Sie bis zu 1.000 Domains pro Region haben.

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 zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen von Datendomains und Zuweisen von Domaininhabern benötigen:

  • Ermöglicht die vollständige Verwaltung der Datendomain, ihrer Bindungen und IAM-Richtlinien: Dataplex Data Domain Admin (roles/dataplex.dataDomainAdmin)

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.

Datendomain erstellen

Erstellen Sie eine Datendomain mit der Google Cloud Console oder der REST API, um Daten-Assets und ‑Produkte innerhalb eines Projekts und Standorts logisch zu gruppieren.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Daten-Domains auf.

    Zu „Daten-Domains“

  2. Klicken Sie auf Data Domain erstellen und geben Sie die folgenden Informationen an:

    • Geben Sie im Feld Anzeigename einen nutzerfreundlichen Namen für die Domain ein. Beispiel: Finance.
    • Geben Sie im Feld Data Domain ID eine eindeutige ID für die Domain ein. Sie können diesen Wert nicht mehr ändern, nachdem das System die Domain erstellt hat.
    • Wählen Sie im Feld Standort die Region aus, in der Sie die Datendomain erstellen möchten.
    • Wählen Sie im Feld Projekt-ID das Projekt aus, in dem Sie die Datendomain erstellen möchten.
    • Optional: Geben Sie im Feld Beschreibung eine kurze Beschreibung der Domain ein.
    • Fügen Sie im Feld Inhaber einen oder mehrere Inhaber der Domain hinzu. Sie können mehrere E‑Mail-Adressen gleichzeitig eingeben.

  3. Optional: Geben Sie im Feld Labels Labels ein, um verwandte Objekte miteinander oder mit anderen Google Cloud -Ressourcen zu gruppieren.

  4. Klicken Sie auf Erstellen. Es kann einige Minuten dauern, bis Sie auf die Datendomain zugreifen oder danach suchen können.

REST

Verwenden Sie zum Erstellen einer Datendomain die Methode projects.locations.dataDomains.create.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • LOCATION_ID: die Region, in der Sie die Datendomain erstellen möchten. Beispiel: us-central1.
  • DATA_DOMAIN_ID: Eine eindeutige Kennung für Ihre Datendomain.

HTTP-Methode und URL: 

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?data_domain_id=DATA_DOMAIN_ID

JSON-Text anfordern:

{
  "display_name": "Finance Domain",
  "description": "Domain for finance datasets and reports.",
  "contacts": {
    "identities": [
      {
        "contact_name": "Alice Wonderland",
        "contact_role": "owner",
        "contact_id": "alice@example.com"
      }
    ]
  }
}

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.

Datensubdomain erstellen

Erstellen Sie eine Subdomain mit der Google Cloud Console oder der REST API, um die Hierarchie der Datendomains zu erweitern.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Daten-Domains auf.

    Zu „Daten-Domains“

  2. Wählen Sie die Domain aus, für die Sie eine Subdomain erstellen möchten.

  3. Klicken Sie auf Daten-Subdomain erstellen und geben Sie die folgenden Informationen an:

    • Geben Sie im Feld Anzeigename einen nutzerfreundlichen Namen für die Domain ein. Beispiel: Finance.
    • Geben Sie im Feld Data Domain ID eine eindeutige ID für die Domain ein. Sie können diesen Wert nicht mehr ändern, nachdem das System die Domain erstellt hat.
    • Optional: Geben Sie im Feld Beschreibung eine kurze Beschreibung der Domain ein.
    • Geben Sie im Feld Inhaber die E‑Mail-Adresse des Domaininhabers ein. Sie können mehrere E‑Mail-Adressen gleichzeitig eingeben.

  4. Optional: Geben Sie im Feld Labels Labels ein, um verwandte Objekte miteinander oder mit anderen Google Cloud -Ressourcen zu gruppieren.

  5. Klicken Sie auf Erstellen. Es kann einige Minuten dauern, bis Sie auf die Daten-Subdomain zugreifen oder danach suchen können.

REST

Verwenden Sie zum Erstellen einer Datensubdomain die Methode projects.locations.dataDomains.create und geben Sie im Anfragetext die parent_data_domain an.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • LOCATION_ID: die Region, in der sich die übergeordnete Datendomain befindet. Beispiel: us-central1.
  • SUBDOMAIN_ID: Eine eindeutige Kennung für Ihre Datensubdomain.
  • PARENT_DATA_DOMAIN_ID: die eindeutige ID der übergeordneten Datendomain, unter der diese Subdomain erstellt wird.

HTTP-Methode und URL: 

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?data_domain_id=SUBDOMAIN_ID

JSON-Text anfordern:

{
  "display_name": "Finance Subdomain",
  "description": "A subdomain within the Finance domain.",
  "contacts": {
    "identities": [
      {
        "contact_name": "Alice Wonderland",
        "contact_role": "owner",
        "contact_id": "alice@example.com"
      }
    ]
  },
  "parent_data_domain": "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DATA_DOMAIN_ID"
}

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.

Rollen und Berechtigungen für Datendomains

In der folgenden Tabelle sind die vordefinierten IAM-Rollen aufgeführt, die Sie Datendomain-Inhabern und ‑Nutzern zuweisen können.

Rollenname IAM-Rolle Beschreibung
Dataplex Data Domain Admin roles/dataplex.dataDomainAdmin Ermöglicht das Erstellen und Verwalten von Daten-Domains und Subdomains sowie deren Bindungen. Mit der Rolle „Admin“ können Sie auch alle IAM-Rollen und ‑Berechtigungen für Domains verwalten.
Dataplex Data Domain Configuration Viewer roles/dataplex.dataDomainViewer Ermöglicht das Ansehen der Konfiguration der Daten-Domain und der Bindungen zwischen Ressourcen und Domains.
Dataplex Data Domain Configuration Editor roles/dataplex.dataDomainEditor Ermöglicht das Bearbeiten vorhandener Domains sowie das Erstellen und Verwalten von Ressourcen-Domain-Bindungen. Mit der Rolle „Bearbeiter“ können Sie auch Metadatenautorisierungen verwalten, mit denen Nutzer Domainressourcen finden können.
Dataplex Data Domain Entry Reader roles/dataplex.dataDomainEntryReader Ermöglicht das Erkennen und Ansehen der Daten-Domain, ihrer Subdomains und der Metadaten aller zugehörigen Ressourcen.

Beachten Sie Folgendes, wenn Sie Domaininhabern oder Nutzern Rollen zuweisen:

  • Identity and Access Management-Datendomänenrollen werden von übergeordneten Domains an Subdomains weitergegeben, aber nicht direkt an enthaltene Ressourcen. Wenn Sie also dem Nutzer der Domain, die ein BigQuery-Dataset enthält, roles/dataplex.dataDomainEntryReader zuweisen, wird die Rolle nicht unter den IAM-Rollen (Identity and Access Management) des Datasets angezeigt.

  • Mit der Rolle roles/dataplex.dataDomainEntryReader, die für eine Domain gewährt wird, können Sie die folgenden Aktionen ausführen:

    • Sie können Ressourcen, ihre Details und Metadaten ermitteln, aber nur, wenn Sie die Ressource innerhalb der Domain aufrufen. Weitere Informationen finden Sie unter Einschränkungen für Datendomains.
    • Sie können API-Methoden wie lookupEntry für die Ressource in der Domain verwenden.

Zugriff auf eine Datendomain gewähren

So weisen Sie Nutzern, die mit einer Datendomain und ihren Ressourcen interagieren, IAM-Rollen und -Berechtigungen zu:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Daten-Domains auf.

    Zu „Daten-Domains“

  2. Klicken Sie auf den Domainnamen, um die Detailseite der Domain aufzurufen.

  3. Klicke in der Leiste oben auf Berechtigungen.

  4. Klicken Sie auf Hauptkonto hinzufügen.

  5. Geben Sie im Feld Neue Hauptkonten die E-Mail-Adresse des Hauptkontos ein.

  6. Wählen Sie im Feld Rolle auswählen die Rolle für die Datendomäne aus. Verwenden Sie beispielsweise Dataplex Data Domain Entry Reader, um dem Nutzer das Erkennen und Ansehen der Daten-Domain, ihrer Subdomains und der Metadaten der enthaltenen Ressourcen zu ermöglichen. Wenn Sie weitere Rollen zuweisen möchten, klicken Sie auf Weitere Rolle hinzufügen.

  7. Klicken Sie auf Speichern.

REST

Verwenden Sie die Methode projects.locations.dataDomains.setIamPolicy, um die IAM-Richtlinie für eine Datendomain festzulegen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • LOCATION_ID: die Region, in der sich die Datendomain befindet. Beispiel: us-central1.
  • DOMAIN_ID: die eindeutige Kennung der Datendomain.
  • ROLE: die Rolle, die Sie dem Domainnutzer zuweisen möchten.

HTTP-Methode und URL: 

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:setIamPolicy

JSON-Text anfordern:

{
  "policy": {
    "bindings": [
      {
        "role": "ROLE",
        "members": [
          "user:example-user@google.com",
          "group:finance-consumers@google.com"
        ]
      }
    ]
  }
}

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.

Zugriff auf eine Datendomain widerrufen

So entfernen Sie eine Rolle oder Berechtigung von einem Hauptkonto:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Daten-Domains auf.

    Zu „Daten-Domains“

  2. Klicken Sie auf den Domainnamen, um die Detailseite der Domain aufzurufen.

  3. Klicke in der Leiste oben auf Berechtigungen.

  4. Suchen Sie im Bereich Berechtigungen das Hauptkonto, für das Sie die Rolle widerrufen möchten.

  5. Klicken Sie neben der Rolle, die Sie entfernen möchten, auf das Symbol Löschen.

  6. Klicken Sie auf Speichern.

REST

Wenn Sie den Zugriff auf eine Datendomain mithilfe der REST API widerrufen möchten, rufen Sie die vorhandene Richtlinie mit der Methode projects.locations.dataDomains.getIamPolicy ab, entfernen Sie die Rolle oder das Hauptkonto aus der Liste bindings und legen Sie die aktualisierte Richtlinie mit der Methode projects.locations.dataDomains.setIamPolicy fest:

  1. Rufen Sie die aktuelle IAM-Richtlinie ab:

    Ersetzen Sie diese Werte in den folgenden Anfragedaten:

    • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
    • LOCATION_ID: die Region, in der sich die Datendomain befindet. Beispiel: us-central1.
    • DOMAIN_ID: die eindeutige Kennung der Datendomain.

    HTTP-Methode und URL: 

    POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:getIamPolicy

    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.

  2. Legen Sie die aktualisierte Richtlinie fest:

    Ersetzen Sie diese Werte in den folgenden Anfragedaten:

    • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
    • LOCATION_ID: die Region, in der sich die Datendomain befindet. Beispiel: us-central1.
    • DOMAIN_ID: die eindeutige Kennung der Datendomain.
    • ROLE: die Rolle, die Sie dem Domainnutzer zuweisen möchten.

    HTTP-Methode und URL: 

    POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:setIamPolicy

    JSON-Text anfordern:

    {
  "policy": {
    "bindings": [
      {
        "role": "ROLE",
        "members": [
          "user:example-user@google.com",
          "group:finance-consumers@google.com"
        ]
      }
    ]
  }
}

    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.

Nächste Schritte