erwin 9.x à 12.x Data Modeler (Fichier) - Import

Spécifications du pont

Fournisseur	erwin, Inc.
Nom de l'outil	erwin Data Modeler
Version de l'outil	9.x à 12.x
Site Web de l'outil	https://erwin.com/products/erwin-data-modeler/ (uniquement en anglais)
Méthodologie supportée	[Modélisation de données] Data Store (Modèle de données physique, Modèle de données logique, Parsage d'expressions de procédures stockées), Disposition graphique via l'API COM sur Native (.erwin) ou fichier d'export (.XML)
Profiling de données
Collecte incrémentale
Collecte multi-modèle
Navigation dans le référentiel distant pour sélectionner un modèle

SPÉCIFICATIONS
Outil : erwin, Inc./erwin Data Modeler version 8.x via l'API COM sur Native (.erwin) ou fichier d'Export (.XML)
Consultez https://erwin.com/products/erwin-data-modeler/
Métadonnées : [Modélisation de données] Data Store (Modèle de données physique, Modèle de données logique, Parsage d'expressions de procédures stockées), Disposition graphique
Composant : CaErwin9Xml version 11.2.0

VUE D'ENSEMBLE
Ce pont d'import importe des modèles de données d'erwin Data Modeler. Ces modèles sont logiques uniquement comme des entités, des attributs, des domaines, physiques uniquement comme des tables, des colonnes, des types de données ou logiques/physiques. Ce pont d'import importe également toutes les relations et leurs implémentations (par ex. PK (clé primaire)/FK (clé étrangère)), ainsi que la disposition graphique des modèles de données (diagrammes).
Ce pont d'import peut importer des fichiers au format .erwin ou .xml, enregistrés à l'aide d'erwin Data Modeler.
- Format natif erwin (.erwin) :
Le pont d'import requiert l'installation de l'API COM/OLE d'erwin Data Modeler afin d'analyser les fichiers au format .ERWIN.
erwin Data Modeler doit être correctement installé avec une licence valide sur la machine exécutant ce pont d'import.
Afin de vous en assurer, ouvrez un modèle erwin dans le Data Modeler et enregistrez-le sous "Format du référentiel XML".
- Format de fichier Erwin XML (.xml) :
Vous pouvez créer la version .xml d'un fichier (Enregistrer sous... dans erwin), sélectionner le format "Référentiel XML" pour le type de fichier XML qu'erwin crée.
Suivez les étapes ci-dessous pour créer ce type de fichier .XML :
1. Ouvrez le fichier .erwin dans erwin.
2. Sélectionnez Fichier, puis Enregistrer sous...
3. Dans le menu déroulant "Type de fichier", sélectionnez "Référentiel XML (*.xml)".
4. Sélectionnez un chemin d'accès et un nom pour le fichier exporté.
5. Cliquez sur OK

PRÉREQUIS
AVERTISSEMENT : Ce pont utilise l'API COM d'un client basé Windows et/ou SDK devant être (a) correctement installé, (b) avoir une licence adéquate au nom de l'utilisateur Windows capable d'exécuter cet outil et (c) capable d'accéder au contenu du serveur de l'outil. De plus :
(1) Comme recommandé par le fournisseur de l'outil, le serveur de l'outil ne doit pas être installé ou coexister sur la machine où le client de l'outil (et le pont) est installé/en cours d'exécution, à cause de conflits potentiels de ressources, notamment par rapport à l'API COM.
(2) Les outils basés sur l'API COM Windows sont connus pour être instables après des échecs répétés ou un manque de ressources système et nécessitent un redémarrage de Windows pour fonctionner à nouveau correctement.
(3) Si ce pont s'exécute en tant qu'application, la connexion doit être faite par le même utilisateur que pour Windows.
Si ce pont est exécuté en tant que service Windows, allez dans le gestionnaire des services Windows, cliquez-droit sur le service MIMB Application Server et allez dans l'onglet "Log On" pour définir le nom du compte sous lequel le service va s'exécuter.

- Utilisateur erwin :
Le pont d'import doit être exécuté au nom de l'utilisateur Windows qui peut exécuter le logiciel erwin.
S'il s'exécute dans le cadre d'une application de bureau Windows, vous devez alors vous connecter à Windows via cet utilisateur.
Si le pont d'import s'exécute dans le cadre d'un service Windows, accédez aux services Windows et cliquez sur le menu "Propriétés" dudit service, puis accédez à l'onglet "Se connecter". Sélectionnez "Ce compte" et spécifiez le nom et le mot de passe de l'utilisateur utilisés pour vous connecter à une session Windows lorsque vous avez testé la connexion d'erwin au Mart. Redémarrez ensuite le service Windows.

FOIRE AUX QUESTIONS
Q : Quel ordre le pont d'import utilise-t-il pour importer les attributs ?
R : De préférence, le pont d'import importe d'abord les modèles physiques, si cette information est présente dans le fichier XML, sinon, l'ordre logique est utilisé.
Pour afficher l'ordre des colonnes physiques dans erwin :
- Passez à la Vue Physique du modèle,
- Dans le menu "Diagramme", sélectionnez "Diagrammes",
- Cliquez sur l'onglet "Table"
- Sélectionnez "Ordre Physique" dans le menu déroulant "Niveau d'affichage physique".
Il s'agit de l'ordre utilisé par erwin lors de la génération de DDL SQL, et MIMB importera cet ordre, s'il est disponible dans le fichier.
Si vous souhaitez importer l'ordre logique, générez un modèle logique uniquement dans erwin et importez-le.

LIMITATIONS
Consultez les limitations générales connues actuellement sur MIMB Known Limitations ou dans Documentation/ReadMe/MIMBKnownLimitations.html où elles sont regroupées

- La modélisation NoSQL Erwin Data Modeler 2021 n'est pas supportée :
En plus de la modélisation de base de données relationnelle, le nouvel Erwin Data Modeler 2021 ajoute le support des modélisations NoSQL/hiérarchiques de fichiers de type JSON ou de bases de données comme MongoDB.
Malheureusement, cette modélisation NoSQL est effectuée au niveau de l'instance et non au niveau du schéma, ce qui n'est pas compatible avec la manière dont la modélisation NoSQL s'effectue dans les autres outils DM/MM/DI/BI et n'est donc pas supportée.
Par exemple, erwin crée autant de colonnes qu'il y a d'instances dans un tableau d'un fichier JSON, au lieu de factoriser tous les champs possibles sur les différentes instances, afin de créer une structure unifiée de toutes les possibilités.

- Avertissement concernant les noms physiques potentiellement manquants :
Ce problème est courant lors de la conversion d'erwin vers des outils ETL ou BI (Business Intelligence), ou vers la norme OMG CWM XMI. Lors de l'enregistrement d'un modèle logique et physique, les noms physiques des tables, colonnes et clés peuvent ne pas toujours être enregistrés dans le fichier XML. Lorsqu'erwin est utilisé pour gérer la génération automatique de noms physiques à partir de noms logiques, seules les règles de génération sont enregistrées. Cela ne sera pas le cas pour des modèles erwin physiques uniquement (ce qui est souvent le cas lors du re-traitement de bases de données existantes).
La solution de contournement principale à ce problème est de cocher la case "Format AllFusion Repository" (comme décrit ci-dessus) lors de l'enregistrement du fichier .XML. Il vous suffit d'importer le fichier XML produit dans le pont d'import erwin, comme d'habitude.
Autre solution : veillez à ce que les noms physiques soient définis explicitement, et ne dépendent pas de règles de génération basées sur les noms logiques.
Vous pouvez également générer un nouveau modèle physique (à enregistrer au format XML) de votre modèle logique et physique existant. Dans le menu "Outils", sélectionnez "Générer un nouveau modèle...", puis dans "Type du nouveau modèle", sélectionnez "Physique".
La prochaine étape de l'Assistant vous demande ensuite toutes les règles de génération pour produire tous les noms physiques.
Le nouveau modèle physique peut alors être enregistré au format XML. Notez que les noms logiques des tables sont également disponibles dans ce nouveau fichier XML, mais malheureusement les noms logiques des attributs peuvent être manquants.
Notez que le pont d'import analyse automatiquement les fichiers .ERWIN à l'aide de la fonction de génération du XML correct dans erwin, faisant en sorte que le problème de noms physiques manquants ne se produise pas.

- Avertissement concernant les rôles de types dimensionnels potentiellement manquants :
Ce problème est courant lorsqu'erwin est utilisé pour définir le type dimensionnel pour les outils BI ou pour la norme OMG CWM XMI. Comme pour le problème de noms physiques expliqué ci-dessus, les rôles de types dimensionnels (de fait, de dimension et de dimension secondaire) peuvent ne pas être disponibles dans le fichier XML, s'ils sont calculés automatiquement par erwin.
La solution est de s'assurer que tous les rôles de types dimensionnels sont explicitement définis (utilisez l'"Éditeur de tables", onglet "Dimensionnel"), ainsi ils ne dépendent pas des calculs automatiques d'erwin habituels.

- Avertissement concernant les messages contextuels potentiels :
Lors de l'import de modèles .erwin, il est possible qu'erwin affiche une fenêtre contextuelle à laquelle le pont d'import peut ne pas pouvoir répondre.
Il en résulte que le pont d'import s'arrête durant l'import. Une solution de contournement recommandée par le fournisseur est de modifier le répertoire comme suit, afin d'éviter les messages contextuels :
- Modifiez le registre sur la machine sur laquelle le pont d'import est exécuté, en utilisant Regedit.exe
- Recherchez la clé :
Pour les versions 9.0 à 9.6 : HKEY_CURRENT_USER\Software\CA\ERwin Data Modeler\9.0\Messages
pour la version 9.7 : HKEY_CURRENT_USER\Software\erwin\Data Modeler\9.7\Messages
- Ajoutez les données "GDM-46=1;" à la valeur "Statut du message"

- Support des noms de fichiers ayant des caractères Unicode :
Si le nom de votre fichier erwin contient des caractères Unicode (par exemple des caractères cyrilliques ou des kanjis), erwin peut ne pas ouvrir le fichier correctement.
Pour contourner cette limitation, vous pouvez :
- renommer le fichier pour éviter l'utilisation de ces caractères,
- ou configurer votre locale système comme UTF-8.
Pour cette dernière option, vous devez avoir la version de Windows 10 insider build 17035 ou nominal build 17134 (Sortie en avril 2018) et utiliser les menus :
1) Windows Settings / Time & Language / Region / Additional time, date and regional settings
or Control Panel / Clock and Region
2) Region / change date, time, or number formats / Administrative / Change system locale... / Region Settings
3) Case : 'Beta: Uilisez Unicode UTF-8 pour le support des langues du monde'

SUPPORT
Fournissez un package de dépannage avec :
- le log de débogage (peut être défini dans l'UI ou dans conf/conf.properties avec MIR_LOG_LEVEL=6)
- la sauvegarde des métadonnées si disponible (peut être configurée dans le paramètre Divers avec l'option -backup, même si cette option commune n'est pas implémentée pour tous les ponts pour des raisons techniques).

- Débogage de l'API COM Windows d'erwin :
Le pont d'import utilise l'API erwin Windows COM via des scripts simples (ErwinApi.js et ErwinXml.js).
Si ces scripts ne fonctionnent pas correctement, contactez le support erwin afin de régler le problème (une réinstallation d'erwin sera peut-être nécessaire).
Les scripts peuvent être testés comme suit :
cscript.exe //E:jscript //Nologo .\conf\MIRModelBridgeTemplate\ERwin\ERwinApi.js -version 9 -GetVersion
cscript.exe //E:jscript //Nologo .\conf\MIRModelBridgeTemplate\ERwin\ERwinXml.js -version 9 -from eMovies.erwin -to eMovies.xml -log eMoviesLog.txt

Paramètres du pont

Mapping du pont