Résoudre les problèmes que vous pouvez rencontrer lors de l'importation d'artefacts de gouvernance avec IBM Knowledge Catalog
- Les noms de colonne sont incorrects
- Les relations avec des artefacts inexistants sont ignorées
- La catégorie n'existe pas
- Impossible de trouver les artefacts après l'importation CSV
- Impossible de trouver les artefacts après l'importation ZIP
- L'importation ZIP crée des artefacts en double
- Les relations avec les classes de données prédéfinies et les classifications importées à partir de ZIP sont manquantes
Les noms de colonne sont incorrects
Description du problème
L'importation échoue avec l'erreur qu'un nom de colonne n'est pas valide pour ce type d'artefact ou qu'une colonne obligatoire est manquante, mais en fait toutes les colonnes du fichier sont nommées correctement et aucune des colonnes obligatoires n'est manquante.
Solution de contournement
Les en-têtes peuvent contenir des espaces qui ne sont pas visibles dans la feuille de calcul ou même dans l'éditeur de texte. Le caractère blanc empêche la reconnaissance du nom de colonne.
- Editez le fichier à l'aide d'un éditeur qui affiche les caractères blancs.
- Essayez de supprimer les en-têtes et entrez leurs noms manuellement à partir de zéro.
- Vérifiez si le codage du fichier est UTF-8, et non pas, par exemple, UTF-8 BOM.
Les relations vers des artefacts inexistants sont ignorées
Description du problème
Lorsque vous définissez un type de relation entre deux artefacts, le processus d'importation aboutit, mais les relations avec des artefacts inexistants sont ignorées. Les relations ignorées génèrent des erreurs similaires à ce qui suit:
GIM00015E: Artifact Average balance in column Related Terms is not found in the specified hierarchy.
Solution de contournement
Si vous prévoyez d'importer plusieurs types d'artefacts qui ont des relations entre eux, importez d'abord tous les artefacts, publiez les artefacts importés, puis importez à nouveau les mêmes fichiers CSV, avec la méthode de fusion Remplacer toutes les valeurs . Le deuxième processus d'importation ajoute les relations aux artefacts existants.
La catégorie n'existe pas
Description du problème
Si une catégorie parent d'un artefact n'est pas définie dans le fichier CVS, les artefacts sont importés dans la catégorie [ uncategorized ] par défaut. Si une catégorie parent d'un artefact est définie dans le fichier CSV, mais qu'elle n'existe pas dans l'environnement, l'importation échoue. Le processus d'importation crée toujours un seul type d'artefact par importation. Lors de l'importation d'artefacts autres que des catégories, la catégorie parent ne peut pas être créée.
Solution de contournement
Avant d'importer des artefacts à partir d'un fichier CSV, assurez-vous que les catégories que vous souhaitez importer existent dans l'environnement. Créez-les avant de démarrer le processus d'importation.
Impossible de trouver les artefacts après l'importation CSV
Description du problème
Les artefacts importés par les fichiers CSV ne sont pas visibles sur les pages publiées.
Solution de contournement
Vous devez publier les artefacts avant qu'ils apparaissent comme publiés et qu'ils soient disponibles pour être utilisés. Si les artefacts se trouvent dans les catégories importées, vous devrez peut-être ajouter des utilisateurs en tant que collaborateurs à ces catégories.
Impossible de trouver les artefacts après l'importation ZIP
Description du problème
Les artefacts importés par les fichiers ZIP ne sont pas visibles dans l'interface utilisateur, mais ils sont disponibles dans les appels d'API.
Solution de contournement
Il est possible que le service wkc-search
n'ait pas été à l'état ready
lors de l'importation ZIP. Pour résoudre le problème, resynchronisez avec la commande suivante:
curl -X GET "$CPD_URL/v3/glossary_terms/admin/resync?artifact_type=all" -k -H "accept: application/json" -H "Authorization: Bearer $TOKEN"
Le processus d'importation ZIP crée des artefacts en double
Description du problème
Les artefacts des fichiers ZIP exportés sont identifiés par des identificateurs d'artefact dans la colonne Artifact ID
, et non par le nom d'artefact et le chemin de catégorie. Cependant, les identificateurs d'artefacts pour les termes commerciaux prédéfinis, les classes de données et les classifications diffèrent entre chaque instance d'IBM Knowledge Catalog Par conséquent, les artefacts prédéfinis importés ne sont pas reconnus comme étant identiques aux artefacts prédéfinis existants. Par conséquent, le processus d'importation crée des artefacts en double.
Solution de contournement
Supprimez les artefacts prédéfinis existants de l'instance IBM Knowledge Catalog cible avant d'importer des artefacts. Voir Suppression d'artefacts publiés du même type.
Pour les classes de données et les classifications prédéfinies:
- Excluez la catégorie [ uncategorized ] lorsque vous créez le fichier ZIP en exportant des artefacts.
- Editez les fichiers CSV des classes de données et des classifications et remplacez les identificateurs d'artefact des classes de données et des classifications prédéfinies dans les colonnes Classification parent et Classe de données parent par les noms d'artefact et les chemins de catégorie prédéfinis équivalents.
- Editez les fichiers CSV d'autres artefacts et remplacez les identificateurs d'artefact des classes de données et des classifications prédéfinies par les noms d'artefact et les chemins de catégorie prédéfinis équivalents dans les colonnes Classifications et Classes de données , pour tous les artefacts qui ont des relations avec les artefacts prédéfinis.
Lorsque vous importez les artefacts, des relations vers les artefacts prédéfinis de la cible existants sont créées.
Pour les termes métier prédéfinis:
- Excluez la catégorie Exemples de données personnelles de Knowledge Accelerator lorsque vous créez le fichier ZIP en exportant des artefacts.
- Editez les fichiers CSV pour les Termsa métier et les autres artefacts et remplacez les identificateurs d'artefact pour les termes métier prédéfinis par les noms d'artefact et les chemins de catégorie prédéfinis équivalents dans la colonne Termes associés et dans toute autre colonne définissant des relations de termes métier.
Lorsque vous importez les artefacts, des relations vers les artefacts prédéfinis de la cible existants sont créées.
Les ensembles de données de référence prédéfinis dans la catégorie Emplacements ont les mêmes valeurs d'ID d'artefact dans toutes les instances d'IBM Knowledge Catalog, il n'est pas nécessaire de trouver une solution.
Les relations vers les classes de données prédéfinies et les classifications importées à partir de ZIP sont manquantes
Description du problème
Les propriétés personnalisées et les valeurs de relation ne sont pas importées.
Solution de contournement
Editez les fichiers CSV et éditez les valeurs des classes de données prédéfinies et des classifications associées à partir des ID d'artefact vers les noms d'artefact et les chemins de catégorie, puis réimportez.
Sujet parent : Dépannage du IBM Knowledge Catalog