Alle Governance-Artefakte aus einer Instanz mit einer ZIP-Datei importieren

Zurück zur englischen Version der Dokumentation

Letzte Aktualisierung: 13. Dez. 2024

Alle Governance-Artefakte aus einer Instanz mit einer ZIP-Datei importieren

Sie können alle Governance-Artefakte aus einer IBM Knowledge Catalog mit einer ZIP-Datei importieren, die Sie durch Exportieren der Artefakte erstellt haben.

Sie können diese Methode verwenden, um Governance-Artefakte von einer IBM Knowledge Catalog zu einer anderen zu verschieben oder um die Eigenschaften von Governance-Artefakten mit einem externen Tool zu bearbeiten. Alle importierten Artefakte werden sofort ohne Workflow veröffentlicht.

Voraussetzungen
Inhalt der ZIP-Datei bearbeiten
Import einer ZIP-Datei vorbereiten
Zusammenführungsoptionen
ZIP-Datei importieren
Importprozess überwachen
Blockierten Importprozess bereinigen

Voraussetzungen

Bevor Sie Governance-Artefakte mit einer ZIP-Datei importieren, erstellen Sie die Datei im richtigen Format und stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen verfügen.

ZIP-Datei

Sie müssen über eine ZIP-Datei mit exportierten Artefakten verfügen, die Sie mit der API-Anforderung GET /v3/governance_artifact_types/{artifact_type}/export erstellt haben. Die maximale Größe der ZIP-Datei beträgt 2 GB. Siehe Alle Governance-Artefakte in eine ZIP-Datei exportieren.

Berechtigungen

Sie müssen über die Benutzerberechtigung Glossar verwalten verfügen.

Sie müssen kein Mitarbeiter in einer der Kategorien sein, die vom Importprozess erstellt wurden oder betroffen sind.

Inhalt der ZIP-Datei bearbeiten

Die exportierte ZIP-Datei enthält einen separaten Ordner für jeden Artefakttyp mit einer CSV-Datei, die diesen Artefakttyp enthält.

Sie können den Inhalt der exportierten ZIP-Datei manuell ändern. Beachten Sie die folgenden Richtlinien:

Do not create additional folders, for example, a parent folder.
Ändern Sie die Ordnernamen nicht. Die Ordner für jeden Artefakttyp in der ZIP-Datei müssen die folgenden Namen haben: category, classification, data_class, glossary_term, policy, ruleund reference_data.
Behalten Sie das korrekte Format jeder CSV-Datei bei. Siehe CSV-Dateiformat für den Import von Governance-Artefakten.
Entfernen Sie nicht die Spalte Artifact ID in jeder CSV-Datei oder benennen Sie sie um. Diese Spalte gibt die ID des Artefakts zusätzlich zum Namen des Artefakts an.
Definieren Sie eine Beziehung zwischen zwei Governance-Artefakten nur für eines der Artefakte. Es gibt zwei Ausnahmen:
1. Die Beziehung besteht zwischen einer Richtlinie und einer Governance-Regel. Definieren Sie in diesem Fall die Beziehung für beide Artefakte in beiden CSV-Dateien. Fügen Sie in der CSV-Datei mit Richtlinien die Beziehung zur Spalte Rule hinzu. Fügen Sie in der CSV-Datei mit Governance-Regeln die Beziehung zur Spalte Parent Policies hinzu.
2. Sie verwenden die Mischoption all . In diesem Fall müssen Sie sicherstellen, dass der gesamte CSV-Inhalt hinsichtlich der Beziehungen zwischen Artefakten konsistent ist. Wenn die ZIP-Importdatei beispielsweise sowohl einen Begriff als auch eine Datenklasse enthält, die mit einer Beziehung verbunden sind, muss diese Beziehung sowohl in der CSV-Datenklasse als auch in der CSV-Datenklasse vorhanden sein. Andernfalls ist das Verhalten beim Importieren von Beziehungen unvorhersehbar, d. h., die Beziehung kann importiert werden.

Import einer ZIP-Datei vorbereiten

Bevor Sie eine ZIP-Datei importieren, müssen Sie die folgenden Tasks ausführen:

Führen Sie die entsprechende Aktion aus, um doppelte vordefinierte Artefakte zu vermeiden.
Angepasste Eigenschaften und Beziehungen erstellen

Doppelte vordefinierte Artefakte vermeiden

Artefakte in exportierten ZIP-Dateien werden mit Artefakt-IDs in der Spalte Artifact ID anstelle des Artefaktnamens und des Kategoriepfads angegeben. Allerdings unterscheiden sich die Artefakt-Identifikatoren für vordefinierte Geschäftsbegriffe, Datenklassen und Klassifizierungen zwischen den einzelnen IBM Knowledge Catalog. Daher werden importierte vordefinierte Geschäftsbegriffe, Datenklassen und Klassifizierungen nicht als identisch mit vorhandenen vordefinierten Geschäftsbegriffen, Datenklassen und Klassifizierungen erkannt. Daher erstellt der Importprozess doppelte Artefakte.

Sie können doppelte Artefakte mit einer der folgenden Methoden vermeiden:

Löschen Sie die vorhandenen vordefinierten Artefakte aus der IBM Knowledge Catalog, bevor Sie Artefakte importieren. Siehe Veröffentlichte Artefakte desselben Typs löschen.
Für vordefinierte Datenklassen und Klassifizierungen:
1. Schließen Sie die Kategorie [uncategorized] aus, wenn Sie die ZIP-Datei durch Exportieren von Artefakten erstellen.
2. Bearbeiten Sie die CSV-Dateien für Datenklassen und Klassifizierungen und ersetzen Sie die Artefakt-IDs für vordefinierte Datenklassen und Klassifizierungen in den Spalten Übergeordnete Klassifikation und Übergeordnete Datenklasse durch die entsprechenden vordefinierten Artefaktnamen und Kategoriepfade.
3. Bearbeiten Sie die CSV-Dateien für andere Artefakte und ersetzen Sie die Artefakt-IDs für vordefinierte Datenklassen und Klassifizierungen durch die entsprechenden vordefinierten Artefaktnamen und Kategoriepfade in den Spalten Klassifikationen und Datenklassen für alle Artefakte, die Beziehungen zu den vordefinierten Artefakten haben.
Wenn Sie die Artefakte importieren, werden Beziehungen zu den vorhandenen vordefinierten Zielartefakten erstellt.
Für vordefinierte Geschäftsbegriffe:
1. Schließen Sie die Kategorie Persönliche Beispieldaten für Knowledge Accelerator aus, wenn Sie die ZIP-Datei durch Exportieren von Artefakten erstellen.
2. Bearbeiten Sie die CSV-Dateien für Geschäftsbegriffe und andere Artefakte und ersetzen Sie die Artefakt-IDs für vordefinierte Geschäftsbegriffe durch die entsprechenden vordefinierten Artefaktnamen und Kategoriepfade in der Spalte Zugehörige Begriffe und in allen anderen Spalten, die Geschäftsbegriffsbeziehungen definieren.
Wenn Sie die Artefakte importieren, werden Beziehungen zu den vorhandenen vordefinierten Zielartefakten erstellt.

Die vordefinierten Referenzdatensätze in der Kategorie Standorte haben in allen IBM Knowledge Catalog die gleichen Artefakt-ID-Werte.

Angepasste Eigenschaften und Beziehungen erstellen

Sie müssen jede angepasste Eigenschaft oder Beziehungsdefinition manuell erstellen, bevor Sie die ZIP-Datei importieren. Andernfalls werden angepasste Eigenschaften und Beziehungswerte nicht importiert.

Weitere Informationen finden Sie unter Angepasste Eigenschaften und Beziehungen.

Zusammenführungsoptionen

Die folgenden Zusammenführungsoptionen sind beim Ausführen des ZIP-Imports verfügbar:

all: Ersetzen Sie alle Werte. Importierte Werte ersetzen vorhandene Werte in einem Katalog.
specified: Durch definierte Werte ersetzen. Importierte Werte, die nicht leer sind, ersetzen vorhandene Werte in einem Katalog.
empty: Leere Werte ersetzen. Importierte Werte ersetzen nur leere Werte in einem Katalog.

specified wird standardmäßig verwendet.

Beim Importieren von Dateien, die Referenzdatenwerte enthalten, müssen Sie immer merge_option=allverwenden.

Weitere Informationen zu den Mischoptionen finden Sie unter Methoden zum Mischen von importierten und vorhandenen Artefakten .

ZIP-Datei importieren

Gehen Sie wie folgt vor, um eine ZIP-Datei mit Governance-Artefakten zu importieren:

Löschen Sie bei Bedarf vorhandene vordefinierte Artefakte oder bearbeiten Sie Beziehungen zu vordefinierten Artefakten. Siehe Import einer ZIP-Datei vorbereiten.
Übergeben Sie die Anforderung POST /v3/governance_artifact_types/import. Schließen Sie die Zusammenführungsoption und den Pfad zur ZIP-Datei ein. Siehe API-Dokumentation: Werte aus angegebener ZIP-Datei importieren. Alle Artefakte werden sofort ohne Workflow veröffentlicht.
Fügen Sie nach Abschluss des Importprozesses weitere Mitarbeiter zu den neuen Kategorien hinzu. Siehe Kategoriemitarbeiter verwalten.

Sie müssen warten, bis der Importprozess abgeschlossen ist, oder Sie bereinigen den blockierten Prozess, bevor Sie einen neuen Importprozess starten können.

Importprozess überwachen

Nachdem Sie die Anforderung zum Importieren der ZIP-Datei übergeben haben, wird eine Prozess-ID in der Antwort (ParameterProzess-ID ) angegeben. Sie können die Prozess-ID verwenden, um den Status des Imports zu überprüfen. Übergeben Sie eine GET /v3/governance_artifact_types/import/status/{process_id}-Anforderung zum Abfragen des Importstatus. Siehe API-Dokumentation: Importstatus.

Blockierten Importprozess bereinigen

Experimentell Dieses experimentelle Release wird noch nicht für die Verwendung in Produktionsumgebungen unterstützt.

Wenn der Import blockiert, können Sie den Importprozess bereinigen und anschließend die ZIP-Datei erneut importieren. Sie können erst einen neuen Importprozess starten, wenn der vorherige abgeschlossen ist oder Sie den blockierten Prozess bereinigt haben. Alle Importprozesse werden nach 24 Stunden Inaktivität automatisch bereinigt.

Sie können den Status des Importprozesses überprüfen, indem Sie eine Anforderung GET /v3/governance_artifact_types/import/status/{process_id} übergeben. Der Prozess ist blockiert, wenn der Status IN_PROGRESS lautet, aber keine Artefakte importiert werden.

Übergeben Sie die Anforderung POST /v3/governance_artifact_types/import/cleanup/{process_id} , um einen blockierten oder fehlgeschlagenen Importprozess zu bereinigen.

Siehe API-Dokumentation: ZIP-Importprozess bereinigen.

Weitere Informationen

Übergeordnetes Thema: Methoden für Governance-Artefakte importieren