erwin 9.x〜12.x Data Modeler (ファイル) - インポート

ブリッジの仕様

ベンダー	erwin, Inc.
ツール名	erwin Data Modeler
ツールバージョン	9.x〜14.x
ツールのWebサイト	https://erwin.com/products/erwin-data-modeler/
サポートされている方法論	[データモデリング] データストア(物理データモデル、論理データモデル、ストアドプロシージャー式解析、Native (.erwin)またはExport (.XML)ファイルでのCOM API経由のグラフィカルレイアウト
データプロファイリング
増分収集
マルチモデル収集
モデル選択のためのリモートリポジトリーの参照

仕様
ツール: Native (.erwin)ファイルまたはExport (.XML)ファイルでのCOM API経由のerwin, Inc. / erwin Data Modelerバージョン9.x〜14.x
https://erwin.com/products/erwin-data-modeler/をご覧ください。
メタデータ: [データモデリング] データストア(物理データモデル、論理データモデル、ストアドプロシージャー式解析)、グラフィカルレイアウト
コンポーネント: CaErwin9Xmlバージョン11.2.0

概要
このインポートブリッジは、erwin Data Modelerからデータモデル(エンティティを持つ論理限定モデル、属性、ドメイン、テーブルを持つ物理限定モデル、カラム、データ型、両方を持つ論理/物理モデルなど)をインポートします。このインポートブリッジは、すべてのリレーションシップとその実装(PK/FKなど)とデータモデルのグラフィカルレイアウト(図)もインポートします。
このインポートブリッジでは、erwin Data Modelerを使用して保存された.erwin形式のファイルまたは.xml形式のファイルのいずれかをインポートできます。
- erwinネイティブ形式(.erwin):
このインポートブリッジでは、.ERWIN形式のファイルを解析するためにerwin Data Modeler COM/OLE APIをインストールする必要があります。
erwin Data Modelerは、このインポートブリッジを実行するマシンに有効なライセンスで適切にインストールする必要があります。
これをテストするためには、Data Modelerでerwinモデルを開き、[XML Repository Format]として保存します。
- erwin XMLファイル形式(.xml):
ファイルの.xmlバージョンを作成し(erwinで[名前を付けて保存...])、erwinが作成するXMLファイルのタイプとして[XML Repository]形式を選択できます。
次のステップに従ってこのタイプの.XMLファイルを作成します。
1. erwinで.erwinファイルを開きます。
2. [ファイル] > [名前を付けて保存...]を選択します。
3. [タイプを指定して保存]プルダウンで[XMLリポジトリー(*.xml)]を選択します。
4. エクスポートされたファイルのパスと名前を指定します。
5. [OK]をクリックします。

要件
警告: このブリッジはWindowsベースのツールクライアントやSDKのCOM APIを使用します。このCOM APIは、(a) 正しくインストールされていること、(b) このツールを実行できるWindowsユーザーに代わってライセンスされていること、(c) ツールサーバーコンテンツにアクセスできることが必要です。追加事項:
(1) ツールベンダーによって推奨されているように、COM APIの場合も含めてリソース競合の恐れがあるため、ツールクライアント(およびブリッジ)がインストールまたは実行されているマシンにツールサーバーをインストールしたり共存させてはなりません。
(2) Windows COM APIベースのツールは度重なる失敗やシステムリソースの不足が発生すると不安定になるため、Windowsを再起動してツールのCOM APIを再び正しく動作させる必要があります。
(3) このブリッジがアプリケーションとして実行されている場合は、上記のWindowsユーザーと同じユーザーでログインする必要があります。
ブリッジがWindowsのサービスとして動作している場合は、WindowsのサービスマネージャーでMIMB Application Serverサービスを右クリックし、ログオンタブに移動して、サービスを実行するアカウントを名前で定義します。

- erwinユーザー:
インポートブリッジは、erwinソフトウェアを実行できるWindowsユーザーに代わって実行する必要があります。
インポートブリッジがWindowsデスクトップアプリケーションの一部として実行されている場合は、そのユーザーでWindowsにログオンする必要があります。
インポートブリッジがWindowsサービスの一部として実行されている場合は、そのWindowsサービスに移動してサービスの[プロパティ]メニューをクリックし、[ログオン]タブに移動して[このアカウント]を選択し、erwinからMartへの接続性をテストする時にWindowsセッションとして使用するパスワードと同じユーザー名を指定した後、Windowsサービスを再起動します。

よくある質問
Q: インポートブリッジはどのようにして属性の順序をインポートするのですか?
A: インポートブリッジのインポートは、情報がXMLファイルに存在する場合は物理順が優先され、それ以外の場合は論理順が使われます。
erwinで物理カラムの順序を表示させるためには:
- モデルの物理ビューに切り替えます。
- [図]メニューで[図]を選択します。
- [テーブル物理]タブをクリックします。
[物理表示レベル]プルダウンから[物理順]を選択します。
これはSQL DDLを生成する際にerwinが使う順序であり、ファイル内で利用可能であればMIMBはこの順序をインポートします。
論理順をインポートする場合は、論理限定モデルをerwinで派生させてインポートしてください。

制限事項
現在判明している一般的な制限事項は、https://metaintegration.com/Products/MIMB/Help/#!Documents/mimbknownlimitations.htmlをご覧ください。

- erwin Data Modeler 2021 NoSQLモデリングはサポートされていません:
新しいerwin Data Modeler 2021では、リレーショナルデータベースのモデリングに加えて、JSONなどのファイルやMongoDBなどのデータベースのNoSQL/階層型モデリングについてもサポートが追加されています。
残念ながらこのNoSQLのモデリングはスキーマレベルではなくインスタンスレベルで行われており、他の多くのDM/MM/DI/BIツールモデルのNoSQLと互換性がないため、サポートされていません。
たとえばerwinは、可能性があるすべての統一ストラクチャーを作るため、さまざまなインスタンスで可能なフィールドをすべて因数分解する代わりにjsonファイルの配列の中にインスタンスの数だけカラムを作成します。

- Warning On Potential Missing Physical Names:
この問題は、erwinからETLまたはBI(ビジネスインテリジェンス)ツール、またはOMG CWM XMI標準に変換する場合に特に関係があります。論理モデルと物理モデルを保存する時は、テーブル、カラム、キーの物理名が必ずしもXMLファイルに保存されるとは限りません。erwinを使って論理名からの物理名の自動生成を管理する時は、生成ルールのみが保存されます。これは、既存のデータベースの再構築に使われることが多い物理限定のerwinモデルでは問題ありません。
この問題の主な回避策は、.XMLファイルの保存時に[AllFusionリポジトリーフォーマット]ラジオボタンを選択することです(上記を参照)。生成されたXMLファイルを通常どおりerwinインポートブリッジにインポートするだけで結構です。
別の解決策としては、物理名がすべて明示的に設定されていることを確認し、論理名からの生成ルールに依存しないようにすることがあります。
または、既存の論理モデルと物理モデルから(XMLとして保存される)新しい物理モデルを派生することもできます。[ツール]メニューから[新規モデルを派生...]を選択し、[新規モデルタイプ]を[物理]として選択します。
ウィザードの次のステップでは、全物理名を生成するための生成ルールがすべて呼び出されます。
その後、新しい物理モデルをXMLとして保存できるようになります。 この新しいXMLファイルではテーブルの論理名も利用可能ですが、残念ながら属性の論理名はまだ見つからないかもしれません。
このインポートブリッジはerwinの正しいXML生成機能を使って.ERWINファイルを自動的に解析するため、物理名の欠落の問題は発生しません。

- ディメンションモデリングのロールが設定されていないことの警告:
この問題は、erwinがBIツールやOMG CWM XMI標準へのディメンションモデリングで使われる時に特に関係があります。上で説明した物理名の問題については、ディメンションモデリングのロール(ファクト、ディメンション、アウトリガー)がerwinによって自動的に計算される場合はXMLファイルで使用できなくなることがあります。
解決策の1つとして、ディメンションモデリングのロールがすべて明示的に設定されていることを確認し([テーブルエディター]、[ディメンション]タブを使用)、使用に基づいたerwinによる動計算に依存しないようにすることがあります。

- ポップアップメッセージについての警告:
.erwinモデルをインポートする際に、erwinにこのインポートブリッジが対応できないポップアップウィンドウが表示される可能性があります。
その結果、インポートブリッジはインポート時にハングアップします。ベンダーは、次のようにレジストリーを変更してポップアップメッセージを回避することを推奨しています。
- レジストリーの編集は、このインポートブリッジを実行しているマシンでRegedit.exeを使って行います。
- 次のキーを検索します。
バージョン9.0～9.6の場合: HKEY_CURRENT_USER\Software\CA\ERwin Data Modeler\9.0\Messages
バージョン9.7の場合: HKEY_CURRENT_USER\Software\erwin\Data Modeler\9.7\Messages
- [メッセージステータス]の値に[GDM-46=1;]というデータを追加します。

- Unicode文字を含むファイル名をサポート:
erwinファイルの名前にUnicode文字(ロシア語のキリル文字や日本語の漢字など)が含まれていると、erwinが正しくファイルを開くことができないことがあります。
この制限を回避するためには、次のいずれかの方法を行います:
- そのような文字が含まれないようファイル名を変更する
- システムロケールをUTF-8に設定する
2番目のオプションでは、Windows 10のインサイダービルド17035かノミナルビルド17134 (2018年4月リリース)を所有し、次のメニューを使用する必要があります:
1) [Windowsの設定] / [時刻と言語] / [地域] / [日付、時刻、地域の追加設定]
または[コントロールパネル] / [日付と時刻]か[地域]
2) [地域] / (日付、時刻、数値の形式を変更) / [管理] / [システムロケールの変更...] / [地域設定]
3) チェックボックス: [ベータ: ワールドワイド言語サポートでUnicode UTF-8を使用]

サポート
トラブルシューティングパッケージを次の項目と共に提供してください。
- デバッグログ(UIまたはconf/conf.propertiesでMIR_LOG_LEVEL=6を使って設定可能)
- 利用できる場合はメタデータバックアップ(技術的理由によりこの共通オプションが実装されていないブリッジがあるものの、Miscellaneousパラメーターで-backupオプションを使って設定可能)

-erwin Windows COM APIデバッギング:
インポートブリッジは、シンプルなスクリプト(ErwinApi.jsとErwinXml.js)経由でErwin Windows COM APIを使用します。
これらのスクリプトが正しく動作しない場合は、Erwinサポートに連絡して問題をデバッグしてください(erwinの再インストールが必要になることがあります)。
スクリプトは次のようにテストできます。
cscript.exe //E:jscript //Nologo .\conf\MIRModelBridgeTemplate\ERwin\ERwinApi.js -バージョン 9 -Getバージョン
cscript.exe //E:jscript //Nologo .\conf\MIRModelBridgeTemplate\ERwin\ERwinXml.js -バージョン 9 -from eMovies.erwin -to eMovies.xml -log eMoviesLog.txt

ブリッジパラメーター

ブリッジのマッピング