Vous pouvez importer des artefacts de gouvernance avec un fichier. Vous pouvez importer un type d'artefact de gouvernance à la fois, ou importer tous les artefacts de gouvernance d'une autre instance IBM Knowledge Catalog.
- Compatibilité entre les environnements de déploiement
- Comparaison des méthodes d'importation
- Artefacts de gouvernance que vous pouvez importer
- Méthodes de fusion des artefacts importés et existants
- Remarques relatives à la sécurité
Compatibilité entre les environnements de déploiement
Vous pouvez exporter puis importer des artefacts de gouvernance entre les instances d'IBM Knowledge Catalog dans les environnements de déploiement suivants :
- Cloud Pak for Data 3.5
- Cloud Pak for Data 4.x
- Cloud Pak for Data as a Service
Les valeurs des responsables ne sont pas compatibles entre les instances IBM Knowledge Catalog Cloud Pak for Data as a Service et Cloud Pak for Data 3.5 ou 4.x
Vous pouvez importer des artefacts de gouvernance depuis IBM InfoSphere Information Governance Catalog vers des instances IBM Knowledge Catalog sur Cloud Pak for Data 3.5 et 4.x Pour importer des artefacts de gouvernance depuis IBM InfoSphere Information Governance Catalog vers des instances IBM Knowledge Catalog sur Cloud Pak for Data as a Service, vous devez modifier chaque fichier CSV pour qu'il soit conforme au format des fichiers CSV des artefacts IBM Knowledge Catalog Par exemple, vous pouvez être amené à effectuer les types d'édition suivants:
- Supprimer les colonnes non prises en charge
- Séparer les différents types d'artefact dans plusieurs fichiers CSV
- Modifier les colonnes prises en charge
- Ajouter des colonnes requises
Comparaison des méthodes d'importation
Choisissez la méthode d'importation appropriée à vos objectifs et à vos circonstances.
- Importation d'un type d'artefact unique
Vous pouvez importer un seul type d'artefact de gouvernance à la fois avec un fichier CSV.
Cette méthode est utile dans les types de cas suivants:
- Vous souhaitez que les artefacts importés soient soumis à un flux de travaux.
- Vous souhaitez ajouter des valeurs pour une propriété à un type d'artefact de gouvernance. Exportez ce type d'artefact en tant que fichier CSV, éditez le fichier CSV, puis importez-le. Par exemple, vous pouvez utiliser cette méthode pour ajouter un attribut personnalisé à vos termes métier.
- Vous souhaitez définir des artefacts dans un autre programme. Créez des fichiers CSV pour chaque type d'artefact. Par exemple, vous pouvez utiliser cette méthode pour définir des artefacts dans un tableur, puis les importer.
Voir Importation d'artefacts de gouvernance par type avec des fichiers CSV et Format de fichier CSV pour l'importation d'artefacts de gouvernance.
- Importation de plusieurs types d'artefact
Vous pouvez importer plusieurs types d'artefacts de gouvernance avec un fichier ZIP que vous avez créé en exportant plusieurs types d'artefacts de gouvernance existants à partir d'une instance IBM Knowledge Catalog Le fichier ZIP contient des fichiers CSV pour les catégories et chaque type d'artefact exporté. Les fichiers CSV correspondent au format du fichier d'importation CSV, à l'exception de:
- La colonne ID d'artefact supplémentaire, qui contient les identificateurs des artefacts au lieu d'identifier les artefacts par nom et chemin de catégorie.
- Les artefacts associés sont définis avec des ID d'artefact à la place du contexte et du nom.
Cette méthode est utile dans les types de cas suivants:
- Vous souhaitez déplacer tous les artefacts de gouvernance d'une instance IBM Knowledge Catalog vers une autre.
Le tableau suivant récapitule les différences entre l'importation d'artefacts avec des fichiers CSV ou un fichier ZIP.
| Caractéristiques | fichier CSV | Fichier ZIP |
|---|---|---|
| Création de fichiers | Exporter un type d'artefact existant Créer un fichier dans un tableur Exporter des artefacts depuis IBM InfoSphere Information Governance Catalog et ajuster le format |
Exporter plusieurs types d'artefact à partir d'une instance |
| Nombre de types d'artefact | Catégories ou un type d'artefact par fichier. | Plusieurs types d'artefact, avec des catégories et chaque type d'artefact dans un fichier CSV distinct. |
| méthodes d'importation | Via la demande d'API de l'interface utilisateur |
Demande d'API |
| Flux de travaux | Tous les artefacts sont importés en tant que brouillon et sont soumis à un flux de travaux. Les catégories sont publiées immédiatement car elles ne sont pas soumises à un flux de travaux. | Tous les artefacts et toutes les catégories sont publiés immédiatement. |
| Droits requis | Droits permettant de créer ou d'éditer des catégories. Vous devez être au moins un éditeur dans la catégorie dans laquelle vous effectuez l'importation. Pour plus de détails, voir Droits requis. | Le droit Gérer le glossaire |
Artefacts de gouvernance que vous pouvez importer
Avec les deux méthodes d'importation, vous pouvez importer des catégories et les types d'artefacts de gouvernance suivants:
- Termes métier
- Classifications
- Classes de données
- Règles de gouvernance
- Stratégies
- Jeux de données de référence
Restrictions :
- Vous pouvez importer des valeurs pour toutes les propriétés de ces types d'artefacts de gouvernance, y compris les relations avec d'autres artefacts. Toutefois, les relations sont importées uniquement lorsque l'artefact associé existe ou est défini dans le même processus d'importation. Pour ajouter des relations que le processus d'importation a ignorées, commencez par publier tous les artefacts de brouillon importés, puis exécutez à nouveau le processus d'importation.
- Vous ne pouvez pas utiliser CSV pour déplacer des artefacts de gouvernance et leurs relations entre des instances Cloud Pak for Data . Par exemple, si vous essayez d'exporter des classes de données avec la méthode de correspondance Faire correspondre aux données de référence au format CSV, puis de l'importer dans une autre instance Cloud Pak for Data , l'importation échoue car l'ID d'artefact n'est pas inclus dans les importations et les exportations CSV. Utilisez l'importation ZIP à la place.
- Lors de l'importation d'un jeu de données de référence à partir d'un fichier CSV, les valeurs de données de référence de cet ensemble ne sont pas importées. Vous devez utiliser un fichier CSV distinct pour importer les valeurs dans le jeu de données. Vous pouvez également utiliser une importation ZIP pour importer à la fois le jeu de données de référence et ses valeurs de données de référence. Pour plus d'informations, voir Importation de fichiers pour des jeux de données de référence.
- Vous ne pouvez pas importer de règles de protection des données ou de règles d'emplacement des données.
Méthodes de fusion des artefacts importés et existants
Que vous importiez des artefacts avec des fichiers CSV ou un fichier ZIP, vous devez choisir ce qui se passe lorsque vous importez des artefacts de gouvernance qui existent déjà et que les valeurs des propriétés sont différentes. Le tableau suivant récapitule les trois méthodes de fusion.
| Méthode de fusion | API | Effet sur les valeurs d'origine | Effet sur les valeurs importées |
|---|---|---|---|
| Remplacer toutes les valeurs | merge_option=all |
Supprimer toutes les valeurs d'origine. | Acceptez toutes les valeurs importées, même les valeurs vides. |
| Remplacer par les valeurs définies | merge_option=specified |
Conserver les valeurs d'origine si les valeurs importées sont vides. | Acceptez toutes les valeurs importées, à l'exception des valeurs vides. |
| Remplacer les valeurs vides | merge_option=empty |
Conserver les valeurs d'origine, à l'exception des valeurs vides. | Accepter uniquement les valeurs importées qui remplacent les valeurs vides. |
Pour les nouveaux artefacts, chacune de ces méthodes produit les mêmes résultats.
Remplacer toutes les valeurs
Toutes les valeurs d'origine de l'artefact sont supprimées et remplacées par les valeurs de l'artefact importé. Si la valeur d'une propriété pour l'artefact importé est vide, toutes les valeurs d'origine de cette propriété sont supprimées.
Par exemple, supposons que vous disposiez d'un terme métier publié nommé release et que vous importez un fichier CSV pour le modifier. Le tableau suivant montre l'effet de l'option Remplacer toutes les valeurs :
| Propriété | Valeurs originelles | Valeurs du fichier CSV | Valeurs résultantes |
|---|---|---|---|
| Nom | release | release | release |
| Type d'artefact | glossary_term | glossary_term | glossary_term |
| Category (Catégorie) | marketing | marketing | marketing |
| Descriptif | Exemple de terme | Exemple de terme édité | Exemple de terme édité |
| Balises | bêta | bêta | |
| Termes connexes | markting> > version | marketing> > date | marketing> > date |
| Classifications |
|
L'artefact de brouillon résultant comporte les modifications suivantes apportées aux valeurs d'origine:
- La description d'origine est remplacée par une nouvelle description.
- La valeur vide d'origine pour les balises est remplacée par une valeur.
- Le terme connexe d'origine est remplacé par un nouveau terme connexe.
- La valeur de classification d'origine est remplacée par une valeur vide.
Lorsque vous utilisez l'option de fusion all , vous devez vous assurer que tout le contenu CSV est cohérent en ce qui concerne les relations entre les artefacts. Par exemple, si le fichier d'importation ZIP contient à la fois un terme et une classe de données connectés avec une relation, cette relation doit être présente à la fois dans les classes de données CSV et dans les termes CSV. Sinon, le comportement d'importation de la relation est imprévisible, la relation peut être importée ou non.
Lors de l'importation de fichiers ZIP contenant des valeurs de données de référence, vous devez toujours utiliser merge_option=all dans l'appel API.
Remplacer par des valeurs définies
Les valeurs d'origine et vides de l'artefact sont remplacées par les valeurs fournies de l'artefact importé. Si la valeur d'une propriété pour l'artefact importé est vide, les valeurs d'origine de la propriété sont conservées.
Par exemple, supposons que vous disposiez d'un terme métier publié nommé release et que vous importez un fichier CSV pour le modifier. Le tableau suivant montre l'effet de l'option Remplacer par les valeurs définies :
| Propriété | Valeurs originelles | Valeurs du fichier CSV | Valeurs résultantes |
|---|---|---|---|
| Nom | release | release | release |
| Type d'artefact | glossary_term | glossary_term | glossary_term |
| Category (Catégorie) | marketing | marketing | marketing |
| Descriptif | Exemple de terme | Exemple de terme édité | Exemple de terme édité |
| Balises | bêta | bêta | |
| Termes connexes | markting> > version | marketing> > date | marketing> > date |
| Classifications |
|
|
L'artefact de brouillon résultant comporte les modifications suivantes apportées aux valeurs d'origine:
- La description d'origine est remplacée par une nouvelle description.
- La valeur vide d'origine pour les balises est remplacée par une valeur.
- Le terme connexe d'origine est remplacé par un nouveau terme connexe.
Remplacer les valeurs vides
Les valeurs vides de l'artefact d'origine sont remplacées par les valeurs fournies de l'artefact importé.
Par exemple, supposons que vous disposiez d'un terme métier publié nommé release et que vous importez un fichier CSV pour le modifier. Le tableau suivant montre l'effet de l'option Remplacer les valeurs vides :
| Propriété | Valeurs originelles | Valeurs du fichier CSV | Valeurs résultantes |
|---|---|---|---|
| Nom | release | release | release |
| Type d'artefact | glossary_term | glossary_term | glossary_term |
| Category (Catégorie) | marketing | marketing | marketing |
| Descriptif | Exemple de terme | Exemple de terme édité | Exemple de terme |
| Balises | bêta | bêta | |
| Termes connexes | markting> > version | marketing> > date | markting> > version |
| Classifications |
|
|
L'artefact de brouillon résultant comporte cette modification des valeurs d'origine:
- La valeur vide d'origine pour les balises est remplacée par une valeur.
Remarques relatives à la sécurité
Les données de gouvernance exportées dans des fichiers CSV sont assainies contre les attaques par injection CSV connues, afin d'être sûres pour les tableurs qui interprètent automatiquement les données CSV. Par conséquent, toute valeur texte commençant par l'un des caractères suivants:
- est égal à (=)
- plus (+)
- moins (-)
- à (@)
sont précédés d'une apostrophe ('). Pour rendre la fonctionnalité cohérente, les fichiers CSV importés sont également analysés pour supprimer automatiquement le guillemet simple ('). L'assainissement s'applique également lors de l'importation et de l'exportation d'artefacts de gouvernance dans des fichiers ZIP, car ils contiennent des fichiers CSV.
Pour désactiver cette fonctionnalité:
Modifier le glossaire IBM Knowledge Catalog Déploiement de services :
oc edit deployment wkc-glossary-serviceDéfinissez la variable d'environnement
ESCAPE_FORMULAS_IN_CSV_FILESsur la valeurfalse.
Pour plus d'informations, voir Injection CSV.
En savoir plus
- Importation d'artefacts de gouvernance par type avec des fichiers CSV
- Format de fichier CSV pour l'importation d'artefacts de gouvernance
- Importation de tous les artefacts de gouvernance à partir d'une instance avec un fichier ZIP
Rubrique parent : Gestion des artefacts de gouvernance