Von Data Catalog auf Dataplex Catalog umstellen

Wenn Sie Data Catalog verwenden, können Sie Ihre Data Catalog-Inhalte und ‑Nutzung an Dataplex Catalog übertragen. Folgen Sie dazu der Anleitung in diesem Dokument.

Wenn Sie den Katalog noch nicht verwendet haben, können Sie mit Dataplex Catalog beginnen. Konfigurieren Sie ihn dazu als Standardkatalog.

Dieses Dokument richtet sich an Datenadministratoren und Datenbetreuer.

Dataplex Catalog hat eine neue Webansicht und API. Wenn Sie zu Dataplex Catalog wechseln, können Ihre vorhandenen und zukünftigen Arbeitslasten und Nutzer von den erweiterten Funktionen profitieren. Weitere Informationen finden Sie in der Dataplex Catalog-Übersicht.

Einen Vergleich von Dataplex Catalog und Data Catalog finden Sie unter Dataplex Catalog im Vergleich zu Data Catalog.

Bevor Sie mit der Umstellung beginnen, sollten Sie sich mit den in Dataplex Catalog nicht unterstützten Funktionen vertraut machen.

Übersicht zur Umstellung

Auf der Seite Übergang zu Dataplex verwalten in der Google Cloud -Console können Sie die Umstellung verwalten.

In diesem Abschnitt werden die verschiedenen Übergangsszenarien beschrieben und der Übergangsprozess für jedes der Szenarien skizziert.

Wenn Sie keine benutzerdefinierten Metadaten in Data Catalog haben oder Data Catalog noch nie verwendet haben

Wenn Sie Data Catalog verwenden und keine benutzerdefinierten Metadaten wie Tags, Tag-Vorlagen, benutzerdefinierte Einträge oder Eintragsgruppen haben oder Data Catalog noch nie verwendet haben, führen Sie die Umstellung durch, indem Sie die Standard-UI für den Katalog auf Dataplex Catalog festlegen.

Hinweis: Wenn Sie keine benutzerdefinierten Metadaten in Data Catalog haben oder Data Catalog noch nie verwendet haben, überspringen Sie alle anderen in diesem Dokument beschriebenen Aufgaben.

Wenn Sie benutzerdefinierte Data Catalog-Metadaten oder programmatische Arbeitslasten haben

Wenn Sie Data Catalog mit benutzerdefinierten Metadaten wie Tags, Tag-Vorlagen, benutzerdefinierten Einträgen oder Eintragsgruppen verwenden, kann Dataplex diese benutzerdefinierten Metadaten automatisch als read-only in Dataplex Catalog importieren. Um diese Funktion zu aktivieren, sind Konfigurationsänderungen erforderlich, wie in der Vorbereitungsphase beschrieben.

Die zweite Phase ist die Übertragungsphase, in der der aktive Status (read-write) Ihrer benutzerdefinierten Metadaten in Dataplex Catalog verschoben wird. In dieser Phase müssen Sie auch alle programmatischen Arbeitslasten aktualisieren, z. B. APIs, Clientbibliotheken, Terraform-Module und Google Cloud CLI-Befehle, um mit Dataplex Catalog zu interagieren.

Im Folgenden finden Sie weitere Details zu den einzelnen Phasen des Übergangs:

1. Vorbereitungsphase: Führen Sie die erforderlichen Konfigurationsaufgaben aus, damit die Data Catalog-Inhalte gleichzeitig im Dataplex Catalog als read-only verfügbar sind. In dieser Phase bleibt Data Catalog die maßgebliche Quelle für Ihre Metadateninhalte.

   Die Vorbereitungsphase umfasst die folgenden Aufgaben:

   1. Aktualisieren Sie die privaten Tag-Vorlagen in Data Catalog in öffentliche.
   2. Aktivieren Sie Tag-Vorlagen und Tags, damit Metadaten gleichzeitig in Dataplex Catalog verfügbar sind.
   3. Konfigurieren Sie IAM-Berechtigungen für Dataplex Catalog für Ihre benutzerdefinierten Metadaten.

   Weitere Informationen finden Sie unter Vorbereitungsphase.

2. Übertragungsphase: Verschieben Sie die Katalognutzung und den aktiven Status (read-write) Ihrer benutzerdefinierten Metadaten in Dataplex Catalog.

   Die Übertragungsphase umfasst die folgenden Aufgaben:

   1. Legen Sie die Standard-UI für den Katalog auf Dataplex Catalog fest.
   2. Übertragen Sie die benutzerdefinierten Metadaten aus Data Catalog an Dataplex Catalog.
   3. Programmatische Arbeitslasten aktualisieren

   Wenn Sie die Übertragungsphase abgeschlossen haben, wird Dataplex Catalog zur maßgeblichen Quelle für alle Ihre Metadaten und Sie müssen Data Catalog nicht mehr verwenden.

   Weitere Informationen finden Sie unter Übertragungsphase.

Erforderliche Rollen

Wenn Sie die Berechtigungen benötigen, um von Data Catalog zu Dataplex Catalog zu wechseln, müssen Sie der Ressource die folgenden IAM-Rollen zuweisen:

• Private Tag-Vorlagen in öffentliche Tag-Vorlagen umwandeln: Data Catalog-Tag-Vorlageninhaber (roles/datacatalog.tagTemplateOwner)

  Diese vordefinierte Rolle enthält die Berechtigung datacatalog.tagTemplates.update, die zum Aktualisieren privater Tag-Vorlagen auf „Öffentlich“ erforderlich ist.

• Öffentliche Tag-Vorlagen und Tags für die gleichzeitige Verfügbarkeit von Metadaten im Dataplex Catalog aktivieren: DataCatalog Migration Config Admin (roles/datacatalog.migrationConfigAdmin)

  Diese vordefinierte Rolle enthält die Berechtigung datacatalog.migrationConfig.set, die zum Aktivieren von Tag-Vorlagen und ‑Tags erforderlich ist.

• Legen Sie die Standard-UI für den Katalog auf „Dataplex Catalog“ fest: DataCatalog Migration Config Admin (roles/datacatalog.migrationConfigAdmin)

  Diese vordefinierte Rolle enthält die Berechtigung datacatalog.migrationConfig.set, die zum Festlegen der Standardoberfläche für Kataloge erforderlich ist.

• Öffentliche Data Catalog-Tag-Vorlagen in Dataplex Catalog übertragen: Data Catalog-Tag-Vorlageninhaber (roles/datacatalog.tagTemplateOwner)

  Diese vordefinierte Rolle enthält die Berechtigung datacatalog.tagTemplates.update, die zum Übertragen öffentlicher Tag-Vorlagen erforderlich ist.

• Data Catalog-Eintragsgruppen in den Dataplex-Katalog übertragen: DataCatalog-Eintragsgruppeninhaber (roles/datacatalog.entryGroupOwner)

  Diese vordefinierte Rolle enthält die Berechtigung datacatalog.entryGroups.update, die zum Übertragen von Eingangsgruppen erforderlich ist.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Möglicherweise können Sie die erforderlichen Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Vorbereitungsphase

Hinweis: Führen Sie die in diesem Abschnitt beschriebenen Aufgaben nur aus, wenn Sie benutzerdefinierte Metadaten im Data Catalog oder programmatische Arbeitslasten haben.

In dieser Phase werden Aufgaben ausgeführt, um die Metadateninhalte von Data Catalog gleichzeitig im Dataplex Catalog im Modus read-only verfügbar zu machen.

In der Vorbereitungsphase sollten Sie Folgendes beachten:

• Data Catalog bleibt die maßgebliche Quelle für Ihre benutzerdefinierten Metadaten.
• Die Seite Dataplex-Suche verweist standardmäßig auf die Data Catalog-Suche, die nur Data Catalog-Metadaten und keine Dataplex Catalog-Metadaten enthält.
• Die Dataplex Catalog-Suche umfasst möglicherweise erst nach Abschluss der Vorbereitungsphase alle öffentlichen Tag-Vorlagen und Tags aus Data Catalog.

Weitere Informationen zur gleichzeitigen Verfügbarkeit von Data Catalog-Metadaten in Dataplex Catalog

Benutzerdefinierte Eintragsgruppen aus Data Catalog und ihre Einträge sind bereits gleichzeitig als read-only in Dataplex Catalog verfügbar. Wenn Sie in der Vorbereitungsphase öffentliche Tag-Vorlagen und Tags aktivieren, werden ihre Inhalte gleichzeitig in Dataplex Catalog als read-only verfügbar gemacht.

In der folgenden Tabelle ist die Zuordnung zwischen Data Catalog- und Dataplex Catalog-Ressourcen zu sehen, wenn die Data Catalog-Ressourcen gleichzeitig in Dataplex Catalog verfügbar gemacht werden:

Zuordnung zwischen Data Catalog und Dataplex Catalog

Data Catalog-Ressource	Entsprechende Dataplex Catalog-Ressource	Beschreibung
Tag-Vorlage	Aspekttyp (global)	Tag-Vorlagen in Data Catalog sind regionale Ressourcen. Wenn Sie Tag-Vorlagen aktivieren, werden ihre Inhalte gleichzeitig als globale Aspekttypen in Dataplex Catalog verfügbar gemacht. So bleiben die regionsübergreifenden Verweise zwischen Tags und Tag-Vorlagen erhalten. Definitionen von globalen Aspekttypen werden in alle Google Cloud- Regionen repliziert. Standardkonzepte wie Schema werden durch Systemaspekttypen dargestellt, die von Dataplex bereitgestellt werden. Weitere Informationen finden Sie unter Kategorien von Aspekttypen.
Tag	Optionaler Aspekt	Wenn Sie Tag-Vorlagen aktivieren, werden ihre Tags gleichzeitig als optionale Aspekte in Dataplex Catalog verfügbar gemacht. Weitere Informationen finden Sie unter Kategorien von Aspekten.
Eintragsgruppe	Eintragsgruppe	Eintragsgruppen für Systemeinträge werden in Dataplex Catalog pro Projekt und Region eingerichtet. In Data Catalog erstellte Eintragsgruppen werden gleichzeitig in Dataplex Catalog verfügbar gemacht.
Benutzerdefinierter Eintrag	Benutzerdefinierter Eintrag	Alle benutzerdefinierten Einträge in Data Catalog werden gleichzeitig als Einträge von GenericEntryType in Dataplex Catalog verfügbar gemacht. Weitere Informationen finden Sie unter Kategorien von Eintragstypen.
Systemeintrag (Google Cloud)	Erforderlicher Systemeintrag	Metadaten, die Systemeinträge beschreiben, z. B. Schema für BigQuery-Tabellen, werden in erforderlichen Aspekten der systemdefinierten Aspekttypen erfasst.

Hinweis:Normalerweise werden Aktualisierungen der Data Catalog-Inhalte innerhalb von 10 Minuten an Dataplex Catalog weitergegeben. In einigen Fällen kann es länger dauern. Um für Datenkonsistenz zu sorgen, empfehlen wir, alle Schreibvorgänge in Data Catalog zu beenden und Dataplex Catalog-Ressourcen vor der Verwendung mit Data Catalog-Ressourcen oder dem ursprünglichen Quellsystem zu vergleichen.

Private Tag-Vorlagen in Data Catalog in öffentliche umwandeln

Hinweis :Führen Sie diese Aufgabe nur aus, wenn Sie private Tag-Vorlagen und ‑Tags in Data Catalog verwenden.
Diese Aufgabe muss von Datenbetreuern oder Datenadministratoren ausgeführt werden.

Dataplex Catalog unterstützt nicht das Konzept privater Aspekte (entspricht privaten Tags). Daher werden private Tag-Vorlagen und Tags nicht gleichzeitig in Dataplex Catalog verfügbar gemacht. Wenn Sie private Tag-Vorlagen und Tags in Dataplex Catalog weitergeben möchten, müssen Sie sie in öffentliche ändern.

Bevor Sie fortfahren, sollten Sie die Struktur der privaten Tag-Vorlagen überprüfen, um sicherzustellen, dass ihre Struktur und Metadaten mit der Sichtbarkeit öffentlicher Tags übereinstimmen.

So aktualisieren Sie private Tag-Vorlagen und Tags in öffentliche:

Console

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

   Zum Katalog

2. Klicken Sie auf Umstellung auf Dataplex verwalten.

3. Klicken Sie auf den Tab Vorlagen für private Tags.

4. Klicken Sie auf Tag-Vorlagen verwalten.

5. Klicken Sie auf der Seite Tag-Vorlagen auf die Vorlage für private Tags, die Sie aktualisieren möchten.

6. Klicken Sie auf der Seite Vorlage – Details auf Bearbeiten.

7. Wählen Sie im Bereich Sichtbarkeit die Option Öffentlich aus.

8. Klicken Sie auf Aktualisieren.

REST

Verwenden Sie die Methode tagTemplates.patch, um die privaten Tag-Vorlagen zu öffentlichen Tag-Vorlagen zu aktualisieren.

Opt-in für öffentliche Tag-Vorlagen und Tags für die gleichzeitige Verfügbarkeit von Metadaten in Dataplex Catalog

Hinweis :Führen Sie diese Aufgabe nur aus, wenn Sie öffentliche Tag-Vorlagen und Tags in Data Catalog haben.
Wenn Sie eine Google Cloud -Organisation haben, muss der Administrator der Organisation diese Einstellung auf Organisationsebene konfigurieren. Sie gilt dann für alle Tag-Vorlagen innerhalb der Organisation.
Bei Projekten ohne Organisation muss der Projektadministrator diese Einstellung für einzelne Projekte konfigurieren. Sie gilt dann für alle Tag-Vorlagen im Projekt.

Wenn Sie das Opt-in erteilen, werden die Inhalte öffentlicher Tag-Vorlagen und Tags aus Data Catalog automatisch und kontinuierlich in Ihrer Google Cloud -Organisation oder Ihrem Projekt (ohne Organisation) an Dataplex Catalog weitergegeben. Die öffentlichen Tag-Vorlagen und Tags aus Data Catalog werden an Dataplex Catalog als öffentliche Aspekttypen bzw. Aspekte weitergegeben. Definitionen von globalen Aspekttypen werden in alle Regionen von Google Cloud repliziert.

So aktivieren Sie öffentliche Tag-Vorlagen und Tags:

Console

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

   Zum Katalog

2. Klicken Sie auf Umstellung auf Dataplex verwalten.

3. Klicken Sie auf den Tab Aktivieren.

4. Klicken Sie auf Zum Opt-in.

5. Geben Sie im Bestätigungsdialog den angezeigten Text ein und klicken Sie auf Bestätigen.

REST

Verwenden Sie die Methode setConfig, um Tag-Vorlagen und ‑Tags zu aktivieren.

Sowohl für Google Cloud -Organisationen als auch für Projekte ohne Organisation können Sie die ursprünglich erteilte Einwilligung widerrufen, indem Sie auf Einwilligung widerrufen klicken. Wenn Sie das Opt-in widerrufen, wird die Weitergabe von Tag-Vorlagen und Tags aus Data Catalog an Dataplex Catalog beendet. Die Dataplex Catalog-Aspekttypen und ‑Aspekte, die durch das Opt-in-Verfahren erstellt, aber nicht an Dataplex Catalog übertragen wurden, werden gelöscht. Das kann bis zu 12 Stunden dauern.

IAM-Berechtigungen für Dataplex Catalog für benutzerdefinierte Metadaten konfigurieren

Dataplex Catalog-Aspekttypen und benutzerdefinierte Eintragsgruppen, die Tag-Vorlagen und Eintragsgruppen aus Data Catalog repräsentieren, übernehmen nicht die ursprünglichen Data Catalog-IAM-Berechtigungen. Sie müssen die Dataplex-IAM-Berechtigungen für diese Aspekttypen und benutzerdefinierten Eintragsgruppen manuell konfigurieren.

Wenn Sie beispielsweise Aspekte mit einem weitergegebenen Aspekttyp erstellen möchten, der eine Data Catalog-Tag-Vorlage darstellt, müssen Sie die erforderlichen IAM-Berechtigungen für diesen Aspekttyp konfigurieren. Wenn Sie benutzerdefinierte Metadaten aufnehmen, müssen Sie auch die erforderlichen IAM-Berechtigungen für die entsprechende Eintragsgruppe konfigurieren, um benutzerdefinierte Einträge in einer weitergegebenen benutzerdefinierten Eintragsgruppe zu erstellen.

Weitere Informationen dazu, wie sich IAM-Berechtigungen in Data Catalog von denen im Dataplex Catalog unterscheiden, finden Sie unter IAM-Berechtigungen zwischen Data Catalog und Dataplex Catalog zuordnen.

So konfigurieren Sie die erforderlichen Dataplex-IAM-Berechtigungen für Aspekttypen und benutzerdefinierte Eintragsgruppen:

Console

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

   Zum Katalog

2. Klicken Sie auf Umstellung auf Dataplex verwalten.

3. Klicken Sie auf den Tab Dataplex-Berechtigungen.

4. Klicken Sie auf Aspekttypen und Tag-Vorlagen, um Dataplex-IAM-Berechtigungen für Aspekttypen zu konfigurieren.

   1. Klicken Sie bei der aus dem Data Catalog übernommenen Tag-Vorlage auf > Berechtigungen.

   2. Klicken Sie auf Hauptkonten hinzufügen.

   3. Fügen Sie ein neues Hauptkonto hinzu und weisen Sie die erforderlichen Rollen zu.

   4. Klicken Sie auf Speichern.

5. Wenn Sie Dataplex-IAM-Berechtigungen für Eintragsgruppen konfigurieren möchten, klicken Sie auf Eintragsgruppen.

   1. Klicken Sie für die aus dem Data Catalog übernommene Eintragsgruppe auf > Berechtigungen.

   2. Klicken Sie auf Hauptkonten hinzufügen.

   3. Fügen Sie ein neues Hauptkonto hinzu und weisen Sie die erforderlichen Rollen zu.

   4. Klicken Sie auf Speichern.

REST

Verwenden Sie die Methode aspectTypes.setIamPolicy, um Dataplex-IAM-Berechtigungen für Aspekttypen zu konfigurieren.

Verwenden Sie die Methode entryGroups.setIamPolicy, um Dataplex-IAM-Berechtigungen für Eintragsgruppen zu konfigurieren.

Übertragungsphase

Hinweis: Führen Sie die in diesem Abschnitt beschriebenen Aufgaben nur aus, wenn Sie benutzerdefinierte Metadaten im Data Catalog oder programmatische Arbeitslasten haben.

In dieser Phase werden Aufgaben ausgeführt, um den aktiven Status (read-write) Ihrer benutzerdefinierten Data Catalog-Metadaten in Dataplex Catalog zu verschieben.

Beachten Sie während der Übertragungsphase die folgenden Punkte:

• Die Seite Suche in Dataplex verweist standardmäßig auf die Dataplex Catalog-Suche.
• Sie können sowohl die Data Catalog- als auch die Dataplex Catalog-Metadaten im Dataplex Catalog aufrufen und lesen.
• Wenn Sie Metadaten in der Google Cloud -Console aktualisieren möchten, werden Sie zur Quelle weitergeleitet. Wenn Sie beispielsweise Data Catalog-Tag-Vorlagen aktualisieren, werden Sie zur Seite „Tag-Vorlagen“ in Data Catalog weitergeleitet.

Standard-UI für Katalog auf Dataplex Catalog festlegen

Hinweis: Bei einer Google Cloud -Organisation muss der Organisationsadministrator diese Einstellung auf Organisationsebene konfigurieren. Bei Projekten ohne Organisation muss der Projektadministrator diese Einstellung für einzelne Projekte konfigurieren.

Wenn Sie die Standard-UI für den Katalog auf Dataplex Catalog festlegen, hat das folgende Auswirkungen:

• Wenn Sie in derGoogle Cloud -Console die Seite Dataplex-Suche aufrufen, wird standardmäßig die Dataplex Catalog-Suche angezeigt. Die Dataplex Catalog-Suche bezieht sich auf Dataplex Catalog und findet alle Ihre Metadateninhalte, einschließlich Inhalte, die in Dataplex Catalog erstellt und aus Data Catalog importiert wurden.

  Bei der Data Catalog-Suche werden nur Data Catalog-Inhalte gefunden, keine Dataplex Catalog-Inhalte. Wir empfehlen daher, die Dataplex Catalog-Suche zu verwenden.

• Auf der Weboberfläche werden Sie aufgefordert, neue Ressourcen in Dataplex Catalog zu erstellen. So wird beispielsweise standardmäßig Aspekttypen erstellen anstelle von Tag-Vorlagen erstellen und Eintragsgruppe erstellen (Dataplex Catalog) anstelle von Eintragsgruppe erstellen (Data Catalog) angezeigt.

• Das Festlegen der Standard-UI für den Katalog auf Dataplex Catalog ist in der Regel ein Vorgang, der nicht rückgängig gemacht werden kann. In Dataplex können Sie Änderungen jedoch in Ausnahmefällen rückgängig machen, z. B. wenn Sie die Standard-UI für den Katalog wieder auf Data Catalog umstellen möchten. Wenn Sie die Änderungen rückgängig machen, können Sie über die Data Catalog-Weboberfläche nicht auf Inhalte zugreifen, die in Dataplex Catalog erstellt wurden.

So legen Sie Dataplex Catalog als Standard-UI für den Katalog fest:

Console

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

   Zum Katalog

2. Klicken Sie auf Umstellung auf Dataplex verwalten.

3. Klicken Sie auf den Tab Dataplex Search (Dataplex-Suche).

4. Klicken Sie auf Standard-UI für Katalog auf Dataplex Catalog festlegen.

REST

Wenn Sie die Standard-UI für den Katalog auf Dataplex Catalog festlegen möchten, verwenden Sie die Methode setConfig.

Benutzerdefinierte Data Catalog-Metadaten an Dataplex Catalog übertragen

Hinweis: Diese Aufgabe muss von Datenadministratoren, Datenbetreuern oder Data Engineers ausgeführt werden.

Sie können die öffentlichen Tag-Vorlagen aus Data Catalog (für die Sie das Opt-in aktiviert haben) und benutzerdefinierte Eintragsgruppen an Dataplex Catalog übertragen. Übertragen Sie jede Tag-Vorlage und jede benutzerdefinierte Eintragsgruppe separat.

Achtung :Die Übertragung kann nicht rückgängig gemacht werden. Nachdem Sie Ihre vorhandenen Tag-Vorlagen und Eintragsgruppen in Data Catalog in Dataplex Catalog übertragen haben, können Sie sie nicht mehr in Data Catalog aktualisieren. Sie können sie jedoch in Data Catalog löschen, da dies keine Auswirkungen auf die an Dataplex Catalog übertragene Version hat.

Im Folgenden wird der Übertragungsprozess zusammengefasst:

• Effekt

  • Der aktive Status für Ressourcen wird von Data Catalog an Dataplex Catalog übertragen. Wenn Sie die Ressource nach der Übertragung ändern oder auf ihren aktuellen Status zugreifen möchten, müssen Sie Dataplex Catalog verwenden.

• Änderungen am Dateninhalt und -fluss

  • Die Ressource wird in Data Catalog als read-only gekennzeichnet.
  • Die Ressource wird in Dataplex Catalog als read-write markiert.
  • Die gleichzeitige Verfügbarkeit dieser Ressource wird beendet.

• Abhängigkeiten

  • Wenn Sie eine Tag-Vorlage übertragen, werden auch alle Tags übertragen, für die diese Vorlage verwendet wird.
  • Beim Übertragen von Eintragsgruppen werden auch alle darin enthaltenen Einträge übertragen.
  • Die Übertragung von Einträgen wirkt sich nicht auf den Übertragungsstatus der zugehörigen Tags und Tag-Vorlagen aus.

Wenn Sie vor der Übertragung den Geschäftskontext eines Eintrags (z. B. overview, contacts) ändern möchten, können Sie sowohl die Data Catalog API als auch die Dataplex API verwenden. Nach der Übertragung dürfen Sie nur noch die Dataplex API verwenden.

Im Folgenden wird beschrieben, welche Vorgänge für einen getaggten benutzerdefinierten Data Catalog-Eintrag zulässig sind, je nach Übertragungsstatus der zugehörigen benutzerdefinierten Eintragsgruppe und Tag-Vorlage:

• Wenn eine Tag-Vorlage in Data Catalog aktiv ist, können Sie damit Tags erstellen. Nachdem Sie die Tag-Vorlage in Dataplex Catalog übertragen haben, können Sie damit keine Tags mehr in Data Catalog erstellen.
• Sie können Aspekte mit Aspekttypen erstellen, die aus Data Catalog-Tag-Vorlagen übernommen werden, erst nachdem Sie die Tag-Vorlagen übertragen haben.

So übertragen Sie die Tag-Vorlagen und benutzerdefinierten Eintragsgruppen aus Data Catalog zu Dataplex Catalog:

Console

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

   Zum Katalog

2. Klicken Sie auf Umstellung auf Dataplex verwalten.

3. Klicken Sie auf den Tab Zu Dataplex übertragen.

4. Wenn Sie Data Catalog-Tag-Vorlagen an Dataplex Catalog übertragen möchten, klicken Sie auf Aspekttypen und Tag-Vorlagen ansehen.

   1. Wählen Sie die Tag-Vorlagen aus, die Sie übertragen möchten.

   2. Klicken Sie auf Übertragen.

   3. Klicken Sie im Dialogfeld zur Bestätigung auf Bestätigen.

5. Wenn Sie benutzerdefinierte Data Catalog-Eintragsgruppen in Dataplex Catalog übertragen möchten, klicken Sie auf Eintragsgruppen ansehen.

   1. Wählen Sie die Gruppen aus, die Sie übertragen möchten.

   2. Klicken Sie auf Übertragen.

   3. Klicken Sie im Dialogfeld zur Bestätigung auf Bestätigen.

REST

Verwenden Sie die Methode tagTemplates.patch, um Tag-Vorlagen und benutzerdefinierte Eintragsgruppen aus Data Catalog zu Dataplex Catalog zu übertragen.

Wenn Sie die Übertragungsphase abgeschlossen haben, wird Dataplex Catalog zur maßgeblichen Quelle für alle Ihre Metadaten und Sie müssen Data Catalog nicht mehr verwenden.

Hinweis :Nach der Übertragung kann es eine kurze Verzögerung dauern, bis alle Änderungen im Data Catalog in Dataplex Catalog übernommen werden. Um für zeitkritische Arbeitslasten Datenkonsistenz zu gewährleisten, empfehlen wir, die Dataplex Catalog-Ressourcen vor der Verwendung mit den Data Catalog-Ressourcen oder dem ursprünglichen Quellsystem zu vergleichen.

Programmatische Arbeitslasten aktualisieren

Der Dataplex-Katalog umfasst eine neue API, Clientbibliotheken, Terraform-Module und Google Cloud CLI-Befehle. Daher müssen Sie alle vorhandenen Arbeitslasten, die Data Catalog programmatisch nutzen, auf Dataplex Catalog umstellen. Codebeispiele für Dataplex

Achten Sie darauf, dass Sie die Aktualisierung programmatischer Arbeitslasten mit der Übertragung der abhängigen Ressourcen wie Tag-Vorlagen und benutzerdefinierte Eintragsgruppen abstimmen. Das ist erforderlich, da durch die Übertragung der aktive Status (read-write) einer Ressource von Data Catalog in Dataplex Catalog verschoben wird.

Im Folgenden finden Sie ein Beispiel für die Aktualisierung programmatischer Arbeitslasten, um mit Dataplex Catalog zu interagieren, koordiniert mit der Übertragung der abhängigen Ressourcen:

1. Wenn Ihre Arbeitslasten die eventuale Konsistenz tolerieren, verschieben Sie read-Vorgänge von Arbeitslasten in Dataplex Catalog.

2. Verschieben Sie Arbeitslasten, die Tagging-write-Vorgänge ausführen, in Dataplex Catalog und übertragen Sie gleichzeitig die entsprechenden Tag-Vorlagen.

3. Verschieben Sie Arbeitslasten, die benutzerdefinierte Datenaufnahmevorgänge write ausführen, in Dataplex Catalog. Dabei müssen die entsprechenden benutzerdefinierten Eintragsgruppen übertragen werden.

Wenn Sie die Aktualisierung von Arbeitslasten und die Übertragung entsprechender Ressourcen voneinander trennen möchten, können Sie in den Arbeitslasten Logik implementieren, um read-write basierend auf dem Status der Ressourcenübertragung an Data Catalog oder Dataplex Catalog weiterzuleiten. Arbeitslasten werden also unabhängig vom Übertragungsstatus der zugehörigen Ressource ausgeführt.

Hinweis :In Dataplex Catalog können benutzerdefinierte Einträge und Aspekte nicht mit Terraform verwaltet werden. Verwenden Sie bulk entry import, um Aspekte für benutzerdefinierte Einträge zu verwalten. Mit bulk entry import können Sie keine Aspekte für Systemeinträge verwalten, die Dataplex automatisch für Ihre Google Cloud--Ressourcen erstellt.

Nächste Schritte

• Weitere Informationen zu Dataplex Catalog
• Weitere Informationen zum Suchen nach Ressourcen in Dataplex Catalog
• Weitere Informationen zum Verwalten von Aspekten und zum Anreichern von Metadaten in Dataplex Catalog
• Informationen zum Verwalten von Einträgen und zum Aufnehmen benutzerdefinierter Quellen in Dataplex Catalog
• Weitere Informationen finden Sie in der Referenz zur Dataplex Catalog API.