Einträge verwalten und benutzerdefinierte Quellen aufnehmen

In diesem Dokument wird beschrieben, wie Sie Eintragstypen, Eintragsgruppen und benutzerdefinierte Einträge erstellen und verwalten, um benutzerdefinierte Datenquellen in Dataplex einzubinden.

Ein Eintrag stellt eine Ressource dar, für die Sie Metadaten erfassen. Eine Eintragsgruppe ist ein Container für einen oder mehrere Einträge, mit dem die Zugriffssteuerung und der regionale Standort verwaltet werden. Mit einem Eintragstyp werden die erforderlichen Metadaten für Einträge definiert. Eintragstypen bringen Struktur und Regeln in eine frei fließende und lose definierte Eintragsressource, sodass Einträge erweiterbar sind.

Zum Einbinden einer benutzerdefinierten Datenquelle in Dataplex erstellen Sie einen benutzerdefinierten Eintrag. Verwenden Sie dazu einen benutzerdefinierten Eintragstyp, der sich in einer benutzerdefinierten Eintragsgruppe befindet. Das Erstellen eines benutzerdefinierten Eintrags umfasst die folgenden übergeordneten Schritte:

  1. Eine Eintragsgruppe erstellen.
  2. Erstellen Sie einen Eintragstyp.
  3. Erstellen Sie einen benutzerdefinierten Eintrag für den Eintragstyp innerhalb der Eintragsgruppe.

Einträge

Ein Eintrag stellt ein Daten-Asset dar, für das Sie Metadaten erfassen. Jeder Eintrag ist eine Instanz eines Eintragstyps. Jeder Vorgang zu Aspekten eines Eintrags muss den erforderlichen Aspekten seines Eintragstyps entsprechen. Wenn Sie beispielsweise einen Eintrag erstellen, müssen Sie Werte für alle Aspekttypen angeben, die durch den Eintragstyp definiert werden. Sie können diese Aspekte für einen Eintrag, der im Eintragstyp als required markiert ist, nicht löschen.

Eintragkategorien

  • Systemeinträge: Dataplex erstellt Einträge für Google Cloud-Ressourcen wie BigQuery-Datasets oder -Tabellen. Die von Dataplex erstellten Einträge werden Systemeinträge genannt. Dataplex hält Systemeinträge durch kontinuierliche Metadatensynchronisierung aus den unterstützten Google Cloud-Systemen automatisch auf dem neuesten Stand.

    Sie können die Metadaten, die automatisch für Systemeinträge eingefügt werden (sogenannte erforderliche Aspekte), nicht ändern. Zusätzliche Metadaten für Systemeinträge können nur mithilfe optionaler Aspekte hinzugefügt und geändert werden. Weitere Informationen finden Sie unter Kategorien von Aspekten.

  • Benutzerdefinierte Einträge: Einträge, die Sie für benutzerdefinierte Ressourcen erstellen und verwalten können, werden als benutzerdefinierte Einträge bezeichnet. Benutzerdefinierte Ressourcen sind die Ressourcen in Nicht-Google-Diensten, die entweder in Google Cloud oder extern (z. B. lokal) gehostet werden.

Eintragsgruppen

Eine Eintragsgruppe ist ein Container für einen oder mehrere Einträge. Mithilfe von Eintragsgruppen können Sie die Zugriffssteuerung und den regionalen Speicherort für die Einträge verwalten. Jede Eintragsgruppe gehört zu einem Projekt.

Kategorien von Eintragsgruppen

  • Systemeintragsgruppen: Für Google Cloud-Ressourcen erstellt Dataplex automatisch Eintragsgruppen für jedes System in jedem Projekt und an jedem Standort, an dem sich die Ressourcen befinden. @bigquery ist beispielsweise die Systemeintragsgruppe für BigQuery.

  • Benutzerdefinierte Eintragsgruppen: Eintragsgruppen, die Sie für benutzerdefinierte Ressourcen erstellen.

Eintragstypen

Eintragstypen definieren die erforderlichen Metadaten für Einträge dieses Typs mithilfe einer Reihe von erforderlichen Aspekttypen.

Sie können die erforderlichen Aspekttypen nur für Einträge und nicht für die Spalten eines Eintrags angeben. Wenn Sie einen Eintrag eines bestimmten Eintragstyps erstellen, müssen Sie Werte für alle erforderlichen Aspekttypen angeben, die durch den Eintragstyp angegeben werden.

Erforderliche Aspekttypen, auf die in einem Eintragstyp verwiesen wird, müssen zum selben Projekt wie der Eintragstyp gehören.

Kategorien von Eintragstypen

  • Benutzerdefinierte Eintragstypen: Eintragstypen, die Sie erstellen und verwalten. Mit diesen Eintragstypen können Sie benutzerdefinierte Einträge erstellen.

  • Systemeintragstypen: Dataplex stellt diese Eintragstypen standardmäßig bereit. Systemeintragstypen werden in die Kategorien „wiederverwendbar“ und „eingeschränkt“ kategorisiert.

    In der folgenden Tabelle werden die Kategorien von Systemeintragstypen und die Liste der Eintragstypen beschrieben, die Dataplex für jede der Kategorien bereitstellt:

    Kategorie des Systemeintragstyps Beschreibung Von Dataplex bereitgestellte Eintragstypen
    Wiederverwendbarer Systemeintragstyp Mit diesem Eintragstyp können Sie benutzerdefinierte Einträge erstellen.
    • generic
    Typ des eingeschränkten Systemeintrags Diese sind für das System reserviert, z. B. zum Erstellen von Einträgen für Google Cloud-Ressourcen.

    Sie können diese Eintragstypen nicht zum Erstellen von Einträgen verwenden. Sie können jedoch Einträge dieser Eintragstypen bearbeiten, um optionale Aspekte hinzuzufügen.
    • bigquery-connection
    • bigquery-dataset
    • bigquery-model
    • bigquery-routine
    • bigquery-table
    • bigquery-view
    • cloudsql-database
    • cloudsql-instance
    • cloudsql-schema
    • cloudsql-table
    • cloudsql-view
    • sql-access
    • storage
    • storage-bucket
    • storage-folder

Sie können einen benutzerdefinierten Eintragstyp an einem bestimmten regionalen Standort oder als globale Ressource erstellen. Systemeintragstypen sind immer global. Der Standort eines Eintragstyps wirkt sich auf dessen Anwendbarkeit aus. Weitere Informationen finden Sie unter Projekt- und Standorteinschränkungen.

Hinweise

Bevor Sie Einträge verwalten und benutzerdefinierte Datenquellen aufnehmen, müssen Sie die in diesem Abschnitt beschriebenen Aufgaben ausgeführt haben.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für die Ressource zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Erstellen und Verwalten von Einträgen benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Weitere Informationen finden Sie unter Dataplex-IAM-Rollen.

API aktivieren

Aktivieren Sie die Dataplex API in Ihrem Dataplex-Projekt.

API aktivieren

Eintragsgruppe erstellen

Console

  1. Rufen Sie in der Google Cloud Console die Dataplex-Seite Katalog auf.

    Zum Katalog

  2. Klicken Sie auf den Tab Eintragsgruppen > Benutzerdefiniert.

  3. Klicken Sie auf Erstellen.

  4. Geben Sie im Fenster Eintragsgruppe erstellen Folgendes ein:

    • Optional: Geben Sie im Feld Display name (Anzeigename) einen Anzeigenamen für die Eintragsgruppe ein.
    • Eintragsgruppen-ID: Geben Sie eine eindeutige ID für die Eintragsgruppe ein.
    • Optional: Geben Sie im Feld Description (Beschreibung) eine Beschreibung für Ihre Eintragsgruppe ein.
    • Standort: Wählen Sie einen Standort aus. Sie können den Standort nach dem Erstellen der Eintragsgruppe nicht mehr ändern.

  5. Optional: Fügen Sie im Abschnitt Labels den Ressourcen beliebige Labels als Schlüssel/Wert-Paare hinzu:

    1. Klicken Sie auf Label hinzufügen.
    2. Geben Sie im Feld Schlüssel einen Schlüssel ein.
    3. Geben Sie in das Feld Wert einen Wert für den Schlüssel ein.
    4. Wenn Sie weitere Labels hinzufügen möchten, klicken Sie auf Label hinzufügen und wiederholen Sie die Schritte.

  6. Klicken Sie auf Speichern.

REST

Verwenden Sie zum Erstellen einer Eintragsgruppe die Methode entryGroups.Create.

Eintragstyp erstellen

Wenn Sie eine neue Quelle aufnehmen möchten, müssen Sie einen Eintragstyp erstellen.

Console

  1. Rufen Sie in der Google Cloud Console die Dataplex-Seite Katalog auf.

    Zum Katalog

  2. Klicken Sie auf den Tab Eintragstypen > Benutzerdefiniert.

  3. Klicken Sie auf Erstellen.

  4. Geben Sie im Fenster Eintragstyp erstellen Folgendes ein:

    1. Optional: Geben Sie im Feld Anzeigename einen Anzeigenamen für den Eintragstyp ein.
    2. Eintragstyp-ID: Geben Sie eine eindeutige ID für den Eintragstyp ein. Sie können dies nach dem Erstellen des Eintragstyps nicht mehr ändern.
    3. Optional: Geben Sie im Feld Beschreibung eine Beschreibung für den Eintragstyp ein.
    4. Optional: Geben Sie im Feld System das Quellsystem ein.
    5. Optional: Geben Sie im Feld Plattform die Plattform ein, zu der Einträge dieses Typs gehören. Beispiel: Google Cloud.
    6. Wählen Sie im Feld Standort einen Standort aus. Sie können den Standort nach dem Erstellen des Eintragstyps nicht mehr ändern.

  5. Optional: Definieren Sie im Bereich Typaliasse den Datentyp für Ihren Eintragstyp. Der Datentyp kann zum Abfragen von Einträgen verwendet werden.

    1. Klicken Sie auf Typalias hinzufügen.
    2. Wählen Sie im Feld Typalias einen Datentyp aus. Sie können mehrere Typaliasse hinzufügen.

  6. Wählen Sie im Abschnitt Erforderliche Aspekttypen die Aspekttypen aus, die für diesen Eintragstyp obligatorisch sind. Jedem Eintrag, der auf Grundlage dieses Typs erstellt wird, werden diese erforderlichen Aspekttypen zugewiesen.

    1. Klicken Sie auf Aspekttyp auswählen.
    2. Wählen Sie im Fenster Aspekttypen auswählen den Aspekttyp aus.
    3. Klicken Sie auf Auswählen.

    Sie können die erforderlichen Aspekte aus einem Eintrag nicht löschen.

  7. Optional: Fügen Sie im Abschnitt Labels den Ressourcen beliebige Labels als Schlüssel/Wert-Paare hinzu:

    1. Klicken Sie auf Label hinzufügen.
    2. Geben Sie im Feld Schlüssel einen Schlüssel ein.
    3. Geben Sie in das Feld Wert einen Wert für den Schlüssel ein.
    4. Wenn Sie weitere Labels hinzufügen möchten, klicken Sie auf Label hinzufügen und wiederholen Sie die Schritte.

  8. Klicken Sie auf Speichern.

REST

Verwenden Sie die Methode entryType.create, um einen Eintragstyp zu erstellen.

Benutzerdefinierten Eintrag erstellen

Bevor Sie einen benutzerdefinierten Eintrag erstellen, müssen Sie eine Eintragsgruppe und einen Eintragstyp erstellt haben.

Console

Das Erstellen eines benutzerdefinierten Eintrags wird in der Google Cloud Console nicht unterstützt. Verwenden Sie stattdessen die Google Cloud CLI oder die API.

REST

Verwenden Sie die Methode entries.create, um einen benutzerdefinierten Eintrag zu erstellen.

Nachdem Sie einen benutzerdefinierten Eintrag erstellt haben, können Sie ihm Aspekte hinzufügen. Weitere Informationen finden Sie unter Aspekte zu einem Eintrag hinzufügen.

Eintragsgruppen verwalten

In diesem Abschnitt wird beschrieben, wie Sie die Liste der verfügbaren Eintragsgruppen aufrufen, Details aufrufen und Eintragsgruppen aktualisieren und löschen.

Liste der verfügbaren Eintragsgruppen aufrufen

Console

  1. Rufen Sie in der Google Cloud Console die Dataplex-Seite Katalog auf.

    Zum Katalog

  2. Klicken Sie auf den Tab Eintragsgruppen.

    Sie können auf die Liste der benutzerdefinierten Eintragsgruppen und der Systemeintragsgruppen zugreifen. Weitere Informationen finden Sie im Abschnitt Kategorien von Eintragsgruppen in diesem Dokument.

    Auf dem Tab Benutzerdefiniert sind die Eintragsgruppen mit dem Suffix (Data Catalog) die Eintragsgruppen, die aus Data Catalog stammen.

  3. Wenn Sie die Liste der Eintragsgruppen in allen Projekten aufrufen möchten, klicken Sie auf den Tab Custom (Benutzerdefiniert) und dann auf die Ein/Aus-Schaltfläche Show from all projects (Aus allen Projekten anzeigen).

REST

Mit der Methode entryGroups.list können Sie die Liste der verfügbaren Eintragsgruppen aufrufen.

Details einer Eintragsgruppe ansehen

Console

  1. Rufen Sie in der Google Cloud Console die Dataplex-Seite Katalog auf.

    Zum Katalog

  2. Klicken Sie auf den Tab Eintragsgruppen.

  3. Klicken Sie auf die Eintragsgruppe, für die Sie die Details ansehen möchten.

    Die Detailseite der Eintragsgruppe wird geöffnet. Sie haben Zugriff auf Informationen wie den Anzeigenamen, die Eintragsgruppen-ID, die Beschreibung, die Projekt-ID, den Standort, die Labels, das Erstellungsdatum und das Datum der letzten Änderung der ausgewählten Eintragsgruppe.

  4. Wenn die Eintragsgruppe aus Data Catalog stammt und mit dem Suffix (Data Catalog) gekennzeichnet ist, können Sie die zugehörigen Details sowohl in der Data Catalog- als auch in der Dataplex Catalog-Oberfläche ansehen. Wählen Sie dazu auf der Detailseite der Eintragsgruppe Data Catalog oder Dataplex Catalog aus.

  5. Klicken Sie auf den Tab Beispieleinträge, um die Liste der zehn zuletzt erstellten zusammengehörigen Einträge anzuzeigen.

REST

Zum Abrufen der Details einer Eintragsgruppe verwenden Sie die Methode entryGroups.get.

Eintragsgruppe aktualisieren

Console

  1. Rufen Sie in der Google Cloud Console die Dataplex-Seite Katalog auf.

    Zum Katalog

  2. Klicken Sie auf den Tab Eintragsgruppen > Benutzerdefiniert.

  3. Klicken Sie auf die Eintragsgruppe, die Sie aktualisieren möchten.

  4. Klicken Sie auf der Seite Eintragsgruppendetails auf Bearbeiten.

  5. Bearbeiten Sie den Anzeigenamen, die Beschreibung und die Labels nach Bedarf.

  6. Klicken Sie auf Speichern.

REST

Verwenden Sie zum Aktualisieren einer Eintragsgruppe die Methode entryGroups.patch.

Eintragsgruppe löschen

Console

  1. Rufen Sie in der Google Cloud Console die Dataplex-Seite Katalog auf.

    Zum Katalog

  2. Klicken Sie auf den Tab Eintragsgruppen > Benutzerdefiniert.

  3. Klicken Sie auf die Eintragsgruppe, die Sie löschen möchten.

  4. Klicken Sie auf der Seite Eintragsgruppendetails auf Löschen. Bestätigen Sie den Vorgang, wenn Sie dazu aufgefordert werden.

REST

Verwenden Sie zum Löschen einer Eintragsgruppe die Methode entryGroups.delete.

Eintragstypen verwalten

In diesem Abschnitt wird beschrieben, wie Sie die Liste der verfügbaren Eintragsgruppen aufrufen, Details aufrufen und Eintragstypen aktualisieren und löschen.

Liste der verfügbaren Eintragstypen aufrufen

Console

  1. Rufen Sie in der Google Cloud Console die Dataplex-Seite Katalog auf.

    Zum Katalog

  2. Klicken Sie auf den Tab Eintragstypen.

    Sie können auf die Liste der benutzerdefinierten Eintragstypen und der Systemeintragstypen zugreifen. Weitere Informationen finden Sie im Abschnitt Kategorien von Eintragstypen in diesem Dokument.

  3. Wenn Sie die Liste der Eintragstypen für alle Projekte aufrufen möchten, klicken Sie auf den Tab Benutzerdefiniert und aktivieren Sie die Ein/Aus-Schaltfläche Aus allen Projekten anzeigen.

REST

Mit der Methode entryTypes.list können Sie die Liste der verfügbaren Eintragstypen aufrufen.

Details zu einem Eintragstyp ansehen

Console

  1. Rufen Sie in der Google Cloud Console die Dataplex-Seite Katalog auf.

    Zum Katalog

  2. Klicken Sie auf den Tab Eintragstypen > Benutzerdefiniert.

  3. Klicken Sie auf den Eintragstyp, für den Sie die Details aufrufen möchten.

    Die Detailseite des Eintragstyps wird geöffnet. Sie können auf Informationen wie den Anzeigenamen, die ID des Eintragstyps, die Beschreibung, die Projekt-ID, den Standort, die Plattform, das System, Typaliasse, Labels, das Erstellungsdatum und das Datum der letzten Änderung des ausgewählten Eintragstyps zugreifen.

  4. Klicken Sie auf den Tab Beispieleinträge, um die Liste der zehn zuletzt erstellten zusammengehörigen Einträge anzuzeigen.

REST

Mit der Methode entryTypes.get können Sie die Details eines Eintragstyps abrufen.

Eintragstyp aktualisieren

Console

  1. Rufen Sie in der Google Cloud Console die Dataplex-Seite Katalog auf.

    Zum Katalog

  2. Klicken Sie auf den Tab Eintragstypen > Benutzerdefiniert.

  3. Klicken Sie auf den Eintragstyp, den Sie aktualisieren möchten.

  4. Klicken Sie auf der Seite Details zum Eintragstyp auf Bearbeiten.

  5. Bearbeiten Sie den Anzeigenamen, die Beschreibung, das System, die Plattform, Typaliasse und Labels nach Bedarf.

  6. Klicken Sie auf Speichern.

REST

Verwenden Sie die Methode entryTypes.patch, um einen Eintragstyp zu aktualisieren.

Eintragstyp löschen

Console

  1. Rufen Sie in der Google Cloud Console die Dataplex-Seite Katalog auf.

    Zum Katalog

  2. Klicken Sie auf den Tab Eintragstypen > Benutzerdefiniert.

  3. Klicken Sie auf den Eintragstyp, den Sie löschen möchten.

  4. Klicken Sie auf der Seite Details zum Eintragstyp auf Löschen. Bestätigen Sie den Vorgang, wenn Sie dazu aufgefordert werden.

REST

Verwenden Sie zum Löschen eines Eintragstyps die Methode entryTypes.delete.

Nächste Schritte