Einträge verwalten und benutzerdefinierte Quellen aufnehmen

In diesem Dokument wird beschrieben, wie Sie Eintragstypen, Eintragsgruppen, und benutzerdefinierte Einträge, um die Integration benutzerdefinierter Datenquellen in Dataplex.

Ein Eintrag stellt eine Ressource dar, für die Sie Metadaten erfassen. Eine Eintragsgruppe ist ein Container für einen oder mehrere Einträge zur Verwaltung der Zugriffssteuerung und regionalen Standort. Mit einem Eintragstyp werden die erforderlichen Metadaten für Einträge definiert. Eintragstypen bringt 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 eine benutzerdefinierte mithilfe eines benutzerdefinierten Eintragstyps, der sich unter 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 des Eintragstyps entsprechen. Wenn Sie beispielsweise Eintrag ist, müssen Sie Werte für alle Aspekttypen angeben, die vom Eintragstyp. Sie können diese Aspekte bei einem Eintrag, der als markiert ist, nicht löschen. required als Eintragstyp.

Eintragkategorien

• Systemeinträge: Dataplex erstellt Einträge für Google Cloud. wie BigQuery-Datasets oder -Tabellen. Die Einträge, die Von Dataplex erstellte Einträge werden Systemeinträge genannt. Dataplex hält Systemeinträge durch kontinuierliche Metadaten automatisch auf dem neuesten Stand von den unterstützten Google Cloud-Systemen zu synchronisieren.

  Die automatisch eingefügten Metadaten (sogenannte erforderliche Aspekten) für Systemeinträge. Sie können nur zusätzliche Metadaten hinzufügen und ändern für Systemeinträge mithilfe optionaler Aspekte. Weitere Informationen finden Sie unter Kategorien von Aspekten.

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

Eintragsgruppen

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

Kategorien von Eintragsgruppen

• Systemeintragsgruppen: für Google Cloud-Ressourcen, Dataplex automatisch Eintragsgruppen für jedes System in jedem Projekt und an dem sich die Ressourcen befinden. Beispiel: @bigquery ist der Systemeintrag Gruppe für BigQuery.

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

Eintragstypen

Über Eintragstypen werden die erforderlichen Metadaten für Einträge dieses Typs mithilfe eines Satzes der erforderlichen Aspekttypen.

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

Erforderliche Aspekttypen, auf die in einem Eintragstyp verwiesen wird, müssen zur dasselbe Projekt wie der Eintragstyp.

Kategorien von Eintragstypen

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

• Systemeintragstypen: Dataplex bietet diese Eintragstypen. ist standardmäßig aktiviert. Systemeintragstypen sind in die Kategorien wiederverwendbar und eingeschränkt.

  In der folgenden Tabelle werden die Kategorien von Systemeintragstypen sowie die Liste der Eintragstypen, 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, aber Sie können Einträge bearbeiten dieser Eintragstypen, 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

Hinweis: Einträge vom Typ entrygroup stellen Eintragsgruppen dar und sind die beim Erstellen einer Eintragsgruppe automatisch erstellt wird. Sie können nach Einträgen suchen dieses Typs. Im Gegensatz zu normalen Einträgen können diese Einträge nicht gelöscht werden. Stattdessen müssen Sie die Eintragsgruppe löschen.

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

Hinweise

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

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwalten von Einträgen benötigen, bitten Sie Ihren Administrator, Ihnen folgende IAM-Rollen für die Ressource:

• Alle Berechtigungen für Einträge, Eintragsgruppen und Eintragstypen: Dataplex-Katalogadministrator (roles/dataplex.catalogAdmin)
• Erstellen und verwalten Sie alle Dataplex Catalog-Ressourcen, einschließlich Einträge, Eintragsgruppen und Eintragstypen: Dataplex-Katalogbearbeiter (roles/dataplex.catalogEditor)
• Vollständiger Zugriff auf eintragsbezogene Vorgänge: Inhaber des Dataplex-Eintrags (roles/dataplex.entryOwner)
• So rufen Sie Einträge, Eintragsgruppen und Eintragstypen sowie zugehörige IAM-Richtlinien auf: Dataplex-Katalogbetrachter (roles/dataplex.catalogViewer)
• Mit Aspekttypen können Sie Aspekte dieser Typen erstellen, wenn Sie benutzerdefinierte Einträge erstellen: Dataplex-Aspekttyp-Nutzer (roles/dataplex.aspectTypeUser)
• Eintragsgruppen erstellen und verwalten: Inhaber von Dataplex-Eintragsgruppen (roles/dataplex.entryGroupOwner)
• Eintragstypen erstellen und verwalten: Inhaber des Dataplex-Eintragstyps (roles/dataplex.entryTypeOwner)
• Mit Eintragstypen können Sie Einträge der folgenden Typen erstellen und ändern: Nutzer des Dataplex-Eintragstyps (roles/dataplex.entryTypeUser)

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

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

Hinweis: Wenn Sie einen Eintragstyp zum Erstellen und Ändern von Einträgen dieses Typs verwenden, gilt Folgendes: der Eintragstyp und der Eintrag sich in verschiedenen Projekten befinden, müssen Sie den Dataplex-Eintragstypnutzer-IAM-Rolle (roles/dataplex.entryTypeUser) für das in dem der Eintragstyp ist.

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 Anzeigename einen Anzeigenamen für die Eintragsgruppe.
   • Eintragsgruppen-ID: Geben Sie eine eindeutige ID für die Eintragsgruppe ein.
   • Optional: Geben Sie in das Feld Beschreibung eine Beschreibung für Ihre Eintragsgruppe.
   • Standort: Wählen Sie einen Standort aus. Danach können Sie den Standort nicht mehr ändern. erstellen Sie die Eintragsgruppe.

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

   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 die Eintragstyp.
   2. Eintragstyp-ID: Geben Sie eine eindeutige ID für den Eintragstyp ein. Sie können nicht nach dem Erstellen des Eintragstyps ändern.
   3. Optional: Geben Sie in das Feld Beschreibung eine Beschreibung für Ihre Eintragstyp.
   4. Optional: Geben Sie im Feld System das Quellsystem ein.
   5. Optional: Geben Sie im Feld Plattform die Plattform ein, für die Einträge vorgenommen werden. gehören. Beispiel: Google Cloud.
   6. Wählen Sie im Feld Standort einen Standort aus. Sie können den Parameter Standort nach dem Erstellen des Eintragstyps.

5. Optional: Definieren Sie im Abschnitt Typaliasse den Datentyp für Ihren Eintragstyp aus. 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.

6. Wählen Sie im Abschnitt Erforderliche Aspekttypen die Aspekttypen aus, die sind für diesen Eintragstyp obligatorisch. Jeder Eintrag, der basierend auf diesem Typ 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 beliebige Labels als Schlüssel/Wert-Paare hinzu. Paaren zu Ihren Ressourcen:

   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 zum Erstellen eines Eintragstyps die Methode entryType.create .

Benutzerdefinierten Eintrag erstellen

Prüfen Sie vor dem Erstellen eines benutzerdefinierten Eintrags, ob Sie erstellt eine Eintragsgruppe und einen entry type (Eintragstyp).

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 zum Erstellen eines benutzerdefinierten Eintrags den entries.create .

Nachdem Sie einen benutzerdefinierten Eintrag erstellt haben, können Sie ihm Aspekte hinzufügen. Für finden Sie unter Einem Eintrag Aspekte hinzufügen

Eintragsgruppen verwalten

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

Hinweis: Eintragsgruppen, die aus Data Catalog übernommen werden, haben das Suffix (Data Catalog) Sie können diese Eintragsgruppen nicht bearbeiten oder löschen, aber Sie können ihre Berechtigungen verwalten.

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 unter Kategorien von Eintragsgruppen. dieses Dokuments.

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

3. Um die Liste der Eintragsgruppen für alle Projekte aufzurufen, klicken Sie auf das Symbol Benutzerdefiniert und klicken Sie dann auf die Ein/Aus-Schaltfläche Aus allen Projekten anzeigen, auf „Ein“.

   Hinweis: Wenn die Ein/Aus-Schaltfläche Aus allen Projekten anzeigen aktiviert ist, können Sie oder löschen Sie eine Eintragsgruppe direkt. Stattdessen müssen Sie auf der Eintragsgruppe, um die Detailseite der Eintragsgruppe zu öffnen, und bearbeiten oder löschen Sie sie.

REST

Um die Liste der verfügbaren Eintragsgruppen aufzurufen, verwenden Sie den entryGroups.list .

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 können auf Informationen wie Anzeigename, Eintragsgruppen-ID, Beschreibung, Projekt-ID, Standort, Labels, das Erstellungsdatum und das Datum der letzten Änderung der ausgewählten Eintragsgruppe.

4. Wenn die Eintragsgruppe aus Data Catalog bezogen wird, mit dem Suffix (Data Catalog) versehen ist, können Sie die zugehörigen Details in sowohl Data Catalog als auch Dataplex Catalog Schnittstellen. Wählen Sie dazu auf der Detailseite der Eintragsgruppe Data Catalog oder Dataplex Catalog.

5. So rufen Sie die Liste der zehn verwandten Einträge auf, die kürzlich erstellt wurden: Klicken Sie auf den Tab Beispieleinträge.

REST

Um die Details einer Eintragsgruppe abzurufen, 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 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, wann werden.

REST

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

Eintragstypen verwalten

In diesem Abschnitt wird beschrieben, wie Sie die Liste der verfügbaren Eintragsgruppen, sowie 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 unter Kategorien von Einträgen. dieses Dokuments.

3. Um die Liste der Eintragstypen für alle Projekte aufzurufen, klicken Sie auf das Symbol Benutzerdefiniert und klicken Sie auf die Ein/Aus-Schaltfläche Aus allen Projekten anzeigen, auf Position.

   Hinweis: Wenn die Ein/Aus-Schaltfläche Aus allen Projekten anzeigen aktiviert ist, können Sie oder löschen Sie einen Eintragstyp direkt. Stattdessen müssen Sie auf den Eintragstyp, um die Detailseite des Eintragstyps zu öffnen, und bearbeiten oder löschen Sie sie.

REST

Um die Liste der verfügbaren Eintragstypen aufzurufen, verwenden Sie den entryTypes.list .

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 Anzeigename, Eintragstyp-ID, Beschreibung, Projekt-ID, Standort, Plattform, System, Typaliasse, Labels, Erstellungsdatum und Datum der letzten Änderung den ausgewählten Eintragstyp aus.

4. So rufen Sie die Liste der zehn verwandten Einträge auf, die kürzlich erstellt wurden: Klicken Sie auf den Tab Beispieleinträge.

REST

Um die Details eines Eintragstyps abzurufen, verwenden Sie die Methode entryTypes.get .

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. Anzeigenamen, Beschreibung, System, Plattform, Typaliasse und Labels hinzufügen.

6. Klicken Sie auf Speichern.

REST

Verwenden Sie zum Aktualisieren eines Eintragstyps die Methode entryTypes.patch .

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, wann werden.

REST

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

Nächste Schritte

• In Dataplex Catalog nach Daten-Assets suchen
• Aspekte verwalten und Metadaten anreichern
• Weitere Informationen zu Dataplex Catalog.