第10章 従来の仮想データベースファイルの DDL 形式への移行
データ仮想化テクノロジープレビューでは、SQL-MED DDL（データ定義言語）形式で仮想データベースの構造を定義する必要があります。一方、Wildfly や Red Hat JBoss Data Virtualization のオファリングなど、レガシーの Teiid 仮想データベースの構造は、.xml または .vdb 形式のファイルを使用して定義します。
レガシーデプロイメント用に開発した仮想データベースの設計を再利用できますが、まずファイルの形式を更新する必要があります。ファイルの変換には、移行ツールを使用できます。ファイルを変換した後、仮想データベースをコンテナーイメージとして再ビルドし、OpenShift にデプロイできます。
移行に関する考慮事項
以下の機能は、JBoss Data Virtualization および Teiid の仮想データベースでサポートされている機能は、このテクノロジープレビューのデータ仮想化リリースで制限または利用できない可能性があります。
- データソースの互換性
- 本リリースでは、すべてのデータソースを使用することはできません。互換性のあるデータソースの一覧は、「互換性のあるデータソース」 を参照してください。
- 内部分散マテリアル
- 利用できません。
- ResultSet キャッシュ
- 利用できません。
- ランタイムメタデータを使用した他の仮想データベースのインポート
- DDL を使用して仮想データベースのメタデータを指定する必要があります。
- マルチソース vdb ソースのランタイム操作
- 利用できません。
移行ユーティリティーは、次の 2 つの方法で使用できます。
- VDB ファイルのみを検証する手順
- この方法を使用して、ユーティリティーが VDB ファイルを正常に変換できるかどうかを確認します。このユーティリティーは VDB ファイルを変換し、検証エラーをターミナルに報告します。検証エラーがない場合は、ユーティリティーは結果の DDL を表示しますが、変換された DDL はファイルに保存されません。
- VDB ファイルおよび VDB ファイルを検証し、DDL ファイルに保存するには、以下を行います。
- このファイルは、検証エラーがない場合にのみ保存されます。
移行ツールは XML ファイルでのみ機能します。.vdb ファイル拡張子を持つファイルは、複数のフォルダーが含まれるファイルアーカイブです。.vdb 形式のレガシーファイルがある場合は、Teiid Designer を使用してファイルを XML 形式にエクスポートしてから、移行ツールを実行して、作成された XML ファイルを変換します。
前提条件
-
.xml形式のレガシーの仮想データベースファイルがある。 -
Teiid OpenShift リポジトリーから
settings.xmlファイル をダウンロードします。Maven はファイルの情報を使用して移行ツールを実行します。
10.1. レガシー仮想データベースの XML ファイルを検証し、DDL 形式で表示
レガシー仮想データベースでテスト変換を実行して検証エラーを確認し、生成される DDL ファイルを表示できます。このように移行ツールを実行すると、変換された DDL ファイルは保存されません。
手順
Teiid OpenShift リポジトリーからダウンロードした
settings.xmlファイルが含まれるディレクトリーを開き、以下のコマンドを入力します。$ mvn -s settings.xml exec:java -Dvdb=<path_to_vdb_xml_file>
以下に例を示します。
$ mvn -s settings.xml exec:java -Dvdb=rdbms-example/src/main/resources/vdb.xml
移行ツールは指定の
.xmlファイルを確認し、検証エラーを報告します。検証エラーがない場合、移行ツールには画面に仮想データベースの.ddlバージョンが表示されます。
