ヘッダーをスキップ

Oracle® Fusion Middleware Oracle Warehouse BuilderからOracle Data Integratorへの移行 12c (12.1.3.0.1) E59398-02 |
| 目次

前 | 次 |

# 2 移行の準備

この章では移行の要件をリスト表示し、移行に使用する構成ファイルの作成方法を説明します。

内容は次のとおりです。

- 移行の要件

- 移行ユーティリティ構成ファイルの作成

## 移行の要件

移行はLinuxおよびWindows (64-bit x86)システムでのみサポートされています。移行前に、次の要件を満たしていることを確認してください。

- OWB 11.2.0.3または11.2.0.4がインストールされていること(さらに、移行パッチが適用されていること。注意: 環境に適用する最新の移行パッチを取得するには、Oracleサポートに問い合せてください。)

- ODI 12.1.2.0.1バンドル・パッチ(パッチ番号17836908)が適用されたODI 12.1.2、またはODI 12.1.3があること

- OWBワークスペースがあること

- ODIリポジトリがあること(移行モードがFAST_CHECKの場合、この前提条件は省略可能です。)

- `ODI_HOME`および`JAVA_HOME`環境変数が設定されていること。`ODI_HOME`変数は、`/home/oracle/Middleware`などODIインストール・ディレクトリに設定する必要があります。`JAVA_HOME`変数は、`/java/jdk1.7.0_25/`などJDKインストール・ディレクトリに設定する必要があります。OWBのスタンドアロン・バージョンを使用している場合、`JAVA_HOME`環境を設定する必要はありません。

- 移行ユーティリティ構成ファイルが作成されていること

また、次の情報があるか確認してください。

- ODIマスター・リポジトリ・パスワード(移行モードがFAST_CHECKの場合、この前提条件は省略可能です。)

- ODIユーザー・パスワード(移行モードがFAST_CHECKの場合、この前提条件は省略可能です。)

- OWBワークスペース所有者のパスワード

- 移行ユーティリティ構成ファイルのフルパスおよびファイル名

注意: 必要なパッチはMy Oracle Support (`https://support.oracle.com`)からダウンロードします。パッチのREADMEファイルの指示に従ってパッチを適用します。

## 64ビット以外のオペレーティング・システムで実行される移行ユーティリティ

OWBリポジトリがWindows 64ビットでもLinux 64ビットでもない環境に存在する場合は、OWBクライアントとODIクライアントの両方を同じマシンにインストールする必要があります。ODIホームを指すように`ODI_HOME`環境変数を設定します。`migration.config`ファイルですべてのパラメータが正しく設定され、リポジトリの正しい場所を指している必要があります。

リモート・リポジトリに対して実行される移行ユーティリティ

次の図に示すようにリポジトリがリモートにある場合、3つの異なるシナリオが考えられます。

最初の場合は、リポジトリを同じサーバーおよび同じデータベース上に配置できます。

2つ目の場合は、リポジトリを同じサーバーの異なるデータベース上に配置できます。

3つ目の場合は、リポジトリを異なるサーバー上に配置できます。

## 移行ユーティリティ構成ファイルの作成

移行前に、移行の実行に使用する構成ファイルをまず作成する必要があります。構成ファイルはテキストベースのプロパティ・ファイルで、接続情報とその他の詳細が含まれています。

内容は次のとおりです。

- 移行ユーティリティ構成ファイルの作成方法

- 構成ファイルのパラメータ

- 構成ファイルの例

### 移行ユーティリティ構成ファイルの作成方法

移行ユーティリティ構成ファイルがより簡単に作成できるように、テンプレート・ファイルが提供されています。手始めにこのテンプレートを使用して、特定の環境および必要性にあわせて設定を編集します。

テンプレート・ファイルの名前は`migration.config`で、OWB_HOME`/bin/admin`ディレクトリにあります。OWB_HOMEはOWBのインストール・ディレクトリです。

移行ユーティリティ構成ファイルの作成方法は、次のとおりです。

1. テキスト・エディタで`migration.config`ファイルを開きます。

2. 特定の環境および必要性にあわせて設定を編集します。各パラメータの詳細は、「構成ファイルのパラメータ」を参照してください。

3. ファイルを保存します。ファイルには好きな名前を付けることができ、好みの場所に保存できます。

   ファイル名とファイル・パスをメモします。この情報は移行ユーティリティを実行する際に必要です。

### 構成ファイルのパラメータ

表2-1に、移行ユーティリティ構成ファイルのパラメータをリストします。

表2-1 移行ユーティリティ構成ファイルのパラメータ

パラメータ | Mandatory | 説明
--- | --- | ---
`ODI_MASTER_USER=<user_name>` | はい | ODIマスター・リポジトリ接続用のユーザー名。
`ODI_MASTER_URL=<JDBC_URL>` | はい | ODIマスター・リポジトリへの接続に使用するJDBC URL。このURLは、次のいずれかの文字を含む場合、引用符を付ける必要があります。 セミコロン(;) バックスラッシュ(\) 二重引用符(") 逆引用符(`) ドル記号($) 小なり記号(<) 大なり記号(>) デフォルト値は`jdbc:oracle:thin:@localhost:1521:mydb`です。
`ODI_MASTER_DRIVER=<JDBC_driver_name>` | はい | ODIマスター・リポジトリへの接続に使用するJDBCドライバ。 デフォルト値は`oracle.jdbc.OracleDriver`です。
`ODI_USERNAME=<user_name>` | はい | ODIのスーパーバイザ・ユーザー名。 デフォルト値は`SUPERVISOR`です。
`ODI_WORK_REPOSITORY_NAME=<user_name>` | はい | ODI作業リポジトリへの接続に使用するユーザー名。 デフォルト値は`WORKREP1`です。
`OWB_WORKSPACE_OWNER=<workspace_owner>` | はい | OWBワークスペース所有者。
`OWB_URL=<URL>` | はい | OWBワークスペースへの接続に使用するURL。 デフォルト値は`localhost:1521:mydb`です。
`OWB_WORKSPACE_NAME=<workspace_name>` | はい | 接続先のOWBワークスペースの名前。次の形式の1つを使用して指定します。 ワークスペース所有者とワークスペースの名前をピリオドで区切った名前。たとえば、`REP_1.WS1`または`rep_1.ws1`など。 ワークスペースの名前のみ。たとえば、`WS1`または`ws1`など。 移行ユーティリティを使用して一度に移行できるワークスペースは1つです。このパラメータ(および必要に応じて他のパラメータ)を編集して、移行する各ワークスペースに対して移行ユーティリティを実行します。 ワークスペース所有者が所有するワークスペースが1つのみの場合は、このパラメータを指定する必要はありません。 ワークスペース所有者が複数のワークスペースを所有しており、このパラメータに値が指定されていない場合は、エラーが返されます。ワークスペースにワークスペース所有者と同じ名前がある場合は、ワークスペースが移行されます。 指定したワークスペースが存在しない場合、接続に失敗します。
`MIGRATION_LOG_FILE=<path_to_log_file>` | いいえ | 移行ユーティリティ・ログ・ファイルへのフルパスで、移行ユーティリティの実行時に生成されます。 ログ・ファイルと同じ接頭辞に`.report`拡張子が付いた移行ユーティリティ除外レポートも生成されます。 このパラメータは、ログ・ファイルとレポート・ファイルの両方の名前と場所を指定するために使用します。パスを指定しない場合は、ログ・ファイルとレポート・ファイルが同じディレクトリに生成され、そこから移行ユーティリティが実行されます。たとえば、OWB_HOME`/owb/bin/unix`などです。デフォルトでは、ファイル名は`migration.log`および`migration.report`です。 これらのファイルの詳細は、「ログ・ファイルおよびレポート・ファイルの確認」を参照してください。
`MIGRATION_REPORT_INCLUDE=<PASSED|FAILED|ALL>` | いいえ | 移行ユーティリティ除外レポートに含まれるコンテンツ。次のオプションがあります。 `PASSED`: 成功したオブジェクトのみを含めます。 `FAILED`: 失敗したオブジェクトのみを含めます。 `ALL`: すべてのオブジェクトを含めます。 デフォルト値は`ALL`です。
`MIGRATION_MODE=<FAST_CHECK|DRY_RUN|RUN>` | いいえ | 移行モード。次のオプションがあります。 `FAST_CHECK`: 移行ユーティリティで選択したオブジェクトのクイック・チェックが実行され、ターゲットのODIリポジトリに移行可能なオブジェクトおよび移行できないオブジェクトのリストが提供されます。このモードを使用すると、移行できるオブジェクトとできないオブジェクトを迅速に判別できます。このモードは、ODI環境をインストールおよび設定しなくても使用できます。 `DRY_RUN`: 移行ユーティリティにより、指定したオブジェクトをターゲットのODIリポジトリに作成可能かどうかがチェックされ、オブジェクトをリポジトリにコミットせずに移行が実行されます。このモードは、ODI環境をインストールおよび設定しなくても使用できます。ただし、ODI関連のパラメータによってmigration.sh/migration.bat(ODI_MASTER_USER,ODI_USERNAME,ODI_MASTER_PASSWORD,ODI_USER_PASSWORD)が起動される場合は、必ずしてもそうとは言えません。 `RUN`: 移行ユーティリティで移行が実行され、移行されたオブジェクトがターゲットのODIリポジトリにコミットされます。このモードを使用すると、OWBからODIへの移行を実行できます。 デフォルト値は`RUN`です。 テスト移行を実行するための`FAST_CHECK`モードおよび`DRY_RUN`モードの使用に関する詳細は、「テスト移行の実行」を参照してください。
`MIGRATION_STRATEGY` | いいえ | ODIリポジトリに同じ名前のオブジェクトがすでに存在する場合にオブジェクトを移行するかどうかを示します。このパラメータには、2つのオプション(`CREATE`および`NODUP`)があります。デフォルト値は`CREATE`です。 `CREATE`に設定すると、ODIで常に新しいオブジェクトが作成されます。同じ名前のオブジェクトがすでにリポジトリに存在する場合、名前の最後に`_#` ("#"は数字)が付く新しいオブジェクトが作成されます。 `NODUP`に設定すると、ODIリポジトリに存在するその名前のオブジェクトが照合され、存在する場合、そのオブジェクトは移行されず、ODIリポジトリ内の既存のオブジェクトが使用されます。
`MIGRATE_DEPENDENCIES=<TRUE|FALSE>` | いいえ | 依存オブジェクトを移行対象として選択したオブジェクトとともに移行するかどうかを制御します。 デフォルト値は`FALSE`です(依存オブジェクトは移行されません)。 再帰的依存性は、`MIGRATE_DEPENDENCIES`を`TRUE`に設定した場合にサポートされます。例: マッピング`MAP_1`には表`T_1`にバインドされたマップ演算子があり、表`T_1`には表`T_2`との間にFK (外部キー)関係があります。`T_1`と`T_2`の両方は依存関係であるとみなされ、マッピング`MAP_1`とともに移行されます。
`STOP_ON_ERROR=<TRUE|FALSE>` | いいえ | エラーの発生時に移行プロセスを続行するか、停止するかを示します。 `TRUE`に設定すると、移行プロセスを停止し、オブジェクトは移行されません。`FALSE`に設定すると、エラーが発生しても移行プロセスを続行し、成功したオブジェクトは移行されます。 デフォルト値は`FALSE`です。
`SPLIT_JOIN_FOR_ANSI_SYNTAX=<TRUE|FALSE>` | いいえ | OWBマッピングのプロパティ`Use ANSI Syntax`を`TRUE`に設定した場合に、結合演算子をバイナリ結合に分割するかどうかを示します。 デフォルト値は`TRUE`です(結合演算子は分割されます)。
`MIGRATE_UNBOUND_OPERATOR=<TRUE|FALSE>` | いいえ | バインドされていない演算子(コード・テンプレート・マッピングを除く)を含むマッピングを移行するかどうかを決定します。バインドされていない演算子には、外部表、表、ビュー、マテリアライズド・ビュー、参照およびプラガブル・マッピングが含まれます。 `TRUE`に設定すると、バインドされていない演算子を含むマッピングが移行されます。バインドされていないエンティティ演算子の場合(外部表、表、ビュー、マテリアライズド・ビューおよび参照)、バインドされていない演算子に対応するODIデータストアが、OWBマッピングのあるOWBモジュールから移行されたODIモデルに作成されます。バインドされていない演算子は、新たに作成されたODIデータストアにバインドされているODIマッピング・コンポーネントに移行されます。 バインドされていないプラガブル・マッピング演算子の場合は、ODI再使用可能マッピングが`STAND_ALONE`という名前のODIフォルダに作成されます。バインドされていないプラガブル・マッピング演算子は、新たに作成された再使用可能マッピングにバインドされたODI再使用可能マッピング・コンポーネントに移行されます。 デフォルト値は`FALSE`で、バインドされていない演算子を含むマッピングはすべて移行されないことを意味します。
`MIGRATION_OBJECTS=<objects>` | いいえ | 移行するOWBオブジェクトを指定します。 デフォルト値はワイルド・カード・アスタリスク(`*`)で、指定されたOWBワークスペースのすべてのプロジェクトが移行されることを意味します。 特定のオブジェクトの移行に関する詳細は、「OWBワークスペースの特定のオブジェクトの移行」を参照してください。
`FLUSH_BATCH_SIZE=<number_of_mappings>` | いいえ | 一度に処理または移行されるマッピングの数を示します。 OWBワークスペースにあるマッピングの数が非常に多い場合に、このパラメータを使用してメモリー不足の問題が発生しないようにします。 デフォルト値は`50`です。メモリー不足の問題が発生する場合は、この値を小さくしてください。

### 構成ファイルの例

サンプルの移行ユーティリティ構成ファイルの値の例を次に示します。

2-1 移行ユーティリティ構成ファイルのサンプル

    ODI_MASTER_USER=ODIREP
    ODI_MASTER_URL=jdbc:oracle:thin:@localhost:1521:machine
    ODI_MASTER_DRIVER=oracle.jdbc.OracleDriver
    ODI_USERNAME=SUPERVISOR
    ODI_WORK_REPOSITORY_NAME=WORK0
    OWB_WORKSPACE_OWNER=rep_0
    OWB_URL=localhost:1521:machine.oracle.com
    OWB_WORKSPACE_NAME=REP_0_WS_0
    MIGRATION_LOG_FILE=/tmp/migration.log
    MIGRATION_REPORT_INCLUDE=ALL
    MIGRATION_MODE=RUN
    MIGRATION_STRATEGY=CREATE
    MIGRATE_DEPENDENCIES=TRUE
    STOP_ON_ERROR=FALSE
    SPLIT_JOIN_FOR_ANSI_SYNTAX=TRUE
    MIGRATE_UNBOUND_OPERATOR=TRUE
    MIGRATION_OBJECTS=PROJECT.MY_PROJECT
    FLUSH_BATCH_SIZE=50