Oracle® Fusion Middleware

Oracle Data Integratorの管理

12c (12.1.3.0.1)

E59403-02(原本部品番号:E51086-02)

2015年3月

このガイドでは、Oracle Data Integratorでの構成タスクの実行方法およびセキュリティの定義方法について説明します。

Oracle Fusion Middleware Oracle Data Integratorの管理, 12c (12.1.3.0.1)

E59403-02

Copyright © 2010, 2015, Oracle and/or its affiliates.All rights reserved.

原本著者: Laura Hofman Miquel、Joshua Stanley、Pratima Chennupati

原本協力著者: Alex Kotopoulis

原本協力者: David Allan、Linda Bittarelli、Sophia Chen、Hiroyuki Chiku、Boobalan Chinnasamy、Victor Chow、Sowmya Dhandapani、Daniel Gallagher、Ayush Ganeriwal、Kevin Hwang、Archana Jagadish、Aslam Khan、Sebu T。Koleth、Ale Paez、Veenavani Revanuru、Nisha Sahadevan、Julien Testut、Sachin Thatte、Jose Thomas、Gary Tripp、Vikas Varma、Robert Velisar、Winnie Wan、Geoff Watters、Jennifer Waywell

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアはさまざまな情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

例一覧

図一覧

表一覧

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

Oracle Data Integratorの新機能

- リリース12c (12.1.3.0.1)での新機能と変更点

- リリース12c (12.1.3)での新機能と変更点

- リリース12c (12.1.2)での新機能と変更点

1 Oracle Data Integratorの概要

- 1.1 Oracle Data Integratorとは

- 1.2 Oracle Data Integratorのコンポーネント

- 1.3 Oracle Data Integratorを構成および管理するための基本タスク

第I部 Oracle Data Integratorアーキテクチャの管理

2 リポジトリの管理

- 2.1 Oracle Data Integratorリポジトリの概要

- 2.2 リポジトリの記憶領域の作成

- 2.3 マスター・リポジトリの作成

- 2.4 マスター・リポジトリへの接続

- 2.5 作業リポジトリの作成

- 2.6 作業リポジトリへの接続

- 2.7 作業リポジトリのパスワードの変更

- 2.8 リポジトリ管理用の拡張アクション

- 2.8.1 作業リポジトリの連結および連結解除(削除)

- 2.8.2 作業リポジトリの消去

- 2.8.3 リポジトリ接続の構成

3 トポロジの設定

- 3.1 トポロジの設定

- 3.1.1 コンテキストの作成

- 3.1.2 データ・サーバーの作成

- 3.1.2.1 前提条件およびガイドライン

- 3.1.2.2 データ・サーバーの作成

- 3.1.2.3 データ・サーバーの作成(詳細設定)

- 3.1.2.4 データ・サーバー接続のテスト

- 3.1.3 物理スキーマの作成

- 3.1.4 論理スキーマの作成

- 3.1.5 物理エージェントの作成

- 3.1.6 論理エージェントの作成

- 3.2 ビッグ・データの使用

- 3.3 エージェントの管理

- 3.3.1 スタンドアロン・エージェント

- 3.3.1.1 スタンドアロン・エージェントの構成

- 3.3.1.2 スタンドアロン・エージェントの開始

- 3.3.1.3 エージェントの停止

- 3.3.2 スタンドアロン・コロケート・エージェント

- 3.3.2.1 スタンドアロン・コロケート・エージェントの構成

- 3.3.2.2 スタンドアロン・コロケート・エージェントの起動

- 3.3.2.3 エージェントの停止

- 3.3.3 Java EEエージェント

- 3.3.3.1 Java EEアプリケーション・サーバーでのエージェントのデプロイ

- 3.3.3.2 Java EEエージェント用のサーバー・テンプレートの作成

- 3.3.3.3 エージェントのアプリケーション・サーバーにおけるOracle Data Integratorからのデータソースのデプロイ

- 3.3.4 エージェントのロード・バランシング

- 3.3.4.1 セッションの委任

- 3.3.4.2 エージェント使用不可

- 3.3.4.3 ロード・バランシングの設定

- 3.4 高可用性トポロジの設定手順

- 3.4.1 エージェントの再構成

第II部 データ・サービスの作成および使用

4 データ・サービスの設定

- 4.1 データ・サービスの設定

- 4.1.1 Webサービス・コンテナの構成

- 4.1.2 データ・ソースの設定

- 4.1.3 モデルの構成

5 データ・サービスの生成およびデプロイ

- 5.1 データ・サービスの生成およびデプロイ

- 5.2 生成サービスの概要

- 5.3 データ・サービスのテスト

第III部 統合プロセスの実行およびモニタリング

6 統合プロセスの実行

- 6.1 ODI実行の理解

- 6.2 マッピング、プロシージャ、パッケージおよびモデル操作の実行

- 6.3 シナリオの実行

- 6.3.1 ODI Studioからのシナリオの実行

- 6.3.2 コマンド行からのシナリオの実行

- 6.4 セッションの再開

- 6.4.1 ODI Studioからのセッションの再開

- 6.4.2 コマンド行からのセッションの再開

- 6.5 セッションの停止

- 6.5.1 ODI Studioからのセッションの停止

- 6.5.2 コマンド行からのセッションの停止

- 6.6 ロード計画の実行

- 6.6.1 ODI Studioからのロード計画の実行

- 6.6.2 コマンド行からのロード計画の実行

- 6.7 ロード計画実行の再開

- 6.7.1 ODI Studioからのロード計画の再開

- 6.7.2 コマンド行からのロード計画の再開

- 6.8 ロード計画実行の停止

- 6.8.1 ODI Studioからのロード計画の停止

- 6.8.2 コマンド行からのロード計画実行の停止

- 6.9 シナリオとロード計画のスケジューリング

- 6.9.1 組込みスケジューラを使用したシナリオまたはロード計画のスケジューリング

- 6.9.1.1 シナリオまたはロード計画のスケジューリング

- 6.9.1.2 エージェントのスケジュールの更新

- 6.9.1.3 スケジュールの表示

- 6.9.2 外部スケジューラを使用したシナリオまたはロード計画のスケジューリング

- 6.10 実行のシミュレーション

- 6.11 Webサービスを使用した実行の管理

- 6.11.1 ランタイムWebサービスの概要

- 6.11.2 Webサービスを使用したシナリオの実行

- 6.11.3 Webサービスを使用したセッション・ステータスのモニタリング

- 6.11.4 Webサービスを使用したセッションの再開

- 6.11.5 Webサービスを使用したロード計画の実行

- 6.11.6 Webサービスを使用したロード計画実行の停止

- 6.11.7 Webサービスを使用したロード計画インスタンスの再開

- 6.11.8 Webサービスを使用したロード計画実行ステータスのモニタリング

- 6.11.9 コマンド行からのWebサービスへのアクセス

- 6.11.10 外部認証によるランタイムWebサービスの使用

- 6.11.11 WS-Addressingの使用

- 6.11.12 コールバックを使用する非同期Webサービスの使用

7 統合プロセスのデバッグ

- 7.1 セッションおよびブループリントについて

- 7.1.1 ブループリントのソース・コードおよびターゲット・コード

- 7.2 セッション・エディタでのデバッグの概要

- 7.2.1 アイコン

- 7.2.2 パッケージ、マッピングおよびプロシージャのデバッグの相違点

- 7.3 デバッグ・セッションの開始

- 7.3.1 実行中のデバッグ・セッションへの接続

- 7.3.1.1 組込みエージェントおよび外部エージェント

- 7.3.1.2 デバッグ・セッションのライフサイクル

- 7.3.2 デバッグ・セッションのオプション

- 7.3.2.1 最初のタスクの前に一時停止

- 7.3.2.2 現在のクライアントに関連付け

- 7.3.2.3 接続前の遅延

- 7.3.2.4 子孫セッションのデバッグ

- 7.3.2.5 エラー時にブレーク

- 7.4 セッション・エディタでのブループリントのステップ実行

- 7.4.1 ステップおよびタスク

- 7.5 デバッグ・カーソルの使用

- 7.5.1 デバッグ・アクション

- 7.5.1.1 ステップ・イン

- 7.5.1.2 一時停止

- 7.5.1.3 再開

- 7.5.1.4 タスク終了まで実行

- 7.5.1.5 次のタスクまで実行

- 7.5.1.6 ステップ終了まで実行

- 7.5.1.7 次のステップまで実行

- 7.5.2 複数のカーソル

- 7.5.2.1 特別な動作

- 7.5.3 ブレークポイントの使用

- 7.5.3.1 「デバッグ・ブレークポイント」ウィンドウについて

- 7.5.3.2 デザイン・ブレークポイントとランタイム・ブレークポイントについて

- 7.5.3.3 ブレークポイントの配置

- 7.5.3.4 ブレークポイントの編集

- 7.5.3.5 ブレークポイントの削除

- 7.5.3.6 ブレーク・ポイントの有効化および無効化

- 7.5.3.7 パス数

- 7.5.4 データのデバッグ

- 7.5.4.1 データの取得

- 7.5.4.2 SQLコードの実行

- 7.5.5 変数のデバッグ

- 7.5.5.1 変数の変更

- 7.5.6 スレッドのデバッグ

- 7.5.6.1 ソースへ移動

- 7.6 デバッグ・セッションの管理

- 7.6.1 標準停止および即時停止

- 7.6.2 実行の再開

8 統合プロセスのモニタリング

- 8.1 モニタリングの概要

- 8.1.1 オペレータ・ナビゲータの概要

- 8.1.2 シナリオ

- 8.1.3 セッション

- 8.1.4 ロード計画

- 8.1.5 ロード計画の実行

- 8.1.6 スケジュール

- 8.1.7 ログ

- 8.1.8 ステータス

- 8.1.9 タスク・タイプ

- 8.2 実行結果のモニタリング

- 8.2.1 セッションのモニタリング

- 8.2.2 ロード計画実行のモニタリング

- 8.2.3 失敗したセッションの処理

- 8.2.4 成功したセッションの確認

- 8.2.5 失敗したロード計画の処理

- 8.2.6 成功したロード計画の確認

- 8.3 実行の管理

- 8.3.1 セッションの管理

- 8.3.1.1 失効したセッションの除去

- 8.3.1.2 一時オブジェクトの削除

- 8.3.2 ロード計画実行の管理

- 8.3.3 ログの管理

- 8.3.3.1 セッションのフィルタ処理

- 8.3.3.2 ログのパージ

- 8.3.3.3 セッション・フォルダを使用したログの編成

- 8.3.3.4 ログ・データのエクスポートおよびインポート

- 8.3.3.5 ODIコンポーネントのランタイム・ロギング

- 8.3.4 シナリオとロード計画の管理

- 8.3.4.1 ロード計画とシナリオ・フォルダ

- 8.3.4.2 ロード計画、シナリオおよびソリューションの本番へのインポート

- 8.3.5 スケジュールの管理

9 Oracle Data Integratorコンソールの使用

- 9.1 Oracle Data Integratorコンソールの概要

- 9.1.1 Oracle Data Integratorコンソールの概念

- 9.1.2 Oracle Data Integratorコンソールのインタフェース

- 9.2 Oracle Data Integratorコンソールの使用

- 9.2.1 Oracle Data Integratorコンソールへの接続

- 9.2.2 一般的なユーザー操作

- 9.2.3 シナリオおよびセッションの管理

- 9.2.4 ロード計画の管理

- 9.2.5 ログのパージ

- 9.2.6 データ系統およびフロー・マップの使用

- 9.2.7 管理操作の実行

- 9.3 ODIドメイン

- 9.4 Oracle Enterprise Manager Fusion Middleware Control

- 9.4.1 ODIプラグインによるOracle Fusion Middleware Controlの構成

- 9.4.2 Oracle Data Integratorコンソールの構成

- 9.4.3 Oracle Data Integratorの管理

- 9.4.4 ODIスタンドアロン・エージェントの構成

- 9.4.5 マスター・リポジトリの構成

- 9.4.6 セッションの検索

- 9.4.7 ロード・プラン実行の検索

- 9.5 Management Pack for Oracle Data Integrator

第IV部 セキュリティ設定の管理

10 Oracle Data Integratorでのセキュリティの管理

- 10.1 Oracle Data Integratorのセキュリティの概要

- 10.1.1 オブジェクト、インスタンスおよびメソッド

- 10.1.2 プロファイル

- 10.1.3 ユーザー

- 10.1.4 ロール

- 10.2 ユーザー管理

- 10.2.1 セキュリティ・ポリシーの手法

- 10.2.2 プロファイルの管理

- 10.2.2.1 新規プロファイルの作成

- 10.2.2.2 プロファイルの複製

- 10.2.2.3 プロファイルの削除

- 10.2.3 ユーザーの管理

- 10.2.3.1 内部リポジトリへの新規ユーザーの作成

- 10.2.3.2 ユーザーへのプロファイルの割当て

- 10.2.3.3 ユーザーのプロファイルの削除

- 10.2.3.4 内部リポジトリのユーザーの削除

- 10.2.4 権限の管理

- 10.2.4.1 プロファイル・メソッドまたはユーザー・メソッドの付与

- 10.2.4.2 プロファイル・メソッドまたはユーザー・メソッドの取消し

- 10.2.4.3 オブジェクト・インスタンス別認可の付与

- 10.2.4.4 オブジェクト・インスタンス別認可の取消し

- 10.2.4.5 未使用認可のクリーン・アップ

- 10.3 Advanced Encryption Standard

- 10.4 パスワードで保護されたウォレットを使用したログイン資格証明の格納

- 10.4.1 パスワードで保護されたウォレットの作成

- 10.4.2 他のユーザーへのリポジトリ・アクセスの許可

- 10.4.3 ウォレット・パスワードの変更

- 10.4.4 ログイン資格証明の保存方法のカスタマイズ

- 10.5 外部パスワード記憶域の設定

- 10.5.1 パスワード記憶域の設定

- 10.5.2 パスワード記憶域の切替え

- 10.5.3 パスワード記憶域のリカバリ

- 10.6 認証モードの管理

- 10.6.1 マスター・リポジトリでの認証モードの設定

- 10.7 外部認証の構成

- 10.7.1 外部認証のためのOracle Data Integrator Studioの構成

- 10.7.1.1 OPSS構成ファイルの設定

- 10.7.1.2 LDAPブートストラップ・ユーザーのためのウォレット・ファイルの作成

- 10.7.1.3 マスター・リポジトリ作成時の外部認証の設定

- 10.7.2 既存のマスター・リポジトリから外部認証モードへの切替え

- 10.7.3 外部認証への切替え後のユーザーの再アクティブ化

- 10.7.4 外部認証用のスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントの構成

- 10.7.5 アイデンティティ・ストアに定義されたプリンシパルのOracle Data Integratorへのマッピング

- 10.7.5.1 エンタープライズ・ロール統合の仕組み

- 10.7.5.2 Oracle Data Integratorロールの定義および管理

- 10.7.5.3 ロール・エディタの使用

- 10.8 パスワード・ポリシーの実施

- 10.9 安全な転送を使用するためのスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントの構成

- 10.9.1 SSL証明書の作成

- 10.9.2 スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントのためのSSLの構成

- 10.9.3 SSL対応エージェントと接続するためのODI Studioの構成

- 10.9.4 SSL対応エージェントと通信するためのOracle Data Integratorクライアント・ツールの構成

- 10.9.5 パスワードのエンコード

- 10.9.6 SSL対応のスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントに対する弱い暗号スイートの無効化

- 10.10 Webプロキシ・サーバーによるOracle Data Integratorの構成

- 10.11 Oracle Access Manager 11gを使用したOracle Data IntegratorコンソールおよびEnterprise Managerのシングル・サインオン(SSO)の構成

- 10.12 Oracle Data Integratorのセキュリティのベスト・プラクティス

例の一覧

- 10-1 サービス・インスタンスの構成例

図一覧

- 3-1 サーバー・テンプレート生成ウィザード - 「エージェント情報」タブ

- 3-2 サーバー・テンプレート生成ウィザード - 「ライブラリおよびドライバ」タブ

- 3-3 サーバー・テンプレート生成ウィザード - 「データソース」タブ

- 3-4 サーバー・テンプレート生成ウィザード - 「テンプレート・ターゲットおよびサマリー」タブ

- 7-1 ステップ前のカーソル配置

- 9-1 Oracle Data Integratorコンソール

- 9-2 Oracle Enterprise Manager Fusion Middleware Control内のODIコンソール

- 10-1 「新規ウォレット・パスワード」ダイアログ・ボックス

- 10-2 「ウォレット・パスワードの変更」ダイアログ・ボックス

- 10-3 ログイン資格証明を保存するための「プリファレンス」ダイアログ・ボックス

- 10-4 「認証モードの切替え」ダイアログ・ボックスの「ログイン」画面

- 10-5 「認証モードの切替え」ウィザードの「資格証明」画面

- 10-6 「エンタープライズ・ロールおよびユーザー取得」ダイアログ・ボックス

- 10-7 外部認証モードへの切替えに成功した場合のメッセージ・ボックス

- 10-8 「USER管理者を開く」ダイアログ・ボックス

- 10-9 マスター・リポジトリ作成ウィザードの「認証」画面

- 10-10 「エンタープライズ・ロールおよびユーザー取得」ダイアログ・ボックス

- 10-11 ロール・エディタ

表一覧

- 1-1 Oracle Data Integratorを構成および管理する手順

- 3-1 ビッグ・データの使用

- 3-2 高可用性トポロジの設定手順

- 6-1 実行パラメータ

- 6-2 Startscenコマンドのパラメータ

- 6-3 restartsessコマンドのパラメータ

- 6-4 StopSessionコマンドのパラメータ

- 6-5 Startloadplanコマンドのパラメータ

- 6-6 Restartloadplanコマンドのパラメータ

- 6-7 Stoploadplanコマンドのパラメータ

- 6-8 スケジューリング詳細

- 6-9 Startscenremoteコマンドのパラメータ

- 6-10 GetSessionStatusRemoteコマンドのパラメータ

- 8-1 オペレータ・ナビゲータのツールバー・メニュー項目

- 8-2 ステータス値

- 8-3 タスク・タイプ

- 8-4 「一時オブジェクトの削除」ダイアログのパラメータ

- 8-5 ログのパージ・パラメータ

- 8-6 セッション・フォルダ・キーワードの照合

- 8-7 ログ・エクスポート・パラメータ

- 8-8 Javaのログ・レベルとOracle Javaデバッグ・レベルのマッピング

- 9-1 ログのパージ・パラメータ

- 10-1 組込みプロファイル

- 10-2 MBeanサーバー・パラメータ

- 10-3 Oracle Data Integrator環境におけるセキュリティのベスト・プラクティス

はじめに

このガイドでは、Oracle Data Integrator (ODI)で構成タスクおよびユーザー管理タスクを実行する方法について説明します。これには、ODIコンポーネントの構成、基本的な管理タスクの実行、統合プロセスの実行とモニタリング、およびODIでのセキュリティの管理が含まれます。

「はじめに」の内容は次のとおりです。

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

対象読者

このドキュメントは、Oracle Data Integratorで継続的な構成タスクを実行する管理者を対象としています。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートをご購入のOracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info) か、聴覚に障害のあるお客様は (http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。

関連ドキュメント

詳細は、Oracle Data Integratorライブラリの次のドキュメントを参照してください。

- Oracle Data Integratorリリース・ノート

- Oracle Data Integratorの理解

- Oracle Data Integratorでの統合プロジェクトの開発

- Oracle Data Integratorのインストールと構成

- Oracle Data Integratorのアップグレード

- Oracle Data Integratorとのビッグ・データの統合

- Oracle Data Integratorアプリケーション・アダプタ・ガイド

- Oracle Data Integratorでのナレッジ・モジュールの開発

- Oracle Data Integrator接続およびナレッジ・モジュール・ガイド

- Oracle Warehouse BuilderからOracle Data Integratorへの移行

- Oracle Data Integratorツール・リファレンス

- Oracle Data Integratorデータ・サービスJava APIリファレンス

- Oracle Data Integratorオープン・ツールJava APIリファレンス

- Oracle Data IntegratorのためのSAP ABAP BWアダプタ・スタート・ガイド

- Oracle Data Integrator Java APIリファレンス

- Oracle Data IntegratorのためのSAP ABAP ERPアダプタ・スタート・ガイド

- Oracle Data Integrator 12cオンライン・ヘルプ([F1]を押すか、「ヘルプ」を選択してから、「検索」または「目次」を選択してメイン・メニューからJDeveloperヘルプ・センターを開いて、ODI Studioで入手可能)

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

Oracle Data Integratorの新機能

この項では、Oracle Fusion Middleware 12cリリースにおけるOracle Data Integrator (ODI)の新機能および製品の重要な変更点の概要を示します。

この章では、次の項目について説明します。

- リリース12c (12.1.3.0.1)の新機能と変更された機能

- リリース12c (12.1.3)での新機能と変更点

- リリース12c (12.1.2)での新機能と変更点

リリース12c (12.1.3.0.1)の新機能と変更された機能

Oracle Data Integrator 12c (12.1.3.0.1)では、次の機能が強化されています。

- SparkおよびPigを使用したODIマッピングの実行

- Oozieを使用したODIジョブの編成

- 拡張Hiveドライバおよびナレッジ・モジュール

- Hadoop監査ログの取得

- ODIファイル・ツールでのHDFSアクセス

- フラット・コンポーネントおよび不規則コンポーネント

- ODIドキュメント・セットに追加された新規ビッグ・データ・ガイド

SparkおよびPigを使用したODIマッピングの実行

ODIを使用すると、実装言語から独立した論理設計を介してマッピングを定義できます。Hadoopベースの変換の場合、生成される変換言語としてHive、SparkおよびPigから選択できます。これにより、環境やユースケースに基づいて最適な実装を選択できるようになります。また、複数の物理設計を使用して様々な実装を同時に選択することもできます。この選択により、ビッグ・データを柔軟で将来性のある方法で開発できるようになります。

- Pig Latin変換の生成: ODIマッピング用の変換言語および実行エンジンとしてPig Latinを選択できます。Apache Pigは、Hadoopで大規模なデータ・セットを分析するためのプラットフォームであり、データ分析プログラムを表現するための高度な言語であるPig Latinを使用します。Pig変換はすべてLocalモードまたはMapReduceモードで実行できます。カスタムPigコードは、ユーザー定義の関数または表関数コンポーネントを介して追加できます。

- Spark変換の生成: ODIマッピングでは、Sparkプログラミング・モデルをPython言語で公開するPySparkを生成することもできます。Apache Sparkは、大規模なデータ処理用の変換エンジンです。これにより、大規模なデータ・セットの高速なインメモリー処理が可能になります。カスタムPySparkコードは、ユーザー定義の関数または表関数コンポーネントを介して追加できます。

Oozieを使用したODIジョブの編成

現在、マッピング、パッケージ、シナリオおよびプロシージャなどのODIジョブ用の編成エンジンとして従来のODI AgentとApache Oozieのどちらかを選択できます。Apache Oozieを使用すると、編成用のODI環境をインストールせずにHadoopインフラストラクチャで完全なネイティブ実行が可能になります。Oozieツールを使用して、ODIジョブをスケジュール、管理および監視できます。ODIでは、Oozieのネイティブ・アクションを使用してHadoopプロセスおよび条件付きブランチ処理ロジックを実行します。

拡張Hiveドライバおよびナレッジ・モジュール

ODIには、全体的なJDBCへの準拠やパフォーマンスの向上など、Apache Hiveドライバと比べて多くのメリットを備えたWebLogic Hive JDBCドライバが用意されています。Hiveナレッジ・モジュールはすべて、この新しいドライバのメリットを活用できるようにリライトされています。また、現在、ソースからロードすることが主な目的であるナレッジ・モジュールは、ロード・ナレッジ・モジュールとして提供されているため、1回のマッピングで他のロード・ナレッジ・モジュールと結合できます。直接ロード型の新しいクラスであるロード・ナレッジ・モジュールを使用すると、中間ステージングなしでターゲットをロードすることもできます。表関数コンポーネントは、Hive構造体をサポートできるよう拡張されています。

Hadoop監査ログの取得

ODIでは、Oozie、Pigおよび他のタスクの実行用として、Hadoop監査ログからの結果をオペレータ・タスクに統合します。ログ結果には、MapReduce統計が表示され、ネイティブWebコンソール内のHadoop統計へのリンクが提供されます。

ODIファイル・ツールでのHDFSアクセス

ODIパッケージおよびプロシージャで使用されるファイルベースのツールが拡張され、Hadoop分散ファイルシステム(HDFS)ファイル処理が組み込まれました。これには、ファイルのコピー、移動、追加および削除、ファイル変更の検出、フォルダの管理、FTPを使用したHDFSへのファイルの直接転送が含まれます。

フラット・コンポーネントおよび不規則コンポーネント

マッピング用の新しいフラット・コンポーネントを使用すると、複雑なサブ構造を属性のフラット・リストの一部として処理できます。新しい不規則コンポーネントにより、キーと値のリストが名前付き属性に変換され、追加処理が可能になります。

ODIドキュメント・セットに追加された新規ビッグ・データ・ガイド

新しいガイド『Oracle Data Integratorとのビッグ・データの統合』が、ODIドキュメント・セットに追加されました。このガイドでは、ビッグ・データの統合、Oozieワークフローのデプロイと実行、およびPig LatinやSparkなどの言語でのコードの生成を行う方法が説明されています。

リリース12c (12.1.3)の新機能と変更された機能

Oracle Data Integrator 12c (12.1.3)では、次の機能が強化されています。

- ODI FIPS準拠

- ODI XMLドライバの機能強化

- JSONのサポート

- Hadoop SQOOP統合

- Hadoop HBase統合

- Hive Appendの最適化

- ODIエンジンへのマルチスレッドのターゲット表ロード

- シナリオおよびロード計画の同時実行に対する制御の向上

- 新規モデルおよびトポロジ・オブジェクトの作成

- ドキュメントの変更

ODI FIPS準拠

ODIでは、ナレッジ・モジュール、プロシージャ、シナリオ、アクションおよびパスワードを暗号化するための標準暗号化アルゴリズムとしてAdvanced Encryption Standard (AES)が使用されるようになりました。要件に合せて暗号化アルゴリズムおよびキー長を構成できます。リポジトリ・エクスポートに含められるパスワードおよびその他の機密情報は、暗号化され、パスワードで保護されるようになりました。

詳細は、「Advanced Encryption Standard」を参照してください。

ODI XMLドライバの機能強化

次に示すXMLスキーマのサポート強化が追加されています。

- 再帰: ODIでは、XMLスキーマ内部の再帰がサポートされるようになりました。

- any、anyTypeおよびanyAttribute: これらの型により定義されたデータは、元のドキュメントのXMLマークアップを使用して文字列型の列に格納されます。

- 使用する表名、列名、型、長さおよび精度をODI XMLドライバに指示するためのメタデータ注釈をXMLスキーマ内部に追加できます。

詳細は、『Oracle Data Integrator接続およびナレッジ・モジュール・ガイド』の「Oracle Data Integrator Driver for XMLの参照情報」を参照してください。

JSONのサポート

ODI複合ファイル・ドライバでは、JSON形式のファイルの読取りと書込みが可能になりました。JSON構造はnXSDスキーマを介して定義されます。

詳細は、『Oracle Data Integrator接続およびナレッジ・モジュール・ガイド』のJSONのサポートに関する項を参照してください。

Hadoop SQOOP統合

ODIでは、Hadoop SQOOPを使用して、次のソースおよびターゲットをロードできるようになりました。

- ナレッジ・モジュールIKM File-Hive to SQL (SQOOP)を使用したリレーショナル・データベースからHDFS、HiveおよびHBaseへのロード

- ナレッジ・モジュールIKM SQL to Hive-HBase-File (SQOOP)を使用したHDFSおよびHiveからリレーショナル・データベースへのロード

SQOOPを使用すると、Hadoop Map-ReduceプロセスでパラレルJDBC接続を使用したメカニズムのロードとアンロードが可能になります。

詳細は、『Oracle Data Integratorアプリケーション・アダプタ・ガイド』のHadoopに関する項を参照してください。

Hadoop HBase統合

ODIでは、新しいテクノロジおよび次のナレッジ・モジュールを介してHadoop HBaseがサポートされるようになりました。

- LKM HBase to Hive (HBase-SerDe)

- IKM Hive to HBase Incremental Update (HBase-SerDe)

- RKM HBase

詳細は、『Oracle Data Integratorアプリケーション・アダプタ・ガイド』のHadoopに関する項を参照してください。

Hive Appendの最適化

Hiveへの書込みを行うナレッジ・モジュールでは、Hive 0.8+機能がサポートされるようになり、既存のデータを新しい追加済ファイルにコピーせずに、データを既存のデータ・ファイルに追加できるようになりました。

詳細は、『Oracle Data Integratorアプリケーション・アダプタ・ガイド』のHadoopに関する項を参照してください。

ODIエンジンへのマルチスレッドのターゲット表ロード

ODIでは、複数のパラレル接続を使用してターゲット表をロードできるようになりました。この機能は、データ・サーバーの「ターゲットの並列度」プロパティを介して制御します。

詳細は、「データ・サーバーの作成」を参照してください。

シナリオおよびロード計画の同時実行に対する制御の向上

シナリオまたはロード計画の同時実行を制限し、同時実行の待機または実行エラーの発生を強制できるようになりました。

詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のシナリオおよびロード計画の同時実行の制御に関する項を参照してください。

新規モデルおよびトポロジ・オブジェクトの作成

デザイナ・ナビゲータの「新規モデルとトポロジ・オブジェクト」ダイアログで、新規のモデルを作成し、それを新規または既存のトポロジ・オブジェクトと関連付けることができます(作業リポジトリに接続されている場合)。このダイアログでは、トポロジ・エディタを使用しなくてもトポロジ・オブジェクトを作成できます(より詳細なオプションが必要な場合を除く)。

詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のモデルおよびトポロジ・オブジェクトの作成に関する項を参照してください。

ドキュメントの変更

以前のOracle Data Integratorの開発者ガイドの記載内容が再編成されました。ODIドキュメント・ライブラリに次の新しいガイドが追加されました。

- Oracle Data Integratorの理解

- Oracle Data Integratorの管理

- Oracle Data Integratorツール・リファレンス

詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の「Oracle Data Integratorの新機能」を参照してください。

リリース12c (12.1.2)の新機能と変更された機能

Oracle Data Integrator 12c (12.1.2)では、次の機能が強化されています。

- 宣言的なフローベースのユーザー・インタフェース

- 再使用可能マッピング

- 複数ターゲットのサポート

- 段階的なデバッガ

- ランタイム・パフォーマンスの向上

- Oracle GoldenGateの統合の改善

- WebLogic Management Frameworkを使用したスタンドアロン・エージェント管理

- OPSSエンタープライズ・ロールとの統合

- XMLの改善

- Oracle Warehouse Builderとの統合

- 一意のリポジトリID

宣言的なフローベースのユーザー・インタフェース

新しい宣言的なフローベースのユーザー・インタフェースは、宣言的アプローチの単純さおよび使いやすさと、構成可能なフローの柔軟性および拡張性をあわせ持っています。マッピング(Oracle Data Integrator 11gの概念であるインタフェースの後継概念)により、結合、フィルタ、集計、設定、分割などのコンポーネントのフロー全体で、ソースがターゲットに関連付けられます。

再使用可能マッピング

再使用可能マッピングを使用して、複数のマッピングで再使用できるフロー・セクションをカプセル化できます。再使用可能マッピングには、包含フローに接続する入力および出力シグネチャを設定でき、再使用可能マッピング内にカプセル化されるソースとターゲットを含めることもできます。

複数ターゲットのサポート

マッピングにより、単一フローの一部として複数のターゲットをロードできます。ターゲットのロード順を指定でき、オプションで分割コンポーネントを使用して行を1つ以上の条件に基づいて異なるターゲットにルーティングできます。

段階的なデバッガ

マッピング、パッケージ、プロシージャおよびシナリオを段階的なデバッガでデバッグできます。これらのオブジェクト内のタスク実行を手動でトラバースし、事前に定義された位置で実行を中断するようにブレークポイントを設定できます。デバッグ・セッション中に変数の値をイントロスペクトおよび変更でき、コミットされていないトランザクションのコンテンツなど、基礎となるソースおよびターゲットのデータを問合せできます。

ランタイム・パフォーマンスの向上

パフォーマンスを向上させるためにランタイム実行が改善されました。セッションのキャッシュされた実行計画であるブループリントの導入など、セッション実行のオーバーヘッドを削減するために様々な変更が行われました。

ソースをステージング領域に並列してロードすることで、パフォーマンスが向上します。ロードの並列化は、マップの物理ビューでカスタマイズできます。

一時データベース・オブジェクトに一意の名前を使用して、同じマッピングを並列して実行することもできます。

Oracle GoldenGateの統合の改善

チェンジ・データ・キャプチャ(CDC)フレームワークのソースとしてのOracle GoldenGateの統合が次の領域で改善されました。

- Oracle GoldenGateのソースおよびターゲット・システムは、トポロジのデータ・サーバーとして構成されるようになりました。抽出およびレプリケート・プロセスは、物理スキーマと論理スキーマによって表現されます。トポロジにおけるこのような表現により、一般的なコンテキスト方針に従って複数のコンテキストを個別に構成できます。

- ほとんどのOracle GoldenGateパラメータを物理スキーマ構成の抽出およびレプリケート・プロセスに追加できるようになりました。UIでは、リストからのパラメータの選択がサポートされます。これにより、Oracle GoldenGateパラメータ・ファイルを生成後に変更する必要性が最小限に抑えられます。

- 1つのマッピングをターゲットのジャーナル化されたCDCロードとバルク・ロードに使用できるようになりました。これを有効にするには、Oracle GoldenGateレプリケーション・ターゲットではなくソース・モデルを使用したOracle GoldenGate JKMを使用し、デプロイメント仕様の一部としてマッピングでジャーナル化を構成します。複数のデプロイメント仕様をジャーナル化されたロードおよびバルク・ロード用に1つのマッピングで使用できます。

- JAgentテクノロジを使用して、Oracle GoldenGateパラメータ・ファイルをソースおよびターゲットのOracle GoldenGateインスタンスに自動的にデプロイし、開始できるようになりました。

WebLogic Management Frameworkを使用したスタンドアロン・エージェント管理

Oracle Data Integratorスタンドアロン・エージェントをWebLogic Management Frameworkから管理できるようになりました。これには、次のような利点があります。

- 構成ウィザードを使用したUI駆動の構成

- 複数の構成を個別のドメインで保守可能

- ノード・マネージャを使用した、エージェントの管理および自動再起動

OPSSエンタープライズ・ロールとの統合

Oracle Data IntegratorでOracle Platform Security Services (OPSS)を使用してリソースへのアクセスを制御できるようになりました。エンタープライズ・ロールをOracle Data Integratorロールにマッピングして、様々なツールにわたってエンタープライズ・ユーザーに権限を与えることができます。

XMLの改善

次のXMLスキーマ構造がサポートされるようになりました。

- リストおよび和集合: リストまたは和集合ベースの要素はVARCHAR列にマッピングされます。

- substitutionGroup: 置換グループに基づく要素によって、置換グループのすべてのタイプそれぞれに表が作成されます。

- 複合コンテンツ: 複合コンテンツを含む要素は、要素のテキストとマークアップ・コンテンツを含むVARCHAR列にマッピングされます。

- 注釈: XMLスキーマの注釈のコンテンツは、表メタデータに格納されます。

Oracle Warehouse Builderとの統合

Oracle Warehouse Builder (OWB)ジョブは、OdiStartOwbJobツールを使用してOracle Data Integratorで実行できるようになりました。OWBリポジトリは、トポロジのデータ・サーバーとして構成されます。OWBジョブ実行のすべての詳細がオペレータ・ツリーにセッションとして表示されます。

一意のリポジトリID

マスター・リポジトリおよび作業リポジトリでは、GUIDの規則に従って一意のIDが使用されるようになりました。これにより、アーティファクトのインポート時の衝突が回避され、組織内の複数のリポジトリを容易に管理および統合できます。

1 Oracle Data Integratorの概要

Oracle Data Integratorは、複雑なデータ・ウェアハウスの構築、デプロイ、管理を行うための完全に統一されたソリューションを提供します。あるいは、SOAまたはビジネス・インテリジェンス環境におけるデータ中心アーキテクチャの一部としても使用されます。この章では、Oracle Data Integratorとその各種コンポーネントの概要を示します。

この章の内容は次のとおりです。

- Oracle Data Integratorとは

- Oracle Data Integratorのコンポーネント

- Oracle Data Integratorを構成および管理するための基本タスク

1.1 Oracle Data Integratorとは

Oracle Data Integrator (ODI)の特徴は、データ統合のあらゆるスタイル(データ中心、イベント中心、サービス中心)を組み込んだアクティブな統合プラットフォームです。ODIでは、大量のデータの効率的な変換、高度なチェンジ・データ・キャプチャ(CDC)フレームワークによるリアルタイムのイベント処理、Oracle SOA Suiteに対するデータ・サービスの提供によって、分断化状態の統合が統一されます。また、堅牢なデータ整合性制御機能によって、データの一貫性と正確性が保証されます。異種のE-LT、宣言的な設計、ナレッジ・モジュールなど、中核となる強力な差別化機能によって、Oracle Data Integratorは、統合プラットフォームのパフォーマンス、柔軟性、生産性、モジュール性およびホットプラガブル性の要件を満たします。

1.2 Oracle Data Integratorのコンポーネント

Oracle Data Integratorプラットフォームは、広義のFusion Middlewareプラットフォームに統合され、このスタックの主要なコンポーネントになります。Oracle Data Integratorにはランタイム・コンポーネントがJava EEアプリケーションとして含まれ、WebLogicアプリケーション・サーバーが十分に活用されるよう強化されています。Oracle Data Integratorコンポーネントには、エンタープライズ規模のデプロイメント、高可用性、スケーラビリティおよび強固なセキュリティのための独自の機能が含まれています。ODIアーキテクチャは、互いに連携する次のコンポーネントで構成されています。

- リポジトリ

- ODI Studioとユーザー・インタフェース

- 設計時プロジェクト

- ランタイム・エージェント

- ODIコンソール

- Oracle Enterprise Manager Fusion Middleware Control

- Management Pack for Oracle Data Integrator

ODIコンポーネントの詳細は、『Oracle Data Integratorの理解』のOracle Data Integratorコンポーネント・アーキテクチャの理解に関する項を参照してください。

1.3 Oracle Data Integratorを構成および管理するための基本タスク

ソフトウェアをインストールした後に基本的なOracle Data Integrator環境を構成および管理するために必要な手順のサマリーを次に示します。

表1-1 Oracle Data Integratorを構成および管理する手順

タスク

ドキュメント

1. マスター・リポジトリおよび作業リポジトリ・スキーマの作成

『Oracle Data Integratorのインストールと構成』のOracle Data Integratorマスター・リポジトリおよび作業リポジトリ・スキーマの作成に関する項を参照してください。

2. 追加の作業リポジトリの作成

「作業リポジトリの作成」を参照してください。

3. Oracle Data Integratorエージェントのドメインの構成

- Java EEエージェント: 『Oracle Data Integratorのインストールと構成』のJava EEエージェントのWebLogicドメインの構成に関する項を参照してください。

- スタンドアロン・エージェント: 『Oracle Data Integratorのインストールと構成』のスタンドアロン・エージェントのスタンドアロン・ドメインの構成に関する項を参照してください。

- スタンドアロン・コロケート・エージェント: 『Oracle Data Integratorのインストールと構成』のスタンドアロン・コロケート・エージェントのWebLogicドメインの構成に関する項を参照してください。

4. エージェントの作成

- Java EEエージェント: 『Oracle Data Integratorのインストールと構成』のODI Studioを使用したマスター・リポジトリでのJava EEエージェントの作成に関する項を参照してください。

- スタンドアロン・エージェント: 『Oracle Data Integratorのインストールと構成』のODI Studioを使用したマスター・リポジトリでのスタンドアロン・エージェントの作成に関する項を参照してください。

- スタンドアロン・コロケート・エージェント: 『Oracle Data Integratorのインストールと構成』のODI Studioを使用したマスター・リポジトリでのスタンドアロン・コロケート・エージェントの作成に関する項を参照してください。

5. エージェントの起動

- Java EEエージェント: 『Oracle Data Integratorのインストールと構成』のJava EEエージェントの起動に関する項を参照してください。

- スタンドアロン・エージェント: 『Oracle Data Integratorのインストールと構成』のノード・マネージャを使用したスタンドアロン・エージェントの起動に関する項を参照してください。

- スタンドアロン・コロケート・エージェント: 『Oracle Data Integratorのインストールと構成』のスタンドアロン・コロケート・エージェントの起動に関する項を参照してください。

6. スタンドアロン・エージェントに対するロード・バランシングの構成

「エージェントのロード・バランシング」を参照してください。

7. Oracle Data Integratorの高可用性の構成

「高可用性トポロジの設定手順」を参照してください。

8. セキュリティの構成

「Oracle Data Integratorでのセキュリティの管理」を参照してください。

9. トポロジの設定

「トポロジの設定」を参照してください。

10. データ・サービスの設定

「データ・サービスの作成および使用」を参照してください。

11. 統合プロセスの実行、デバッグおよびモニター

「統合プロセスの実行およびモニタリング」を参照してください。

12. Enterprise Managerを使用したODI環境の管理

「ODIドメイン」、「Oracle Enterprise Manager Fusion Middleware Control」および「Management Pack for Oracle Data Integrator」を参照してください。

13. エージェントの停止

『Oracle Data Integratorのインストールと構成』のOracle Data Integratorエージェントの停止に関する項を参照してください。

第I部

Oracle Data Integratorアーキテクチャの管理

この部では、Oracle Data Integratorのアーキテクチャについて説明します。

この部の構成は、次のとおりです。

- 第2章「リポジトリの管理」

- 第3章「トポロジの設定」

2 リポジトリの管理

この章では、Oracle Data Integratorリポジトリを作成して管理する方法を説明します。Oracle Data Integratorで使用するリポジトリの概要も説明します。

この章には次の項が含まれます:

- Oracle Data Integratorのリポジトリの概要

- リポジトリの記憶領域の作成

- マスター・リポジトリの作成

- マスター・リポジトリへの接続

- 作業リポジトリの作成

- 作業リポジトリへの接続

- 作業リポジトリのパスワードの変更

- リポジトリ管理用の拡張アクション

関連項目:

- RCUでのODIリポジトリの作成の詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- ODIリポジトリのアップグレードの詳細は、『Oracle Data Integratorのアップグレード』を参照してください。

2.1 Oracle Data Integratorリポジトリの概要

Oracle Data Integratorのリポジトリには、次の2つのタイプがあります:

- マスター・リポジトリ: 企業のITリソースのトポロジ、セキュリティ、およびプロジェクトやデータ・モデルのバージョン管理に関する情報を保持するデータ構造。このリポジトリは、異なるOracle Data Integratorモジュールからクライアント/サーバー・モードでアクセス可能なリレーショナル・データベースに格納されます。通常、必要なマスター・リポジトリは1つのみです。ただし、次のいずれかの場合は、複数のマスター・リポジトリの作成が必要になる可能性があります:

- 高速ネットワークでリンクされていない複数のサイトにわたってプロジェクトを構築する場合(例: オフサイト開発)。

- 運用環境(開発、テスト、本番)を、マスター・リポジトリを格納するデータベースも含めて明確に区別する必要がある場合。これらの環境が複数のサイトに存在する場合に該当する可能性があります。

- 作業リポジトリ: データ・モデル、プロジェクトおよびその使用に関する情報を保持するデータ構造。このリポジトリは、異なるOracle Data Integratorモジュールからクライアント/サーバー・モードでアクセス可能なリレーショナル・データベースに格納されます。必要に応じて、複数のマスター・リポジトリに対して複数の作業リポジトリを指定できます。ただし、バージョン管理上の目的のため、1つの作業リポジトリは1つのマスター・リポジトリにのみリンクできます。

通常、リポジトリを作成するには、リポジトリ作成ユーティリティ(RCU)を使用します。RCUによって、記憶領域の管理とリポジトリの作成が自動的に実行されます。ただし、リポジトリを手動で作成する必要がある場合は、ODI Studioを使用してリポジトリを手動で作成および構成できます。

リポジトリの作成と構成に必要な手順については、次の各項で詳細に説明します:

- リポジトリの記憶領域の作成

- マスター・リポジトリの作成

- マスター・リポジトリへの接続

- 作業リポジトリの作成

- 作業リポジトリへの接続

注意:
作業リポジトリのサイズ削減を目的とする実行ログのパージと、データベース上のリポジトリのバックアップをメンテナンス作業として定期的に実行することをお薦めします。

リポジトリ管理用の拡張アクションの詳細は、「リポジトリ管理用の拡張アクション」を参照してください。

2.2 リポジトリの記憶領域の作成

Oracle Data Integratorのリポジトリは、Oracle Fusion Middleware 12cでサポートされているデータベース・エンジンにインストールできます。サポートされているデータベースのバージョンと各データベース要件の最新リストは、次を参照してください:

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

リポジトリを格納するデータベースごとに、記憶領域を作成する必要があります。

注意:
メンテナンスおよびバックアップ時の便宜を図るため、リポジトリはアプリケーション・データの保存場所とは別に格納することをお薦めします(たとえば、Oracleデータベースの異なるスキーマに格納するか、Microsoft SQL Serverなどの異なるデータベースに格納します)。

マスター・リポジトリは、作業リポジトリの1つとして同じスキーマに格納できます。ただし、同じスキーマに異なる2つの作業リポジトリを作成することはできません。

次の表に、リポジトリの作成手順の例をガイドとして示します:

テクノロジ

手順

Oracle

マスター・リポジトリをホストするスキーマodimと、作業リポジトリをホストするスキーマodiwを作成します。
これらのスキーマは、次のSQLコマンドで作成します。

SQL> create user MY_SCHEMA identified by MY_PASS
default tablespace MY_TBS
temporary tablespace MY_TEMP;
SQL> grant connect, resource to MY_SCHEMA;
SQL> grant execute on dbms_lock to MY_SCHEMA;

説明:

MY_SCHEMAは、たとえばodimやodiwなど、作成するスキーマの名前に対応します。

MY_PASS: データの格納先となるOracle表領域<MY_TBS>に指定したパスワード。

MY_TEMP: デフォルトの一時表領域。

Microsoft SQL Server

マスター・リポジトリをホストするデータベースdb_odimと、作業リポジトリをホストするデータベースdb_odiwを作成します。これらのデータベースをデフォルトで保持する2つのログインodimおよびodiwを作成します。
Oracle Enterprise Managerを使用して、2つのデータベースdb_odimとdb_odiwを作成します。

クエリー・アナライザまたはI-SQLを使用して、次のコマンドを実行します。

CREATE LOGIN mylogin
WITH PASSWORD = 'mypass',
DEFAULT_DATABASE = defaultbase,
DEFAULT_LANGUAGE = us_english;
USE defaultbase;
CREATE USER dbo FOR LOGIN mylogin;
GO

説明:

myloginは、odimまたはodiwに対応します。

mypassは、これらのログインのパスワードに対応します。

defaultbaseは、それぞれdb_odimおよびdb_odiwに対応します。

注意: 大/小文字を照合してリポジトリ情報を格納するMicrosoft SQL Serverデータベースを構成することをお薦めします。これにより、名前が同じで大/小文字が異なる複数のオブジェクトをリバース・エンジニアリングおよび作成できます(例: tablenameとTableNAme)。

Sybase ASE

マスター・リポジトリをホストするデータベースdb_odimと、作業リポジトリをホストするデータベースdb_odiwを作成します。これらのデータベースをデフォルトで保持する2つのログインodimおよびodiwを作成します。
I-SQLを使用して、次のコマンドを起動します。

isql -Usa -P<sa password> -S<Server>
use master
go
disk init
name = "<Device Name>",
physname = "<Actual path>",
size = <Size>
go
create database <database name>
on <Device Name>='<Size>'
log on <Device Name>='<Size>' WITH OVERRIDE
go
use <database name>
go
sp_addlogin '<DB USERNAME>', '<password>', <database name>
go
sp_adduser '<DB USERNAME>'
go
grant CREATE TABLE to <DB USERNAME>

注意: ログおよびデータには別のデバイスを使用してください。また、<DB USERNAMEは大文字にしてください。

MySQL

1. MySQL端末にログインします。

2. 次に示すように、マスター用、作業用およびスキーマ・バージョン・レジストリ用のデータベースを作成します。

create database <MASTER_DB>;
create database <WORK_DB>;
create database <SCHEME_VERSION_REGISTRY_DB>;

3. 次に示すように、ユーザーを作成します。

create user '<MASTER_DB>'@'localhost' identified by '<password>';
create user '<WORK_DB>'@'localhost' identified by '<password>';
create user '<MASTER_DB>'@'%' identified by '<password>';
create user '<WORK_DB>'@'%' identified by '<password>';
commit;

注意: ユーザー名は大文字にしてください。

4. 次に示すように、権限をユーザーに付与します。

grant all privileges on <MASTER_DB>.* to <MASTER_DB>;
grant all privileges on <MASTER_DB>.* to <MASTER_DB>@localhost;
grant all privileges on <MASTER_DB>.* to <MASTER_DB>@'%';
grant all privileges on <WORK_DB>.* to <WORK_DB>;
grant all privileges on <WORK_DB>.* to <WORK_DB>@localhost;
grant all privileges on <WORK_DB>.* to <WORK_DB>@'%';

DB2/400

マスター・リポジトリをホストするライブラリodimと、作業リポジトリをホストするスキーマodiwを作成します。これらのライブラリをデフォルトで保持する2つのユーザーodimおよびodiwを作成します。
注意: 各ライブラリは、SQLコレクションの形式で作成する必要があります。

DB2/UDB

前提条件:

- マスターおよび作業リポジトリ・ユーザーは、最小16Kのページ・サイズの表領域にアクセスできる必要があります

- データベースには最小16 Kの一時表領域が必要です

例:

CREATE  LARGE  TABLESPACE ODI16 PAGESIZE 16 K  MANAGED BY AUTOMATIC STORAGE ;
GRANT USE OF TABLESPACE ODI16 TO USER ODIREPOS;

2.3 マスター・リポジトリの作成

マスター・リポジトリを作成する作業は、空のリポジトリ構造を作成し、そのリポジトリ構造にメタデータ(テクノロジの定義や組込みのセキュリティ・プロファイル)をシードする作業です。

マスター・リポジトリを作成するには:

1. ODI Studioで、「ファイル」→「新規」を選択して「新規ギャラリ」ダイアログを開きます。

2. 「新規ギャラリ」ダイアログの「カテゴリ」ツリーで、「ODI」を選択します。

3. 「項目」リストから「マスター・リポジトリ作成ウィザード」を選択します。

4. 「OK」をクリックします。
マスター・リポジトリ作成ウィザードが開きます。

5. 「データベース接続」で、次のようにパラメータを指定します。

- テクノロジ: リストから、マスター・リポジトリをホストするテクノロジを選択します。デフォルトは「Oracle」です。

- JDBCドライバ: リポジトリをホストするテクノロジへのアクセスに使用するドライバ。

- JDBC URL: データベースへのJDBC接続の確立に使用するURL。
「JDBCドライバ」パラメータと「JDBC URL」パラメータは同期化され、デフォルト値はテクノロジによって異なります。

- ユーザー: 表の所有者のユーザーIDまたはログイン(例: odim)。

- パスワード: このユーザーのパスワード。

- DBAユーザー: データベース管理者のユーザー名。

- DBAパスワード: このユーザーのパスワード。

6. 必要に応じて、「リポジトリ構成」パラメータを指定します。

7. 「テスト接続」をクリックして、マスター・リポジトリへの接続をテストします。
「情報」ダイアログが開き、接続が確立されたかどうかが通知されます。接続に失敗した場合は、マスター・リポジトリへの接続を修正してから次の手順に進んでください。

8. 「次へ」をクリックします。

9. 次のいずれかの操作を行います。

- ODIの内部セキュリティ・システムを使用してユーザーを管理する場合は、「ODI認証の使用」を選択し、次のスーパーバイザ・ログイン情報を入力します。

プロパティ

説明

スーパーバイザ・ユーザー

ODIスーパーバイザのユーザー名。値はSUPERVISORである必要があります。

スーパーバイザ・パスワード

このユーザーのパスワード

パスワードの確認

このユーザーのパスワード

- Oracle Internet Directoryなどの外部エンタープライズ・アイデンティティ・ストアを使用してユーザー認証を管理する場合は、「外部認証の使用」を選択し、次のスーパーバイザ・ログイン情報を入力します。

プロパティ

説明

スーパーバイザ・ユーザー

ODIスーパーバイザのユーザー名

スーパーバイザ・パスワード

このユーザーのパスワード

注意:
外部認証オプションを使用する場合は、ODI Studioを外部認証に対応するように構成する必要があります。詳細は、「外部認証の構成」を参照してください。

10. 「次へ」をクリックします。

11. データ・サーバー(つまり、トポロジで定義されたソースとターゲット)のパスワード記憶域の詳細を次のように指定します。

- Oracle Data Integratorのマスター・リポジトリにパスワードを保存する場合は、「内部パスワード記憶域」を選択します。

- JPS資格証明ストア・フレームワーク(CSF)を使用してデータ・サーバーおよびコンテキスト・パスワードをリモートの資格証明ストアに保存する場合は、「外部パスワード記憶域」を選択します。資格証明ストアにアクセスするために「MBeanサーバー・パラメータ」を指定します。詳細は、「Oracle Data Integratorでのセキュリティの管理」を参照してください。

12. マスター・リポジトリ作成ウィザードで「終了」をクリックして、入力内容を確認します。

マスター・リポジトリの作成が開始されます。表示されるメッセージとログで進行状況を確認できます。作成されたマスター・リポジトリをテストするには、「マスター・リポジトリへの接続」を参照してください。

注意:
マスター・リポジトリでは、デフォルトで暗号化にAES-128が使用されます。ただし、暗号化アルゴリズムAES-256を使用してマスター・リポジトリを作成する場合は、odi.confファイルに次の行を追加して更新する必要があります。
AddVMOption: Doracle.odi.encryption.algo=AES
AddVMOption: Doracle.odi.encryption.keylen=256

AESの詳細は、「Advanced Encryption Standard」を参照してください。

2.4 マスター・リポジトリへの接続

マスター・リポジトリに接続するには、『Oracle Data Integratorのインストールと構成』のマスター・リポジトリへの接続に関する項に示された手順に従ってください。

2.5 作業リポジトリの作成

マスター・リポジトリには1つ以上の作業リポジトリを関連付けることができますが、作業リポジトリは1つのマスター・リポジトリにのみ関連付けることができます。

新しい作業リポジトリを作成するには:

1. トポロジ・ナビゲータで、「リポジトリ」パネルを開きます。

2. 「作業リポジトリ」ノードを右クリックして「新規作業リポジトリ」を選択します。
作業リポジトリ作成ウィザードが開きます。

3. Oracle Data Integrator作業リポジトリ接続の詳細を次のように指定します。

- テクノロジ: 作業リポジトリをホストするサーバーのテクノロジを選択します。デフォルトは「Oracle」です。

- JDBCドライバ: リポジトリをホストするテクノロジへのアクセスに使用するドライバ。

- JDBC URL: 作業リポジトリをホストするデータ・サーバーの完全なパス。
「JDBCドライバ」パラメータと「JDBC URL」パラメータは同期化され、デフォルト値はテクノロジによって異なります。

接続に関する問題を回避するために、JDBC URLではlocalhostではなくフル・マシン名を使用することをお薦めします。たとえば、リモート・クライアントでは、クライアント(ODI StudioまたはSDK)が作業リポジトリとは別のマシン上にあり、localhostが作業リポジトリをホストするマシンではなく現在のクライアント・マシンを指している場合があります。

- ユーザー: 作業リポジトリに対して作成およびホストする表の所有者のユーザーIDまたはログイン。

- パスワード: このユーザーのパスワード。

4. 「テスト接続」をクリックして、接続が有効であることを確認します。

5. 「次へ」をクリックします。
ステップ3で指定した接続に対する作業リポジトリがすでに存在しているかどうかが検証されます。

- この接続に対する既存の作業リポジトリが検出された場合は、次の段階として、その作業リポジトリをマスター・リポジトリに連結します。手順の詳細は、連結するOracle Data Integrator作業リポジトリのパスワードの指定を参照してください。

- この接続に対する作業リポジトリが検出されなかった場合は、新規の作業リポジトリが作成されます。新規作業リポジトリの作成を続行し、ステップ6にある作業リポジトリの詳細を指定してください。

6. Oracle Data Integrator作業リポジトリのプロパティを指定します:

- 名前: 作業リポジトリに一意の名前を指定します(例: DEVWORKREP1)。

- パスワード: オプション。この作業リポジトリを別のマスターに連結する際に必要なパスワードを入力します。このオプションを空白にした場合、この操作にパスワードは必要ありません。

- タイプ: 作業リポジトリのタイプを選択します。

- 開発: このタイプのリポジトリでは、データ・モデルやプロジェクトなど(マッピング、プロシージャなども含む)の設計時オブジェクトを管理できます。開発リポジトリには、ランタイム・オブジェクト(シナリオおよびセッション)も含まれます。このタイプのリポジトリは開発環境に適しています。

- 実行: このタイプのリポジトリには、ランタイム・オブジェクト(シナリオ、スケジュールおよびセッション)のみが含まれます。これにより、オペレータ・ナビゲータで、データ統合ジョブを起動およびモニタリングできます。このようなリポジトリには設計時アーティファクトを含めることができません。これを「デザイナ・ナビゲータ」で使用することはできません。実行リポジトリは本番環境に適しています。

7. 「終了」をクリックします。

8. 「作業リポジトリ・ログインの作成」ダイアログが開きます。作業リポジトリのログインを作成する場合は、「はい」をクリックします。新しいダイアログが開き、ログイン名を入力するように求められます。作業リポジトリのログインを作成しない場合は、「いいえ」をクリックします。

9. ツールバーにある「保存」をクリックします。

詳細は、「作業リポジトリへの接続」を参照してください。

2.6 作業リポジトリへの接続

作業リポジトリに接続するには、ODI Studioの「リポジトリへの接続」をクリックし、「作業リポジトリの作成」の手順8で指定した資格証明を入力します。

作業リポジトリ作成のステップ8で作業リポジトリのログイン名を作成していない場合、接続するには、次のステップを実行して、ログインを作成する必要があります。

1. ODI Studioで、「ファイル」→「新規」を選択して「新規ギャラリ」ダイアログを開きます。

2. 「新規ギャラリ」ダイアログの「カテゴリ」ツリーで、「ODI」を選択します。

3. 「項目」リストから「新規ODIリポジトリ・ログインの作成」を選択します。

4. 「OK」をクリックします。
「リポジトリ接続情報」ダイアログが開きます。

5. Oracle Data Integrator接続の詳細を次のように指定します:

- ログイン名: 一般的な別名(例: Repository)

- ユーザー: マスター・リポジトリの作成時に定義したODIスーパーバイザ・ユーザー名、またはマスター・リポジトリの作成後にセキュリティ・ナビゲータで定義したODIユーザー名。

- パスワード: マスター・リポジトリの作成時に定義したODIスーパーバイザ・パスワード、またはマスター・リポジトリの作成後にセキュリティ・ナビゲータで定義したODIユーザー・パスワード。

6. データベース接続(マスター・リポジトリ)の詳細を次のように指定します。

- ユーザー: ODIマスター・リポジトリを保持するスキーマ(データベース、ライブラリ)のデータベース・ユーザーIDまたはログイン。

- パスワード: このユーザーのパスワード。

- ドライバ・リスト: 作成したマスター・リポジトリをサポートするDBMSへの接続に必要なドライバをドロップダウン・リストから選択します。

- ドライバ名: ドライバの完全な名前。

- URL: リポジトリをホストするデータベースへのJDBC接続の確立に使用するURL。

7. 「テスト」をクリックして、接続が有効であることを確認します。

8. 「作業リポジトリ」を選択し、作業リポジトリの詳細を次のように指定します。

- 作業リポジトリ名: 前のステップで作業リポジトリに指定した名前(例ではWorkRep1)。このフィールドの右側にあるボタンをクリックすると、マスター・リポジトリで使用可能な作業リポジトリのリストを表示できます。

9. 「OK」をクリックして、入力内容を検証します。

2.7 作業リポジトリのパスワードの変更

作業リポジトリのパスワードを変更するには:

1. トポロジ・ナビゲータの「リポジトリ」ツリーで、作業リポジトリ・ノードを展開します。

2. 作業リポジトリをダブルクリックするか、または右クリックして「開く」を選択します。作業リポジトリ・エディタが開きます。

3. 作業リポジトリ・エディタの「定義」タブで、「パスワードの変更」をクリックします。

4. 現在のパスワードを入力し、新しいパスワードを2回入力します。

5. 「OK」をクリックします。

2.8 リポジトリ管理用の拡張アクション

リポジトリ管理用の拡張アクションは、リポジトリの作成プロセスには関係しません。この項で説明するアクションは、既存のリポジトリに対して実行する拡張アクションです。リポジトリを作成した後でそのパスワード記憶域を切り替える必要がある場合があります。また、資格証明ストアがクラッシュした場合はそのパスワード記憶域をリカバリする必要があります。パスワード処理に関連するアクションについては、「外部パスワード記憶域の設定」を参照してください。マスター・リポジトリと作業リポジトリのエクスポートおよびインポートの詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の「エクスポートおよびインポート」を参照してください。

この項には次のトピックが含まれます:

- 作業リポジトリの連結および連結解除(削除)

- 作業リポジトリの消去

- リポジトリ接続の構成

2.8.1 作業リポジトリの連結および連結解除(削除)

作業リポジトリの連結とは、既存の作業リポジトリを現在のマスター・リポジトリにリンクする操作です。この既存の作業リポジトリは、データベースにすでに存在し、現在のまたは別のマスター・リポジトリから連結解除されているものです。

作業リポジトリの削除とは、マスター・リポジトリへのリンクを削除して連結解除することです。連結とは逆の操作です。この操作によって作業リポジトリの内容が破棄されることはありません。

作業リポジトリの連結

作業リポジトリをマスター・リポジトリに連結するには:

1. トポロジ・ナビゲータで、「リポジトリ」パネルに移動します。

2. 「作業リポジトリ」ノードを右クリックして「新規作業リポジトリ」を選択します。
作業リポジトリ作成ウィザードが開きます。

3. Oracle Data Integrator作業リポジトリ接続の詳細を次のように指定します。

- テクノロジ: リストから、作業リポジトリをホストするテクノロジを選択します。デフォルトは「Oracle」です。

- JDBCドライバ: リポジトリをホストするテクノロジへのアクセスに使用するドライバ。

- JDBC URL: 作業リポジトリをホストするデータ・サーバーの完全なパス。
「JDBCドライバ」パラメータと「JDBC URL」パラメータは同期化され、デフォルト値はテクノロジによって異なります。

- ユーザー: 作業リポジトリに対して作成およびホストする表の所有者のユーザーIDまたはログイン。

- パスワード: このユーザーのパスワード。

4. 「テスト接続」をクリックして、接続が有効であることを確認します。

5. 「次へ」をクリックします。

6. 連結するOracle Data Integrator作業リポジトリの「パスワード」を指定します。

7. 「次へ」をクリックします。

8. 連結するOracle Data Integrator作業リポジトリの「名前」を指定します。

9. 「終了」をクリックします。

作業リポジトリの削除

リポジトリを連結解除するには、次の手順に従って、マスター・リポジトリからリンクを削除します。

1. トポロジ・ナビゲータで、「リポジトリ」パネルを展開します。

2. 作業リポジトリ・ノードを展開し、削除する作業リポジトリを右クリックします。

3. 「削除」を選択します。

4. 確認ダイアログで、「はい」をクリックします。

5. 作業リポジトリがマスター・リポジトリから連結解除され、トポロジ・ナビゲータの「リポジトリ」パネルから削除されます。

2.8.2 作業リポジトリの消去

作業リポジトリの削除とは、作業リポジトリをマスター・リポジトリから連結解除する操作です。詳細は、「作業リポジトリの連結および連結解除(削除)」を参照してください。

作業リポジトリの消去とは、作業リポジトリをデータベースから削除する操作です。

警告:

消去した作業リポジトリは元に戻すことができません。作業リポジトリに保存されているすべての情報(モデルのメタデータ、プロジェクト、およびシナリオ、スケジュール、ログなどのランタイム情報を含む)が完全に削除されます。

作業リポジトリの消去

作業リポジトリをデータベースから消去するには:

1. トポロジ・ナビゲータで、「リポジトリ」パネルを展開します。

2. 作業リポジトリ・ノードを展開し、削除する作業リポジトリを右クリックします。

3. 「データベースから消去」を選択します。

4. 作業リポジトリをデータベースから完全に消去する場合は、確認ダイアログで「はい」をクリックします。

5. 作業リポジトリがデータベースから消去され、トポロジ・ナビゲータの「リポジトリ」パネルから削除されます。

2.8.3 リポジトリ接続の構成

リポジトリ・データベースへの同時接続数は、リポジトリが格納されるデータベース・エンジンによって制御および制限される可能性があります。Oracleでの接続数を制限する初期化パラメータはprocessesです。多数のパラレル実行を実行する場合、リポジトリ・データベースに許可される最大接続数を増やすようにデータベースを調整することが必要な場合があります。

必要な接続数は、実行中のODI Studioインスタンスおよびロード・プラン・ステップの数によって次のように異なります。

- 各ODI Studioセッションには、セッションの期間中に2つのデータベース接続(マスターへの接続と作業リポジトリへの接続)が必要です。セッションの開始後、短期間のセキュリティ・チェックを実行するために3番目のデータベース接続も必要です。

- Oracle以外のデータベースの場合、各ロード・プラン・ステップでは、ロード・プランの実行中に追加接続がロックとして使用されます。

3 トポロジの設定

この章では、Oracle Data Integratorにおけるトポロジの設定方法について説明します。

この章には次の項が含まれます:

- トポロジの設定

- ビッグ・データの使用

- エージェントの管理

- 高可用性トポロジの設定手順

関連項目:
『Oracle Data Integratorでの統合プロジェクトの開発』の「Oracle Data Integratorトポロジの概要」。

3.1 トポロジの設定

次のステップは、トポロジを作成するためのガイドラインです。初期設定後にトポロジをいつでも変更できます。

1. 様々な環境に対応するコンテキストを作成します。「コンテキストの作成」を参照してください。

2. Oracle Data Integratorで使用されるサーバーに対応するデータ・サーバーを作成します。「データ・サーバーの作成」を参照してください。

3. データ・サーバーごとに、Oracle Data Integratorと統合されるデータが含まれるスキーマに対応する物理スキーマを作成します。「物理スキーマの作成」を参照してください。

4. 論理スキーマを作成し、コンテキストでこれらを物理スキーマと関連付けます。「論理スキーマの作成」を参照してください。

5. 情報システムにインストールされたスタンドアロン・エージェント、スタンドアロン・コロケート・エージェントまたはJava EEエージェントに対応する物理エージェントを作成します。「物理エージェントの作成」を参照してください。

6. 論理エージェントを作成し、コンテキストでこれらを物理エージェントと関連付けます。「論理エージェントの作成」を参照してください。

注意:
「新規モデルとトポロジ・オブジェクト」ダイアログを使用して、モデルを作成し、それをトポロジ・オブジェクトと関連付けることができます(作業リポジトリに接続されている場合)。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のモデルおよびトポロジ・オブジェクトの作成に関する項を参照してください。

3.1.1 コンテキストの作成

コンテキストを作成するには:

1. トポロジ・ナビゲータで、「コンテキスト」ナビゲーション・ツリーを展開します。

2. ナビゲーション・ツリー・ヘッダーで「新規コンテキスト」をクリックします。

3. 次の各フィールドに値を入力します。

- 名前: Oracle Data Integratorグラフィカル・インタフェースに表示されるコンテキストの名前。

- コード: 様々なリポジトリ間でのコンテキストの参照および識別を可能にする、コンテキストのコード。

- パスワード: グラフィカル・インタフェースでユーザー・リクエストがこのコンテキストに切り替わった場合にリクエストされるパスワード。クリティカル・コンテキスト(本番データを示すコンテキストなど)にはパスワードを使用することをお薦めします。

- デザイナ・ナビゲータまたはオペレータ・ナビゲータの各種リストで、このコンテキストをデフォルトで表示する必要がある場合は、「デフォルト」を選択します。

4. 「ファイル」メニューから「保存」をクリックします。

3.1.2 データ・サーバーの作成

データ・サーバーは、統合フローでOracle Data Integratorによりアクセスされるデータベース、JMSサーバー・インスタンス、スクリプト・エンジンまたはファイル・システムなどに対応します。データ・サーバーでは、物理スキーマの形式で下位区分が作成されます。

注意:
よく使用されるテクノロジのデータ・サーバー作成方法の詳細は、『Oracle Data Integrator接続およびナレッジ・モジュール・ガイド』を参照してください。

3.1.2.1 前提条件およびガイドライン

データ・サーバーの作成時には、次のガイドラインに従うことをお薦めします。

テクノロジ固有の要件の確認

一部のテクノロジでは、次のような要素のインストールおよび構成が必要です。

- JDBCドライバのインストール。詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- クライアント・コネクタのインストール

- データ・ソースの構成

データ・サーバーによって接続しているテクノロジのドキュメントおよび『Oracle Data Integrator接続およびナレッジ・モジュール・ガイド』を参照してください。接続情報は、テクノロジに応じて変更される場合があります。提供されているサーバー・ドキュメントを参照し、接続方法を定義するようサーバー管理者に連絡してください。

Oracle Data Integratorユーザーの作成

Oracle Data Integratorで使用される各データベース・エンジンについて、このデータ・サーバー上にODI専用のユーザーを作成することをお薦めします(通常はODI_TEMP)。

ユーザー権限を付与して、次の操作を実行します。

- 自分のスキーマでオブジェクトを作成または削除したり、データ操作を実行します。

- 統合プロセスに必要な操作に従って、このデータ・サーバーのその他のスキーマのオブジェクトにデータを取り込みます。

このユーザーは、次のように使用する必要があります:

- このユーザーの名前/パスワードをデータ・サーバーのユーザー/パスワード定義で使用します。

- このユーザーのスキーマを、このサーバー上のすべてのデータ・スキーマの作業スキーマとして使用します。

3.1.2.2 データ・サーバーの作成

データ・サーバーを作成するには:

1. トポロジ・ナビゲータで、「物理アーキテクチャ」ナビゲーション・ツリーにある「テクノロジ」ノードを展開します。

ヒント:
「物理アーキテクチャ」ナビゲーション・ツリーに表示されるテクノロジのリストは、非常に長くなる可能性があります。表示されるテクノロジ・リストを絞り込むために、「トポロジ・ナビゲータ」ツールバー・メニューから「未使用のテクノロジを非表示」を選択して、未使用のテクノロジを非表示することができます。

2. データ・サーバーを作成するテクノロジを選択します。

3. 右クリックして「新規データ・サーバー」を選択します。

4. 「定義」タブで、次のフィールドに値を入力します:

- 名前: Oracle Data Integratorに表示されるデータ・サーバーの名前。
データ・サーバーの名前を付ける場合は、命名標準の<TECHNOLOGY_NAME>_<SERVER_NAME>を使用することをお薦めします。

- ...(データ・サーバー): これは他のデータ・サーバーで識別のために使用されるデータ・サーバーの物理名です。データ・サーバーを自然な方法で相互接続できる場合はこの名前を入力します。このパラメータは、一部のテクノロジでは必須ではありません。
たとえば、Oracleの場合、この名前はインスタンス名に相当しており、DBLinkを使用して別のOracleデータ・サーバーからこのデータ・サーバーにアクセスする際に使用されます。

- ユーザー/パスワード: データ・サーバーに接続するためのユーザー名およびパスワード。このパラメータは、ファイル・テクノロジなど一部のテクノロジでは必須ではありません。
テクノロジに応じて、ログイン、ユーザーまたはアカウントを指定できます。JNDIプロトコルを使用した一部の接続については、ユーザー名およびそれに関連するパスワードはオプションです(LDAPディレクトリで指定されている場合)。

5. データ・サーバーに対して接続パラメータを定義します。
JDBCによって直接テクノロジにアクセスできます。あるいは、このデータ・サーバーへのJDBC接続がJNDIディレクトリから提供される場合もあります。

JNDIディレクトリによってテクノロジにアクセスする場合、次の操作を行います。

1. 「定義」タブで「JNDI接続」を選択します。

2. 「JNDI」タブに移動し、次のフィールドに入力します:

フィールド

説明

JNDI認証

- なし: 命名またはディレクトリ・サービスへの匿名アクセス

- 簡易: 認証済アクセス(非暗号化)

- CRAM-MD5: 認証済アクセス(暗号化されたMD5)

- <other value>: 認証済アクセス(<other value>に従って暗号化)

JNDIユーザー/パスワード

JNDIディレクトリに接続するユーザー/パスワード

JNDIプロトコル

接続に使用されるプロトコル
最も一般的なプロトコルのみをここにリストしています。これは完全なリストではありません。

- LDAP: LDAPディレクトリへのアクセス

- SMQP: SwiftMQ MOMディレクトリへのアクセス

- <other value>: サブプロトコル<other value>に従ったアクセス

JNDIドライバ

JNDI接続を可能にするドライバ
Sun LDAPディレクトリの例: com.sun.jndi.ldap.LdapCtxFactory

JNDI URL

JNDI接続を可能にするURL
例: ldap://suse70:389/o=linuxfocus.org

JNDIリソース

接続パラメータを含むディレクトリ要素
例: cn=sampledb

JDBCによってテクノロジに接続する場合、次の操作を行います。

1. 「JNDI接続」ボックスを選択解除します。

2. 「JDBC」タブに移動し、次のフィールドに入力します:

フィールド

説明

JDBCドライバ

データ・サーバーへの接続に使用されるJDBCドライバの名前

JDBC URL

データ・サーバーに接続できるURL

事前定義済のJDBCドライバおよびURLのリストを取得するには、使用可能なドライバの表示または「URLサンプルの表示」をクリックします。

6. 「定義」タブで、残りの各フィールドに値を入力します。

- 配列フェッチ・サイズ: 大量のデータをデータ・サーバーから読み取る際、Oracle Data Integratorは連続的なレコードのバッチをフェッチします。この値は、Oracle Data Integratorがデータ・サーバーとの1回の通信でリクエストする行(読み取るレコード)の数です。

- バッチ更新サイズ: 大量のデータをデータ・サーバーに書き込む際、Oracle Data Integratorは連続的なレコードのバッチを挿入します。この値は、Oracle Data Integratorが1回のINSERTコマンドでリクエストする行(書き込むレコード)の数です。

注意:
配列フェッチおよびバッチ更新のパラメータは、JDBCの使用時のみアクセス可能です。ただし、すべてのJDBCドライバが同じ値を受け付けるとは限りません。場合によっては、これらのパラメータを空白にすることが望ましい場合もあります。

注意:
配列フェッチおよびバッチ更新の値に指定する数字が大きいほど、データ・サーバーとOracle Data Integrator間のやりとりが少なくなります。ただし、各やりとりでリカバリされるデータ量が増加するのに伴い、Oracle Data Integratorマシンにかかる負荷が大きくなります。配列フェッチの管理と同じように、バッチ更新の管理は最適化の範囲に含まれます。デフォルト値(30)から始めて、それ以上のパフォーマンス向上が認められないところまで値を10ずつ増やすことをお薦めします。

- ターゲットの並列度: ロード・タスクに対して許可されるスレッドの数を示します。デフォルト値は1です。許可される最大スレッド数は99です。

注意:
「ターゲットの並列度」を大きくした場合、ターゲット環境や、ターゲット・スレッド/接続の最大数をサポートするだめのリソースが十分にあるかどうかによって、その結果は異なります。配列フェッチおよびバッチ更新のサイズに関しては、環境に最も適した値を決定するためのベンチマークを実行する必要があります。個々のソース・スレッドおよびターゲット・スレッドのパフォーマンスの詳細は、オペレータのロード・タスクの「実行の詳細」セクションに表示されます。「実行」の値はJDBC操作の実行にかかった時間であり、待機の値は、ソースがターゲットによる行のロードを待機している時間、またはターゲットがソースによる行の提供を待機している時間です。また、行のロード順序に依存している場合、たとえば、順序やタイムスタンプなどを使用している場合は、「ターゲットの並列度」の値を1より大きくしないでください。これは、ソース行の処理とロードが、多数のターゲット・スレッドの1つによって中間的に行われるためです。

7. 「ファイル」メニューで、「保存」をクリックしてデータ・サーバーの作成を検証します。

3.1.2.3 データ・サーバーの作成(詳細設定)

次の操作はオプションです。

- 接続プロパティの追加

- データソースの定義

- 接続時または切断時のコマンドの設定

接続プロパティの追加

これらのプロパティは、オプションの構成パラメータを指定するために、接続の作成時に渡されます。各プロパティは(キー、値の)ペアです。

- JDBCの場合: これらのプロパティは、使用されるドライバによって決まります。使用可能なプロパティのリストについては、ドライバのドキュメントを参照してください。JDBCでは、接続用のユーザーおよびパスワードを「定義」タブではなくここで指定できます。

- JNDIの場合: これらのプロパティは、使用されるリソースによって決まります。

データ・サーバーに接続プロパティを追加するには:

1. 「プロパティ」タブで、「プロパティを追加」をクリックします。

2. このプロパティを識別するキーを指定します。このキーは大/小文字が区別されます。

3. プロパティの値を指定します。

4. 「ファイル」メニューから「保存」をクリックします。

データソースの定義

「データソース」タブでは、アプリケーション・サーバーにデプロイされたOracle Data Integrator Java EEエージェントでこのデータ・サーバーへの接続に使用されるJDBCデータソースを定義できます。スタンドアロン・エージェントにはデータソースは適用されません。

データソースの定義は必須ではありませんが、定義することで、Java EEエージェントはアプリケーション・サーバーで使用可能なデータソースおよび接続プーリングの機能の恩恵を受けることができます。接続プーリングにより、複数セッション間で接続を再利用できます。Java EEエージェントで指定のデータ・サーバーに対してデータソースが宣言されていない場合、このJava EEエージェントは常に直接JDBC接続を使用してデータ・サーバーに接続します。アプリケーション・サーバーのデータソースはいずれも使用しません。

Oracle Data Integratorでデータソースを定義する前に、次の点に注意してください。

- WebLogic Serverのデータソースは、接続プール構成で「文キャッシュ・サイズ」パラメータを0に設定して作成する必要があります。文キャッシュはデータ統合のパフォーマンスに若干の影響を及ぼし、一部のJDBCドライバでデータの切捨てなどの予期しない結果を招く可能性があります。これはソースおよびターゲットのデータ・サーバーへのデータ接続にのみ影響し、リポジトリ接続には影響しません。

- 接続プーリングをデータソースで使用する場合、プロシージャおよびナレッジ・モジュールでALTER SESSION文を使用しないことをお薦めします。接続でALTER SESSION文が必要な場合は、関連データソースでの接続プーリングを無効化することをお薦めします。

データ・サーバーに対してJDBCデータソースを定義するには:

1. データ・サーバー・エディタの「データソース」タブで、「データソースの追加」をクリックします。

2. 「エージェント」フィールドで物理エージェントを選択します。

3. 「JNDI名」フィールドにデータソース名を入力します。
この名前は、アプリケーション・サーバーのデータソース名と一致する必要があるので注意してください。

4. 環境命名コンテキスト(ENC)を使用する場合は、「JNDI標準」を選択します。
「JNDI標準」を選択した場合、Oracle Data Integratorでは、アプリケーション・サーバーのJNDIディレクトリでデータソースを識別するために、データソース名の前に文字列java:comp/env/が自動的に付けられます。

JNDI標準は、Oracle WebLogic Serverではサポートされておらず、グローバル・データ・ソースに対してはサポートされていないことに注意してください。

5. 「ファイル」メニューから「保存」をクリックします。

Java EEエージェントに対してデータソースを定義した後、Java EEエージェントがデプロイされているアプリケーション・サーバーでデータソースを作成する必要があります。アプリケーション・サーバーでデータソースを作成するには、次のような複数の方法があります。

- アプリケーション・サーバー・コンソールからデータ・ソースを構成します。詳細は、アプリケーション・サーバーのドキュメントを参照してください。

- エージェントのアプリケーション・サーバーにおけるOracle Data Integratorからのデータソースのデプロイ。

- Java EEアプリケーション・サーバーでのエージェントのデプロイ。

接続時または切断時のコマンドの設定

「接続/切断時」タブでは、物理アーキテクチャに定義されているデータ・サーバーへの接続の作成時またはクローズ時に実行するSQLコマンドを定義できます。

接続時のコマンドは、ODIコンポーネント(ODIクライアント・コンポーネントを含む)がこのデータ・サーバーに接続されるたびに実行されます。

切断時のコマンドは、ODIコンポーネント(ODIクライアント・コンポーネントを含む)がこのデータ・サーバーから切断されるたびに実行されます。

これらのSQLコマンドは、データ・サーバー定義とともにマスター・リポジトリに格納されます。

接続時または切断時のコマンドを設定する前に、次にことに注意してください。

- 接続時および切断時のコマンドは、テクノロジ・タイプが「データベース」(JDBC)のデータ・サーバーでのみサポートされます。

- 接続時および切断時のコマンドは、データソースを使用している場合も実行されます。この場合、コマンドは、接続プールに対して接続を取得および解放するときに実行されます。

- 置換APIがサポートされています。設計時タグ<%はサポートされていません。実行時タグ<?および<@はサポートされています。

- 置換モードではグローバル変数(#GLOBAL.<VAR_NAMEまたは#<VAR_NAME)のみがサポートされています。詳細は、変数の有効範囲を参照してください。式エディタには、現在のデータ・サーバーに有効な変数のみが表示されます。

- 接続時および切断時のコマンドに使用される変数は、実行時にのみ置換され、その時点でセッションが開始します。データ・サーバーの接続をテストする場合や、このデータ・サーバーでデータの表示操作を実行する場合、変数を使用するコマンドは失敗となります。これらの変数はシナリオで宣言してください。

- Oracle Data Integratorの順序は、接続時および切断時のコマンドではサポートされていません。

接続時および切断時のコマンドには、次の使用方法があります。

- セッションが実行されると、データ・サーバーへの接続が開きます。コマンド「接続時」が定義されているデータ・サーバーで接続が開くたびに、「接続時のコマンド」と呼ばれる特定のステップの下にタスクが作成されます。このタスクには、接続の確立先となるデータ・サーバー、およびこのデータ・サーバーへの接続を作成するステップとタスクに基づいて名前が設定されます。このタスクには、接続時のコマンドのコードが格納されます。

- セッションが完了すると、データ・サーバーへの接続はすべてクローズされます。切断時のコマンドが定義されているデータ・サーバーで接続がクローズされるたびに、「切断時のコマンド」という特定のステップにタスクが作成されます。このタスクには、切断されるデータ・サーバー、およびこのデータ・サーバーへの接続を切り離したステップとタスクに基づいて名前が設定されます。これには、切断時のコマンドのコードが格納されます。

- ODI StudioまたはODIコンソールで行われる操作が、データベース・サーバーへの接続を必要とする場合(データの表示、テスト接続など)、このコマンドに「クライアント・トランザクション」を選択すると、接続時/切断時のコマンドも実行されます。

注意:
オペレータ・ナビゲータに接続時および切断時ステップを表示するかどうかを指定できます。ユーザー・パラメータ「接続時および切断時ステップを非表示」をYesに設定すると、接続時および切断時ステップは表示されません。

接続時または切断時のコマンドを設定するには:

1. データ・サーバー・エディタの「接続/切断時」タブで、「接続時」セクションまたは「切断時」セクションの「式エディタを起動します」をクリックします。

2. 式エディタで、SQLコマンドを入力します。

注意:
式エディタには、データ・サーバーのテクノロジで使用可能な置換メソッドとキーワードのみが表示されます。グローバル変数が表示されるのは、作業リポジトリへの接続が使用できる場合のみであることに注意してください。

3. 「OK」をクリックします。「コマンド」フィールドにSQLコマンドが表示されます。

4. オプションで、コマンドの実行後に接続をコミットする場合は「コミット」を選択します。「実行」リストで「自動コミット」または「クライアント・トランザクション」が選択されている場合、この値は無視されます。

5. オプションで、コマンド実行時に発生した例外を無視する場合は、「エラーの無視」を選択します。「エラーの無視」が選択されていない場合、コール操作はエラー・ステータスで終了します。セッションの途中で失敗となった、「エラーの無視」が選択されているコマンドは、警告状態のタスクとして表示されます。

6. 「ログ・レベル」リストから、接続または切断コマンドのログ・レベル(1から6)を選択します。実行時には、コマンドのログ・レベルに基づいてコマンドをセッション・ログに保存できます。デフォルトは3です。

7. 「実行」リストから、コマンドを実行するトランザクションを選択します。

注意:
0から9のトランザクションおよび「自動コミット」トランザクションは、(プロシージャまたはナレッジ・モジュールによる)セッションで作成された接続に相当します。「クライアント・トランザクション」は、クライアント・コンポーネント(ODI ConsoleおよびStudio)に相当します。

すべてのトランザクションを選択または選択解除する場合は、「すべて選択」または「すべて選択解除」を選択できます。

8. 「ファイル」メニューから「保存」をクリックします。

接続をテストする準備が整いました。詳細は、「データ・サーバー接続のテスト」を参照してください。

3.1.2.4 データ・サーバー接続のテスト

トポロジの定義を続行する前に、データ・サーバー接続をテストすることをお薦めします。

データ・サーバーへの接続をテストするには:

1. トポロジ・ナビゲータで、「物理アーキテクチャ」ナビゲーション・ツリーの「テクノロジ」ノードを展開してから、データ・サーバーが含まれるテクノロジを展開します。

2. テストするデータ・サーバーをダブルクリックします。データ・サーバー・エディタが開きます。

3. 「テスト接続」をクリックします。
「テスト接続」ダイアログが表示されます。

4. テストを実行するエージェントを選択します。「ローカル(エージェントなし)」は、ローカル・ステーションが接続を試行することを示します。

5. 「詳細」をクリックし、データベースおよびJDBCドライバの特性および能力を取得します。

6. 「テスト」をクリックし、テストを起動します。

テストが機能した場合、「接続が正常に実行されました」というウィンドウが表示され、機能しない場合、エラー・ウィンドウが表示されます。接続失敗の原因の詳細を取得するには、このエラー・ウィンドウの「詳細」ボタンを使用します。

3.1.3 物理スキーマの作成

Oracle Data Integratorの物理スキーマは、次のスキーマのペアに相当します。

- (データ)スキーマ。ここで、Oracle Data Integratorはマッピングのソースおよびターゲット・データ構造を検索します。

- 作業スキーマ。ここで、Oracle Data Integratorはデータ・スキーマに含まれるソースおよびターゲットに関連付けられた一時作業データ構造を作成し、操作できます。

よく使用されるテクノロジの物理スキーマ作成方法の詳細は、『Oracle Data Integrator接続およびナレッジ・モジュール・ガイド』を参照してください。

物理スキーマを作成する前に、次の点に注意してください。

- テクノロジの中には、複数のスキーマをサポートしないものがあります。一部のテクノロジでは、1つのデータ・サーバーのスキーマが1つのみであるため、作業スキーマおよびデータ・スキーマを指定しません。

- 一部のテクノロジでは、一時構造の作成をサポートしていません。これらのテクノロジでは、作業スキーマは使用できません。

- 物理スキーマが関連付けられているデータ・サーバーで指定されたユーザーには、このデータ・サーバーに関連付けられたスキーマでの適切な権限が必要です。

- OWBテクノロジの物理スキーマでは、OWBワークスペースのみが表示され、選択可能になります。

物理スキーマを作成するには:

1. データ・サーバーを選択し、右クリックして「新規物理スキーマ」を選択します。物理スキーマ・エディタが表示されます。

2. テクノロジが複数のスキーマをサポートしている場合、次の操作を行います。

1. ...(スキーマ)で、このData Integrator物理スキーマについてデータ・スキーマを選択または入力します。テクノロジがスキーマ・リストをサポートしている場合、スキーマのリストが表示されます。

2. ...(作業スキーマ)で、このData Integrator物理スキーマについて作業スキーマを選択または入力します。テクノロジがスキーマ・リストをサポートしている場合、スキーマのリストが表示されます。

3. このスキーマをこのデータ・サーバーのデフォルト・スキーマにする場合は、「デフォルト」ボックスを選択します(最初の物理スキーマが常にデフォルト・スキーマとなります)。

4. 「コンテキスト」タブに移動します。

5. 「追加」をクリックします。

6. この新規物理スキーマに対して、コンテキストおよび既存の論理スキーマを選択します。
このテクノロジの論理スキーマが存在しない場合、このエディタから作成できます。

論理スキーマを作成するには:

1. 左側の列で既存のコンテキストを選択します。

2. 右側の列で論理スキーマ名を入力します。
このエディタを保存する際に、この論理スキーマは自動的に作成され、このコンテキスト内のこの物理スキーマに関連付けられます。

7. 「ファイル」メニューから「保存」をクリックします。

3.1.4 論理スキーマの作成

論理スキーマを作成するには:

1. トポロジ・ナビゲータで、「論理アーキテクチャ」ナビゲーション・ツリーにある「テクノロジ」ノードを展開します。

2. 論理スキーマを関連付けるテクノロジを選択します。

3. 右クリックして「新規論理スキーマ」を選択します。

4. 「スキーマ名」を入力します。

5. 左側の列の各コンテキストについて、右側の列で既存の物理スキーマを選択します。この物理スキーマはこのコンテキストの論理スキーマと自動的に関連付けられます。必要なすべてのコンテキストについてこの操作を繰り返します。

6. 「ファイル」メニューから「保存」をクリックします。

3.1.5 物理エージェントの作成

物理エージェントを作成するには:

1. トポロジ・ナビゲータで、「物理アーキテクチャ」ナビゲーション・ツリーにある「エージェント」ノードを右クリックします。

2. 「新規エージェント」を選択します。

3. 次の各フィールドに値を入力します。

- 名前: Javaグラフィカル・インタフェースで使用されるエージェントの名前。

注意:
Internalというエージェント名は使用しないでください。Oracle Data Integratorでは、内部エージェントを使用してセッションを実行するときに「内部」エージェントを使用するため、「内部」というエージェント名は予約されています。

- ホスト: エージェントが起動されるマシンのネットワーク名またはIPアドレス。

- ポート: エージェントで使用されるリスニング・ポート。デフォルトでは、このポートは20910です。

- Webアプリケーション・コンテキスト: アプリケーション・サーバーにデプロイされたJava EEエージェントに対応するWebアプリケーションの名前。スタンドアロン・エージェントおよびスタンドアロン・コロケート・エージェントの場合、このフィールドはoraclediagentに設定する必要があります。

- 「プロトコル」はエージェント接続に使用するプロトコルです。使用可能な値は、httpまたはhttpsです。デフォルトはhttpです。

- このエージェントでサポートされる最大セッション数。

- スレッドの最大数: ODIエージェントが任意の時点で使用できる最大スレッド数を制御します。お使いのシステム・リソースおよびCPUの容量にあわせて調整してください。

- セッション当たりの最大スレッド数: ODIでは複数のスレッドを持つセッションの実行をサポートしています。この値は、単一セッション実行時の最大並列度を制限します。

- セッション・ブループリント・キャッシュ管理:

- 最大キャッシュ・エントリ: パフォーマンスの場合、セッション・ブループリントはキャッシュされます。このパラメータを調整して、ブループリント・キャッシュによるJVMメモリー消費を制御します。

- 未使用ブループリント・ライフタイム(秒): キャッシュからブループリントをフラッシュするためのアイドル時間間隔。

4. ロード・バランシングを設定する場合、「ロード・バランシング」タブに移動し、現在のエージェントが実行を委任できるリンク済物理エージェントのセットを選択します。詳細は、「ロード・バランシングの設定」を参照してください。

5. エージェントが起動されている場合、「テスト」をクリックします。「接続に成功」ダイアログが表示されます。

6. 「はい」をクリックします。

3.1.6 論理エージェントの作成

論理エージェントを作成するには:

1. トポロジ・ナビゲータで、「論理アーキテクチャ」ナビゲーション・ツリーにある「エージェント」ノードを右クリックします。

2. 「新規論理エージェント」を選択します。

3. 「エージェント名」を入力します。

4. 左側の列の各コンテキストについて、右側の列で既存の物理エージェントを選択します。この物理エージェントはこのコンテキストの論理エージェントと自動的に関連付けられます。必要なすべてのコンテキストについてこの操作を繰り返します。

5. 「ファイル」メニューから「保存」をクリックします。

3.2 ビッグ・データの使用

Oracle Data Integratorを使用すると、ビッグ・データの統合、Oozieワークフローのデプロイと実行、およびPig LatinやSparkなどの言語でのコードの生成を行うことができます。

次のステップは、ビッグ・データを使用するためのトポロジを設定するためのガイドラインです。

表3-1 ビッグ・データの使用

タスク

ドキュメント

Hadoopデータを統合する環境の設定

『Oracle Data Integratorとのビッグ・データの統合』のHadoopデータを統合するための環境の設定に関する項を参照してください。

Hive、HDFSおよびHBaseなどのビッグ・データ・テクノロジ用のデータ・サーバーの設定

『Oracle Data Integratorとのビッグ・データの統合』の次の各項を参照してください。

ファイル・データソースの設定

Hiveデータソースの設定

HBaseデータソースの設定

Oracle Data Integrator内でOozieワークフローを実行するためのOozieエンジンの設定

『Oracle Data Integratorとのビッグ・データの統合』のOozieランタイム・エンジンの設定および初期化に関する項を参照してください。

Pig LatinおよびSparkコードを生成するためのHive、PigおよびSparkトポロジ・オブジェクトの設定

『Oracle Data Integratorとのビッグ・データの統合』の次の各項を参照してください。

Hiveデータ・サーバーの設定

Hive物理スキーマの作成

Pigデータ・サーバーの設定

Pig物理スキーマの作成

Sparkデータ・サーバーの設定

Spark物理スキーマの作成

3.3 エージェントの管理

この項では、スタンドアロン・エージェント、スタンドアロン・コロケート・エージェントおよびJava EEエージェントの使用方法と、ロード・バランシングの処理方法について説明します。Oracle Data Integratorエージェントの詳細は、『Oracle Data Integratorの理解』のランタイム・エージェントに関する項および『Oracle Data Integratorのインストールと構成』のOracle Data Integratorエージェントの理解に関する項を参照してください。

3.3.1 スタンドアロン・エージェント

スタンドアロン・エージェントの管理では、次の各項で説明するアクションを実行します。

- スタンドアロン・エージェントの構成

- スタンドアロン・エージェントの開始

- エージェントの停止

注意:
この項で説明するタスクの実行に必要なエージェント・コマンド行スクリプトは、Oracle Data Integratorスタンドアロン・エージェントがインストールされている場合のみ使用できます。スタンドアロン・エージェントのインストール方法の詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

3.3.1.1 スタンドアロン・エージェントの構成

スタンドアロン・エージェントの構成については、『Oracle Data Integratorのインストールと構成』に説明があります。次を参照してください。

- 「Oracle Data Integratorのインストール」

- 「Oracle Data Integratorマスターおよび作業リポジトリ・スキーマの作成」

- 「スタンドアロン・エージェントのドメインの構成」

3.3.1.2 スタンドアロン・エージェントの開始

スタンドアロン・エージェントは、事前定義済のスケジュールどおりに、または要求に応じて、シナリオを実行できます。スタンドアロン・エージェントを起動する手順は、『Oracle Data Integratorのインストールと構成』のノード・マネージャを使用したスタンドアロン・エージェントの起動に関する項を参照してください。

3.3.1.3 エージェントの停止

スタンドアロン・エージェントを停止する手順は、『Oracle Data Integratorのインストールと構成』のOracle Data Integratorエージェントの停止に関する項を参照してください。

3.3.2 スタンドアロン・コロケート・エージェント

スタンドアロン・コロケート・エージェントの管理では、次の各項で説明するアクションを実行します。

- スタンドアロン・コロケート・エージェントの構成

- スタンドアロン・コロケート・エージェントの起動

- エージェントの停止

注意:
スタンドアロン・コロケート・エージェントは、WebLogicドメイン内に構成されて管理サーバーにより管理されるスタンドアロン・エージェントです。WebLogicドメインでは、Oracle Fusion Middleware Infrastructureのサービスをエージェントの管理に使用できます。詳細は、『Oracle Data Integratorのインストールと構成』のスタンドアロン・コロケート・エージェントの標準インストール・トポロジの理解に関する項を参照してください。

3.3.2.1 スタンドアロン・コロケート・エージェントの構成

スタンドアロン・コロケート・エージェントの構成については、『Oracle Data Integratorのインストールと構成』に説明があります。次を参照してください。

- 「Oracle Data Integratorのインストール」

- 「Oracle Data Integratorマスターおよび作業リポジトリ・スキーマの作成」

- 「スタンドアロン・コロケート・エージェントのドメインの構成」

3.3.2.2 スタンドアロン・コロケート・エージェントの起動

スタンドアロン・コロケート・エージェントを起動する手順は、『Oracle Data Integratorのインストールと構成』のスタンドアロン・コロケート・エージェントの起動に関する項を参照してください。

3.3.2.3 エージェントの停止

スタンドアロン・コロケート・エージェントを停止する手順は、『Oracle Data Integratorのインストールと構成』のOracle Data Integratorエージェントの停止に関する項を参照してください。

3.3.3 Java EEエージェント

Java EEエージェントの管理は、次の各項で説明するアクションを伴います。

- Java EEアプリケーション・サーバーでのエージェントのデプロイ

- Java EEエージェント用のサーバー・テンプレートの作成

- エージェントのアプリケーション・サーバーにおけるOracle Data Integratorからのデータソースのデプロイ

3.3.3.1 Java EEアプリケーション・サーバーでのエージェントのデプロイ

Java EEエージェントの構成については、『Oracle Data Integratorのインストールと構成』に説明があります。次を参照してください。

- 「Oracle Data Integratorのインストール」

- 「Oracle Data Integratorマスターおよび作業リポジトリ・スキーマの作成」

- 「Java EEエージェントのドメインの構成」

3.3.3.2 Java EEエージェント用のサーバー・テンプレートの作成

Oracle Data Integratorでは、ランタイム・エージェント用のサーバー・テンプレートの作成に役立つサーバー・テンプレート生成ウィザードが用意されています。

サーバー・テンプレート生成ウィザードを開くには:

1. 物理エージェント・エディタのツールバー・メニューから、「サーバー・テンプレートの生成」を選択します。これにより、図3-1に示すテンプレート生成ウィザードが開始されます。

図3-1 サーバー・テンプレート生成ウィザード - 「エージェント情報」タブ

2. 「エージェント情報」タブで、エージェント情報を確認し、必要に応じてデフォルト構成を変更します。
「エージェント情報」には次のパラメータが含まれます。

- 一般
エージェント名: デプロイするエージェントの名前が表示されます。

- マスター・リポジトリ接続
データソースJNDI名: マスター・リポジトリに接続するためにJava EEエージェントで使用されるデータソースの名前。テンプレートには、このデータソースの定義を含めることができます。デフォルトはjdbc/odiMasterRepositoryです。

- 接続の再試行設定
接続の再試行回数: エージェントによるリポジトリへの接続が切断された場合の再試行回数。ODIリポジトリがOracle RACデータベースに存在する場合、このパラメータをゼロ以外の値に設定すると、高可用性接続再試行機能が有効になります。この機能が有効である場合、1つ以上のOracle RACノードが使用不可になっても、エージェントは中断もなく引き続きセッションを実行できます。

再試行の遅延(ミリ秒): 各接続再試行の間隔(ミリ秒)。

- スーパーバイザ認証
スーパーバイザ・キー: スーパーバイザ権限を持つODIユーザーのログインおよびパスワードが含まれるアプリケーション・サーバー資格証明ストアのキーの名前。このエージェントはこのユーザー資格証明を使用してリポジトリに接続します。

3. 「次」をクリックします。図3-2に示すような「ライブラリおよびドライバ」タブが表示されます。

図3-2 サーバー・テンプレート生成ウィザード - 「ライブラリおよびドライバ」タブ

4. 「ライブラリおよびドライバ」タブで、このエージェントとともにデプロイする外部ライブラリおよびドライバをリストから選択します。ユーザーが追加したライブラリのみがここに表示されます。
ライブラリは、このエージェントに必要なJARファイルまたはZIPファイルとなる点に注意してください。ソースおよびターゲット・データ・サーバーにアクセスするための追加JDBCドライバまたはライブラリをここで選択する必要があります。

また、「タイプ」列で、「ドメイン」ライブラリまたは「共有」ライブラリを選択することもできます。「ドメイン」を選択すると、各JARがシステム・クラス・パスの一部として追加されて、そのドメイン内のすべてのアプリケーションで表示できるようになります。「共有」を選択した場合、JARをデプロイ時に選択して共有ライブラリにすることができます。JARを共有ライブラリとして選択した場合、「名前」列が有効になり、JARファイルの参照名(MANIFESTファイルでExtension-Name属性に対して指定されている名前)が表示されます。JARファイルに参照名がない場合、選択した共有ライブラリはODI Studioで指定されている名前でWebLogic Serverにデプロイされるため、「名前」列に一意の名前を追加する必要があります。

注意:
「共有」タイプには、必ず「OpenTool JAR」を選択してください。また、共有として選択したJARは、共有ライブラリとして手動でWeblogic Serverにデプロイする必要があります。これにより、これらのJARはアプリケーション・クラス・パスの一部として追加されます。

ツールバーの対応するボタンを使用して、リスト内のすべてのライブラリまたはドライバ(あるいはその両方)を選択または選択解除できます。

5. 「次」をクリックします。図3-3に示すような「データソース」タブが表示されます。

図3-3 サーバー・テンプレート生成ウィザード - 「データソース」タブ

6. 「データソース」タブで、このエージェント・テンプレートに含めるデータソース定義を選択します。ウィザードからはデータソースの選択のみ可能です。これらのデータソースの命名および追加は、物理エージェント・エディタの「データソース」タブで行います。

7. 「次」をクリックします。図3-4に示すような「テンプレート・ターゲットおよびサマリー」タブが表示されます。

図3-4 サーバー・テンプレート生成ウィザード - 「テンプレート・ターゲットおよびサマリー」タブ

8. 「テンプレート・ターゲットおよびサマリー」タブで、サーバー・テンプレートが生成される「ターゲット・テンプレート・パス」を入力します。

9. 「終了」をクリックしてウィザードを閉じ、サーバー・テンプレートを生成します。
「テンプレート生成情報」ダイアログが表示されます。

10. 「OK」をクリックし、ダイアログを閉じます。

生成されたテンプレートは、それぞれの構成ウィザードを使用したWLSまたはWASでのエージェントのデプロイに使用できます。詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

資格証明ストアでのスーパーバイザの宣言

テンプレートのデプロイ後、スーパーバイザをWLSまたはWAS資格証明ストアに宣言する必要があります。詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

3.3.3.3 エージェントのアプリケーション・サーバーにおけるOracle Data Integratorからのデータソースのデプロイ

トポロジ・ナビゲータから、Java EEエージェントを構成するアプリケーション・サーバーにデータソースをデプロイできます。データソースはOracle WebLogic Serverにのみデプロイできます。

アプリケーション・サーバーでデータソースをデプロイするには:

1. データソースをデプロイするアプリケーション・サーバー用に構成された物理エージェント・エディタを開きます。

2. 「データソース」タブに移動します。

3. ソース/ターゲット・データ・サーバーを、トポロジ・ナビゲータの「物理アーキテクチャ」ツリーから「データソース」タブにドラッグ・アンド・ドロップします。

4. これらのデータソースの「JNDI名」を指定します。

5. いずれかのデータソースを右クリックし、「サーバーにおけるデータソースのデプロイ」を選択します。

6. 「データソース・デプロイ」ダイアログで、データソースをデプロイするサーバーを選択します。使用可能な値は、WLSまたはWASサーバーです。

7. 「デプロイメント・サーバー詳細」セクションで、次の各フィールドに入力します。

- ホスト: アプリケーション・サーバーのホスト名またはIPアドレス。

- ポート: デプロイメント・マネージャのブートストラップ・ポート。

- ユーザー: サーバーのユーザー名。

- パスワード: このユーザーのパスワード。

8. 「データソース・デプロイ」セクションで、データソースをデプロイするサーバーの名前(たとえばodi_server1)を指定します。

9. 「OK」をクリックします。

注意:
この操作では、Oracle WebLogic Serverにデータソース定義が作成されるのみです。これらのデータソースが機能するために必要なドライバ・ファイルまたはライブラリ・ファイルはインストールされません。Studioクラスパスに追加されたドライバはエージェント・テンプレートに含めることができます。詳細は、「Java EEエージェント用のサーバー・テンプレートの作成」を参照してください。

WLSデータソース構成および使用方法

WebLogic ServerでOracle Data Integrator用にデータソースを設定する場合、次の点に注意してください。

- データソースは、接続プール構成で「文キャッシュ・サイズ」パラメータを0に設定して作成する必要があります。文キャッシュはデータ統合のパフォーマンスに若干の影響を及ぼし、一部のJDBCドライバでデータの切捨てなどの予期しない結果を招く可能性があります。

- 接続プーリングをデータソースで使用する場合、プロシージャおよびナレッジ・モジュールでALTER SESSION文を使用しないことをお薦めします。接続でALTER SESSION文が必要な場合は、変更された接続が使用後に接続プールに戻されるため、関連データソースでの接続プーリングを無効化することをお薦めします。

3.3.4 エージェントのロード・バランシング

Oracle Data Integratorでは、物理エージェント間でパラレル・セッション実行のロード・バランシングを実行できます。

各物理エージェントは次で定義されます:

- 作業リポジトリから同時に実行できる最大セッション数。
最大セッション数の値は、エージェントが動作するマシンの能力に応じて設定する必要があります。また、Oracle Data Integratorエージェントに対して指定する処理能力に応じて設定することもできます。

- オプションで、セッションの実行を委任できるリンク先物理エージェントの数

エージェントの負荷は、指定時間にこのエージェントの比率(実行中のセッション数 / セッションの最大数)で決定されます。

3.3.4.1 セッションの委任

リンク先エージェントを持つエージェントでセッションが開始されると、Oracle Data Integratorでは負荷のより少ないリンク先エージェントが判別され、このリンク先エージェントにセッションが委任されます。

エージェントは、他のエージェントにすべての着信セッションを委任するのではなく、自身にリンクして一部の着信セッションを実行できます。自身にリンクしていないエージェントは、リンク先エージェントへのセッションの委任のみが可能であり、セッションの実行は不可である点に注意してください。

委任はリンク先エージェントの階層内でカスケードします。エージェントAにエージェントB1およびB2がリンクされており、エージェントB1にエージェントC1がリンクされている場合、エージェントAで開始したセッションはエージェントB2またはC1により実行されます。エージェント・リンクをループさせないようにすることをお薦めします。

ユーザー・パラメータ「新しいロード・バランシングの使用」がはいに設定されている場合、セッション終了ごとにセッションのロード・バランシングも再実行されます。これは、エージェントがセッションを終了した場合、すでに別のエージェントに割り当てられているセッションが再割当される可能性があることを意味します。

3.3.4.2 エージェント使用不可

指定のエージェントについて、実行中のセッション数が最大セッション数に到達した場合、そのエージェントは実行中のセッション数が最大セッション数を下回るまで、着信セッションを「キュー」ステータスにします。

エージェントが(クラッシュしたなどで)使用できず、ユーザー・パラメータ「新しいロード・バランシングの使用」が「はい」に設定されている場合、キュー内のセッションはすべて、セッションを実行しておらずキューにセッションがない別のロード・バランシング済エージェントに再割当されます。

3.3.4.3 ロード・バランシングの設定

ロード・バランシングを設定するには:

1. 物理エージェントのセットを定義し、これらをエージェントの階層にリンクします(詳細は、「物理エージェントの作成」を参照してください)。

2. トポロジで定義されたエージェントに対応する物理エージェントをすべて開始します。

3. 階層のルート・エージェントで実行を開始します。Oracle Data Integratorにより、リンク先エージェント間で実行のロード・バランシングが行われます。

3.4 高可用性トポロジの設定手順

この項では、高可用性トポロジを設定するために実行する必要のある高度な手順について説明します。

表3-2 高可用性トポロジの設定手順

タスク

ドキュメント

1. Real Application Clustersのインストール

詳細は、『Oracle Real Application Clusters管理およびデプロイメント・ガイド』を参照してください。

2. ミドルウェア・コンポーネントのインストール

Oracle Fusion Middlewareインフラストラクチャのインストールおよび構成を参照してください。

3. Oracle RACへのリポジトリ接続の構成

高可用性ガイドのOracle RACへのリポジトリ接続の構成に関する項を参照してください。

4. Oracle HTTP Serverのインストール

『Oracle HTTP Serverのインストールと構成』を参照してください。

5. ロード・バランサの構成

高可用性ガイドのロード・バランサの構成に関する項および高可用性環境におけるサーバーのロード・バランシングに関する項を参照してください。

6. トポロジのスケール・アウト(マシンのスケール・アウト)

高可用性ガイドのトポロジのスケール・アウト(マシンのスケール・アウト)に関する項を参照してください。

7. 高可用性ドメインの作成

高可用性ガイドのOracle RACでのアクティブなGridLinkデータソースの構成に関する項を参照してください。

8. 管理サーバーの高可用性の構成

高可用性ガイドの管理サーバーの高可用性に関する項を参照してください。

9. エージェントの再構成

「エージェントの再構成」を参照してください。

3.4.1 エージェントの再構成

エージェント定義は、個々のサーバーのアドレスではなく、ロード・バランサのアドレスを指す必要があります。Oracle Data Integrator Studioに接続し、次に示すように、ロードバランサの「ホスト」および「ポート」プロパティを編集します。

1. ODI_HOME/oracledi/client/odi.shでOracle Data Integrator Studioを起動します。

2. Oracle Data Integrator Studioが起動したら、左側のペインで「リポジトリへの接続...」をクリックします。

3. ログイン・ウィンドウが表示されたら、「OK」をクリックしてログオンします。

4. 接続されたら、左側のペインで「物理アーキテクチャ」セクションを開きます。

5. 「エージェント」を選択し、「OracleDIAgent」を選択します。

6. 次のプロパティを編集します。
- ホスト: ロード・バランサの仮想サーバー・アドレス。

- ポート: ロード・バランサの仮想アドレスのリスニング・ポート。

7. 「テスト」をクリックして、エージェントの接続をテストします。

8. 変更内容を保存して、Oracle Data Integrator Studioを終了します。

第II部

データ・サービスの作成および使用

この部では、Oracle Data Integratorを使用してデータ・サービスを構成および生成する方法について説明します。

この部の構成は、次のとおりです。

- 第4章「データ・サービスの設定」

- 第5章「データ・サービスの生成およびデプロイ」

4 データ・サービスの設定

この章では、Oracle Data Integratorを使用してデータ・サービスを構成する方法について説明します。データ・サービスを使用すると、Webサービス・インタフェースを介してデータにアクセスできます。また、データ・サービスを使用すると、Oracle Data Integratorのチェンジ・データ・キャプチャ機能を使用して取得した変更にアクセスすることもできます。チェンジ・データ・キャプチャの詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の「ジャーナル化の使用」を参照してください。

この章の内容は次のとおりです。

- データ・サービスの設定

関連項目:
『Oracle Data Integratorでの統合プロジェクトの開発』の「Webサービスの使用」を参照してください。

4.1 データ・サービスの設定

データ・サービスは、Webサービス・コンテナ(Webサービス・スタックがインストールされているアプリケーション・サーバー)にデプロイします。このWebサービス・コンテナは、JAX-WSテクノロジに関連付けられたトポロジにデータ・サーバー形式で宣言する必要があります。

データ・サービスをアプリケーション・サーバーにデプロイする際は、そのアプリケーション・サーバーのデータにアクセスするために、データ・ソースもトポロジに定義してデプロイするか、そのアプリケーション・サーバーに作成する必要があります。

データ・サービスを設定するには、次の各項で説明する手順を実行します。

- Webサービス・コンテナの構成

- データ・ソースの設定

- モデルの構成

4.1.1 Webサービス・コンテナの構成

Oracle Data Integratorでデータ・サービスをWebサービス・コンテナにデプロイするには、そのWebサービス・コンテナをトポロジ内でデータ・サーバーとして宣言する必要があります。

注意:
Webサービス・コンテナとデータを格納するサーバーを混同しないように注意してください。どちらもOracle Data Integratorではデータ・サーバーとして宣言されますが、前者はデータを格納しません。それらはデータ・サービスを公開する目的にのみ使用されます。

Oracle Data Integratorで宣言されたWebサービス・コンテナでは、次の3つのモードのいずれかを使用してWebサービスをデプロイします。

- ファイルをサーバーに直接コピーします(サーバーに対するファイル・アクセス権がある場合)。

- FTPを使用してサーバーにアップロードします。

Webサービス・コンテナを構成するための次の手順は、使用するWebサービス・コンテナのタイプおよびデプロイ・モードによって異なります。

Webサービス・コンテナを構成するには:

1. トポロジ・ナビゲータで、「物理アーキテクチャ」パネルの「テクノロジ」ノードを展開します。

2. 「JAX-WS」テクノロジを右クリックして、「新規データ・サーバー」を選択します。

3. 「定義」タブで、次のフィールドに値を入力します:

- 名前: Oracle Data Integratorに表示されるデータ・サーバーの名前。
データ・サーバーの名前を付ける場合は、命名標準の<TECHNOLOGY_NAME>_<SERVER_NAME>を使用することをお薦めします。

- 公開されたサービスのベースURL: Webサービスを使用できるベースURLを入力します。Oracle WebLogic Serverの場合は、http://<host>:<HTTP Port>/です。

4. 次のいずれかのデプロイ・オプションを選択します。

- Webサービスをディレクトリへ保存: Webサービスを作成するディレクトリ。Webサービスを個別にコンテナにデプロイする場合は、アプリケーション・サーバー上のネットワーク・ディレクトリまたはローカル・ディレクトリを使用できます。

- WebサービスをFTPによりアップロード: 生成されたWebサービスをコンテナにアップロードする場合にこのオプションを選択します。アップロード操作を実行するには、「FTP URL」、および「ユーザー名」と「パスワード」を入力する必要があります。

5. 「ファイル」メニューから「保存」をクリックします。データ・サーバーが物理アーキテクチャに表示されます。

6. このデータ・サーバーを選択し、右クリックして「新規物理スキーマ」を選択します。新しい物理スキーマ・エディタが表示されます。「コンテキスト」タブで、コンテキストを使用して新規の物理スキーマを既存の論理スキーマに関連付けます。最初に、JAX-WSテクノロジの新規論理スキーマを作成する必要があることがあります。論理スキーマを作成する手順は、「トポロジの設定」を参照してください。

7. 「ファイル」メニューから「保存」をクリックします。

必要なことは、Webコンテナの物理スキーマを1つ構成することです。デプロイするコンテナの条件をコンテキストで設定するため、ここでは論理スキーマ/コンテキスト/物理スキーマの関連付けが重要です。

4.1.2 データ・ソースの設定

Oracle Data Integratorで生成するデータ・サービスには、ソースおよびターゲットの接続情報が含まれていません。かわりに、データ・サービスは、Webサービス・コンテナ内またはアプリケーション・サーバー上に定義されているデータ・ソースを使用します。これらのデータ・ソースには、データへのアクセスに必要な接続プロパティが含まれています。各データ・ソースは、Oracle Data Integratorトポロジ内にすでに定義されているデータ・サーバーに対応している必要があります。

データ・ソースを設定するには、次のいずれかを実行します。

- アプリケーション・サーバー・コンソールからデータ・ソースを構成します。詳細は、アプリケーション・サーバーのドキュメントを参照してください。

- コンテナがOracle WebLogic Serverの場合は、Oracle Data Integratorからデータ・ソースをデプロイします。データソースのデプロイの詳細は、「トポロジの設定」を参照してください。

4.1.3 モデルの構成

データ・サービスを構成するには、最初にモデルを作成して移入する必要があります。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の「データ・モデルおよびデータストアの作成および使用」を参照してください。

適切なサービス・ナレッジ・モジュール(SKM)をプロジェクトの1つにインポートしておく必要があります。SKMには、データ・サービスを生成するコード・テンプレートが含まれています。KMのインポートの詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の「統合プロジェクトの作成」を参照してください。

データ・サービスのモデルを構成するには:

1. デザイナ・ナビゲータの「モデル」ツリーで、モデルを選択します。

2. そのモデルをダブルクリックし、編集します。

3. 「サービス」タブで、次の各フィールドに値を入力します。

- アプリケーション・サーバー: すでに定義したコンテナに対応する論理スキーマを選択します。

- ネームスペース: WebサービスWSDLで使用するネームスペースを入力します。

- パッケージ名: Webサービスを格納するために生成するJavaパッケージの名前。通常、この名前の形式はcom.<company name>.<project name>です。

- データソースの名前: コンテナに定義されている名前。使用するアプリケーション・サーバーに応じて、データ・ソースはローカルまたはグローバルになります。

- データ・ソースがグローバルの場合は、「データソース名」フィールドにデータ・ソース名のみ入力する必要があります。

- データ・ソースがローカルの場合は、データ・ソース名の前にjava:/comp/env/を付ける必要があります。

OC4Jはデフォルトでグローバル・データ・ソースを使用し、Tomcatはローカル・データ・ソースを使用します。詳細は、アプリケーション・サーバーのドキュメントを参照してください。

- データ・サービスの名前: この名前は、モデル・レベルでのデータ・サービス操作に使用されます。後でデータストアごとにデータ・サービス名を定義することもできます。

4. リストからサービス・ナレッジ・モジュール(SKM)を選択し、そのオプションを設定します。このKMとそのオプションの詳細は、『Oracle Data Integrator接続およびナレッジ・モジュール・ガイド』を参照してください。プロジェクトにインポートされたSKMのみがこのリストに表示されます。

5. 「デプロイ済データストア」タブに移動します。

6. データ・サービスとともに公開するすべてのデータストアを選択します。データストアごとに、「データ・サービス名」および「公開済エンティティ」の名前を入力します。

7. 「ファイル」メニューから「保存」をクリックします。

必要に応じて、生成されたデータ・サービスの構成をデータストア・レベルおよび属性レベルで微調整することもできます。

たとえば、許可する操作を属性ごとに指定できます。これの重要な用途の1つは、データ・サービスを介した属性に対する書込みをロックすることです。

データ・サービス・オプションをデータストア・レベルで構成するには:

1. デザイナ・ナビゲータの「モデル」ツリーで、データストアを選択します。

2. このデータストアをダブルクリックし、編集します。

3. 「サービス」タブを選択します。

4. データストアをデプロイする場合は、「データ・サービスとしてデプロイ」を選択します。

5. データストアの「データ・サービス名」および「公開済エンティティ」の名前を入力します。

6. 「ファイル」メニューから「保存」をクリックします。

データ・サービス・オプションを属性レベルで構成するには:

1. デザイナ・ナビゲータの「モデル」ツリーで、属性を選択します。

2. この属性をダブルクリックして、編集します。

3. 「サービス」タブを選択します。

4. 許可する操作を「選択」、「挿入」、「削除」から選択します。「挿入」アクションには、「更新」アクションが含まれます。

5. 「ファイル」メニューから「保存」をクリックします。

5 データ・サービスの生成およびデプロイ

この章では、Oracle Data Integratorを使用してデータ・サービスを生成およびデプロイする方法について説明します。

この章の内容は次のとおりです。

- データ・サービスの生成およびデプロイ

- 生成サービスの概要

- データ・サービスのテスト

5.1 データ・サービスの生成およびデプロイ

モデル、データ・ソースおよびコンテナを構成した後は、データ・サービスを生成してデプロイできます。モデルにデータ・サービスを生成すると、モデル・レベルのデータ・サービスおよび選択したデータストアのデータ・サービスがモデルに生成されます。

モデルにデータ・サービスを生成するには:

1. デザイナ・ナビゲータの「モデル」ツリーで、モデルを選択します。

2. 右クリックして「サービスの生成」を選択します。「データ・サービスを生成中」ウィンドウが開きます。

3. 「データ・サービスを生成中」ウィンドウで、次の各フィールドに値を入力します。

- 生成されたデータ・サービスを格納: 生成されたソース・コードおよびコンパイルされたWebサービスがここに配置されます。このディレクトリは、生成後に削除できる一時的な場所です。データ・サービスに対して生成されたソース・コードをここで確認できます。

- コンテキスト: データ・サービスを生成してデプロイするコンテキスト。このコンテキストの選択は、次の3つに影響します。

- 生成時のJDBC/Javaデータ型バインディングの決定

- データの提供に使用される物理スキーマの決定

- デプロイ先の物理Webサービス・コンテナの決定

- 生成フェーズ: 1つ以上の生成フェーズを選択します。通常のデプロイでは、3つのフェーズすべてを選択する必要があります。ただし、新規のSKMをテストする場合などには、生成フェーズのみを実行すると便利です。各フェーズの意味は、次の表を参照してください。

4. 「OK」をクリックし、データ・サービスの生成およびデプロイを開始します。

フェーズ

説明

コードの生成

このフェーズは、次の操作を実行します。

- 生成ディレクトリの内容を削除します。

- SKMのコード・テンプレートを使用して、データ・サービスのJavaソース・コードを生成します。

コンパイル

このフェーズは、次の操作を実行します。

- Webサービス・フレームワークを抽出します。

- Javaソース・コードをコンパイルします。

デプロイメント

このフェーズは、次の操作を実行します。

- コンパイル・コードをパッケージ化します。

- コンテナに対して選択したデプロイ方法を使用して、パッケージをデプロイ・ターゲットにデプロイします。

5.2 生成サービスの概要

Oracle Data Integratorで生成されるデータ・サービスには、モデル・レベルのサービスとデータストア・レベルのサービスがあります。次に、これらのサービスについて説明します。

モデル・レベルのサービス

モデルが一貫性セットCDCに対応している場合、データ・サービスはモデル・レベルで生成されます。

モデル・レベルでは、次のサービスを使用できます。

- extend Window(パラメータなし): ウィンドウの拡張操作を実行します。

- lock(サブスクライバ名): 名前付きサブスクライバの一貫性セットをロックします。複数のサブスクライバの一貫性セットをロックするには、複数のOdiInvokeWebServiceステップを使用するなどして、このサービスを複数回コールします。

- unlock(サブスクライバ名): 名前付きサブスクライバの一貫性セットをロック解除します。

- purge(パラメータなし): 使用された変更をパージします。

これらの操作の詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の「ジャーナル化の使用」を参照してください。

データストア・レベルのサービス

生成された各データ・サービスによって提供される操作の範囲は、その生成に使用されたSKMに応じて異なります。Oracle Data Integratorに付属するSKMでは、複数の共通プロパティを共有しています。ほとんどの場合、公開されるエンティティの名前が各操作の名前の一部となります。次に、公開エンティティCustomerを使用した例を示します。

データストア・レベルでは、次の操作を使用できます。

- 単一のエンティティに対する操作。これらの操作では、主キーの値を指定することで単一のレコードを操作できます。新規行が存在する場合は、その行を記述する他のフィールドを指定する必要があります。例: addcustomer、getcustomer、deletecustomer、updatecustomer。

- フィルタで指定されたエンティティ・グループに対する操作。これらの操作では、1つまたは複数のフィールドの値を指定してフィルタを定義し、各行に追加された変更に対応する他の値をオプションで指定します。通常、戻される行の最大数も指定できます。例: getcustomerfilter、deletecustomerfilter、updatecustomerfilter。

- エンティティのリストに対する操作。このリストは、前述の単一のエンティティの場合と同様に、個々のエンティティを複数指定することで作成します。例: addcustomerlist、deletecustomerlist、getcustomerlist、updatecustomerlist。

5.3 データ・サービスのテスト

生成されたデータ・サービスをテストする最も簡単な方法は、OdiInvokeWebService Oracle Data Integratorツールのグラフィカル・インタフェースを使用することです。この件の詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の「Webサービスの使用」を参照してください。

第III部

統合プロセスの実行およびモニタリング

この部では、統合プロセスの実行方法とモニター方法について説明します。

この部の構成は、次のとおりです。

- 第6章「統合プロセスの実行」

- 第7章「統合プロセスのデバッグ」

- 第8章「統合プロセスのモニタリング」

- 第9章「Oracle Data Integratorコンソールの使用」

6 統合プロセスの実行

この章では、統合プロセスの実行方法とスケジュール方法について説明します。

この章には次の項が含まれます:

- ODI実行の理解

- マッピング、プロシージャ、パッケージおよびモデル操作の実行

- シナリオの実行

- セッションの再開

- セッションの停止

- ロード計画の実行

- ロード計画実行の再開

- ロード計画実行の停止

- シナリオとロード計画のスケジューリング

- 実行のシミュレーション

- Webサービスを使用した実行の管理

注意:
Hadoopクラスタ内での統合プロセスの実行およびスケジュール方法の詳細は、『Oracle Data Integratorとのビッグ・データの統合』を参照してください。

6.1 ODI実行の理解

実行は、Oracle Data Integratorで統合タスクの実行が必要な場合に発生します。この統合タスクは次のいずれかです。

- Oracle Data Integrator Studioから開始されたカスタマイズしたリバースエンジニアリング、ジャーナル化操作、静的チェックなど、モデル、サブモデルまたはデータストアに対する操作

- 通常はOracle Data Integrator Studioから開始されるマッピング、パッケージ、プロシージャなどの設計時オブジェクトの実行

- Oracle Data Integrator Studioまたはコマンド行から、あるいはスケジュールやWebサービス・インタフェースを介して起動されたランタイム・シナリオまたはロード計画の実行

Oracle Data Integratorでは、実行用のコードは、セッションの形式かロード計画を実行する場合はロード計画実行の形式で生成されます。

ランタイム・エージェントは、このコードを処理してソースとターゲットに接続し、データ統合を実行します。エージェントは、指定の実行コンテキストを使用して、これらのソースとターゲットを配置します。

Oracle Data Integrator Studioから実行が開始されると、「実行」ダイアログが表示されます。このダイアログには、表6-1にリストされている実行パラメータが表示されます。

表6-1 実行パラメータ

プロパティ

説明

コンテキスト

セッションが開始されるコンテキスト。

エージェント

マッピングを実行するエージェント。「ローカル(エージェントなし)」を選択することで、Oracle Data Integrator Studioに組み込まれているエージェントを使用して、オブジェクトを実行することもできます。

ログ・レベル

保持するロギング情報のレベル。この値以下のログ・レベルが定義されているすべてのセッション・タスクは、セッション完了時に、セッション・ログに保持されます。ただし、オブジェクトの実行が異常終了した場合は、この設定にかかわらず、すべてのタスクが保持されます。

ログ・レベル6は、ログ・レベル5と動作は同じですが、変数の追跡が追加されていることに注意してください。『Oracle Data Integratorでの統合プロジェクトの開発』の変数と順序の追跡に関する項を参照してください。

シミュレーション

実行をシミュレーションして実行レポートを作成する場合は、「シミュレーション」を選択します。詳細は、「実行のシミュレーション」を参照してください。

セッションのライフ・サイクル

この項では、セッションのライフ・サイクルについて説明します。ロード計画実行およびロード計画ライフ・サイクルの詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のロード計画の概要に関する項を参照してください。

セッションのライフ・サイクルは、次のとおりです。

1. 実行リクエストがエージェントに送信されるか、またはエージェントがスケジュールから実行をトリガーします。
設計時オブジェクト(マッピング、パッケージなど)に対してOracle Data Integrator Studioから実行がトリガーされた場合、Studioでは、リクエストの送信前に、作業リポジトリ内にセッションのコードが事前に生成されることに注意してください。実行がシナリオから開始された場合は、そのシナリオにすでに事前生成のコードが含まれているため、このフェーズは不要です。

2. エージェントはセッションに対するコードの生成を完了します。エージェントは用意されたコンテキストを使用して、データ・サーバー接続や完全修飾表名などの物理的な情報を解決します。生成されたコードは、「待機中」ステータスのセッションとして作業リポジトリに書き込まれます。

3. エージェントは、セッションの実行に必要なソース・データ・サーバーとターゲット・データ・サーバーへの接続を初期化します。

4. エージェントは実行リクエストを認識します。実行がStudio,から開始されている場合は、「セッションを開始しました」ダイアログが表示されます。

5. エージェントは、このセッションに含まれている各タスクを実行します。これには、セッションのタスクに含まれているコードを実行するデータベース・サーバー、オペレーティング・システムまたはスクリプト・エンジンの機能が使用されます。

6. セッションの処理中に、エージェントはリポジトリ内の実行ログを更新し、実行統計とエラー・メッセージをレポートします。
セッションが開始された後は、オペレータ・ナビゲータなどを使用してそのセッションをログでモニターできます。セッションのモニタリングの詳細は、「統合プロセスのモニタリング」を参照してください。

7. セッションが完了すると、タスクは、保存されるか、このセッションの開始時に指定したログ・レベルの値に従ってログから削除されます。

注意:
セッションは常に、一意のセッション番号(セッションID)によって識別されます。この番号はセッションをモニタリングしているときに表示できます。また、この番号はセッションの開始時にコマンド行またはWebサービス・インタフェースによっても戻されます。

コマンド行やWebサービスなどの他の場所から実行を開始するときは、同じ実行パラメータを指定して、同じ「セッションを開始しました」フィードバックを受信します。セッションがコマンド行またはWebサービス・インタフェースから同期で開始された場合、そのコマンド行またはWebサービスはセッションが完了するまで待機し、セッション・リターン・コードとエラー・メッセージ(ある場合)を提供します。

6.2 マッピング、プロシージャ、パッケージおよびモデル操作の実行

マッピング、プロシージャおよびパッケージは、Oracle Data Integrator Studioのデザイナ・ナビゲータから実行できる設計時オブジェクトです。

- マッピング実行の詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のマッピングの実行に関する項を参照してください。

- プロシージャ実行の詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のプロシージャの使用に関する項を参照してください。

- パッケージ実行の詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のパッケージの実行に関する項を参照してください。

- モデル操作の詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のモデルの作成およびリバースエンジニアリングに関する項、モデル内のデータ品質のチェックに関する項およびジャーナル化の設定に関する項を参照してください。

6.3 シナリオの実行

シナリオは複数の方法で実行できます。

- ODI Studioからのシナリオの実行

- コマンド行からのシナリオの実行

- Webサービスからの実行。詳細は、「Webサービスを使用したシナリオの実行」を参照してください。

- ODIコンソールからの操作。「シナリオおよびセッションの管理」を参照してください。

注意:
シナリオを実行する前に、シナリオをデザイナ・ナビゲータで生成するか、またはファイルからインポートする必要があります。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の「シナリオの使用」を参照してください。

6.3.1 ODI Studioからのシナリオの実行

シナリオは、Oracle Data Integrator Studioのデザイナ・ナビゲータまたはオペレータ・ナビゲータから開始できます。

Oracle Data Integrator Studioからシナリオを開始するには:

1. (デザイナ・ナビゲータの)「プロジェクト」ナビゲーション・ツリーまたは(オペレータ・ナビゲータの)「シナリオ」ナビゲーション・ツリーで、シナリオを選択します。

2. 右クリックして「実行」を選択します。

3. 「実行」ダイアログで実行パラメータを設定します。詳細は、表6-1を参照してください。Oracle Data Integrator Studioに組み込まれているエージェントを使用してシナリオを実行するには、「ローカル(エージェントなし)」を選択します。

4. 「OK」をクリックします。

5. シナリオでパラメータとして変数が使用されている場合は、「変数値」ダイログが表示されます。セッション変数の値を選択します。変数に対して「最新の値」を選択すると、その変数の現在値が使用され、使用可能な値がない場合は、デフォルト値が使用されます。

エージェントがセッションの処理を開始すると、「セッションを開始しました」ダイアログが表示されます。

注意:
シナリオを編集して、シナリオの同時実行を制限するかどうかを指定できます。また、同時シナリオをエラーで即時に終了するかどうかを指定したり、待機動作で実行の順番をチェックするためのポーリング頻度(秒)を指定することもできます。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のシナリオおよびロード計画の同時実行の制御に関する項を参照してください。

6.3.2 コマンド行からのシナリオの実行

シナリオはコマンド行から開始できます。

コマンド行からシナリオを実行する前に、次の要件を熟読してください:

- この項で説明するタスクの実行に必要なコマンド行スクリプトは、Oracle Data Integratorスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントがインストールされている場合のみ使用できます。スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントのインストール方法の詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- このコマンドを使用するには、リポジトリへの接続がドメインで構成されている必要があります。詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- コマンド行からシナリオを開始すると、デフォルトでは、セッションはリモートのランタイム・エージェントに対しては開始されませんが、コマンド行から開始されたローカルのJavaプロセスによって実行されます。このプロセスは、ローカルで中断できますが、実際のランタイム・エージェントではないため、セッション停止シグナルを受信できません。したがって、この方法で開始したセッションをリモートで停止することはできません。
このプロセスは、Oracle Data Integratorオペレータのログで「ローカル(エージェントなし)」で識別されます。この名前はNAMEパラメータを使用して変更できます。

ランタイム・エージェントに対してセッションを開始する場合は、AGENT_URLパラメータを使用する必要があります。

コマンド行からシナリオを開始するには:

1. Oracle Data Integratorドメインを作成し、エージェント・テンプレートを構成します。

- ODIスタンドアロン・インストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

- ODI Enterpriseインストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・コロケート・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

2. ディレクトリをOracle Data Integratorインストールの<DOMAIN_HOME>/bin/ディレクトリに変更します。

3. 次のコマンドを入力して、シナリオを開始します。
UNIXシステムの場合:

./startscen.sh -INSTANCE=<ODIInstanceName> <scenario_name> <scenario_version> <context_code> [<log_level>] [-AGENT_URL=<remote_agent_url>] [-ASYNC=yes|no] [-NAME=<local_agent_name>] [-SESSION_NAME=<session_name>] [-KEYWORDS=<keywords>] [<variable>=<value>]*

ODIInstanceNameは、このプロシージャのステップ1で構成されたインスタンスです。

Windowsシステムの場合:

startscen.cmd "-INSTANCE=<ODIInstanceName>" <scenario_name> <scenario_version> <context_code> [<log_level>] ["-AGENT_URL=<remote_agent_url>"]["-ASYNC=yes|no"] ["-NAME=<local_agent_name>"] ["-SESSION_NAME=<session_name>"] ["-KEYWORDS=<keywords>"] ["<variable>=<value>"]*

注意:
Windowsプラットフォームでは、等号(=)またはスペースを含むコマンド引数は、二重引用符で囲む必要があります。コマンド・コールは、UNIXのコマンド・コールとは異なる場合があります。例:
UNIXの場合

./startscen.sh -INSTANCE=OracleDIAgent1 PKG001 001 GLOBAL -SESSION_NAME=RUN1 -AGENT_URL=http://localhost:20910/oraclediagent

Windowsの場合

startscen.cmd "-INSTANCE=OracleDIAgent1" PKG001 001 GLOBAL "-SESSION_NAME=RUN1" "-AGENT_URL=http://localhost:20910/oraclediagent"

表6-2に、様々なパラメータ(必須とオプションの両方)を示します。パラメータの前にはハイフン(-)を、可能な値の前には等号(=)を付けます。この場合、コマンドを入力するオペレーティング・システムに固有の文字保護の構文に準拠する必要があります。

表6-2 Startscenコマンドのパラメータ

パラメータ

説明

-INSTANCE=<ODIInstanceName>

ドメインで構成されているODIインスタンスの名前。ODIインスタンスでは、シナリオを開始するために使用されるリポジトリ構成を定義します(必須)。

<scenario_name>

シナリオの名前(必須)。

<scenario_version>

シナリオのバージョン(必須)。指定したバージョンが-1の場合は、そのシナリオの最新バージョンが実行されます。

<context_code>

実行コンテキストのコード(必須)。

[<log_level>]

保持するロギング情報のレベル。

このパラメータの形式は<nで、<nは0から6までの必要なログ・レベルです。デフォルトのログ・レベルは5です。ログ・レベル6は、ログ・レベル5と動作は同じですが、変数の追跡が追加されていることに注意してください。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の変数と順序の追跡に関する項を参照してください。

例: startscen.cmd SCENAR 1 GLOBAL 5

[-AGENT_URL=<remote_agent_url>

このセッションを実行するランタイム・エージェントのURL。このパラメータを設定した場合、NAMEパラメータは無視されます。

一般的なエージェントURLの形式は<protocol>://<AgentHost>:<AgentPort>/<agentWebContext>です。

例: http://myhost:8001/oraclediagent、https://mySSLHost:8002/oraclediagent

[-ASYNC=yes|no]

リモート・エージェントの非同期実行には、Yesに設定します。ASYNCが使用されている場合、AGENT_URLは必須です。

非同期実行が使用されている場合、シナリオのセッションIDが戻されます。

[-NAME=<local_agent_name>]

このセッションの実行ログに、Local (No Agent)のかわりに表示されるエージェント名。AGENT_URLを使用した場合、このパラメータは無視されます。

注意: NAMEパラメータに既存の物理エージェント名を使用することはお薦めできません。この名前を使用したランタイム・エージェントには、このセッションに関するすべての情報がないため、正しく管理できません。次の機能は、このセッションでは正しく機能しません。

- 失効したセッションの除去: このエージェントが開始されると、このセッションは失効とみなされます。エージェントがこのセッションを検出するとエラーになります。

- セッションの停止: このエージェントは、リクエスト時にセッションを停止できません。

- エージェント・セッションのカウント: このセッションは、このエージェントで実行されていない場合でも、このエージェントのセッションにカウントされます。

既存のいずれの物理エージェント名とも一致しないNAMEを使用することをお薦めします。

指定の物理エージェントに対してセッションを開始する場合は、かわりにAGENT_URLパラメータを使用する必要があります。

[-SESSION_NAME=<session_name>]

実行ログに表示するセッションの名前。指定しない場合は、シナリオ名がセッション名として使用されます。

[-KEYWORDS=<keywords>]

このセッションに関連付けられているキーワードのリスト。これらのキーワードによって、セッションの識別が容易になります。このリストは、カンマ区切りのキーワード・リストです。

[<variable>=<value>]

<value>を<variable>に割り当てて、シナリオを実行できます。<variable>はプロジェクト変数またはグローバル変数です。<variable>は、プロジェクト変数またはグローバル変数のいずれかです。グローバル変数は、GLOBAL.<variable Name>とする必要があります。

このパラメータは、複数の変数を割り当てる際に反復できます。

startscenコマンド行では、変数名の接頭辞にハッシュ記号(#)を使用しないでください。

6.4 セッションの再開

エラーが発生したセッション、またはユーザーが停止したセッションは再開できます。

Oracle Data Integratorは、ソース・データ・サーバーおよびターゲット・データ・サーバーとの対話時にJDBCトランザクションを使用し、セッションがエラー状態で終了した場合、オープン・トランザクションの状態は永続化されません。適切な再起動ポイントは、未完了のトランザクションを起動したタスクです。そのような再起動ポイントが特定できない場合、エラー状態にある既存のセッションを再開するのではなく、シナリオを実行することで新たなセッションを開始することをお薦めします。

再開できるのは、ステータスが「エラー」または「待機中」のセッションのみです。デフォルトで、セッションは、実行に失敗した最後のタスク(通常は、エラー状態または待機状態のタスク)から再開されます。既存のステージング表での処理を続行し、長い時間のかかるロード・フェーズの再実行を回避するために、セッションを再開する必要がある場合もあります。その場合、ユーザーは、KM固有のトランザクション管理を考慮に入れる必要があります。一般的なガイドラインとしては、ロード・タスクでクラッシュが発生した場合、失敗したロード・タスクから再起動できます。統合フェーズでクラッシュが発生した場合、ターゲットへの統合はトランザクション内で行われるため、最初の統合タスクから再起動します。このガイドラインは、一度に1つのマッピングにのみ適用されます。複数のマッピングが連鎖しており、最後のマッピングのみがコミットされている場合、トランザクションは複数のインタフェースにわたって実行されるため、それらの複数のマッピングをすべて再起動する必要があります。

特定のタスクまたは手順から再起動する手順は次のとおりです。

1. オペレータ・ナビゲータで、このタスクまたは手順に移動し、それを編集して、「待機中」状態に切り替えます。

2. 「オペレータ」ツリー・ビューで、これ以降のすべてのタスクおよび手順を「待機中」状態に設定します。

3. 次のいずれかの方法を使用して、セッションを再開します。

- ODI Studioからのセッションの再開。

- コマンド行からのセッションの再開。

- Webサービスからの実行。詳細は、「Webサービスを使用したセッションの再開」を参照してください。

- ODIコンソールからの操作。「シナリオおよびセッションの管理」を参照してください。

警告:

セッションが再開されると、ソース・システムとターゲット・システムへのすべての接続とトランザクションが再度作成され、前回のセッション実行からリカバリされることはありません。したがって、前回の実行からのトランザクションで未コミットの操作が適用されることはありません。また、セッションの正常な続行に必要なデータが存在しない可能性があります。

6.4.1 ODI Studioからのセッションの再開

Oracle Data Integrator Studioからセッションを再開するには:

1. オペレータ・ナビゲータで、再開するセッションを選択します。

2. 右クリックして「再開」を選択します。

3. 「セッションの再開」ダイアログで、新しいセッションの実行に使用するエージェントを指定します。
セッションを実行するエージェントを選択するには、次のいずれかを実行します:

- 前のセッション実行に使用されたエージェントを使用するには、「前のエージェントを使用: <エージェント名>」を選択します。

- セッション実行に使用するエージェントをリストから選択するには、「別のエージェントを選択」を選択します。

注意:
ODI Studio組込みのエージェントを使用する場合は、「内部」を選択します。

4. ログ・レベルを選択します。ログ・レベル6は、ログ・レベル5と動作は同じですが、変数の追跡が追加されていることに注意してください。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の変数と順序の追跡に関する項を参照してください。

5. 表示されたセッションを再開してダイアログを閉じるには、「OK」をクリックします。セッションを再開しない場合は、「取消」をクリックします。

Oracle Data Integratorでセッションが再開されると、「セッションを開始しました」ダイアログが表示されます。

6.4.2 コマンド行からのセッションの再開

コマンド行からセッションを再開する前に、次の要件を熟読してください。

- この項で説明するタスクの実行に必要なコマンド行スクリプトは、Oracle Data Integratorスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントがインストールされている場合のみ使用できます。スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントのインストール方法の詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- このコマンドを使用するには、リポジトリへの接続がドメインで構成されている必要があります。詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- コマンド行からセッションを再開すると、デフォルトでは、そのセッションはリモートのランタイム・エージェントに対しては開始されませんが、コマンド行から開始されたローカルのJavaプロセスによって実行されます。このプロセスは、ローカルで中断できますが、実際のランタイム・エージェントではないため、セッション停止シグナルを受信できません。したがって、この方法で開始したセッションをリモートで停止することはできません。
ランタイム・エージェントに対してセッションを開始する場合は、AGENT_URLパラメータを使用する必要があります。

コマンド行からセッションを再開するには:

1. Oracle Data Integratorドメインを作成し、エージェント・テンプレートを構成します。

- ODIスタンドアロン・インストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

- ODI Enterpriseインストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・コロケート・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

2. ディレクトリをOracle Data Integratorインストールの<DOMAIN_HOME>/bin/ディレクトリに変更します。

3. 次のコマンドを入力して、シナリオを再開します。
UNIXシステムの場合:

./restartsession.sh -INSTANCE=<ODIInstanceName> <session_number> [-log_level][-AGENT_URL=<remote_agent_url>]

ODIInstanceNameは、このプロシージャのステップ1で構成されたインスタンスです。

Windowsシステムの場合:

restartsession.cmd "-INSTANCE=<ODIInstanceName>" <session_number> [-log_level]["-AGENT_URL=<remote_agent_url>"]

表6-3に、このコマンドの様々なパラメータ(必須とオプションの両方)を示します。パラメータの前にはハイフン(-)を、可能な値の前には等号(=)を付けます。この場合、コマンドを入力するオペレーティング・システムに固有の文字保護の構文に準拠する必要があります。

表6-3 restartsessコマンドのパラメータ

パラメータ

説明

-INSTANCE=<ODIInstanceName>

ドメインで構成されているODIインスタンスの名前。ODIインスタンスでは、セッションを再開するために使用されるリポジトリ構成を定義します(必須)。

<session_number>

再開するセッションの番号(ID)。

[-log_level]

保持するロギング情報のレベル。ログ・レベル6は、ログ・レベル5と動作は同じですが、変数の追跡が追加されていることに注意してください。セッション再開時にこのlog_levelパラメータが入力されていないと、セッションの実行に使用された前回のログ・レベルが再利用されることに注意してください。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の変数と順序の追跡に関する項を参照してください。

[-AGENT_URL=<remote_agent_url>]

このセッションを再開するランタイム・エージェントのURL。デフォルトでは、セッションは、コマンド行から開始されたローカルのJavaプロセスによって実行されます。

6.5 セッションの停止

実行中または待機中のセッションは停止できます。たとえば、マッピングにエラーが含まれていることに気付いた場合、または実行時間が長い場合は、セッションを停止する必要がある場合があります。セッションを停止するには、特定の権限が必要になります。詳細は、「セッション」を参照してください。

セッションを停止する方法は次の2通りあることに注意してください。

- 標準: セッションは、現在のタスクの終了後に停止されます。

- 即時: 現在のタスクがすぐに中断されてセッションが停止されます。このモードを使用すると、長時間実行されているタスク、たとえば長いSQL文をその完了前に停止できます。

注意:
即時停止は、タスクの中断をサポートするテクノロジとドライバがある場合のみ機能します。タスクの中断は、statement.cancelメソッドがJDBCドライバで実装されている場合にサポートされます。

注意:
停止できるセッションは、Java EEエージェント、スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェント内で実行されているセッションのみです。Studioの組込みエージェントで実行されているセッション、あるいはAGENT_URLパラメータを指定せずにstartscen.shまたはstartscen.cmdスクリプトで開始されたセッションは停止できません。詳細は、「シナリオの実行」を参照してください。

セッションは複数の方法で停止できます。

- ODI Studioからのセッションの停止。

- コマンド行からのセッションの停止

- ODIコンソールからの操作。「シナリオおよびセッションの管理」を参照してください。

6.5.1 ODI Studioからのセッションの停止

Oracle Data Integrator Studioからセッションを停止するには:

1. オペレータ・ナビゲータで、停止する実行中または待機中のセッションをツリーから選択します。

2. 右クリックして「標準停止」または「即時停止」を選択します。

3. 「セッションの停止」ダイアログで「OK」をクリックします。

セッションが停止され、ステータスが「エラー」に変更されます。

6.5.2 コマンド行からのセッションの停止

コマンド行からセッションを停止する前に、次の要件を熟読してください。

- この項で説明するタスクの実行に必要なコマンド行スクリプトは、Oracle Data Integratorスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントがインストールされている場合のみ使用できます。スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントのインストール方法の詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- このコマンドを使用するには、リポジトリへの接続がドメインで構成されている必要があります。詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

コマンド行からセッションを停止するには:

1. Oracle Data Integratorドメインを作成し、エージェント・テンプレートを構成します。

- ODIスタンドアロン・インストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

- ODI Enterpriseインストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・コロケート・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

2. ディレクトリをOracle Data Integratorインストールの<DOMAIN_HOME>/bin/ディレクトリに変更します。

3. 次のコマンドを入力して、シナリオを停止します。
UNIXシステムの場合:

./stopsession.sh -INSTANCE=<ODIInstanceName> <session_id> [-AGENT_URL=<remote_agent_url>] [-STOP_LEVEL=<normal (デフォルト) | immediate>]

ODIInstanceNameは、このプロシージャのステップ1で構成されたインスタンスです。

Windowsシステムの場合:

stopsession.cmd "-INSTANCE=<ODIInstanceName>" <session_id> ["-AGENT_URL=<remote_agent_url>"] ["-STOP_LEVEL=<normal (デフォルト) | immediate>"]

表6-4に、このコマンドの様々なパラメータ(必須とオプションの両方)を示します。パラメータの前にはハイフン(-)を、可能な値の前には等号(=)を付けます。この場合、コマンドを入力するオペレーティング・システムに固有の文字保護の構文に準拠する必要があります。

表6-4 StopSessionコマンドのパラメータ

パラメータ

説明

-INSTANCE=<ODIInstanceName>

ドメインで構成されているODIインスタンスの名前。ODIインスタンスでは、セッションを停止するために使用されるリポジトリ構成を定義します(必須)。

<session_id>

停止するセッションの番号(ID)。

[-AGENT_URL=<remote_agent_url>

このセッションを停止するランタイム・エージェントのURL。デフォルトでは、セッションは、コマンド行から開始されたローカルのJavaプロセスによって実行されます。

[-STOP_LEVEL=<normal (デフォルト) | immediate>]

実行中のセッションの停止に使用するレベル。省略すると、normalがデフォルトの停止レベルとして使用されます。

6.6 ロード計画の実行

ロード計画は複数の方法で実行できます。

- ODI Studioからのロード計画の実行。

- コマンド行からのロード計画の実行。

- Webサービスからの実行。詳細は、「Webサービスを使用したロード計画の実行」を参照してください。

- ODIコンソールからの操作。「ロード計画の管理」を参照してください。

注意:
ロード計画は、「ローカル(エージェントなし)」のODI Studioの組込みエージェントを使用して実行することはできません。

6.6.1 ODI Studioからのロード計画の実行

ODI Studioでは、デザイナ・ナビゲータまたはオペレータ・ナビゲータでロード計画を実行できます。

デザイナ・ナビゲータまたはオペレータ・ナビゲータでロード計画を実行するには:

1. 「ロード計画とシナリオ」ナビゲーション・ツリーで、実行するロード計画を選択します。

2. 右クリックして「実行」を選択します。

3. 「ロード計画の開始」ダイアログで、実行パラメータを選択します。

- ロード計画が実行される「コンテキスト」を選択します。

- ステップを実行する「論理エージェント」を選択します。

- 「ログ・レベル」を選択します。この値以下のログ・レベルが定義されているすべてのセッションは、セッション完了時に、セッション・ログに保持されます。ただし、オブジェクトの実行が異常終了した場合は、この設定にかかわらず、すべてのタスクが保持されます。
ログ・レベル6は、ログ・レベル5と動作は同じですが、変数の追跡が追加されていることに注意してください。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の変数と順序の追跡に関する項を参照してください。

「ロード計画」で定義された「セッション・タスクのログ・レベル」の値を使用するには、「セッション・タスクのログ・レベルの使用」(デフォルト)を選択します。

- 変数表に、ロード計画に使用する変数の起動値を入力します。

4. 「OK」をクリックします。

5. 「ロード計画が開始しました」ウィンドウが表示されます。

6. 「OK」をクリックします。

ロード計画の新規の実行が開始されます。ロード計画インスタンスが作成され、最初のロード計画が実行されます。ロード計画実行はオペレータ・ナビゲータで確認できます。

注意:
ロード計画を作成または編集して、ロード計画の同時実行を制限するかどうかを指定できます。また、同時ロード計画をエラーで即時に終了するかどうかを指定したり、待機動作で実行の順番をチェックするためのポーリング頻度(秒)を指定することもできます。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のロード計画の作成に関する項を参照してください。

6.6.2 コマンド行からのロード計画の実行

コマンド行からロード計画を開始できます。

コマンド行からロード計画を実行する前に、次の要件を熟読してください。

- この項で説明するタスクの実行に必要なコマンド行スクリプトは、Oracle Data Integratorスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントがインストールされている場合のみ使用できます。スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントのインストール方法の詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- このコマンドを使用するには、リポジトリへの接続がドメインで構成されている必要があります。詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- ロード計画実行は、AGENT_URLパラメータで識別されたランタイム・エージェントに対して開始されます。

コマンド行からロード計画を開始するには:

1. Oracle Data Integratorドメインを作成し、エージェント・テンプレートを構成します。

- ODIスタンドアロン・インストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

- ODI Enterpriseインストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・コロケート・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

2. ディレクトリをOracle Data Integratorインストールの<DOMAIN_HOME>/bin/ディレクトリに変更します。

3. 次のコマンドを入力して、ロード計画を開始します。
UNIXシステムの場合:

./startloadplan.sh -INSTANCE=<ODIInstanceName> <load_plan_name> <context_code> [log_level] -AGENT_URL=<agent_url> [-KEYWORDS=<keywords>] [<variable>=<value>]*

ODIInstanceNameは、このプロシージャのステップ1で構成されたインスタンスです。

WINDOWSシステムの場合:

startloadplan.cmd "-INSTANCE=<ODIInstanceName>" <load_plan_name> <context_code> [log_level]"-AGENT_URL=<agent_url>" ["-KEYWORDS=<keywords>"] ["<variable>=<value>"]*

注意:
Windowsプラットフォームでは、等号(=)またはスペースを含むコマンド引数は、二重引用符で囲む必要があります。コマンド・コールは、UNIXのコマンド・コールとは異なる場合があります。例:
UNIXシステムの場合:

./startloadplan.sh -INSTANCE=OracleDIAgent1 DWLoadPlan DEV -AGENT_URL=http://localhost:20910/oraclediagent

WINDOWSシステムの場合:

startloadplan.cmd "-INSTANCE=OracleDIAgent1" DWLoadPlan DEV "-AGENT_URL=http://localhost:20910/oraclediagent"

表6-5に、様々なパラメータ(必須とオプションの両方)を示します。パラメータの前にはハイフン(-)を、可能な値の前には等号(=)を付けます。この場合、コマンドを入力するオペレーティング・システムに固有の文字保護の構文に準拠する必要があります。

表6-5 Startloadplanコマンドのパラメータ

パラメータ

説明

-INSTANCE=<ODIInstanceName>

ドメインで構成されているODIインスタンスの名前。ODIインスタンスでは、ロード計画を開始するために使用されるリポジトリ構成を定義します(必須)。

<load_plan_name>

開始するロード計画の名前(必須)。

<context_code>

ロード計画の開始に使用するコンテキストのコード。この値を指定しない場合、ロード計画ではコール側セッションのコンテキストが使用されます(必須)。

[log_level]

保持するロギング情報のレベル。この値以下のログ・レベルが定義されているすべてのセッションは、セッション完了時に、セッション・ログに保持されます。ただし、オブジェクトの実行が異常終了した場合は、この設定にかかわらず、すべてのタスクが保持されます。

ログ・レベル6は、ログ・レベル5と動作は同じですが、変数の追跡が追加されていることに注意してください。デフォルトは、ロード計画の「セッション・タスクのログ・レベル」(ロード計画の開始に使用されたレベル)です。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の変数と順序の追跡に関する項を参照してください。

["-AGENT_URL=<agent_url>"]

ロード計画を開始する物理エージェントのURL(必須)。

["-KEYWORDS=<Keywords>"]

セッション・フォルダおよび自動分類によるODIログの編成を促進するためのキーワード。このロード計画に関連付けるキーワードのカンマ区切りリストを入力します。

["variable>=<value> "]

ロード計画変数の起動値(オプション)。プロジェクト変数は<project_code>.<variable_name>で、グローバル変数はGLOBAL.<variable_name>で指定します。このリストは、<variable>=<value>の形式になります。

日付および数値変数の書式は、次のとおりです:

- 日付: yyyy-MM-dd'T'HH:mm:ssZ
たとえば、2009-12-06T15:59:34+0100となります。

- 数値: 整数値
たとえば、29833です。

例:

"A_PROJ.A_REFRESH_VAR=bb" "A_PROJ.A_CROSS_PROJ_VAR=aa" "A_PROJ.A_VAR=cc"

6.7 ロード計画実行の再開

ロード計画を再開すると、選択したロード計画インスタンスに対する新規の実行が開始します。ロード計画の再開では、エラーになったステップの「再開タイプ」パラメータにより、ロード計画および子セッションの再開方法が定義されます。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の再開動作の定義に関する項およびセッションの再開に関する項を参照してください。

注意:
ロード計画インスタンスの再開は、最近の(最大番号の)実行ステータスに依存します。再開が有効になるのは、最近の実行ステータスが「エラー」の場合のみです。

ロード計画は複数の方法で再開できます。

- ODI Studioからのロード計画の再開。

- コマンド行からのロード計画の再開。

- Webサービスからの実行。詳細は、「Webサービスを使用したロード計画インスタンスの再開」を参照してください。

- ODIコンソールからの操作。「ロード計画の管理」を参照してください。

6.7.1 ODI Studioからのロード計画の再開

ODI Studioからロード計画を再開するには:

1. オペレータ・ナビゲータで、「ロード計画実行」ナビゲーション・ツリーから再開するロード計画実行を選択します。

2. 右クリックして「再開」を選択します。

3. 「ロード計画の再開」ダイアログで、ロード計画を再開するエージェントを選択します。オプションで、異なるログ・レベルを選択します。

4. 「OK」をクリックします。

ロード計画が再開され、新規のロード計画実行が作成されます。

6.7.2 コマンド行からのロード計画の再開

コマンド行からロード計画を再開する前に、次の要件を熟読してください。

- この項で説明するタスクの実行に必要なコマンド行スクリプトは、Oracle Data Integratorスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントがインストールされている場合のみ使用できます。スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントのインストール方法の詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- このコマンドを使用するには、リポジトリへの接続がドメインで構成されている必要があります。詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- ロード計画実行は、AGENT_URLパラメータで識別されたリモート・ランタイム・エージェントに対して再開されます。

コマンド行からロード計画を再開するには:

1. Oracle Data Integratorドメインを作成し、エージェント・テンプレートを構成します。

- ODIスタンドアロン・インストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

- ODI Enterpriseインストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・コロケート・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

2. ディレクトリをOracle Data Integratorインストールの<DOMAIN_HOME>/bin/ディレクトリに変更します。

3. ロード計画を再開するには、次のコマンドを入力します。
UNIXシステムの場合:

./restartloadplan.sh -INSTANCE=<ODIInstanceName> <load_plan_instance_id> [log_level] -AGENT_URL=<agent_url>

ODIInstanceNameは、このプロシージャのステップ1で構成されたインスタンスです。

WINDOWSシステムの場合:

restartloadplan.cmd "-INSTANCE=<ODIInstanceName>" <load_plan_instance_id> [log_level] "-AGENT_URL=<agent_url>"

注意:
Windowsプラットフォームでは、等号(=)またはスペースを含むコマンド引数は、二重引用符で囲む必要があります。コマンド・コールは、UNIXのコマンド・コールとは異なる場合があります。

表6-6に、様々なパラメータ(必須とオプションの両方)を示します。パラメータの前にはハイフン(-)を、可能な値の前には等号(=)を付けます。この場合、コマンドを入力するオペレーティング・システムに固有の文字保護の構文に準拠する必要があります。

表6-6 Restartloadplanコマンドのパラメータ

パラメータ

説明

-INSTANCE=<ODIInstanceName>

ドメインで構成されているODIインスタンスの名前。ODIインスタンスでは、ロード計画を再開するために使用されるリポジトリ構成を定義します(必須)。

<load_plan_instance_id>

停止または失敗となり、再開するロード計画インスタンスのID(必須)。

[log_level]

保持するロギング情報のレベル。この値以下のログ・レベルが定義されているすべてのセッションは、セッション完了時に、セッション・ログに保持されます。ただし、オブジェクトの実行が異常終了した場合は、この設定にかかわらず、すべてのタスクが保持されます。

ログ・レベル6は、ログ・レベル5と動作は同じですが、変数の追跡が追加されていることに注意してください。デフォルトは、ロード計画の前回の実行に使用されたログ・レベルの値です。

詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の変数と順序の追跡に関する項を参照してください。

["-AGENT_URL=<agent_url>"]

ロード計画を開始する物理エージェントのURL(オプション)。

6.8 ロード計画実行の停止

実行中または待機中のロード計画実行を停止できます。たとえば、ロード計画にエラーが含まれていることに気付いた場合、または実行時間が長い場合は、ロード計画実行を停止することがあります。

ロード計画実行を停止する方法は2通りあることに注意してください:

- 標準停止: 標準停止モードでは、ロード計画の停止を担当するエージェントが、このロード計画のセッションを実行している各エージェントに、標準停止シグナルを送信します。各エージェントは、セッションの現在のタスクが完了するのを待機し、その後、セッションをエラーで終了します。ロード計画によって例外ステップが実行されることはありません。すべての例外が終了すると、ロード計画はエラー状態に移行されます。

- 即時停止: 即時停止モードでは、ロード計画の停止を担当するエージェントが、このロード計画のセッションを実行している各エージェントに、即時停止シグナルを送信します。各エージェントは、セッションの現在のタスクが完了するのを待機せずに、セッションをエラーで即時に終了します。ロード計画によって例外ステップが実行されることはありません。すべての例外が終了すると、ロード計画はエラー状態に移行されます。

ロード計画は複数の方法で停止できます。

- ODI Studioからのロード計画の停止。

- コマンド行からのロード計画実行の停止。

- Webサービスからの実行。詳細は、「Webサービスを使用したロード計画実行の停止」を参照してください。

- ODIコンソールからの操作。「ロード計画の管理」を参照してください。

6.8.1 ODI Studioからのロード計画の停止

ODI Studioからロード計画実行を停止するには:

1. オペレータ・ナビゲータで、「ロード計画実行」ナビゲーション・ツリーから(実行中または待機中の)停止するロード計画実行を選択します。

2. 右クリックして「標準停止」または「即時停止」を選択します。

3. 「ロード計画実行の停止」ダイアログで、ロード計画を停止するエージェントを選択します。

4. 「OK」をクリックします。

ロード計画実行が停止され、ステータスが「エラー」に変更されます。

6.8.2 コマンド行からのロード計画実行の停止

コマンド行からロード計画を停止する前に、次の要件を熟読してください。

- この項で説明するタスクの実行に必要なコマンド行スクリプトは、Oracle Data Integratorスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントがインストールされている場合のみ使用できます。スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントのインストール方法の詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- このコマンドを使用するには、リポジトリへの接続がドメインで構成されている必要があります。詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- ロード計画実行シグナルは、AGENT_URLパラメータで識別されたリモート・ランタイム・エージェントによって送信されます。

コマンド行からロード計画実行を停止するには:

1. Oracle Data Integratorドメインを作成し、エージェント・テンプレートを構成します。

- ODIスタンドアロン・インストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

- ODI Enterpriseインストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・コロケート・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

2. ディレクトリをOracle Data Integratorインストールの<DOMAIN_HOME>/bin/ディレクトリに変更します。

3. 次のコマンドを入力して、ロード計画を停止します。
UNIXシステムの場合:

./stoploadplan.sh -INSTANCE=<ODIInstanceName> <load_plan_instance_id> [<load_plan_run_count>] -AGENT_URL=<agent_url> [-STOP_LEVEL=<normal (default) | immediate>]

ODIInstanceNameは、このプロシージャのステップ1で構成されたインスタンスです。

WINDOWSシステムの場合:

stoploadplan.cmd "-INSTANCE=<ODIInstanceName>" <load_plan_instance_id> [<load_plan_run_count>] "-AGENT_URL=<agent_url>" ["-STOP_LEVEL=<normal (default) | immediate>"]

表6-7に、様々なパラメータ(必須とオプションの両方)を示します。パラメータの前にはハイフン(-)を、可能な値の前には等号(=)を付けます。この場合、コマンドを入力するオペレーティング・システムに固有の文字保護の構文に準拠する必要があります。

表6-7 Stoploadplanコマンドのパラメータ

パラメータ

説明

-INSTANCE=<ODIInstanceName>

ドメインで構成されているODIインスタンスの名前。ODIインスタンスでは、ロード計画を停止するために使用されるリポジトリ構成を定義します(必須)。

<load_plan_instance_id>

停止する実行中のロード計画実行のID(必須)。

[<load_plan_run_count>]

ロード計画インスタンスのロード計画実行カウント。最新のロード計画実行が誤って停止されないようにします。これを省略すると、最新のロード計画実行カウントが使用されます(オプション)。

["-AGENT_URL=<agent_url>"]

ロード計画を開始する物理エージェントのURL(オプション)。

[-STOP_LEVEL=<normal (デフォルト) | immediate>]

ロード計画実行の停止に使用するレベル。デフォルトはnormalです。

注意:
Windowsプラットフォームでは、等号(=)またはスペースを含むコマンド引数は、二重引用符で囲む必要があります。コマンド・コールは、UNIXのコマンド・コールとは異なる場合があります。

6.9 シナリオとロード計画のスケジューリング

シナリオおよびロード計画の実行は、Oracle Data Integrator組込みスケジューラまたは外部スケジューラを使用してスケジュールできます。この項では、この2つの方法を説明します。

- 組込みスケジューラを使用したシナリオまたはロード計画のスケジューリング

- 外部スケジューラを使用したシナリオまたはロード計画のスケジューリング

6.9.1 組込みスケジューラを使用したシナリオまたはロード計画のスケジューリング

スケジュールは、シナリオおよびロード計画に関連付けることができます。このようなスケジュールは、スケジューラ組込みのランタイム・エージェントによって管理されます。

シナリオやロード計画には複数のスケジュールを指定でき、複数の方法でスケジュールできますが、1つのスケジュールに関連するシナリオまたはロード計画は1つのみという要件を理解することが重要です。シナリオまたはロード計画の「スケジューリング」ノードの下には、様々なスケジュールが表示されます。各スケジュールには、開始日と反復サイクルを指定できます。

例:

- スケジュール1: 毎週木曜日の午後9時、1回のみ

- スケジュール2: 毎日午前8時から午後12時まで、5秒ごとに繰返し

- スケジュール3: 毎日午後2時から午後6時まで、5秒ごとに繰返し、最大サイクル期間は5時間

6.9.1.1 シナリオまたはロード計画のスケジューリング

Oracle Data Integrator Studioからシナリオまたはロード計画をスケジュールするには:

1. デザイナ・ナビゲータまたはオペレータ・ナビゲータで、シナリオまたはロード計画の下にある「スケジューリング」ノードを右クリックします。

2. 「新規スケジューリング」を選択します。スケジューリング・エディタが表示されます。

3. スケジューリング・エディタの「定義」タブで、次のようにパラメータを指定します。

プロパティ

説明

コンテキスト

シナリオまたはロード計画が開始されるコンテキスト。

エージェント

シナリオまたはロード計画を実行するエージェント。

ログ・レベル

保持するロギング情報のレベル。

スケジュールのアクティブ化は、「ステータス」パラメータによって定義されます。

プロパティ

説明

アクティブ

エージェントの再開時、または物理エージェントのスケジュールの更新時に、スケジュールがアクティブになります。

非アクティブ

スケジュールはアクティブではないため、実行されません。

アクティブな期間

スケジュールのアクティビティ範囲。ある期間中にアクティブなスケジュールは、この特定の期間内のみに実行されます。

各実行サイクルの実行頻度は、「実行」パラメータによって定義されます。

プロパティ

説明

実行

実行オプションの頻度(毎年、毎月、...簡易)。このオプションは、このメイン・オプションに依存する一連のオプションによって完成されます。

4. 「実行サイクル」タブで、次のように、シナリオの反復モードに対してパラメータを指定します。

プロパティ

説明

なし(1回実行)

シナリオまたはロード計画は1回のみ実行されます。

複数回

シナリオまたはロード計画は複数回繰り返されます。

- 最大反復数: サイクル中にシナリオが繰り返される最大回数。

- 最大サイクル継続時間: 最大回数に達すると、シナリオはただちに再開されなくなり、サイクルが停止します。

- 反復間隔: 各シナリオ実行の間の停止時間。

制約

実行中に問題が発生した場合、1つのサイクル反復に制限を設定できます。

- 失敗時の試行回数: 1回の反復での最大連続試行回数。

- 実行停止期限: 1回の反復での最大実行時間。この時間に達すると、シナリオまたはロード計画は自動的に停止します。

5. 「変数」タブで、値を指定する変数の「最新の値」を選択解除します。このタブに表示されるのは、シナリオまたはロード計画で使用され、このシナリオまたはロード計画のパラメータとしてフラグが指定されている変数のみです。

6. 「ファイル」メニューから「保存」をクリックします。

新しいスケジュールが、シナリオまたはロード計画の「スケジューリング」ノードの下に表示されます。

スケジュール変更は、ランタイム・エージェントの開始時またはランタイム・エージェントによるスケジュール更新リクエストの受信時に反映されます。

6.9.1.2 エージェントのスケジュールの更新

エージェントは開始時に、接続しているマスター・リポジトリに添付されているすべてのリポジトリのスケジュールを読み取ります。特定のリポジトリでこのエージェントのスケジュールが追加された場合は、そのエージェント・スケジュールをリフレッシュできます。

エージェントのスケジュールを更新するには:

1. トポロジ・ナビゲータで、「物理アーキテクチャ」ナビゲーション・ツリーにある「エージェント」ノードを展開します。

2. スケジュールを更新する物理エージェントを選択します。

3. 右クリックして「スケジューリングの更新」を選択します。

4. 「リポジトリの選択」ダイアログで、スケジューリング情報を読み取るリポジトリを選択します。すべてのリポジトリからスケジューリング情報を読み取るには、「すべての作業リポジトリを選択」を選択します。

5. 「OK」をクリックします。

エージェントは、これらのリポジトリに定義されているスケジュールから、エージェント自体のメモリー内スケジュールをリフレッシュして再計算します。

また、OdiUpdateAgentScheduleツールを使用してエージェントのスケジュールを更新することもできます(Oracle Data Integratorツール・リファレンスのOdiUpdateAgentScheduleに関する項を参照)。

6.9.1.3 スケジュールの表示

すべてのエージェントのスケジュールされたタスク、または特定のエージェントのスケジュールされたタスクを表示できます。

注意:
スケジューリング情報は、エージェントのメモリー内スケジュールから取得されます。正確なスケジュール情報を表示するためには、エージェントが開始され、そのスケジュールがリフレッシュされている必要があります。

すべてのエージェントのスケジュールの表示

すべてのエージェントのスケジュールを表示するには:

1. オペレータ・ナビゲータのツールバー・メニューから、「ナビゲータの接続」→「スケジューリング」の順に選択します。

「スケジュールの表示」ダイアログに、すべてのエージェントのスケジュールが表示されます。

1つのエージェントのスケジュールの表示

1つのエージェントのスケジュールを表示するには:

1. トポロジ・ナビゲータで、「物理アーキテクチャ」ナビゲーション・ツリーにある「エージェント」ノードを展開します。

2. スケジュールを更新する物理エージェントを選択します。

3. 右クリックして「スケジュールの表示」を選択します。

スケジュール・エディタに、このエージェントのスケジュールが表示されます。

注意:
「スケジューリング情報」は、エージェントのスケジュールから取得されます。正確なスケジュール情報を表示するためには、エージェントが開始され、そのスケジュールがリフレッシュされている必要があります。

「スケジュールの表示」ダイアログの使用

スケジュールはガント・ダイアグラムの形式で表示されます。表6-8に、「スケジュール」ダイアログの詳細を示します。

表6-8 スケジューリング詳細

パラメータ

説明

選択したエージェント

スケジュールが表示されるエージェント。「すべてのエージェント」を選択して、すべてのエージェントのスケジュールを表示することもできます。

選択した作業リポジトリ

選択した作業リポジトリで実行されたシナリオのみがスケジュールに表示されます。デフォルトは「すべての作業リポジトリ」です。

スケジュールの範囲

スケジュールが表示される時間範囲。このスケジュールをリフレッシュするには、「リフレッシュ」をクリックします。

更新

選択したエージェントのスケジュールを更新するには、「更新」をクリックします。

時間範囲

指定した時間範囲(1時間、2時間など)を使用して、現在時刻にこの時間を加え、ダイアグラムをその中央に配置できます。この機能により、進行中のセッションと着信セッションを視覚化できます。矢印を使用すると、範囲を前方または後方に移動できます。

シナリオ詳細

このパネルには、スケジュールされた各シナリオの詳細と実行統計が表示されます。

(マウス・ボタンを押したまま)ダイアグラム内のゾーンを選択すると、選択したゾーンに自動的にズームできます。

ダイアグラム内で右クリックするとコンテキスト・メニューが表示され、ズーム、ダイアグラムをイメージ・ファイルとして保存、表示プロパティの印刷または編集の各操作を実行できます。

6.9.2 外部スケジューラを使用したシナリオまたはロード計画のスケジューリング

外部スケジューラを使用してシナリオまたはロード計画を開始するには、次のいずれかの方法で実行します。

- 外部スケジューラでのstartscenまたはstartloadplanコマンドの使用

- シナリオまたはロード計画実行をトリガーするWebサービス・インタフェースの使用

詳細は、次を参照してください:

- 「コマンド行からのシナリオの実行」

- 「コマンド行からのロード計画の実行」

- 「Webサービスを使用したシナリオの実行」

- 「Webサービスを使用したロード計画の実行」

シナリオまたはロード計画が正常に完了した場合、リターン・コードは0です。正常に完了しない場合のリターン・コードは、0以外です。このコードは次の応答で使用されます。

- コマンド行コールのリターン・コード。エラー・メッセージ(ある場合)は、標準エラー出力に含まれます。

- Webサービス・コールのSOAPレスポンス。Webサービス・レスポンスには、セッション・エラー・メッセージ(ある場合)も含まれています。

6.10 実行のシミュレーション

Oracle Data Integratorでは、設計時に実行をシミュレーションできます。実行をシミュレーションすると、その実行に対応するコードが、このコードを実行せずに生成されて表示されます。実行シミュレーションによって、コード確認に適したレポートが提供されます。

注意:
シミュレーション・モードで実行が開始された場合、ログにはセッションが作成されません。

実行をシミュレーションするには:

1. デザイナ・ナビゲータの「プロジェクト」ビューで、実行するオブジェクトを選択します。

2. 右クリックして「実行」を選択します。

3. 「実行」ダイアログで実行パラメータを設定し、「シミュレーション」を選択します。詳細は、表6-1を参照してください。

4. 「OK」をクリックします。

シミュレーション・レポートが表示されます。

「保存」をクリックすると、レポートを.xmlファイルまたは.htmlファイルとして保存できます。

6.11 Webサービスを使用した実行の管理

この項では、Webサービスを使用してランタイム操作を実行する方法について説明します。この章には次の項目があります。

- ランタイムWebサービスの概要

- Webサービスを使用したシナリオの実行

- Webサービスを使用したセッション・ステータスのモニタリング

- Webサービスを使用したセッションの再開

- Webサービスを使用したロード計画の実行

- Webサービスを使用したロード計画実行の停止

- Webサービスを使用したロード計画インスタンスの再開

- Webサービスを使用したロード計画実行ステータスのモニタリング

- コマンド行からのWebサービスへのアクセス

- 外部認証によるランタイムWebサービスの使用

- WS-Addressingの使用

- コールバックを使用する非同期Webサービスの使用

6.11.1 ランタイムWebサービスの概要

Oracle Data Integratorには、ランタイム操作を実行するためのWebサービスが含まれています。これらのWebサービスは次の場所にあります。

- ランタイム・エージェントでは、Webサービスを使用して、シナリオまたはロード計画の開始、セッション・ステータスまたはロード計画実行ステータスのモニタリング、セッションまたはロード計画インスタンスの再開、およびロード計画実行の停止を操作できます。このWebサービスから操作を使用するには、最初にスタンドアロン・エージェントまたはJava EEエージェントをインストールして構成する必要があります。

次の内容は、エージェントおよび公開Webサービスに対して使用されるSOAPリクエストに適用されます。

- Webサービス操作では、SOAPリクエストにあるプレーンテキストのパスワードを受け入れます。したがって、保護されていないネットワーク上でWebサービスを呼び出すには、保護されたプロトコル(HTTPS)を使用することをお薦めします。または、外部認証も使用できます。詳細は、「外部認証によるランタイムWebサービスの使用」を参照してください。

- エージェントまたは公開Webサービス・コンポーネントはマスター・リポジトリに接続するように構成されているため、SOAPリクエストにリポジトリ接続情報は必要ありません。ほとんどの操作の実行で必要なのは、ODIユーザーと作業リポジトリの名前のみです。

6.11.2 Webサービスを使用したシナリオの実行

エージェントWebサービスのinvokeStartScen操作は、指定の作業リポジトリ内で、シナリオを同期または非同期モードで開始します。セッションは、Webサービスを提供しているエージェントによって実行されます。

<OdiStartScenRequest>
<Credentials>
<OdiUser>odi_user</OdiUser>
<OdiPassword>odi_password</OdiPassword>
<WorkRepository>work_repository</WorkRepository>
</Credentials>
<Request>
<ScenarioName>scenario_name</ScenarioName>
<ScenarioVersion>scenario_version</ScenarioVersion>
<Context>context</Context>
<LogLevel>log_level</LogLevel>
<Synchronous>synchronous</Synchronous>
<SessionName>session_name</SessionName>
<Keywords>session_name</Keywords>
<Variables>
<Name>variable_name</name>
<Value>variable_value</Value>
</Variables>
</Request>
</OdiStartScenRequest>

シナリオの実行によって、リクエストのsynchronous要素の値に応じたレスポンスでセッションIDが戻されます。

- 同期モード(Synchronous=1)では、セッションが完了するとレスポンスが戻され、レスポンスに実行結果が反映されます。

- 非同期モード(Synchronous=0)では、セッションが開始されるとレスポンスが戻され、セッションが正しく開始されたかどうかの事実のみが示されます。

この操作では、次の形式でレスポンスが戻されます。

<?xml version = '1.0' encoding = 'ISO-8859-1'?><ns2:OdiStartScenResponse xmlns:ns2="xmlns.oracle.com/odi/OdiInvoke/">   <Session>543001</Session></ns2:OdiStartScenResponse>

6.11.3 Webサービスを使用したセッション・ステータスのモニタリング

エージェントWebサービスのgetSessionStatus操作では、指定リポジトリ内の1つ以上のセッションのステータスが、SessionIds要素に指定したセッション番号で識別されて戻されます。実行中のセッションと完了したセッションの両方が管理されます。

<OdiGetSessionsStatusRequest>
<Credentials>
<OdiUser>odi_user</OdiUser>
<OdiPassword>odi_password</OdiPassword>
<WorkRepository>work_repository</WorkRepository
</Credentials>
<SessionIds>session_number</SessionIds>
</OdiGetSessionsStatusRequest>

この操作では、次の形式でレスポンスが戻されます。

<SessionStatusResponse>
<SessionId>session_id</SessionId>
<SessionStatus>status_code</SessionStatus>
<SessionReturnCode>return_code</SessionReturnCode>
</SessionStatusResponse>

正常に終了したセッションのリターン・コードはゼロです。可能性のあるステータス・コードは、次のとおりです:

- D: 完了

- E: エラー

- M: 警告

- Q: キュー

- R: 実行中

- W: 待機中

6.11.4 Webサービスを使用したセッションの再開

エージェントWebサービスのinvokeRestartSess操作では、指定作業リポジトリ内のセッション番号(SessionID要素に指定)で識別されたセッションが再開されます。セッションは、Webサービスを提供しているエージェントによって実行されます。

再開できるのは、ステータスが「エラー」または「待機中」のセッションのみです。セッションは、最後の未完了タスク(通常はエラーが発生したタスク)から再開されます。

変数の値を変更したり、KeepVariablesブール要素を使用して前回のセッション実行からの変数値を再利用できることに注意してください。

<invokeRestartSessRequest>
<Credentials>
<OdiUser>odi_user</OdiUser>
<OdiPassword>odi_password</OdiPassword>
<WorkRepository>work_repository</WorkRepository>
</Credentials>
<Request>
<SessionID>session_number</SessionID>
<Synchronous>synchronous</Synchronous>
<KeepVariables>0|1</KeepVariables>
<LogLevel>log_level</LogLevel>
<Variables>
<Name>variable_name</name>
<Value>variable_value</Value>
</Variables>
</Request>
</invokeRestartSessRequest>

この操作では、Synchronous要素の値に従って、InvokeStartScenと同様のレスポンスが戻されます。

6.11.5 Webサービスを使用したロード計画の実行

エージェントWebサービスのinvokeStartLoadPlan操作では、指定作業リポジトリ内のロード計画が開始されます。ロード計画はWebサービスを提供するエージェントによって実行されます。invokeStartLoadPlan操作のパラメータについて、次のことに注意してください。

- OdiPassword: クリアテキストのパスワードを使用します。

- Context: コンテキスト・コードを使用します。

- Keywords: 複数のキーワードを使用する場合は、キーワードのカンマ区切りリストを入力します。

- Name: 変数には完全修飾名(GLOBAL.variable_nameまたはPROJECT_CODE.variable_name)を使用します。

次に、OdiStartLoadPlanRequestの記述形式を示します。

<OdiStartLoadPlanRequest>
<Credentials>
<OdiUser>odi_user</OdiUser>
<OdiPassword>odi_password</OdiPassword>
<WorkRepository>work_repository</WorkRepository>
</Credentials>
<StartLoadPlanRequest>
<LoadPlanName>load_plan_name</LoadPlanName>
<Context>context</Context>
<Keywords>keywords</Keywords>
<LogLevel>log_level</LogLevel>
<LoadPlanStartupParameters>
<Name>variable_name</Name>
<Value>variable_value</Value>
</LoadPlanStartupParameters>
</StartLoadPlanRequest>
</OdiStartLoadPlanRequest>

invokeStartLoadPlan操作のレスポンスでは、次の値が戻されます。

- ロード計画実行ID

- ロード計画実行カウント

- マスター・リポジトリID

- マスター・リポジトリ・タイムスタンプ

次に、OdiStartLoadPlanレスポンスの例を示します。

<?xml version = '1.0' encoding = 'UTF8'?>
<ns2:OdiStartLoadPlanResponse xmlns:ns2="xmlns.oracle.com/odi/OdiInvoke/">
<executionInfo>
<StartedRunInformation>
<OdiLoadPlanInstanceId>2001</OdiLoadPlanInstanceId>
<RunCount>1</RunCount>
<MasterRepositoryId>0</MasterRepositoryId>
<MasterRepositoryTimestamp>1290196542926</MasterRepositoryTimestamp>
</StartedRunInformation>
</executionInfo>
</ns2:OdiStartLoadPlanResponse>

6.11.6 Webサービスを使用したロード計画実行の停止

エージェントWebサービスのinvokeStopLoadPlan操作では、インスタンスIDと実行番号によって識別された、指定作業リポジトリ内の実行中のロード計画実行が停止されます。ロード計画インスタンスは、Webサービスを提供するエージェントによって停止されます。StopLevelパラメータには、次の値を指定できます。

- NORMAL: 現在のタスクが終了するまで待機してからセッションを停止します。

- IMMEDIATE: セッションを即時に停止します。オープン中のすべての文が取り消され、トランザクションがロールバックされます。

ロード計画実行の停止方法の詳細は、「ロード計画実行の停止」を参照してください。invokeStopLoadPlan操作で使用するその他のパラメータの詳細は、「Webサービスを使用したロード計画の実行」を参照してください。

<OdiStopLoadPlanRequest>
<Credentials>
<OdiUser>odi_user</OdiUser>
<OdiPassword>odi_password</OdiPassword>
<WorkRepository>work_repository</WorkRepository>
</Credentials>
<OdiStopLoadPlanRequest>
<LoadPlanInstanceId>load_plan_instance_id</LoadPlanInstanceId>
<LoadPlanInstanceRunCount>load_plan_run_count</LoadPlanInstanceRunCount>
<StopLevel>stop_level</StopLevel>
</OdiStopLoadPlanRequest>
</OdiStopLoadPlanRequest>

invokeStopLoadPlan操作のレスポンスでは、次の値が戻されます。

- ロード計画実行ID

- ロード計画実行カウント

- マスター・リポジトリID

- マスター・リポジトリ・タイムスタンプ

次に、OdiStopLoadPlanレスポンスの例を示します。

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:OdiStopLoadPlanResponse xmlns:ns2="xmlns.oracle.com/odi/OdiInvoke/">
<executionInfo>
<StoppedRunInformation>
<OdiLoadPlanInstanceId>3001</OdiLoadPlanInstanceId>
<RunCount>1</RunCount>
<MasterRepositoryId>0</MasterRepositoryId>
<MasterRepositoryTimestamp>1290196542926</MasterRepositoryTimestamp>
</StoppedRunInformation>
</executionInfo>
</ns2:OdiStopLoadPlanResponse>
</S:Body>
</S:Envelope>

6.11.7 Webサービスを使用したロード計画インスタンスの再開

エージェントWebサービスのinvokeRestartLoadPlan操作では、インスタンスIDによって識別された、指定作業リポジトリ内のロード計画インスタンスが再開されます。ロード計画インスタンスは、Webサービスを提供するエージェントによって再開されます。

<OdiRestartLoadPlanRequest>
<Credentials>
<OdiUser>odi_user</OdiUser>
<OdiPassword>odi_password</OdiPassword>
<WorkRepository>work_repository</WorkRepository>
</Credentials>
<RestartLoadPlanRequest>
<LoadPlanInstanceId>load_plan_instance_id</LoadPlanInstanceId>
<LogLevel>log_level</LogLevel>
</RestartLoadPlanRequest>
</OdiRestartLoadPlanRequest>

6.11.8 Webサービスを使用したロード計画実行ステータスのモニタリング

エージェントWebサービスのgetLoadPlanStatus操作では、インスタンスIDと実行番号によって識別された、指定作業リポジトリ内の1つ以上のロード計画のステータスが戻されます。実行中のロード計画と完了したロード計画の両方のインスタンスが対象となります。

<OdiGetLoadPlanStatusRequest>
<Credentials>
<OdiUser>odi_user</OdiUser>
<OdiPassword>odi_password</OdiPassword>
<WorkRepository>work_repository</WorkRepository>
</Credentials>
<LoadPlans>
<LoadPlanInstanceId>load_plan_instance_id</LoadPlanInstanceId>
<LoadPlanRunNumber>load_plan_run_number</LoadPlanRunNumber>
</LoadPlans>
</OdiGetLoadPlanStatusRequest>

getStopLoadPlanStatus操作のレスポンスでは、次の値が戻されます。

- ロード計画実行ID

- ロード計画実行カウント

- ロード計画実行リターン・コード

- ロード計画メッセージ

次に、OdiGetLoadPlanStatusレスポンスの例を示します。

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:OdiGetLoadPlanStatusResponse xmlns:ns2="xmlns.oracle.com/odi/OdiInvoke/">
<LoadPlanStatusResponse>
<LoadPlanInstanceId>3001</LoadPlanInstanceId>
<LoadPlanRunNumber>1</LoadPlanRunNumber>
<LoadPlanStatus>E</LoadPlanStatus>
<LoadPlanReturnCode>ODI-1530</LoadPlanReturnCode>
<LoadPlanMessage>ODI-1530: Load plan instance was stopped by user request.</LoadPlanMessage>
</LoadPlanStatusResponse>
</ns2:OdiGetLoadPlanStatusResponse>
</S:Body>
</S:Envelope>

6.11.9 コマンド行からのWebサービスへのアクセス

Oracle Data Integratorには、UNIXプラットフォーム用の2つのシェル・スクリプトが含まれています。これらのシェル・スクリプトでは、Webサービス・インタフェースを使用して、コマンド行からランタイム・エージェントWebサービス操作を介してシナリオを開始およびモニタリングします。

- startscenremote.shは、そのWebサービスのリモート・エージェントでセッションを開始します。このシナリオは、同期または非同期で開始できます。非同期で開始した場合は、セッションが完了するかタイムアウトになるまで、そのセッションに対する定期的なスクリプト・ポーリングを指定できます。

- getsessionstatusremote.shは、Webサービス・インタフェースを介してセッションのステータスを取得します。この2番目のスクリプトは、startscenremote.shスクリプトで使用されます。

コマンド行からWebサービスにアクセスする前に、次の重要な注意事項を慎重に読んでください。

- この項で説明するタスクの実行に必要なコマンド行スクリプトは、Oracle Data Integratorスタンドアロン・エージェントがインストールされている場合のみ使用できます。スタンドアロン・エージェントのインストール方法の詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

- startscen.shコマンド行と異なり、これらのスクリプトは、UNIXまたはLinuxプラットフォームにインストールされている軽量WGETユーティリティを使用して、Webサービス・コールを実行します。Javaコードは使用せず、ポーリング・メカニズムを使用して、マシンで実行するプロセスの数を削減します。これらのスクリプトは、大量のシナリオとセッションをコマンド行から同時に管理する必要がある場合に適しています。

シナリオの開始

シナリオをコマンド行からWebサービスを介して開始するには:

1. ディレクトリをOracle Data Integratorインストールの/agent/binディレクトリに変更します。

2. 次のコマンドを入力して、シナリオを開始します。
UNIXシステムの場合:

./startscenremote.sh <scenario_name> <scenario_version> <context_code> <work_repository> <remote_agent_url> <odi_user> <odi_password> -l <log_level> -s <sync_mode> -n <session_name> -k <session_keyword> -a <assign_variable> -t <timeout> -i <interval> -h <http_timeout> -v

表6-9に、このコマンドの様々なパラメータ(必須とオプションの両方)を示します。

表6-9 Startscenremoteコマンドのパラメータ

パラメータ

説明

<scenario_name>

シナリオの名前(必須)。

<scenario_version>

シナリオのバージョン(必須)。指定したバージョンが-1の場合は、そのシナリオの最新バージョンが実行されます。

<context_code>

実行コンテキストのコード(必須)。

<work_repository>

シナリオが格納されている作業リポジトリの名前。

<remote_agent_url>

このセッションを実行するランタイム・エージェントのURL。

<odi_user>

このセッションの実行に使用するユーザーの名前。

<odi_password>

このユーザーのパスワード。

-l <log_level>

保持するロギング情報のレベル。

このパラメータの形式は<n>で、<n>は0から6までの必要なログ・レベルです。デフォルトのログ・レベルは5です。

ログ・レベル6は、ログ・レベル5と動作は同じですが、変数の追跡が追加されていることに注意してください。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の変数と順序の追跡に関する項を参照してください。

例: startscen.cmd SCENAR 1 GLOBAL 5

-s <sync_mode>

実行モード:

- 0: 同期

- 1: 非同期(セッションの完了を待機しない)

- 2: 非同期(セッションの完了を待機します)

-n <session_name>

セッションの名前。

-k <session_keyword>

このセッションに関連付けられているキーワードのリスト。これらのキーワードによって、セッションの識別が容易になります。このリストは、カンマ区切りのキーワード・リストです。

-a <assign_variable>

変数を割り当てます。<value>を<variable>に割り当てて、シナリオを実行できます。<variable>はプロジェクト変数またはグローバル変数です。<variable>は、プロジェクト変数またはグローバル変数のいずれかです。グローバル変数は、GLOBAL.<variable Name>とする必要があります。

このパラメータは、複数の変数を割り当てる際に反復できます。

startscenコマンド行では、変数名の接頭辞にハッシュ記号(#)を使用しないでください。

例: -a PROJ1.VAR1=100

-t <timeout>

sync_mode = 2の場合に、セッションの完了を待機するタイムアウト時間(秒)。

-i <interval>

sync_mode = 2の場合のセッション・ステータスのポーリング間隔。

-h <http_timeout>

Webサービス・コールのHTTPタイムアウト。

-v

冗長モード。

セッション・ステータスのモニタリング

コマンド行からWebサービスを介してセッションのステータスをモニターするには:

1. ディレクトリをOracle Data Integratorインストールの/agent/binディレクトリに変更します。

2. 次のコマンドを入力して、シナリオを開始します。
UNIXシステムの場合:

./getsessionstatusremote.sh <session_number> <work_repository> <remote_agent_url> <odi_user> <odi_password> -w <wait_mode> -t <timeout> -i <interval> -h <http_timeout> -v

表6-10に、このコマンドの様々なパラメータ(必須とオプションの両方)を示します。

表6-10 GetSessionStatusRemoteコマンドのパラメータ

パラメータ

説明

<session_number>

モニターするセッションの数。

<work_repository>

シナリオが格納されている作業リポジトリの名前。

<remote_agent_url>

このセッションを実行するランタイム・エージェントのURL。

<odi_user>

このセッションの実行に使用するユーザーの名前。

<odi_password>

このユーザーのパスワード。

-w <wait_mode>

待機モード:

- 0: セッションの完了を待機しないで、現在のステータスをレポートします。

- 1: セッションの完了を待機してから、ステータスをレポートします。

-t <timeout>

sync_mode = 2の場合に、セッションの完了を待機するタイムアウト時間(秒)。

-i <interval>

sync_mode = 2の場合のセッション・ステータスのポーリング間隔。

-h <http_timeout>

Webサービス・コールのHTTPタイムアウト。

-v

冗長モード。

6.11.10 外部認証によるランタイムWebサービスの使用

この章のWebサービスの例では、OdiUserおよびOdiPassword要素を使用して、SOAP本文内部のODI認証を使用しています。

Oracle Platform Security Services (OPSS)が構成されたリポジトリおよびコンテナ・ベースの認証に外部認証を設定する場合は(詳細は、「外部認証の構成」を参照)、HTTP基本認証、WS-Securityヘッダー、SAMLトークンなどを使用して認証をWebサービスに渡すことができます。OPSSでは、認証がアイデンティティ・プロバイダによってサーバー側で透過的に処理されます。この場合、OdiUserおよびOdiPassword要素は省略できます。

ランタイムWebサービスは、まずOPSSを使用して認証を試行します。認証パラメータが指定されていない場合は、OPSSによって匿名ユーザーが使用され、OdiUserおよびOdiPasswordがチェックされます。それ以外の場合(つまり、OPSSへの資格証明が正しくない場合)は、OPSSによって認証例外がスローされ、Webサービスは起動されません。

注意:
OPSS認証は、Oracle WebLogic ServerにデプロイされたパブリックWebサービスまたはJEEエージェントでのみ使用できます。

6.11.11 WS-Addressingの使用

この章で説明しているWebサービスは、オプションでWS-Addressingをサポートしています。WS-Addressingは、ランタイムWebサービス・コールの完了時にエンドポイントでのレスポンスを可能にします。このため、ReplyToおよびFaultToという2つのエンドポイントを、SOAPリクエスト・ヘッダーにオプションで指定できます。

これらのエンドポイントは、次のように使用されます:

- ランタイムWebサービス・コールが正常に完了した場合は、Actionの結果がReplyToエンドポイントに送信されます。

- SOAPリクエストでエラーが検出されたり、Oracle Data Integratorがリクエストを処理できない場合は、FaultToアドレスにメッセージが送信されます。FaultToアドレスが指定されていない場合は、かわりにReplyToアドレスにエラーが送信されます。

- Oracle Data Integratorエージェントでリクエストの処理中にエラーが検出され、ODIエラー・メッセージを生成する必要がある場合は、このエラー・メッセージがReplyToアドレスに送信されます。

有効なReplyToアドレスが指定されていない場合、コールバック操作はコールバック・モードで実行されません。

次に、セッション20001のセッション・ステータスを取得するために送信されたリクエストの例を示します:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:odi="xmlns.oracle.com/odi/OdiInvoke/">
<soapenv:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
<wsa:Action soapenv:mustUnderstand="1">xmlns.oracle.com/odi/OdiInvoke/getSessionStatus</wsa:Action>
<wsa:ReplyTo soapenv:mustUnderstand="1">
<wsa:Address>http://host001:8080/examples/servlets/servlet/RequestPrinter</wsa:Address>
</wsa:ReplyTo>
<wsa:MessageID soapenv:mustUnderstand="1">uuid:71bd2037-fbef-4e1c-a991-4afcd8cb2b8e</wsa:MessageID>
</soapenv:Header>
<soapenv:Body>
<odi:OdiGetSessionsStatusRequest>
<Credentials>
<!--You may enter the following 3 items in any order-->
<OdiUser></OdiUser>
<OdiPassword></OdiPassword>
<WorkRepository>WORKREP1</WorkRepository>
</Credentials>
<!--Zero or more repetitions:-->
<SessionIds>20001</SessionIds>
</odi:OdiGetSessionsStatusRequest>
</soapenv:Body>
</soapenv:Envelope>

次の呼出しはReplyToアドレス(http://host001:8080/examples/servlets/servlet/RequestPrinter)に対して行われます。

この呼出しには、リクエストに指定されたActionへのレスポンスと、リクエストとレスポンスを関係付けるための元のMessageIDが含まれています。

<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Header>
<To xmlns="http://www.w3.org/2005/08/addressing">http:// host001:8080/examples/servlets/servlet/RequestPrinter</To>
<Action xmlns="http://www.w3.org/2005/08/addressing">xmlns.oracle.com/odi/OdiInvoke/:requestPortType:getSessionStatusResponse</Action>
<MessageID xmlns="http://www.w3.org/2005/08/addressing">uuid:eda383f4-3cb5-4dc2-988c-a4f7051763ea</MessageID>
<RelatesTo xmlns="http://www.w3.org/2005/08/addressing">uuid:71bd2037-fbef-4e1c-a991-4afcd8cb2b8e</RelatesTo>
</S:Header>
<S:Body>
<ns2:OdiGetSessionsStatusResponse xmlns:ns2="xmlns.oracle.com/odi/OdiInvoke/">
<SessionStatusResponse>
<SessionId>26001</SessionId>
<SessionStatus>D</SessionStatus>
<SessionReturnCode>0</SessionReturnCode>
</SessionStatusResponse>
</ns2:OdiGetSessionsStatusResponse>
</S:Body>
</S:Envelope>

WS-Adressingの詳細は、次のURLのWorld Wide Web Consortium (W3C) Webサイトを参照してください。

- Webサービスのアドレス指定: http://www.w3.org/Submission/ws-addressing/

- WS-Addressing SOAPバインディング: http://www.w3.org/TR/2006/REC-ws-addr-soap-20060509/

- WS-Addressing WSDLバインディング: http://www.w3.org/TR/2006/WD-ws-addr-wsdl-20060216/

6.11.12 コールバックを使用する非同期Webサービスの使用

JRF非同期Webサービスまたは非同期BPELプロセスのパターンに従って、時間のかかるWebサービス操作を非同期で開始できます。これらは、"リクエスト-レスポンス・ポート・ペア"のパターンに従います。

このパターンでは、Webサービス・クライアントがコールバック操作を実装します。クライアントがリクエストした操作を完了すると、サーバーはこのコールバック操作に結果を送信します。

エージェントWebサービスのinvokeStartScenWithCallbackおよびinvokeRestartSessWithCallbackという2つの特定の操作では、このパターンがサポートされています。

これらの操作には次の機能があります:

- レスポンスは返されません。これらは一方向の操作です。

- これらの2つの操作を呼び出すクライアントは、invokeStartSceCallbackおよびinvokeRestartSessCallbackの一方向操作をそれぞれ実装する必要があります。invokeStartScenWithCallbackおよびinvokeRestartSessWithCallbackの各アクションの結果は、これらの操作に送信されます。

- 呼出しでは、ReplyToアドレスおよび使用する可能性のあるFaultToアドレスをSOAPヘッダーで指定する必要があります。ReplyToアドレスを指定せずにメソッドを呼び出すと、操作は同期で実行されます(これは、invokeStartScenまたはinvokeRestartSess操作に対応します)。操作でエラーが発生した場合は、ReplyToアドレスまたはFaultToアドレスに送信されます。

invokeStartScenWithCallbackおよびinvokeRestartSessWithCallbackを使用して同期で開始されたシナリオまたはセッションは、一方向の操作であるため、SOAPレスポンスを返しません。セッションが完了すると、コールバック・アドレスにレスポンスが送信されます。

注意:
Oracle BPELではこれらの操作が自動的に実装され、それらのエンドポイントを示すWS-Addressingヘッダーが送信されます。

7 統合プロセスのデバッグ

この章では、Oracle Data Integratorデバッガを使用して、統合プロセスでの問題を解決する方法について説明します。

この章には次の項が含まれます:

- セッションおよびブループリントについて

- セッション・エディタでのデバッグの概要

- デバッグ・セッションの開始

- セッション・エディタでのブループリントのステップ実行

- デバッグ・カーソルの使用

- デバッグ・セッションの管理

7.1 セッションおよびブループリントについて

Oracle Data Integrator Studioでは、セッションのステップとタスクを手動でステップ実行できるグラフィカル・デバッガを提供しています。デバッガを使用して、マッピング、プロシージャ、パッケージまたはシナリオに関する問題を識別できます。デバッグは、アクティブなセッションのブループリントで実行されます。

セッションのブループリントは、Oracle Data Integrator Studioでそのセッションのタブに表示されるのみです。マッピングやシナリオのバージョンおよびタイムスタンプが同じである場合は、異なるセッションで同じブループリントが表示されます。

マッピングを編集すると、それに基づいて実行される新しいセッションでは、前にキャッシュされたブループリントが使用されず、かわりに新しいブループリントが生成されます。マッピングが実行されるたびに、新しいブループリントが再度生成されます。シナリオの場合にのみ、シナリオが変更されないかぎり同じブループリントを複数の実行に対して保持します。シナリオが変更されると、後続セッション用に新しいブループリントが生成されます。

7.1.1 ブループリントのソース・コードおよびターゲット・コード

ブループリントを直接変更することはできません。ただし、セッション・エディタで現在デバッガの対象となっているタスクのソース・コードとターゲット・コードを編集することはできます。編集済コードは、マッピングから実行されるすべてのセッションで使用されます。セッションをすべて削除しても、キャッシュされたブループリントが残り、変更されていないマッピングから次にセッションを開始する際に再使用されます。

7.2 セッション・エディタでのデバッグの概要

セッション・エディタのブループリントで、実行中のセッションをデバッグし、完了したセッションを再開し、セッションのステップとタスクを手動でステップ実行できます。ブループリントには、ステップとタスクをIDで識別するステップ階層表が含まれます。実行できるデバッガ・タスクは次のとおりです。

- ステップおよびタスクのブレークポイントの設定。ブレークポイントは、ブループリントにグラフィカルに表示され、「デバッグ・ブレークポイント」ビューにリストされます。

- セッション内のタスクのソース・コードとターゲット・コードの表示と更新/編集、およびデータを表示する問合せの実行。

- 変数の値およびコミットされていないデータの表示(接続が「自動コミット」接続でない場合)。

- アクティブなすべてのデバッグ・セッションの表示、およびデバッグ可能セッションに対する切断または接続。

- 接続されているセッションのすべてのスレッドの表示。

7.2.1 アイコン

デバッグの実行は、デバッグ・ツールバーのデバッグ・コマンドで制御できます。

アイコン

コマンド

説明

ブレークポイントの追加

ブループリントの現在選択されている行、プロシージャで現在選択されているタスク、またはパッケージで現在選択されているステップでブレークポイントを切り替えます。

デバッグ・セッションの開始

フォーカスのあるエディタのデバッグ・セッションを開始します。セッション・エディタでは、このコマンドを使用してセッションを再開できます。

デバッグ・セッションに接続

エージェントで実行されているデバッグ・セッションに接続します。これにより、現在実行されているセッションが開き、順番に実行できるようになります。ローカル・エージェントに接続することはできません。

デバッグ・セッションの切断

現在のデバッグ・セッションを切断します。デバッグ・セッションを切断した後、実行を継続し、ブレークポイントは無視されます。
切断したセッションに再接続できます。
ローカル・エージェントで実行されているセッションからの切断はできません。

現在のカーソル

ブループリントの現在のカーソルが強調表示され、セッション・エディタが開いていない場合は開きます。

データの取得

現在選択されているタスクのSQLコードが、「デバッグ・データ」ウィンドウのSQLコマンド・フィールドに挿入されます。「ソース・タスク・データ」と「ターゲット・タスク・データ」の両方のウィンドウに移入されます。

ステップ・イン

現在選択されているノードの1つ目の子ノードの最初にステップ・インします。現在選択されているノードに子がない場合は、無効化されます。

タスク終了まで実行

現在選択されているタスクの最後まで実行します。タスクに子がある場合は、タスクの最後に到達するまですべての子を実行します。
タスクの最初でない場合は無効化されます。

次のタスクまで実行

次のタスクの最初まで実行します。タスク・リストの最後のタスクである場合は、親タスクの最後に移動します。

ステップ終了まで実行

現在のステップの最後まで実行します。ステップの最後に到達するまで、すべてのタスクを実行します。

次のステップまで実行

次のステップの最初まで実行します。

一時停止

現在の実行を一時停止します。ステップ/タスクを順番に実行するか、実行を再開することで、実行を続行できます。

再開

現在のカーソルで実行を再開し、セッションが終了するか、ブレークポイントに達するまで続行します。

7.2.2 パッケージ、マッピングおよびプロシージャのデバッグの相違点

パッケージ、マッピングおよびプロシージャをデバッグする場合、ブレークポイントを設定できる場所が異なります。

- ブレークポイントはマッピングに設定できません。

- プロシージャでは、ブレークポイントはタスクに設定できます。

- パッケージでは、ブレークポイントはステップに設定できます。

7.3 デバッグ・セッションの開始

コンテキスト・メニューまたはツールバーの「デバッグ」コマンドにアクセスして、オブジェクトのデバッグ・セッションを開始できます。デバッグ・セッションを開始すると、「デバッグ・セッションの開始」ダイアログが起動します。「デバッグ・セッションのオプション」を参照してください。

ツールバーからのセッションの開始

Oracle Data Integrator Studioのツールバーからデバッグ・セッションを開始するには:

1. 「プロジェクト」ビューで、マッピング、パッケージ、プロシージャまたはシナリオを選択します。

2. ツールバーで、「デバッグ・セッションの開始」を選択します。

3. 「デバッグ」ウィンドウで、「デバッグ・セッションのオプション」で説明しているオプションを構成します。

4. 「OK」をクリックします。
情報メッセージで、セッションが開始されたことが示されます。

ナビゲータ・ツリーからのセッションの開始

Oracle Data Integrator Studioのナビゲータ・ツリーからデバッグ・セッションを開始するには:

1. ナビゲータ・ツリーで、マッピング、パッケージ、プロシージャまたはシナリオを選択します。

2. 右クリックして、「デバッグ」を選択します。

3. 「デバッグ」ウィンドウで、「デバッグ・セッションのオプション」で説明しているオプションを構成します。

4. 「OK」をクリックします。
情報メッセージで、セッションが開始されたことが示されます。

メイン・メニューからのセッションの開始

Oracle Data Integrator Studioのメイン・メニューからデバッグ・セッションを開始するには:

1. 「実行」→「デバッグ」→「デバッグ・セッションの開始」を選択します。

2. 「デバッグ」ウィンドウで、「デバッグ・セッションのオプション」で説明しているオプションを構成します。

3. 「OK」をクリックします。
情報メッセージで、セッションが開始されたことが示されます。

シナリオのセッションの開始

シナリオのデバッグ・セッションを開始するには:

1. 次のいずれかの方法を使用してシナリオを検索します。

- デザイナ・ナビゲータで、「ロード計画とシナリオ」ツリーを展開し、シナリオを見つけます。

- デザイナ・ナビゲータで、「プロジェクト」ツリーを展開し、ソースのシナリオ・ノードの下にあるシナリオを見つけます。

- マッピング・エディタの「シナリオ」タブで、オブジェクトのシナリオのリストでシナリオを見つけます。

2. シナリオを右クリックして、「デバッグ」を選択します。

3. 「デバッグ」ウィンドウで、「デバッグ・セッションのオプション」で説明しているオプションを構成します。

4. 「OK」をクリックします。
情報メッセージで、セッションが開始されたことが示されます。

7.3.1 実行中のデバッグ・セッションへの接続

デバッガを、現在のリポジトリに登録されているエージェント上のデバッグ可能セッションに接続できます。デバッガの接続先のセッションは、「デバッグ・セッションに接続」ダイアログ・ボックスを開く前に開始されていたデバッグ可能セッションである必要があります。エージェントを使用せずに、ローカルで実行されているセッションに接続することはできません。

セッションに接続するには:

1. 「実行」→「デバッグ」→「デバッグ・セッションに接続」を選択します。

2. 「デバッグ・セッションの接続」ウィンドウで、次の接続パラメータを入力します。

- エージェント: デバッグ可能セッションを実行するエージェントを選択します。「任意のエージェント」を選択すると、構成されているすべてのエージェントのデバッグ可能セッションすべてがセッション・リストに表示されます。

- セッション: エージェント・リストに選択されているエージェントからの接続に使用可能なすべてのデバッグ可能セッションが表示されます。

3. 「OK」をクリックします。

7.3.1.1 組込みエージェントおよび外部エージェント

デバッグ・セッションは、コンテキストおよびエージェントで実行されます。デバッグ・セッションを実行するエージェントの名前を選択できます。「ローカル(エージェントなし)」を選択することにより、組込みエージェントをOracle Data Integrator Studioで使用できます。

7.3.1.2 デバッグ・セッションのライフサイクル

セッションは、通常セッションまたはデバッグ・セッションであるかどうかに関係なく、オペレータ・ナビゲータに実行中として表示されます。セッションが一時停止されたことは示されません。ローカル・エージェントで実行されていた停止セッションには、「デバッグ・セッション」ウィンドウを介して戻ることができます。

セッションのライフサイクルの詳細は、「ODI実行の理解」を参照してください。

7.3.2 デバッグ・セッションのオプション

起動する前に、デバッガ・セッションのオプションを構成できます。

7.3.2.1 最初のタスクの前に一時停止

「最初のタスクの前に一時停止」を選択すると、デバッグ可能セッションに接続しているクライアントがない場合でも、最初のタスクの前にデバッガの実行が一時停止されます。

これが選択されていない場合、デバッグ・クライアントに接続されていないデバッグ・セッションは完了するまで続行されます。デバッグ・セッションがデバッグ・クライアントに接続されている場合は、最初のブレークポイント(ある場合)で停止します。

この設定はデフォルトで選択されています。

7.3.2.2 現在のクライアントに関連付け

「現在のクライアントに関連付け」を選択すると、デバッガによりデバッグ・モードでセッションが開始され、セッションをデバッグするためのブループリントが開きます。

選択を解除すると、デバッガによりデバッグ・モードでセッションが開始されますが、デバッグ用のブループリントは開きません。後で、セッションをこのクライアントまたは他のクライアントに関連付けることができます。

この設定はデフォルトで選択されています。

7.3.2.3 接続前の遅延

接続前の遅延を設定して、デバッガが開始済セッションに接続を試行するまでの秒数を定義します。

デフォルトは5秒です。

7.3.2.4 子孫セッションのデバッグ

「子孫セッションのデバッグ」を選択すると、Startコマンドが実行されるたびに、新しいデバッグ・セッションを開始するかを尋ねられます。この設定が適用されるのはパッケージまたはプロシージャのみで、マッピングには適用されません。

これが選択されていない場合、子孫セッションは通常どおりに実行され、デバッガ・クライアントから接続することはできません。

この設定はデフォルトで選択解除されています。

7.3.2.5 エラー時にブレーク

「エラー時にブレーク」を選択すると、エラーが発生したタスクでデバッガの実行が一時停止されます。これにより、トランザクション内でデータを確認できます。

選択を解除すると、セッション実行エンジンは、通常どおりすべてのエラーに対応します。デバッガ・クライアントにより通知が行われることはありません。

この設定はデフォルトで選択解除されています。

7.4 セッション・エディタでのブループリントのステップ実行

ブループリントには、選択したセッションのすべてのステップ階層とタスク階層が示され、個々のコマンドを確認できます。

「現在のクライアントに関連付け」オプションが選択されている場合、セッションを開始すると、その「ブループリント」ビューのセッション・エディタが開きます。それ以外の場合は、デバッグ・ツールバーで「現在のカーソル」を選択してセッション・エディタを開きます。

7.4.1 ステップおよびタスク

ブループリントの各行は、ステップまたはタスクを表します。ブループリントのタスクはコンテナ・タスクである場合があり、逐次実行または並列実行が可能です。コンテナ・タスク内のタスクは、実行されるリーフ・ノードです。マッピングに基づくセッションにはステップが1つしかありませんが、パッケージに基づくセッションには複数のステップが含まれる場合があります。

7.5 デバッグ・カーソルの使用

実行の行の前または後にカーソルを置くことができます。デバッガでは、行の前または後のカーソル位置の半分がハイライト表示されます。

図7-1に、実行の行の前にあるカーソル位置を示します。

図7-1 ステップ前のカーソル配置

7.5.1 デバッグ・アクション

選択したカーソル位置に対してデバッグ・アクションを実行できます。

7.5.1.1 ステップ・イン

「ステップ・イン」アクションでは、現在選択されているノードの1つ目の子ノードの最初にステップ・インします。現在選択されているノードに子がない場合は、無効化されます。

「ステップ・イン」アクションは、ステップとタスクを含むものすべてに対して機能します。

7.5.1.2 一時停止

「一時停止」アクションは、現在の実行を一時停止します。実行が一時停止されると、まだ実行されていないタスクのコードを変更でき、実行が再開される際に、変更したコードが取得されます。

ステップ/タスクを順番に実行するか、実行を再開することで、実行を続行できます。

7.5.1.3 再開

「再開」アクションでは、現在のカーソルで実行を再開し、セッションが終了するか、ブレークポイントに達するまで続行します。

7.5.1.4 タスク終了まで実行

「タスク終了まで実行」アクションは、現在選択されているタスクの最後まで実行されます。タスクに子がある場合は、タスクの最後に到達するまですべての子を実行します。

このアクションは、カーソルがタスクの最初にない場合は無効になっています。

7.5.1.5 次のタスクまで実行

「次のタスクまで実行」アクションは、次のタスクの最初まで実行されます。カーソルがタスク・リストの最後のタスクである場合は、親タスクの最後に移動します。

7.5.1.6 ステップ終了まで実行

「ステップ終了まで実行」アクションは、現在のステップの最後まで実行され、ステップの最後に到達するまですべてのタスクを実行します。

7.5.1.7 次のステップまで実行

「次のステップまで実行」アクションは、次のステップの最初まで実行されます。

7.5.2 複数のカーソル

セッション内並列性では複数のカーソルを使用できます。

7.5.2.1 特別な動作

パラレル・コンテナ・タスクでは、子タスクごとに別のカーソルを開き、カーソルは最後の子タスクが終了するまでコンテナ・タスクに残ったままになります。各子カーソルを個別に使用して、タスクをステップ実行し、ブレークポイントを使用し、データまたは変数を表示できます。子カーソルは、子タスクが終了すると表示されなくなります。子カーソルでのresumeコマンドの実行は、子タスクの最後までのみ行われます。

7.5.3 ブレークポイントの使用

ブループリントのステップおよびタスクにブレークポイントを設定し、デバッグ目的で実行を一時停止できます。

7.5.3.1 「デバッグ・ブレークポイント」ウィンドウについて

「デバッグ・ブレークポイント」を使用して、すべてのブレークポイントのリストを表示します。

7.5.3.2 デザイン・ブレークポイントとランタイム・ブレークポイントについて

ランタイム・ブレークポイントおよびデザイン・ブレークポイントという2つのブレークポイント・リストがあります。

- ランタイム・ブレークポイントは、セッション・エディタの「ブループリント」タブで追加できます。ブループリント上のランタイム・ブレークポイントは、同じブループリントから開始されたセッションにわたって使用されます。シナリオ実行では、シナリオが変更されないままであるかぎり、ブループリントを再使用します。

- デザイン・ブレークポイントは、パッケージやプロシージャなど、デザイン・アーティファクトで定義されます。実行中、デザイン・ブレークポイントにより、関連付けられているブループリントにランタイム・ブレークポイントが生成されます。デザイン・ブレークポイントは、パッケージ・エディタで追加できます。

7.5.3.3 ブレークポイントの配置

ブレークポイントを追加するには:

1. 「実行」→「ブレークポイント」→「ブレークポイントの追加」を選択します。

2. ブループリントにブレークポイントを表す赤い点が配置されます。

3. 実行を開始または再開します。

4. 実行がブレークポイントで一時停止した場合は、次のことを調べます。

- データのデバッグ。「変数のデバッグ」を参照してください。

- 変数値。「変数のデバッグ」を参照してください。

- セッション・スレッドのデバッグ。「スレッドのデバッグ」を参照してください。

7.5.3.4 ブレークポイントの編集

ブレークポイントを編集するには:

1. 「実行」→「ブレークポイント」→「ブレークポイントの編集」を選択します。

2. 「ブレークポイント・プロパティ」ウィンドウが表示されます。

3. 次のプロパティを設定します。

- 有効: ブレークポイントが有効であるかどうかがチェックされます。

- 選択すると、ブレークポイントがアクティブになり、実行が一時停止されます。

- 選択を解除すると、実行中、ブレークポイントは無視されます。

- タスクの実行後に一時停止:

- 選択すると、タスクまたはステップの実行後にブレークポイントが一時停止されます。

- 選択を解除すると、タスクまたはステップの実行前にブレークポイントが一時停止されます。

- パス数: 実行を一時停止する前に、ブレークポイントがパスされる必要のある回数。0の場合は最初のパスで実行が一時停止され、1の場合は実行を一時停止する前に、ブレークポイントが1回パスされます。

4. 「OK」をクリックします。

7.5.3.5 ブレークポイントの削除

単一ブレークポイントを削除するには:

- ステップまたはタスクを右クリックして、「ブレークポイントの削除」を選択します。

すべてのブレークポイントを削除するには(「ブレークポイント」ウィンドウからのみ実行可能):

- 「実行」→「ブレークポイント」→「すべて削除」を選択します。

7.5.3.6 ブレーク・ポイントの有効化および無効化

単一ブレークポイントを有効化または無効化するには、次を選択します。

- 「実行」→「ブレークポイント」→「有効化」、または

- 「実行」→「ブレークポイント」→「無効化」。

すべてのブレークポイントを有効化または無効化するには(「ブレークポイント」ウィンドウからのみ実行可能)、次を選択します。

- 「実行」→「ブレークポイント」→「すべて有効化」、または

- 「実行」→「ブレークポイント」→「すべて無効化」。

7.5.3.7 パス数

パス数は、実行を一時停止する前に、ブレークポイントがパスされる必要のある回数を示します。0の場合はパスごとに実行が一時停止され、1の場合は最初のパスでのみ実行が一時停止され、5の場合は5番目のパスでのみ実行が一時停止されます。

7.5.4 データのデバッグ

「デバッグ・データ」タブを使用して、現在のデバッガ・タスクのコンテキストでデータを問い合せます。

「データ」ウィンドウには、「ソース・タスク・データ」と「ターゲット・タスク・データ」の2つのタブがあり、現在のタスクのソースおよびターゲットに関連付けられているデータ・サーバーの問合せが可能です。メイン・ツールバーにある「データの取得」コマンドを使用すると、現在のタスクのSQLコードが、「ソース・タスク・データ」と「ターゲット・タスク・データ」の両方のフィールドに挿入されます。ウィンドウには、SQLコマンドを入力するためのフィールドがあり、「SQLコードの実行」ボタンをクリックすると実行できます。

SQLコマンドで現在のセッションのトランザクション・コンテキストが使用され、コミットされていないデータを問い合せることができます。セッションのデバッグ実行で複数のタスクがある場合、コマンドでは「データ」ウィンドウに同期化されたタスクのコンテキストを使用します。

7.5.4.1 データの取得

データの取得により、現在選択されているタスクのSQLコードが、「デバッグ・データ」ウィンドウのSQLコマンド・フィールドに挿入されます。「ソース・タスク・データ」と「ターゲット・タスク・データ」の両方のウィンドウに移入されます。

「データの取得」コマンドは元のカーソル行と連携します。つまり、ステップ処理を継続している場合は、「データ」ウィンドウは元のカーソル行に関連付けられたままとなります。新しい現在のカーソル行に移動するには、「データの取得」を再度押す必要があります。

7.5.4.1.1 ソース・タスク・データ

通常は、ソース・コマンドのタスク・コードに、ソースからデータを取得するための選択問合せが含まれています。デフォルトでは、「ソース・タスク・データ」フィールドにこの問合せが表示されます。問合せの内容を変更せずに実行すると適切でない可能性があるため、実行前に問合せを確認して変更する必要があります。

7.5.4.1.2 ターゲット・タスク・データ

ターゲット・タスク・データには、通常、挿入や更新などのDML操作が含まれています。Oracle Data Integratorは、ターゲットSQLの解析を試みてターゲット表名を特定し、次のような単純な問合せを提供します。

select * from <parsedTargetTableName>

Oracle Data IntegratorがターゲットSQLを解析してターゲット表名を特定できない場合は、次のような推奨される問合せが表示されます。

select * from <SpecifyTargetTableName>

問合せの内容を変更せずに実行すると適切でない可能性があるため、実行前に問合せを確認して変更する必要があります。

7.5.4.2 SQLコードの実行

SQLコードの実行を行う前に、データの取得を実行する必要があります。データを表示または選択する問合せを実行できますが、データに変更を適用することはできません。

7.5.4.2.1 SQLコードの編集

SQLコードを編集し、データを問い合せるには:

1. セッションで「デバッグ・データ」タブを選択します。

2. 「データの取得」を選択して、現在のタスクのSQLコードを「ソース・タスク・データ」と「ターゲット・タスク・データ」のフィールドに挿入します。

3. SQLコマンドを編集します。select文を使用して、ターゲットの未コミット・トランザクションのデータを問い合せることができます。

4. 「SQLコードの実行」をクリックします。

7.5.5 変数のデバッグ

「デバッグ変数」タブを使用して、現在のセッションで使用されているすべての変数を表示し、ステップおよびタスクのステップ実行時の変数の変化を確認します。変数の値を変更して、セッションの実行に影響を与えることができます。

各変数に関する次の情報を表示できます。

プロパティ

説明

名前

変数の名前。

値

変数の値。変更して実行を変えることが可能です。

タイプ

変数のタイプ。

7.5.5.1 変数の変更

変数を変更するには:

1. 必要な場合、ブレークポイントを設定します。「ブレークポイントの使用」を参照してください。

2. ブループリント内でカーソルを配置します。

3. 「デバッグ変数」タブで、値を変更する変数を選択します。

4. セッションの実行を開始または再開します。

7.5.6 スレッドのデバッグ

「デバッグ・スレッド」タブを使用すると、接続されているセッション・エディタのすべてのスレッドがフォーカスして表示されます。スレッドのアイコンは、スレッドが一時停止されているか実行されているかを表示します。

7.5.6.1 ソースへ移動

各スレッドの「ソースへ移動」コンテキスト・メニュー・コマンドを使用すると、ブループリント内のスレッドの場所にジャンプします。

7.6 デバッグ・セッションの管理

「ウィンドウ」→「デバッガ」→「デバッグ・セッション」を選択して、「デバッグ・セッション」ウィンドウですべてのアクティブなデバッグ・セッションのリストを表示できます。

「デバッグ・セッション」ウィンドウで、リストされているセッションへの接続または切断が可能です。

プロパティ

説明

エージェント

セッションを実行するエージェント。

セッション番号

セッションのID。

セッション名

セッション名。

セッション接続済

セッションがデバッガ・クライアントに接続されているかされていないかが表示されます。

7.6.1 標準停止および即時停止

セッションを正常に切断し、即時に切断できます。

1. 「デバッグ・セッション」ウィンドウで、リスト内のセッションを右クリックし、「デバッグ・セッションの切断」を選択します。
セッションがStudioでアクティブになります。

2. セッション・ウィンドウの左上にある「切断」ボタンを選択して、次を選択します。

- 標準停止: セッションは、現在のタスクの終了後に停止されます。

- 即時停止: 現在のタスクがすぐに中断されてセッションが停止されます。このモードを使用すると、長時間実行されているタスク、たとえば長いSQL文をその完了前に停止できます。

3. 「OK」をクリックし、切断を確定します。

4. セッションが停止すると、「セッションのデバッグが完了しました。」というメッセージが表示されます。セッションは「デバッグ・セッション」リストから削除されます。

「セッションの停止」を参照してください。

7.6.2 実行の再開

セッション・ウィンドウで、停止したセッションを再開できます。

セッションを再開するには:

1. セッション・ウィンドウの左上で、「実行再開」を選択します。
「実行再開」ウィンドウが表示されます。

2. セッションを実行するエージェントを選択するには、次のいずれかのオプションを選択します。

- 前のエージェントを使用: 前のセッション実行に使用されたエージェントを使用するために<agent name>を指定する場合。

- 別のエージェントを選択: セッション実行に使用するエージェントを選択する場合。ODI Studio組込みのエージェントを使用する場合は、「内部」を選択します。

3. ログ・レベルを選択します。ログ・レベル6は、ログ・レベル5と動作は同じですが、変数と順序の追跡が追加されています。

4. 表示されたセッションを再開してダイアログを閉じるには、「OK」をクリックします。
情報メッセージ「セッションが起動しました」が表示され、セッションが「デバッグ・セッション」リストに追加されます。

失敗したセッションをデバッグ・モードで再開するには、次の手順を実行します。

1. ナビゲータ・ツリーで、失敗したセッションを選択します。

2. 右クリックして、「デバッグ」を選択します。

3. 「デバッグ」ウィンドウで、「デバッグ・セッションのオプション」で説明しているオプションを構成します。

4. 「OK」をクリックします。
情報メッセージで、セッションが再開されたことが示されます。

8 統合プロセスのモニタリング

この章では、オペレータ・ナビゲータで開発実行を管理する方法について説明します。オペレータ・ナビゲータのユーザー・インタフェースの概要も示します。

この章には次の項が含まれます:

- モニタリングの概要

- 実行結果のモニタリング

- 実行の管理

8.1 モニタリングの概要

開発実行のモニタリングには、実行が成功した場合またはエラーになった場合の実行結果の表示、および開発実行の管理が含まれます。この項では、Oracle Data Integratorのモニタリング機能の概要を示します。実行結果の使用方法については、「実行結果のモニタリング」を参照してください。開発実行の管理方法については、「実行の管理」を参照してください。

8.1.1 オペレータ・ナビゲータの概要

オペレータ・ナビゲータを使用すると、実行結果を表示でき、セッションの開発実行および本番のシナリオとロード計画を管理できます。

オペレータ・ナビゲータは、マスター・リポジトリに定義されているトポロジを使用して、この情報を作業リポジトリに格納します。

オペレータ・ナビゲータでは、現在のユーザーが使用できるオブジェクトが6つのナビゲーション・ツリーに表示されます。

- 「セッション・リスト」には、日付、物理エージェント、ステータス、キーワードなどの単位で編成されたすべてのセッションが表示されます。

- 「階層セッション」には、子セッションとともに階層構造に編成された実行セッションが表示されます。

- 「ロード計画実行」には、ロード計画インスタンスのロード計画実行が表示されます。

- 「スケジューリング」には、論理エージェントとスケジュールのリストが表示されます。

- 「ロード計画とシナリオ」には、使用可能なシナリオとロード計画のリストが表示されます。

- 「ソリューション」には、ソリューションのリストが表示されます。

オペレータ・ナビゲータのツールバー・メニュー

主なモニタリング・タスクは、オペレータ・ナビゲータのツールバー・メニューから実行できます。オペレータ・ナビゲータのツールバー・メニューから、表8-1で説明されている機能にアクセスできます。

表8-1 オペレータ・ナビゲータのツールバー・メニュー項目

アイコン

メニュー項目

説明

リフレッシュ

「リフレッシュ」をクリックすると、オペレータ・ナビゲータのツリーをリフレッシュできます。

フィルタ

アクティブ化されたフィルタ

「フィルタ」をクリックすると、オペレータ・ナビゲータに表示するセッションに対するフィルタを定義できます。

自動リフレッシュ

「自動リフレッシュ」をクリックすると、オペレータ・ナビゲータのツリーを自動的にリフレッシュできます。

ナビゲータの接続

「ナビゲータの接続」をクリックすると、オペレータ・ナビゲータのツールバー・メニューにアクセスできます。オペレータ・ナビゲータのツールバー・メニューから、次の処理を実行できます。

- シナリオのインポート

- ログのインポートおよびエクスポート

- 複数のエクスポートの実行

- ログのパージ

- スケジューリング情報の表示

- 失効したセッションの除去

- 一時オブジェクトの削除

8.1.2 シナリオ

シナリオは、ソース・コンポーネント(マッピング、パッケージ、プロシージャ、変数)を本番に移行するために設計されます。シナリオは、このコンポーネント用のコード(SQL、シェルなど)の生成結果として作成されます。

シナリオが実行されると、セッションが作成されます。

本番環境にインポートしたシナリオは、ロード計画とシナリオ・フォルダに編成できます。詳細は、「シナリオとロード計画の管理」を参照してください。

8.1.3 セッション

Oracle Data Integratorでは、実行がセッションになります。セッションは、オペレータ・ナビゲータで表示および管理できます。

セッションとは、実行エージェントが担当する1回の実行(シナリオ、マッピング、パッケージ、プロシージャなど)です。セッションはステップで構成され、ステップはタスクで構成されます。

ステップは、タスクとセッションの間に位置する実行単位です。パッケージまたはシナリオ内の1つのステップに対応します。たとえば、マッピングまたは単一の変数を実行した場合、結果のセッションのステップは1つのみです。

セッションで使用するデータ・サーバーに対して接続時のコマンドと切断時のコマンドを設定した場合は、「接続時のコマンド」と「切断時のコマンド」という特別な2つのステップが作成されています。詳細は、「接続時または切断時のコマンドの設定」を参照してください。

タスクは、最小の実行単位です。KM内のコマンド、プロシージャなどに対応します。

セッションはセッション・フォルダにグループ化できます。セッション・フォルダでは、特定のキーワードを指定して起動されたセッションが自動的にグループ化されます。詳細は、「セッション・フォルダを使用したログの編成」を参照してください。

セッションを停止したり、失効したセッションを除去するには、特定の権限が必要になります。これらの権限を次にリストします。

次のいずれかのセッション権限を持っている場合、セッションを停止できます。

- スーパーバイザ・ユーザーであること。

- セッションの開始者であり、セッションの所有者であること。

- 「即時停止」権限または「標準停止」権限が明示的に割り当てられていること。「オブジェクト」ツリーを展開して、特定のプロファイルのセッション・オブジェクト・ノードを展開すると、これらのメソッド・オブジェクトがセキュリティ・ナビゲータに表示されます。

次のいずれかのセッション権限を持っている場合、失効したセッションを除去できます。

- スーパーバイザ・ユーザーであること。

- 「失効したセッションの除去」権限が明示的に割り当てられていること。「オブジェクト」ツリーを展開して、特定のプロファイルのエージェント・オブジェクト・ノードを展開すると、このメソッド・オブジェクトがセキュリティ・ナビゲータに表示されます。

OPERATORまたはNG OPERATORプロファイルが割り当てられている場合は、セッションを停止したり、失効したセッションを除去することもできます。

8.1.4 ロード計画

ロード計画は、Oracle Data Integratorの実行可能オブジェクトの最も粗密なタイプで、きめの細かいオブジェクトの実行および編成に使用されます。そのステップではシナリオが使用されます。ロード計画は、子ステップを階層に編成したものです。この階層では、ステップの条件付き処理が並列または順次で行えます。

本番環境にインポートしたロード計画は、ロード計画とシナリオ・フォルダに編成できます。詳細は、「シナリオとロード計画の管理」を参照してください。

8.1.5 ロード計画の実行

ロード計画を実行すると、ロード計画インスタンスとそのインスタンスの最初のロード計画実行が作成されます。このロード計画インスタンスは元のロード計画から切り離されるため、個別に変更できます。ロード計画インスタンスが再開されるたびに、そのロード計画インスタンスのロード計画実行が作成されます。ロード計画実行は、インスタンスの実行の試行に対応しています。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のロード計画実行ライフサイクルに関する項を参照してください。

実行時に、ロード計画実行では、ロード計画で順番に並べられたシナリオに対応するセッションを開始します。

ロード計画実行のリストには、ロード計画実行のみが表示されることに注意してください。各実行は、ロード計画インスタンスIDと試行(実行)番号で識別されます。

8.1.6 スケジュール

シナリオとロード計画の実行は、Oracle Data Integratorの組込みスケジューラまたは外部スケジューラを使用してスケジュールできます。これらの方法については、「シナリオとロード計画のスケジューリング」を参照してください。

スケジュールは、デザイナ・ナビゲータおよびオペレータ・ナビゲータ内で、シナリオまたはロード計画の「スケジューリング」ノードの下に表示されます。各スケジュールには、開始日と反復サイクルを指定できます。

8.1.7 ログ

Oracle Data Integratorのログは、リポジトリに格納されているすべてのセッションおよびロード計画のインスタンス/実行に対応します。このログは、モニタリングのためにエクスポート、パージまたはフィルタ処理できます。詳細は、「ログの管理」を参照してください。

8.1.8 ステータス

セッション、ステップ、タスクまたはロード計画実行には、常にステータスが割り当てられます。表8-2に、割り当てられる可能性がある6つのステータス値を示します。

表8-2 ステータス値

ステータス名

セッションのステータス・アイコン

ロード計画のステータス・アイコン

ステータスの説明

完了

ロード計画、セッション、ステップまたはタスクは正常に実行されました。

前回の実行で完了

ロード計画ステップは前回のロード計画実行で実行されました。このアイコンは再開後に表示されます。

エラー

ロード計画、セッション、ステップまたはタスクは、エラーのために終了しました。

実行中

ロード計画、セッション、ステップまたはタスクは実行中です。

待機中

ロード計画、セッション、ステップまたはタスクは実行を待機中です。

警告(セッションとタスクのみ)

- セッションの場合: セッションは正常に完了しましたが、データ品質チェック中にエラーが検出されました。

- タスクの場合: タスクはエラーで終了しましたが、このタスクではエラーが許容されるため、セッションは停止されませんでした。

キュー(セッションのみ)

セッションは、エージェントが実行可能な状態になるのを待機中です。

セッションが終了すると、そのステータスは最後に実行されたステップのステータス(「完了」または「エラー」)になります。ステップが終了すると、そのステータスは最後に実行されたタスクのステータスになります(タスクによって「警告」が戻された場合を除きます。この場合、ステップのステータスは「完了」になります)。

ロード計画のすべての子ステップが正常に実行された場合、そのロード計画は成功(「完了」ステータス)です。ロード計画の子ステップの少なくとも1つがエラーになり、ルート・ステップに対して例外が生成された場合は、ステータスが「エラー」になります。

8.1.9 タスク・タイプ

タスクは、セッションのステップ内のノードです。タスクのタイプを表8-3に示します。

表8-3 タスク・タイプ

タスク・タイプ

セッションのタスク・アイコン

タスクの説明

標準タスク

このタスクは、セッションにおける連続的な位置に従って実行されます。正常に完了すると、完了ステータスのマークが付けられます。エラー・ステータスで完了した場合、タスクは失敗し、エラー・ステータスのマークが付けられます。

シリアル・タスク

子タスクが順番に実行されます。シリアル・タスクは、すべての子タスクが正常に完了すると完了し、完了ステータスのマークが付けられます。最初の子タスクがエラー・ステータスで完了した場合は失敗したとみなされ、エラー・ステータスのマークが付けられます。

パラレル・タスク

子タスクが同時に実行されます。パラレル・タスクは、すべての子タスクが正常に完了すると完了とみなされ、完了ステータスのマークが付けられます。いずれかの子タスクが失敗した場合は失敗したとみなされ、エラー・ステータスのマークが付けられます。

8.2 実行結果のモニタリング

Oracle Data Integratorでロード計画が実行された場合は、実行がセッションまたはロード計画実行になります。セッションはステップで構成され、ステップはタスクで構成されます。セッションは、オペレータ・ナビゲータで表示および管理できます。

ロード計画実行はオペレータ・ナビゲータに表示されます。ロード計画実行の各ステップを確認するには、その実行用のエディタを開きます。ロード計画に関連付けられているセッションが、残りのセッションとともにオペレータ・ナビゲータに表示されます。

8.2.1 セッションのモニタリング

セッションをモニターするには:

1. オペレータ・ナビゲータで、「セッション・リスト」ナビゲーション・ツリーを展開します。

2. 「すべての実行」ノードを展開し、ナビゲータのツールバーの「リフレッシュ」をクリックします。

3. オプションで、フィルタをアクティブ化し、表示されるセッションの数を削減します。詳細は、「セッションのフィルタリング」を参照してください。

4. セッションのリストで、セッションのステータスを確認します。

8.2.2 ロード計画実行のモニタリング

ロード計画実行をモニターするには:

1. オペレータ・ナビゲータで、「ロード計画実行」ナビゲーション・ツリーを展開します。

2. 「すべての実行」ノードを展開し、ナビゲータのツールバーの「リフレッシュ」をクリックします。

3. リストで、ロード計画実行のステータスを確認します。

4. ロード計画実行をダブルクリックし、ロード計画実行エディタを開きます。

5. ロード計画実行エディタで、「ステップ」タブを選択します。

6. ロード計画の各ステップの状態を確認します。このタブで、次のタスクを実行できます。

- エディタのツールバーで「リフレッシュ」をクリックし、表の内容を更新します。

- シナリオ実行ステップの場合は、「セッションID」列内をクリックし、このロード計画によって開始されたステップのセッションを開きます。

8.2.3 失敗したセッションの処理

セッションがエラーまたは警告で終了した場合は、エラーをオペレータ・ナビゲータで分析できます。

エラーを分析するには:

1. オペレータ・ナビゲータで、エラーが発生したセッション、ステップおよびタスクを識別します。

2. エラーが発生したタスクをダブルクリックします。タスク・エディタが開きます。

3. 「実行統計」セクションの「定義」タブに、セッションを停止したエラーを示すリターン・コードとメッセージが表示されます。「実行の詳細」セクションに、ロード・タスクのパフォーマンスに関するメトリックおよびパフォーマンスに影響を与える構成データが表示されます。

4. 「コード」タブにタスクのソース・コードとターゲット・コードが表示され、確認および編集できます。
オプションで、解決済の変数値および順序値とともにコードを表示するには、「値の表示/非表示」をクリックします。次の点に注意してください。

- 変数値が表示されている場合、コードは読取り専用になります。これで変数値を追跡できます。

- パスワードとして使用される変数は表示されません。

詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の変数と順序の追跡に関する項を参照してください。

5. 「接続」タブで、コードが実行されたソース接続とターゲット接続を確認できます。

「コード」タブでコマンドのコードを修正して、変更内容を適用します。このアクションの実行後、セッションの再開が可能です(「セッションの再開」を参照)。セッションは、エラーが発生したタスクから再開されます。

注意:
セッションのタスクのコードを修正しても、実行されたソース・オブジェクト(マッピング、プロシージャ、パッケージまたはシナリオ)は修正されません。このソース・オブジェクトはデザイナ・ナビゲータで修正する必要があり、シナリオ(ある場合)は再生成する必要があります。セッション内のコードの変更は、問題をデバッグするために有効です。

警告:

セッションが失敗した場合は、ソース・システムとターゲット・システムに対するすべての接続およびトランザクションがロールバックされます。この結果、トランザクションでコミットされていない文は適用されません。

8.2.4 成功したセッションの確認

セッションが正常に終了した場合は、実行された変更をオペレータ・ナビゲータで表示できます。これらの変更には、挿入、更新、削除、エラーの数、合計行数などのレコード統計の他、実行の開始時間と終了時間、継続時間(秒)、リターン・コードおよびメッセージ(ある場合)などの実行統計があります。

セッション・レベルの統計では、このセッションの全ステップの統計が集計され、各ステップの統計では、このステップ内の全タスクの統計が集計されます。

実行統計を確認するには:

1. オペレータ・ナビゲータで、確認するセッション、ステップまたはタスクを識別します。

2. セッション、ステップまたはタスクをダブルクリックします。対応するエディタが開きます。

3. レコード統計および実行統計が「定義」タブに表示されます。

レコード統計

プロパティ

説明

挿入数

セッション/ステップ/タスク中に挿入された行数。

更新数

セッション/ステップ/タスク中に更新された行数。

削除数

セッション/ステップ/タスク中に削除された行数。

エラー数

セッション/ステップ/タスク中にエラーが発生した行数。

行数

セッション/ステップ/タスク中に処理された合計行数。

実行統計

プロパティ

説明

開始

セッション/ステップ/タスクの実行開始日時。

終了

セッション/ステップ/タスクの実行終了日時。

期間(秒)

セッション/ステップ/タスクの実行に要した時間。

リターン・コード

セッション/ステップ/タスクのリターン・コード。

実行の詳細

ロード・タスクのパフォーマンスに関するメトリックおよびパフォーマンスに影響を与える構成データが表示されます。

マッピングまたはデータストア・チェックが実行されたセッション・ステップの場合は、ターゲット表の詳細が表示されます。マッピングが実行されたセッション・ステップの場合は、セッション・ステップ・エディタの「ナレッジ・モジュール詳細」セクションに、マッピングで使用されたナレッジ・モジュールが表示されます。

セッションの追跡が有効になっている場合、セッション・ステップ・エディタおよびセッション・タスク・エディタの「変数値と順序値」セクションに変数または順序に関する情報が表示されます。

セッション・エディタの「同時実行コントローラ」セクションに、セッションの同時実行を制限するために選択したオプションが表示されます。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のシナリオおよびロード計画の同時実行の制御に関する項を参照してください。

8.2.5 失敗したロード計画の処理

ロード計画がエラーで終了した場合は、失敗したセッションおよびロード計画の失敗の原因となったセッションを確認します。失敗したセッションのソースを修正します。

ロード計画インスタンスは再開できます。詳細は、「ロード計画実行の再開」を参照してください。

ロード計画インスタンスは、そのステップに定義されている再開タイプに基づいて再開されることに注意してください。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のロード計画の例外および再開可能の処理に関する項を参照してください。

また、ロード計画実行が次回再開したときに、ロード計画のこの特定のステップを無視するように、「ロード計画実行」エディタの「ステップ」タブで、失敗したロード計画ステップの実行ステータスを「エラー」から「完了」に変更することもできます。これは、このロード計画ステップが失敗する原因のエラーを現時点では修正できない場合や、このロード計画ステップに関係なく残りのロード計画を実行する必要がある場合などに便利です。

8.2.6 成功したロード計画の確認

ロード計画が正常に終了した場合は、ロード計画実行エディタから実行統計を確認できます。

このロード計画に対して開始した各セッションの統計は、セッション・エディタで確認することもできます。

ロード計画実行の実行統計を確認するには:

1. オペレータ・ナビゲータで、確認するロード計画実行を識別します。

2. ロード計画実行をダブルクリックします。対応するエディタが開きます。

3. 「ステップ」タブに、レコードと実行統計が表示されます。

8.3 実行の管理

開発実行の管理は、オペレータ・ナビゲータで実行します。実行するアクションに応じて、実行プロセス中または実行終了後に実行を管理できます。実行可能なアクションは、次のとおりです。

- セッションの管理

- ロード計画実行の管理

- ログの管理

- シナリオとロード計画の管理

- スケジュールの管理

8.3.1 セッションの管理

セッションの管理には、次のタスクが含まれます。

- ランタイム・オブジェクトまたはシナリオを実行することで新規セッションを作成できます。セッションの開始の詳細は、「統合プロセスの実行」を参照してください。

- 進行中のセッションを中断できます。セッションの停止方法については、「セッションの停止」を参照してください。

- 失敗したセッションまたはユーザー・アクションによって停止されたセッションを再開できます。セッションの再開については、「セッションの再開」を参照してください。

これらのタスクに加えて、本番では失効したセッションの処理が必要になる場合があります。

8.3.1.1 失効したセッションの除去

失効したセッションとは、エージェントまたはリポジトリのクラッシュ後、誤って実行状態のままになったセッションのことです。

セッションが失効した場合は、このセッションを開始したエージェントによって自動的に検出され、そのステータスが「エラー」に変更されます。オペレータ・ナビゲータまたはトポロジ・ナビゲータで、特定のエージェントに対して、失効したセッションを除去するように手動でリクエストできます。

失効したセッションを手動で除去するには:

1. 次のいずれかの操作を行います。

- オペレータ・ナビゲータのツールバー・メニューから「失効したセッションの除去」を選択します。

- トポロジ・ナビゲータで、「物理アーキテクチャ」ナビゲーション・ツリーからエージェントを選択し、右クリックして「失効したセッションの除去」を選択します。

「失効したセッションの除去」ダイアログが開きます。

2. 「失効したセッションの除去」ダイアログで、失効したセッションを除去するための基準を指定します。

- リストから、失効したセッションを除去するエージェントを選択します。
すべてのエージェントの失効したセッションを除去する場合は、「すべてのエージェントを除去」を選択します。

- リストから、除去する作業リポジトリを選択します。
すべての作業リポジトリの失効したセッションを除去する場合は、「すべての作業リポジトリを除去」を選択します。

3. 「OK」をクリックすると、除去処理を開始します。除去処理の進行状況が進行状況バーに示されます。

失効したセッションを除去するには、特定の権限が必要になります。詳細は、「セッション」を参照してください。

8.3.1.2 一時オブジェクトの削除

実行間で残っている可能性のある一時オブジェクトを削除するには、次の手順を実行します。

1. オペレータ・ナビゲータのツールバー・メニューから、「一時オブジェクトの削除」を選択します。

2. 「一時オブジェクトの削除」ダイアログで、表8-4に示す基準を設定します。

表8-4 「一時オブジェクトの削除」ダイアログのパラメータ

パラメータ

説明

セッション数

クリーンアップをスキップするセッション数。カウントがゼロの場合、フィルタ基準と一致するすべてのセッションがクリーンアップされます。

開始

クリーンアップの開始日。この日付以降に開始したセッションはすべてクリーンアップされます。

終了

クリーンアップの終了日。この日付以前に開始したセッションはすべてクリーンアップされます。

コンテキスト

このコンテキストで実行されたセッションのみをクリーンアップします。

エージェント

このエージェントによって実行されたセッションのみをクリーンアップします。

ユーザー

このユーザーによって起動されたセッションのみをクリーンアップします。

セッション名

セッション名。

3. 「OK」をクリックします。

8.3.2 ロード計画実行の管理

ロード計画実行の管理には、次のタスクが含まれます:

- ロード計画を実行することで新規ロード計画のインスタンスと実行を作成できます。ロード計画の開始については、「ロード計画の実行」を参照してください。

- 進行中のロード計画実行を中断できます。ロード計画実行の停止方法については、「ロード計画実行の停止」を参照してください。

- 失敗したロード計画実行またはユーザー・アクションによって停止されたロード計画実行を再開できます。ロード計画実行の再開については、「ロード計画実行の再開」を参照してください。

8.3.3 ログの管理

Oracle Data Integratorには、ログ・データを管理するためのソリューションが複数用意されています。

- セッションのフィルタリング: オペレータ・ナビゲータに特定の実行セッションのみを表示する場合

- ログのパージ: 過去のセッションの情報を削除する場合

- セッション・フォルダを使用したログの編成

- ログ・データのエクスポートおよびインポート: アーカイブ目的の場合

- ODIコンポーネントのランタイム・ロギング: (ODI Studio、ODI Java EEエージェント、ODIスタンドアロン・エージェントおよびODIスタンドアロン・コロケート・エージェント)

8.3.3.1 セッションのフィルタ処理

ユーザー、ステータス、セッション継続時間などのパラメータに基づいてログ・セッションをフィルタリングすると、オペレータ・ナビゲータに特定の実行セッションのみを表示できます。現在のフィルタに一致しないセッションは、ビューで非表示になりますが、ログからは削除されません。

セッションをフィルタ処理するには:

1. オペレータ・ナビゲータのツールバー・メニューで、「フィルタ」をクリックします。フィルタの定義エディタが開きます。

2. フィルタの定義エディタで、必要に応じてフィルタ基準を設定します。デフォルト設定ではすべてのセッションが選択されることに注意してください。

- セッション番号: すべてのセッションを表示する場合は、空白を使用します。

- セッション名: ワイルドカードとして%を使用します。たとえば、DWH%と指定すると、名前がDWHで始まるすべてのセッションが一致します。

- セッションの実行コンテキスト。

- セッションの実行に使用されるエージェント。

- セッションを開始したユーザー。

- ステータス: 「実行中」、「待機中」など。

- 実行の日付: 開始日または終了日(あるいはその両方)を指定します。

- 継続時間が次より長い: 基準となる秒数を指定します。

3. 「適用」をクリックして現在のフィルタをプレビューします。

4. 「OK」をクリックします。

これらの基準と一致しないセッションは、「セッション・リスト」ナビゲーション・ツリーで非表示になります。ツールバーの「フィルタ」ボタンがアクティブ化されます。

フィルタを解除するには、オペレータのツールバー・メニューにある「フィルタ」をクリックします。現在のフィルタが解除され、すべてのセッションがリストに表示されます。

8.3.3.2 ログのパージ

ログのパージを使用すると、過去のセッションおよびロード計画実行をログから削除できます。この方法は、作業リポジトリにアーカイブされたセッションおよびロード計画の量を適切に保つために使用されます。パージは定期的に実行することをお薦めします。シナリオでOdiPurgeLogツールを使用すると、このパージを自動化できます(Oracle Data Integratorツール・リファレンスのOdiPurgeLogに関する項を参照)。

ログをパージするには:

1. オペレータ・ナビゲータのツールバー・メニューから、「ナビゲータの接続」→「ログのパージ」の順に選択します。ログのパージ・エディタが開きます。

2. ログのパージ・エディタで、削除するセッションまたはロード計画実行に対して、表8-5にリストされている基準を設定します。

表8-5 ログのパージ・パラメータ

パラメータ

説明

パージ・タイプ

パージするオブジェクトを選択します。

範囲

この時間範囲のセッションまたはロード計画実行(あるいはその両方)が削除されます。

セッション・ログのみのパージを選択した場合、ロード計画実行の一部として起動したセッションはフィルタ基準と一致した場合でもパージされません。ロード計画実行をパージした場合は、フィルタ基準に一致したロード計画実行、およびそのロード計画実行の一部として直接開始したセッションとその子/孫セッションが削除されます。

コンテキスト

このコンテキストで実行されたセッションまたはロード計画実行(あるいはその両方)が削除されます。

エージェント

このエージェントによって実行されたセッションまたはロード計画実行(あるいはその両方)が削除されます。

ステータス

このステータスのセッションまたはロード計画実行(あるいはその両方)が削除されます。

ユーザー

このユーザーによって実行されたセッションまたはロード計画実行(あるいはその両方)が削除されます。

名前

このセッション名と一致するセッションまたはロード計画実行(あるいはその両方)が削除されます。%をワイルドカードとして使用して、セッション名マスクを指定できます。

シナリオ・レポートのパージ

「シナリオ・レポートのパージ」を選択した場合は、シナリオ・レポート(各シナリオの実行ノードの下に表示されるレポート)もパージされます。

指定したフィルタと一致するセッションまたはロード計画実行(あるいはその両方)のみが次のように削除されます。

- セッション・ログのみのパージを選択した場合、ロード計画実行の一部として開始したセッションはフィルタ基準と一致した場合でもパージされません。

- ロード計画実行をパージした場合は、フィルタ基準に一致したロード計画実行、およびそのロード計画実行の一部として直接開始したセッションとその子/孫セッションが削除されます。

- ロード計画実行がフィルタと一致した場合は、関連するすべてのセッションもフィルタ基準と一致するかどうかに関係なくパージされます。

3. 「OK」をクリックします。

Oracle Data Integratorによって、セッションまたはロード計画実行(あるいはその両方)がログから削除されます。

注意:
オペレータ・ナビゲータで1つ以上のセッションまたはロード計画実行を選択して[Delete]キーを押す方法で、セッションまたはロード計画実行を削除することもできます。この方法でロード計画実行を削除すると、対応するセッションが削除されます。

8.3.3.3 セッション・フォルダを使用したログの編成

セッション・フォルダを使用すると、ログを編成できます。セッション・フォルダでは、特定のキーワードを使用して開始されたセッションおよびロード計画実行を自動的にグループ化します。セッション・フォルダは、「セッション・リスト」または「ロード計画実行」ナビゲーション・ツリーの「キーワード」ノードの下に作成されます。

各セッション・フォルダには、関連付けられた1つ以上のキーワードがあります。セッション・フォルダのすべてのキーワードを使用して起動されたセッションは、そのフォルダの下に自動的に分類されます。

新規セッション・フォルダを作成するには:

1. オペレータ・ナビゲータで、「セッション・リスト」または「ロード計画実行」ナビゲーション・ツリーに移動します。

2. 「キーワード」ノードを右クリックして、「新規セッション・フォルダ」を選択します。

3. 「フォルダ名」を指定します。

4. 「追加」をクリックして、キーワードをリストに追加します。追加するキーワードごとにこの手順を繰り返します。

注意:
特定のセッション・フォルダの中ですべてのキーワードを含むセッションまたはロード計画のみが、そのセッション・フォルダの下に表示されます。キーワードの照合では、大文字と小文字が区別されます。

表8-6は、セッション・フォルダ・キーワードの照合方法の例を示しています。

表8-6 セッション・フォルダ・キーワードの照合

セッション・フォルダ・キーワード

セッション・キーワード

一致

DWH、Test、Batch

Batch

いいえ - すべてのキーワードが一致する必要があります。

Batch

DWH、Batch

はい - セッションのその他のキーワードは無視されます。

DWH、Test

Test、dwh

いいえ - 照合では大文字と小文字が区別されます。

キーワードを使用してセッションを開始するには、たとえば、-KEYWORDSパラメータを使用してコマンド行からシナリオを開始できます。詳細は、「統合プロセスの実行」を参照してください。

注意:
セッション・フォルダのキーワード照合は動的に処理されます。セッション・フォルダのキーワードが変更されるか、新規フォルダが作成されると、既存のセッションは即時に再分類されます。

8.3.3.4 ログ・データのエクスポートおよびインポート

アーカイブ目的でログ・データをエクスポートおよびインポートします。

ログ・データのエクスポート

ログ・データのエクスポートでは、アーカイブ目的でログ・ファイルをエクスポートできます。

ログをエクスポートするには:

1. デザイナ、トポロジ、セキュリティまたはオペレータ・ナビゲータのツールバー・メニューから「エクスポート」を選択します。

2. 「選択項目のエクスポート」ダイアログで、「ログのエクスポート」を選択します。

3. 「OK」をクリックします。

4. 「ログのエクスポート」ダイアログで、表8-7の説明に従って、ログ・エクスポート・パラメータを設定します。

表8-7 ログ・エクスポート・パラメータ

プロパティ

説明

ディレクトリへエクスポート

エクスポート・ファイルが作成されるディレクトリ。

ZIPファイルにエクスポート

このオプションを選択した場合は、すべてのログ・エクスポート・ファイルを含んだ単一の圧縮ファイルが作成されます。そうしない場合は、ログ・エクスポート・ファイルのセットが作成されます。

ZIPファイル名

圧縮されたエクスポート・ファイルの名前。

フィルタ

この一連のオプションによって、指定したパラメータに応じてエクスポートするログ・ファイルをフィルタ処理できます。

ログ・タイプ

ログを取得するオブジェクトをリストから選択します。選択可能な値は、「すべて」、「ロード計画実行およびアタッチされたセッション」または「セッション」です。

開始および終了

実行日: 「開始」の日付または「終了」の日付、またはその両方を指定します。

エージェント

セッションの実行に使用されるエージェント。特定のエージェントに基づいたフィルタ処理を行わない場合は、デフォルトの「すべてのエージェント」の値をそのまま使用します。

コンテキスト

セッションの実行コンテキスト。コンテキストに依存したフィルタ処理を行わない場合は、デフォルトの「すべてのコンテキスト」の値をそのまま使用します。

ステータス

指定できる状態はDone、Error、Queued、Running、Waiting、Warning、All Statesです。特定のセッション状態に基づいたフィルタ処理を行わない場合は、デフォルトの「すべての状態」の値をそのまま使用します。

ユーザー

セッションを起動したユーザー。特定のユーザーに基づいたフィルタ処理を行わない場合は、デフォルトの「すべてのユーザー」の値をそのまま使用します。

セッション名

ワイルドカードとして%を使用します。たとえば、DWH%と指定すると、名前がDWHで始まるすべてのセッションが一致します。

暗号化

これらのフィールドでは、エクスポートされるオブジェクトに含まれている機密データの暗号化に使用するエクスポート・キーを入力できます。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のエクスポート・キーに関する項を参照してください。

エクスポート・キー

エクスポート中に必要な任意の機密データを暗号化するためのAES KEYを指定します。

エクスポート・キー文字列は最小8文字および最長100文字です。少なくとも1つの特殊文字(@、#、$、%、+、/、=)または数字、および少なくとも1つの小文字または大文字のアルファベット文字が必要です。

エクスポート・キーの確認

エクスポート・キーを再入力します。

エクスポート・キーの保存

選択した場合、将来のエクスポートに備えてエクスポート・キーは保存されます。

拡張オプション

この一連のオプションによって、出力ファイル形式をパラメータ化できます。

文字セット

エクスポート・ファイルに指定するエンコーディング。XMLファイル・ヘッダーのパラメータencodingの値です。

<?xml version="1.0" encoding="ISO-8859-1"?>

Java文字セット

ファイル生成に使用されるJava文字セット。

5. 「OK」をクリックします。

ログ・データは、指定した場所にエクスポートされます。

また、OdiExportLogツールを使用してログ・データ・エクスポートを自動化することもできます(Oracle Data Integratorツール・リファレンスのOdiExportLogに関する項を参照)。

ログ・データのインポート

ログ・データのインポートでは、アーカイブ目的でエクスポートされたログ・ファイルを作業リポジトリにインポートできます。

ログをインポートするには:

1. デザイナ、トポロジ、セキュリティまたはオペレータ・ナビゲータのツールバー・メニューから「インポート...」を選択します。

2. 「選択項目のインポート」ダイアログで、「ログのインポート」を選択します。

3. 「OK」をクリックします。

4. 「ログのインポート」ダイアログで、次の手順を実行します。

1. インポート・モードを選択します。セッションは、「シノニム・モードINSERT」モードでのみインポートできることに注意してください。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のインポート・モードに関する項を参照してください。

2. ファイルをフォルダからインポートするか、ZIPファイルからインポートするかを選択します。

3. ファイル・インポート・フォルダまたはzipファイルを入力します。

4. 「OK」をクリックします。

5. 要求されたら、ログ・データのエクスポート時に使用されたエクスポート・キーを入力します。エクスポート・キーを入力しない場合、暗号化された機密(暗号)データはインポート済ログ・データから削除されます。エクスポート・キーの詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のエクスポート・キーに関する項を参照してください。

指定したフォルダまたはZIPファイルが作業リポジトリにインポートされます。

8.3.3.5 ODIコンポーネントのランタイム・ロギング

ランタイム・ロギングを設定してODIコンポーネントを追跡したり、様々な問題の調査やシステムのモニターのために詳細なレベルに設定することができます。トレースできるODIコンポーネントは、ODI Studio、ODI Java EEエージェント、ODIスタンドアロン・エージェントおよびODIスタンドアロン・コロケート・エージェントです。

注意:
詳細なロギングでは、ODIのパフォーマンスは低下します。

ログ・レベル

ログ・レベルは、log_handler要素またはlogger要素(あるいはその両方)に対して設定できます。ODIコンポーネントのログ構成ファイルでログ・レベルを設定する際は、次の点に注意してください。

- log_handlerに対して設定した場合は、そのlog_handlerのすべての使用に適用されます。

- loggerに対して設定した場合は、そのハンドラのすべてと、明示的にレベルが設定されていない下位のすべてのloggerに適用されます。

- メッセージのログ・レベルが次の条件に該当する場合、そのメッセージはログに記録されます。

- そのloggerのレベル以上(>=)、かつ

- そのlog_handlerのレベル以上(>=)

ODIコンポーネントでは、Oracle Javaデバッグ・レベル(OJDL)が使用されます。表8-8に、Javaのログ・レベルとOracle Javaデバッグ・レベルのマッピングを示します。

表8-8 Javaのログ・レベルとOracle Javaデバッグ・レベルのマッピング

Javaのログ・レベル

Oracle Javaデバッグ・レベル

SEVERE intValue()+100

INCIDENT_ERROR:1

SEVERE

ERROR:1

WARNING

WARNING:1

INFO

NOTIFICATION:1

CONFIG

NOTIFICATION:16

FINE

TRACE:1

FINER

TRACE:16

FINEST

TRACE:32

ランタイム・ロギングの設定

ランタイム・ロギングを設定するには、様々なODIロガーおよびログ・ハンドラを有効にする必要があります。ODI Java EEエージェントおよびODIスタンドアロン・コロケート・エージェントの場合、Oracle Enterprise Managerコンソール内のロギング構成メカニズムを介してこれを実行できます。ODI Studioおよびスタンドアロン・エージェントの場合、次に示すように、ODIロギング・システム構成ファイル内に関連するログ・レベルを設定します。

1. ODIコンポーネントのODIロギング・システム構成ファイルを開きます。
各コンポーネントは、それぞれ固有の構成ファイルを持っています。

- ODI Studio:

$ODI_HOME/odi/studio/bin/ODI-logging-config.xml

- ODIスタンドアロン・エージェント:

<DOMAIN_HOME>/config/fmwconfig/components/ODI/<INSTANCE_NAME>/ODI-logging-config.xml

2. ログ・ファイルのパスが有効で、既存のパスであることを確認します。例:

<log_handler name="ODI-file-handler" class="oracle.core.ojdl.logging.ODLHandlerFactory"
level="ALL">
<property name="format" value="ODL-Text"/>
<property name="path" value="/u01/oracle/odi11g/oracledi/agent/log/${LOG_FILE}"/>
<property name="maxFileSize" value="1000000"/> <!-- in bytes -->
<property name="maxLogSize" value="50000000"/> <!-- in bytes -->
<property name="encoding" value="UTF-8"/>
</log_handler>

ログ・ファイルのパスについては、次の点に注意してください。

- Windowsの場合、次のようなパスになります。

%ODI_HOME%\oracledi\agent\log\${LOG_FILE}

- WindowsおよびUnixでは、相対パスを使用できます。

3. ロガーを有効にして、ログ・レベルを設定します。たとえば、oracle.odi.agentのロガーの場合、次のようにして最も詳細なロギング設定を有効にできます。

<logger name="oracle.odi.agent" level="TRACE:32" useParentHandlers="false">
<handler name="ODI-file-handler"/>
<handler name="ODI-console-handler"/>
</logger>

4. 構成ファイルを保存し、変更を有効にするためにODI StudioおよびODIスタンドアロン・エージェントを再起動します。

例 INFO (NOTIFICATION:1)メッセージ

次の場合、INFO (NORTIFICATION:1)メッセージはログに記録されます。

- loggerのレベル(継承されている場合を含む)が<= NOTIFICATION:1

- log_handlerのレベルが<= NOTIFICATION:1 (例: TRACE:1)

次の場合、INFO (NORTIFICATION:1)メッセージはログに記録されません。

- loggerのレベル(継承されている場合を含む)が> NOTIFICATION:1

- log_handlerのレベルが> NOTIFICATION:1 (例: WARNING:1)

ランタイム・ロガーはoracle.odi.agentという名前です。このメッセージ・レベルで対象範囲となるコンテンツは次のとおりです。

NOTIFICATION:1 (or INFO) Agent Level
NOTIFICATION:16 (or CONFIG) the above + Session Level
TRACE:1 (or FINE) the above + Step Level
TRACE:16 (or FINER) the above + Task + SQL
TRACE:32 (or FINEST) the above + more detail

oracle.odi.agentのコンソール・レベルは、エージェントの起動メッセージが表示されるように設定することをお薦めします(NOTIFICATION:1)。

8.3.4 シナリオとロード計画の管理

オペレータ・ナビゲータで、シナリオまたはロード計画を使用して実行を管理することもできます。

シナリオを実行する前に、シナリオをデザイナ・ナビゲータで生成するか、またはファイルからインポートする必要があります。『Oracle Data Integratorでの統合プロジェクトの開発』の「シナリオの使用」を参照してください。ロード計画はデザイナ・ナビゲータを使用して作成することもできますが、オペレータ・ナビゲータを使用して変更することもできます。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の「ロード計画の使用」を参照してください。

オペレータ・ナビゲータからのシナリオの起動については、「ODI Studioからのシナリオの実行」を、ロード計画の実行方法については、「ロード計画の実行」を参照してください。

8.3.4.1 ロード計画とシナリオ・フォルダ

オペレータ・ナビゲータでは、複数のシナリオとロード計画をロード計画とシナリオ・フォルダにグループ化して簡単に編成できます。ロード計画とシナリオ・フォルダには、別のロード計画とシナリオ・フォルダを含めることができます。

ロード計画とシナリオ・フォルダを作成するには:

1. オペレータ・ナビゲータで、「ロード計画とシナリオ」ナビゲーション・ツリーに移動します。

2. 「ロード計画とシナリオ」ツールバー・メニューから、「新規ロード計画とシナリオ・フォルダ」を選択します。

3. ロード計画とシナリオ・フォルダ・エディタの「定義」タブで、フォルダの名前を入力します。

4. 「ファイル」メニューから、「保存」を選択します。

これでシナリオとロード計画を再編成できます。シナリオとロード計画をロード計画とシナリオ・フォルダにドラッグ・アンド・ドロップします。

8.3.4.2 ロード計画、シナリオおよびソリューションの本番へのインポート

デザイナから生成されたロード計画またはシナリオをエクスポートして、開発リポジトリまたは実行リポジトリにインポートできます。この操作は、ロード計画またはシナリオを別のリポジトリ(異なる環境やサイト上など)にデプロイするために使用されます。

開発リポジトリへのロード計画またはシナリオのインポートは、デザイナ・ナビゲータまたはオペレータ・ナビゲータで実行します。実行リポジトリの場合、この目的で使用できるのはオペレータ・ナビゲータのみです。

本番へのシナリオのインポート方法の詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の本番へのシナリオのインポートに関する項を参照し、ロード計画のインポートの詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のロード計画のインポートに関する項を参照してください。

同様に、複数のシナリオが含まれるソリューションをインポートすると、シナリオのグループを一度に簡単に転送およびリストアできます。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の「バージョン・コントロールの使用」を参照してください。実行リポジトリへの接続時は、ソリューションからリストアできるのはシナリオのみであることに注意してください。

8.3.5 スケジュールの管理

1つのシナリオまたは1つのロード計画には必ず1つのスケジュールが関連付けられます。スケジュールはオペレータ・ナビゲータで作成できます。詳細は、「シナリオとロード計画のスケジューリング」を参照してください。

シナリオまたはロード計画のインポート時にすでに存在しているスケジュールを一緒にインポートすることもできます。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』の本番へのシナリオのインポートに関する項、および『Oracle Data Integratorでの統合プロジェクトの開発』のロード計画のエクスポート、インポートおよびバージョニングに関する項を参照してください。

すべてのエージェントのスケジュールされたタスク、または特定のエージェントのスケジュールされたタスクを表示できます。詳細は、「スケジュールの表示」を参照してください。

9 Oracle Data Integratorコンソールの使用

この章では、Oracle Data Integratorコンソールの使用方法について説明します。コンソール・ユーザー・インタフェースの概要も示します。

この章には次の項が含まれます:

- Oracle Data Integratorコンソールの概要

- Oracle Data Integratorコンソールの使用

- ODIドメイン

- Oracle Enterprise Manager Fusion Middleware Control

- Management Pack for Oracle Data Integrator

9.1 Oracle Data Integratorコンソールの概要

Oracle Data Integratorコンソールは、Oracle Data Integratorのランタイム・アーキテクチャを管理およびモニタリングし、設計時のオブジェクトを参照するためのWebベースのコンソールです。

この節では、次のトピックについて説明します。

- Oracle Data Integratorコンソールの概念

- Oracle Data Integratorコンソールのインタフェース

9.1.1 Oracle Data Integratorコンソールの概念

Oracle Data Integratorコンソールは、様々なタイプのユーザーが使用できるWebベースのコンソールです。

- 管理者は、Oracle Data Integratorコンソールを使用して、リポジトリの作成とインポート、およびトポロジ(データ・サーバー、スキーマなど)の構成ができます。

- 本番オペレータは、Oracle Data Integratorコンソールを使用して、シナリオとロード計画の管理、セッションとロード計画実行のモニター、およびOracle Data Integratorで生成されたエラー表の内容の管理を実行できます。

- ビジネス・ユーザーおよび開発者は、このインタフェースで開発アーティファクトを参照します。この作業には、たとえばデータ系統機能やフロー・マップ機能を使用します。

このWebインタフェースは、Oracle Fusion Middleware Controlコンソールとシームレスに統合されているため、Fusion Middlewareの管理者は、Oracle Data Integratorのコンポーネントおよびセッションの詳細にドリルダウンできます。

注意:
Fusion Middleware Control Extension for Oracle Data Integratorには、Oracle Data Integratorコンソールが必要です。この拡張によってドメイン内のOracle Data Integratorコンポーネントを検出および表示するには、Oracle Data Integratorコンソールがインストールおよび構成されている必要があります。

9.1.2 Oracle Data Integratorコンソールのインタフェース

Oracle Data Integratorコンソールは、ADF-Facesフレームワークを使用したWebインタフェースです。

図9-1は、Oracle Data Integratorコンソールのレイアウトを示しています。

図9-1 Oracle Data Integratorコンソール

Oracle Data Integratorコンソールでは、左側のパネルの2つのナビゲーション・タブに、現在のユーザーが使用できるオブジェクトが表示されます。

- 「参照」タブには、参照および編集可能なリポジトリ・オブジェクトが表示されます。このタブでは、セッションおよびエラー表の管理もできます。

- 「管理」タブは、リポジトリおよびリポジトリ接続の管理に使用します。このタブを使用できるのは、スーパーバイザ権限がある接続ユーザー、または最初のリポジトリ接続を設定するユーザーです。

右側のパネルには次のタブが表示されます。

- 「検索」タブは常に表示可能で、接続されているリポジトリ内のオブジェクトを検索できます。

- マスター/詳細タブは、参照または編集中のオブジェクトごとに表示されます。同時に複数のオブジェクトの参照または編集が可能であることに注意してください。

ナビゲーション・タブの上部にある検索フィールドを使用すると、ナビゲーション・タブが閉じている場合でも「検索」タブを開くことができます。

ナビゲーション・タブの使用

ナビゲーション・タブでは、リポジトリに含まれているオブジェクトを参照できます。オブジェクトまたはノードが選択されている場合、ナビゲーション・タブのツールバーには、このオブジェクトまたはノードに対して使用できるアクションのアイコンが表示されます。このオブジェクトに対して使用できないアクションのアイコンは、グレー表示されます。たとえば、「参照」タブの「トポロジ」ノードの下にあるデータ・サーバー・オブジェクトは編集および追加できますが、「デザイナ」ノードの下にあるプロジェクトは編集できません。同時に開くことができるタブの数は10までであることに注意してください。

9.2 Oracle Data Integratorコンソールの使用

この項では、Oracle Data Integratorコンソールで使用できる様々なタイプの操作について説明します。コンソールで管理できる各オブジェクト・タイプを中心に説明するのではなく、コンソールでオブジェクトを管理するための秘訣を提供します。

この項には次のトピックが含まれます:

- Oracle Data Integratorコンソールへの接続

- 一般的なユーザー操作

- シナリオおよびセッションの管理

- ロード計画の管理

- ログのパージ

- データ系統およびフロー・マップの使用

- 管理操作の実行

注意:
Oracle Data Integratorコンソールでは、マスター・リポジトリに定義されているセキュリティが使用されます。ユーザーに許可されない操作は、このユーザーに対してグレー表示されます。
また、「管理」タブを使用できるのは、スーパーバイザ権限があるユーザーのみです。

9.2.1 Oracle Data Integratorコンソールへの接続

Oracle Data Integratorコンソールは、管理者が定義したリポジトリ接続を介してリポジトリに接続します。

Oracle Data Integratorコンソールに接続するには、事前にOracle Data Integratorコンソールがインストールされている必要があります。Oracle Data Integratorコンソールのインストールの詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

注意:
Oracle Data Integratorコンソールに初めて接続するとき、リポジトリ接続が構成されていない場合は、最初のリポジトリ接続を作成するために「管理」タブにアクセスできます。詳細は、リポジトリ接続の作成を参照してください。最初のリポジトリ接続の作成後、「管理」タブはログイン・ページからは使用できなくなり、このタブを使用できるのはスーパーバイザ権限のあるユーザーのみになります。

Oracle Data Integratorコンソールへの接続

Oracle Data Integratorコンソールに接続するには:

1. Webブラウザを開き、Oracle Data IntegratorコンソールがインストールされているURLに接続します。例: http://odi_host:8001/odiconsole/。

2. 「リポジトリ」リストから、接続するマスター・リポジトリまたは作業リポジトリに対応するリポジトリ接続を選択します。

3. 「ユーザーID」および「パスワード」を指定します。

4. 「サインイン」をクリックします。

9.2.2 一般的なユーザー操作

この項では、一般的なユーザーがOracle Data Integratorコンソールで使用できる一般的な操作について説明します。

この項では次の操作について記載しています:

注意:
シナリオおよびロード計画に対する作成、編集および削除操作は許可されていません。ODIコンソールでこれらのオブジェクトに対して実行可能な操作の詳細は、「シナリオおよびセッションの管理」および「ロード計画の管理」を参照してください。

- オブジェクトの表示

- オブジェクトの編集

- オブジェクトの作成

- オブジェクトの削除

- オブジェクトの検索

オブジェクトの表示

オブジェクトを表示するには:

1. 「参照」または「管理」ナビゲーション・タブでオブジェクトを選択します。

2. ナビゲーション・タブのツールバーで「表示」をクリックします。オブジェクトの単純なページまたはマスター/詳細ページが開きます。

オブジェクトの編集

オブジェクトを編集するには:

1. 「参照」または「管理」ナビゲーション・タブでオブジェクトを選択します。

2. ナビゲーション・タブのツールバーで「更新」をクリックします。オブジェクトの編集ページが開きます。

3. オブジェクトの各フィールドの値を変更します。

4. このオブジェクトの編集ページで「保存」をクリックします。

オブジェクトの作成

オブジェクトを作成するには:

1. 「参照」または「管理」ナビゲーション・タブで、作成するオブジェクトの親ノードに移動します。たとえば、コンテキストを作成する場合は、「参照」タブで、「トポロジ」→「コンテキスト」ノードに移動します。

2. ナビゲーション・タブのツールバーで「作成」をクリックします。このオブジェクトの「追加」ダイアログが表示されます。

3. オブジェクトの各フィールドに値を指定します。

4. このオブジェクトの「追加」ダイアログで「保存」をクリックします。ナビゲーション・タブに新しいオブジェクトが表示されます。

オブジェクトの削除

オブジェクトを削除するには:

1. 「参照」または「管理」ナビゲーション・タブでオブジェクトを選択します。

2. ナビゲーション・タブのツールバーで「削除」をクリックします。

3. 確認ウィンドウで「OK」をクリックします。

オブジェクトの検索

オブジェクトを検索するには:

1. 「検索」タブで、検索するオブジェクトに対応するタブを選択します。

- 「デザインタイム」タブでは、設計時オブジェクトを検索できます

- 「トポロジ」タブでは、トポロジ・オブジェクトを検索できます

- 「ランタイム」タブでは、ロード計画、シナリオ、シナリオ・フォルダまたはセッション・フォルダなどのランタイム・オブジェクトを検索できます

- 「セッション」タブでは、セッションを検索できます

- 「ロード計画実行」タブでは、ロード計画実行を検索できます

2. 検索パラメータを設定して検索を絞り込みます。
たとえば、設計時またはトポロジ・オブジェクトを検索する場合:

1. 「検索」 「テキスト」フィールドで検索するオブジェクトの名前の一部分を入力します。

2. 大文字と小文字を区別して検索する場合、「大/小文字区別」を選択します(この機能はセッションまたはロード計画実行検索では提供されていません)。

3. 「モデル/プロジェクト」(「デザイナ」タブ)または「トポロジ」(「トポロジ」タブ)で、検索するオブジェクトのタイプを選択します。すべてのオブジェクトを検索する場合は、「すべて」を選択します。

3. 「検索」をクリックします。

4. 「検索結果」がオブジェクト・タイプ別にグループ化されて表示されます。検索結果でオブジェクトをクリックすると、そのマスター/詳細ページが開きます。

9.2.3 シナリオおよびセッションの管理

この項では、Oracle Data Integratorコンソールで使用できる、シナリオおよびセッションに関連する操作について説明します。

この項では次の操作について記載しています:

- シナリオのインポート

- シナリオのエクスポート

- シナリオの実行

- セッションの停止

- セッションの再開

- 失効したセッションの除去

- データ統計およびエラー・レコードの管理

シナリオのインポート

シナリオをインポートするには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「シナリオ/ロード計画」→「シナリオ」の順に移動します。

3. ナビゲーション・タブのツールバーで「インポート」をクリックします。

4. 「インポート・モード」を選択し、シナリオXMLファイルでエクスポート・ファイルを選択します。

5. 「シナリオのインポート」をクリックします。

6. 要求されたら、このシナリオのエクスポート時に使用されたエクスポート・キーを入力します。エクスポート・キーを入力しない場合、暗号化された機密(暗号)データはインポート済オブジェクトから削除されます。エクスポート・キーの詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のエクスポート・キーに関する項を参照してください。

シナリオのエクスポート

シナリオをエクスポートするには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「シナリオ/ロード計画」→「シナリオ」の順に移動します。

3. ナビゲーション・タブのツールバーで「エクスポート」をクリックします。

4. 「シナリオのエクスポート」ダイアログで、次のパラメータを設定します。

- 「シナリオ名」リストから、エクスポートするシナリオを選択します。

- 「Java文字セットのエンコーディング」フィールドに、エクスポート・ファイルのJava文字セットを入力します。

- 「XML文字セットのエンコーディング」フィールドに、エクスポート・ファイルに指定するエンコーディングを入力します。

- 「XMLバージョン」フィールドに、エクスポート・ファイルに指定するXMLバージョンを入力します。

- 「エクスポート・キー」フィールドに、エクスポート中に必要な機密データ暗号化のためのAES KEYを指定します。エクスポート・キー文字列は最小8文字および最長100文字です。少なくとも1つの特殊文字(@、#、$、%、+、/、=)、数字または小文字または大文字のアルファベット文字が必要です。

- 「エクスポート・キーの確認」フィールドに、エクスポート・キーを再入力します。

- オプションで、将来のすべてのエクスポート用にエクスポート・キーを保存する場合は、「後のエクスポート用に保存」を選択します。

- オプションで、リンクされている子オブジェクトをエクスポートする場合は、「依存オブジェクトを含める」を選択します。

5. 「シナリオのエクスポート」をクリックします。

シナリオの実行

シナリオを実行するには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「シナリオ/ロード計画」→「シナリオ」の順に移動します。

3. 実行するシナリオを選択します。

4. ナビゲーション・タブのツールバーで「実行」をクリックします。

5. この実行の「エージェント」、「コンテキスト」および「ログ・レベル」を選択します。

6. 「シナリオの実行」をクリックします。

セッションの停止

実行中のセッションの通常の停止または即時停止を実行できます。ステータスが「完了」、「警告」または「エラー」のセッションは停止できません。

セッションを停止するには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「セッション/ロード計画実行」→「セッション」の順に移動します。

3. 停止するセッションを選択します。

4. ナビゲーション・タブのツールバーで「停止」をクリックします。

セッションの再開

セッションを再開するには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「セッション/ロード計画実行」→「セッション」の順に移動します。

3. 再開するセッションを選択します。

4. ナビゲーション・タブのツールバーで「再開」をクリックします。

5. 「セッションの再開」ダイアログで、次のパラメータを設定します:

- エージェント: リストから、新しいセッションの実行に使用するエージェントを選択します。

- ログ・レベル: リストからログ・レベルを選択します。変数の追跡を有効にするには、「実行」または「セッションの再開」ダイアログで「ログ・レベル6」を選択します。ログ・レベル6は、ログ・レベル5と動作は同じですが、変数の追跡が追加されています。

6. 「セッションの再開」をクリックします。

失効したセッションの除去

失効したセッションを除去するには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「セッション/ロード計画実行」→「セッション」の順に移動します。

3. ナビゲーション・タブのツールバーで「クリーン」をクリックします。

4. 「失効したセッションの除去」ダイアログで、失効したセッションを除去する「エージェント」を選択します。

5. 「OK」をクリックします。

データ統計およびエラー・レコードの管理

Oracle Data Integratorコンソールでは、レコード統計などのセッションの詳細を参照できます。セッションでフロー・チェック中または静的チェック中にエラーのあるデータが検出されると、これらのエラーはエラー表に分離されます。Oracle Data Integratorコンソールを使用して、エラーのある行を参照および管理することもできます。

注意:
エラーのあるデータが検出されたセッションは、「警告」ステータスで終了します。

エラーのあるデータを表示するには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「セッション/ロード計画実行」→「セッション」の順に使用して、指定のセッションに移動します。ナビゲーション・タブのツールバーでセッションを選択し、「ビュー」をクリックします。
セッション・ページが表示されます。

3. セッション・ページで、「関係」セクションに移動して、「レコード統計」タブを選択します。
このタブには、このセッションで対象となっている各物理表、およびレコード統計が表示されます。

4. 「エラー」列に表示されている番号をクリックします。エラー表の内容が表示されます。

- 制約タイプ、名前、メッセージの内容、検出日などでエラーをフィルタ処理できます。「フィルタ結果」をクリックして、フィルタを適用します。

- 「問合せ結果」表でエラーをいくつか選択し、「削除」をクリックしてこれらのレコードを削除します。

- すべてのエラーを削除する場合は、「すべて削除」をクリックします。

注意:
削除操作は元に戻すことができません。

9.2.4 ロード計画の管理

この項では、Oracle Data Integratorコンソールで使用できるロード計画に関連する操作について説明します。

この項では次の操作について記載しています:

- ロード計画のインポート

- ロード計画のエクスポート

- ロード計画の実行

- ロード計画実行の停止

- ロード計画実行の再開

ロード計画のインポート

ロード計画をインポートするには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「シナリオ/ロード計画」→「ロード計画」の順に移動します。

3. ナビゲーション・タブのツールバーで「インポート」をクリックします。

4. 「ロード計画のインポート」ダイアログで、「インポート・モード」の値を選択し、「ロード計画XMLファイルの選択」フィールドでエクスポート・ファイルを選択します。

5. 「インポート」をクリックします。

6. 要求されたら、このシナリオのエクスポート時に使用されたエクスポート・キーを入力します。エクスポート・キーを入力しない場合、暗号化された機密(暗号)データはインポート済オブジェクトから削除されます。エクスポート・キーの詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のエクスポート・キーに関する項を参照してください。

注意:
以前にエクスポートしたロード計画をインポートする場合、インポートされるロード計画には、ロード計画が参照するシナリオは格納されていません。ロード計画で使用されるシナリオは、個別にインポートする必要があります。詳細は、「シナリオのインポート」を参照してください。

ロード計画のエクスポート

ロード計画をエクスポートするには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「シナリオ/ロード計画」→「ロード計画」の順に移動します。

3. エクスポートするロード計画を選択します。

4. ナビゲーション・タブのツールバーで「エクスポート」をクリックします。

5. 「エクスポート」ダイアログで、次のパラメータを設定します:

- 「ロード計画名」リストから、エクスポートするロード計画を選択します。

- 「Java文字セットのエンコーディング」フィールドに、エクスポート・ファイルのJava文字セットを入力します。

- 「XML文字セットのエンコーディング」フィールドに、エクスポート・ファイルに指定するエンコーディングを入力します。

- 「XMLバージョン」フィールドに、エクスポート・ファイルに指定するXMLバージョンを入力します。

- 「エクスポート・キー」フィールドに、エクスポート中に必要な機密データ暗号化のためのAES KEYを指定します。エクスポート・キー文字列は最小8文字および最長100文字です。少なくとも1つの特殊文字(@、#、$、%、+、/、=)、数字または小文字または大文字のアルファベット文字が必要です。

- 「エクスポート・キーの確認」フィールドに、エクスポート・キーを再入力します。

- オプションで、将来のすべてのエクスポート用にエクスポート・キーを保存する場合は、「後のエクスポート用に保存」を選択します。

- オプションで、リンクされている子オブジェクトをエクスポートする場合は、「依存オブジェクトを含める」を選択します。

6. 「エクスポート」をクリックします。

注意:
ロード計画のエクスポートには、ロード計画が参照するシナリオは含まれません。ロード計画で使用されるシナリオは、個別にエクスポートする必要があります。詳細は、「シナリオのエクスポート」を参照してください。

ロード計画の実行

ロード計画を実行するには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「シナリオ/ロード計画」→「ロード計画」の順に移動します。

3. 実行するロード計画を選択します。

4. ナビゲーション・タブのツールバーで「実行」をクリックします。

5. 「論理エージェント」、「コンテキスト」、「ログ・レベル」の値を選択し、ロード計画で変数を使用する場合は、ロード計画変数の「起動値」を指定します。

6. 「実行」をクリックします。

ロード計画実行の停止

ロード計画実行に対して、通常の停止または即時停止を実行できます。実行中または待機中のロード計画実行を停止できます。

ロード計画実行を停止するには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「セッション/ロード計画実行」→「ロード計画実行」の順に移動します。

3. 停止するロード計画実行を選択します。

4. ナビゲーション・タブのツールバーで「停止」をクリックします。

ロード計画実行の再開

ロード計画の実行を再開できるのは、現在のロード計画インスタンスに対して選択された実行がエラー・ステータスであり、さらに、同じロード計画の他のインスタンスが現在実行されていない場合のみです。

ロード計画実行を再開するには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「セッション/ロード計画実行」→「ロード計画実行」の順に移動します。

3. 再開するロード計画実行を選択します。

4. 「ロード計画の再開」ダイアログで、ロード計画を再開する物理エージェントを選択します。オプションで、異なるログ・レベルを選択します。

5. ナビゲーション・タブのツールバーで「再開」をクリックします。

9.2.5 ログのパージ

この項では、Oracle Data Integratorコンソールで、過去のセッションまたはロード計画実行(あるいはその両方)をログから削除することで、ログをパージする方法について説明します。

ログをパージするには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「ランタイム」→「セッション/ロード計画実行」の順に移動します。

3. ナビゲーション・タブのツールバーで「パージ」をクリックします。

4. 「セッション/ロード計画実行のパージ」ダイアログで、表9-1にリストされているパージ・パラメータを設定します。

表9-1 ログのパージ・パラメータ

パラメータ

説明

パージ・タイプ

パージするオブジェクトを選択します。

範囲

この時間範囲のセッションまたはロード計画実行(あるいはその両方)が削除されます。

セッション・ログのみのパージを選択した場合、ロード計画実行の一部として起動したセッションはフィルタ基準と一致した場合でもパージされません。ロード計画実行をパージした場合は、フィルタ基準に一致したロード計画実行、およびそのロード計画実行の一部として直接開始したセッションとその子/孫セッションが削除されます。

コンテキスト

このコンテキストで実行されたセッションまたはロード計画実行(あるいはその両方)が削除されます。

エージェント

このエージェントによって実行されたセッションまたはロード計画実行(あるいはその両方)が削除されます。

ステータス

このステータスのセッションまたはロード計画実行(あるいはその両方)が削除されます。

ユーザー

このユーザーによって実行されたセッションまたはロード計画実行(あるいはその両方)が削除されます。

名前

このセッション名と一致するセッションまたはロード計画実行(あるいはその両方)が削除されます。%をワイルドカードとして使用して、セッション名マスクを指定できます。

シナリオ・レポートのパージ

「シナリオ・レポートのパージ」を選択した場合は、シナリオ・レポート(各シナリオの実行ノードの下に表示されるレポート)もパージされます。

指定したフィルタと一致するセッションまたはロード計画実行(あるいはその両方)のみが次のように削除されます。

- セッション・ログのみのパージを選択した場合、ロード計画実行の一部として開始したセッションはフィルタ基準と一致した場合でもパージされません。

- ロード計画実行をパージした場合は、フィルタ基準に一致したロード計画実行、およびそのロード計画実行の一部として直接開始したセッションとその子/孫セッションが削除されます。

- ロード計画実行がフィルタと一致した場合は、関連するすべてのセッションもフィルタ基準と一致するかどうかに関係なくパージされます。

5. 「OK」をクリックします。

Oracle Data Integratorコンソールによって、セッションまたはロード計画実行(あるいはその両方)がログから削除されます。

9.2.6 データ系統およびフロー・マップの使用

この項では、Oracle Data Integratorコンソールで使用できる、データ系統およびフロー・マップ機能の使用方法について説明します。

- 「データ系統」では、特定のデータストアの観点からデータのフローを表示するグラフが示されます。このグラフでは、このデータ・フローを前後に移動でき、データ・フローをたどることもできます。

- 「フロー・マップ」では、データ構造(モデル、サブモデルおよびデータストア)と設計時オブジェクト(プロジェクト、フォルダ、パッケージ、マッピング)間の関連のマップが示されます。このグラフでは、複数のデータ構造とそのデータ・フローで構成されるマップを描画できます。

この項では次の操作について記載しています:

- データ系統の使用

- フロー・マップの使用

データ系統の使用

データ系統を表示するには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「デザインタイム」→「モデル」→「データ系統」の順に移動します。

3. ナビゲーション・タブのツールバーで「表示」をクリックします。

4. 「データ系統」ページで、モデルを選択し、次にこのモデルのサブモデルとデータストアを選択します。

5. データストア・ノード間のマッピングを表示する場合は、「マッピングの表示」を選択します。

6. 「命名オプション」セクションで、データストア名およびマッピング名に付加する接頭辞を選択します。

7. 「ビュー」をクリックして、データ系統グラフを描画します。このグラフは、ステップ4で選択したデータストアを中心に描画されます。
このグラフでは、次のアクションを使用できます:

- 「戻る」をクリックして、「データ系統」オプションに戻り、グラフを再描画します。

- ハンド・ツールを使用し、データストアをクリックして、このデータストアを中心に系統を再描画します。

- ハンド・ツールを使用し、マッピングをクリックしてこのマッピングのページを表示します。

- 矢印ツールを使用して、グループを展開/縮小します。

- 移動ツールを使用して、グラフを移動します。

- ズーム・イン/ズーム・アウト・ツールを使用して、グラフのサイズを変更します。

- 表示オプションを選択して表示オプションを変更し、この新しいオプションでグラフをリフレッシュします。

フロー・マップの使用

フロー・マップを表示するには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「デザインタイム」→「モデル」→「フロー・マップ」の順に移動します。

3. ナビゲーション・タブのツールバーで「表示」をクリックします。

4. 「データ系統」ページで、モデルを1つ以上選択します。すべてのモデルを選択する場合は、「すべて」を選択します。

5. プロジェクトを1つ以上選択します。すべてのプロジェクトを選択する場合は、「すべて」を選択します。

6. 「マップの詳細レベルの選択」セクションで、マップの粒度を選択します。ここで選択するオブジェクトがグラフのノードになります。
マップにデータ構造のみを表示する場合は、「マップ内にプロジェクト、フォルダ、パッケージまたはインタフェースを表示しない。」を選択します。

7. オプションで、マップ内のオブジェクトのグループ化方法の指定セクションのオプションを使用して、マップ内のデータ構造および設計時オブジェクトのグループ化を指定します。

8. 「ビュー」をクリックして、フロー・マップのグラフを描画します。
このグラフでは、次のアクションを使用できます:

- 「戻る」をクリックして、「フロー・マップ」オプションに戻り、グラフを再描画します。

- ハンド・ツールを使用し、マップ内のノード(データストア、マッピングなどを表すノード)をクリックして、このオブジェクトのページを開きます。

- 矢印ツールを使用して、グループを展開/縮小します。

- 移動ツールを使用して、グラフを移動します。

- ズーム・イン/ズーム・アウト・ツールを使用して、グラフのサイズを変更します。

9.2.7 管理操作の実行

この項では、Oracle Data Integratorコンソールで使用できる様々な管理操作について説明します。これらの操作は、スーパーバイザ権限のあるユーザーが使用できます。

この項では次の操作について記載しています:

- リポジトリ接続の作成

- データ・サーバーまたは物理エージェントの接続のテスト

- リポジトリの管理

- Java EEエージェントの管理

リポジトリ接続の作成

リポジトリ接続は、Oracle Data Integratorコンソールに対する接続定義です。この接続には、Oracle Data Integratorのユーザーとパスワードの情報は含まれません。

リポジトリ接続を作成するには:

1. 「管理」ナビゲーション・タブで「リポジトリ接続」ノードに移動します。

2. ナビゲーション・タブのツールバーで「作成」をクリックします。このオブジェクトの「リポジトリ接続の作成」ダイアログが表示されます。

3. リポジトリ接続の値を指定します:

- 接続別名: ログイン・ページに表示される接続名。

- マスターJNDI URL: マスター・リポジトリ・データベースに接続するためのデータソースのJNDI URL。

- スーパーバイザ・ユーザー名: スーパーバイザ権限を持つOracle Data Integratorユーザーの名前。Oracle Data Integratorコンソールでリポジトリへの接続に使用されます。このユーザーのパスワードは、WLSまたはWAS資格証明ストアに宣言されている必要があります。

- 作業JNDI URL: 作業リポジトリ・データベースに接続するためのデータソースのJNDI URL。このフィールドに値を指定しない場合リポジトリ接続で許可されるのはマスターへの接続のみで、ナビゲーションはトポロジ情報に限定されます。

- JNDI URL: 環境ネーミング・コンテキスト(ENC)を使用する場合は、このオプションを選択します。このオプションを選択すると、アプリケーション・サーバーのJNDIディレクトリでデータ・ソースを識別するために、Oracle Data Integratorコンソールによって、データ・ソース名に文字列java:comp/env/が自動的に付加されます。JNDI標準は、Oracle WebLogic Serverではサポートされておらず、グローバル・データ・ソースに対してはサポートされていないことに注意してください。

- デフォルト: ログイン・ページでこのリポジトリ接続がデフォルトで選択されるようにする場合は、このオプションを選択します。

4. 「保存」をクリックします。新規リポジトリ接続が「管理」ナビゲーション・タブに表示されます。

データ・サーバーまたは物理エージェントの接続のテスト

この項では、Oracle Data Integratorコンソールで、データ・サーバーの接続または物理エージェントの接続をテストする方法について説明します。

データ・サーバーの接続をテストするには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「トポロジ」→「データ・サーバー」の順に移動します。

3. 接続をテストするデータ・サーバーを選択します。

4. ナビゲーション・タブのツールバーで「テスト接続」をクリックします。

5. 「テスト接続」ダイアログで、次を選択します:

- 物理エージェント: テストを実行する物理エージェント。

- トランザクション: コマンドの実行対象のトランザクション。このパラメータは、このデータ・サーバーに接続時または切断時のコマンドが定義されている場合にのみ表示されます。0から9のトランザクションおよび「自動コミット」トランザクションは、(プロシージャまたはナレッジ・モジュールによる)セッションで作成された接続に相当します。「クライアント・トランザクション」は、クライアント・コンポーネント(ODIコンソールおよびStudio)に相当します。

6. 「テスト」をクリックします。

テストが機能した場合は、「接続が正常に実行されました」というダイアログが表示されます。機能しない場合は、エラー・メッセージが表示されます。

物理エージェントの接続をテストするには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「トポロジ」→「エージェント」→「物理エージェント」の順に移動します。

3. 接続をテストする物理エージェントを選択します。

4. ナビゲーション・タブのツールバーで「テスト接続」をクリックします。

テストが機能した場合は、「接続が正常に実行されました」というダイアログが表示されます。機能しない場合は、エラー・メッセージが表示されます。

リポジトリの管理

Oracle Data Integratorコンソールでは、リポジトリに関する管理操作(作成、インポート、エクスポート)を実行できます。これらの操作は、「管理」ナビゲーション・タブの「リポジトリ」ノードから使用できます。これらの管理操作によって、Oracle Data Integrator Studioを介して使用できる管理操作がWebインタフェースに再作成され、ODIコンソールから環境の設定および保守が可能になります。

これらの操作の詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のリポジトリの管理に関する項および「エクスポートおよびインポート」を参照してください。

Java EEエージェントの管理

Oracle Data Integratorコンソールでは、物理エージェントへのJDBCデータソースの追加、およびテンプレートの作成による物理エージェントのWebLogic Serverへのデプロイが可能です。

Java EEエージェント、データソースおよびテンプレートの詳細は、「トポロジの設定」を参照してください。

データソースを物理エージェントに追加するには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「トポロジ」→「エージェント」→「物理エージェント」の順に移動します。

3. 管理するエージェントを選択します。

4. ナビゲーション・タブのツールバーで「編集」をクリックします。

5. 「データソースの追加」をクリックします。

6. このデータソースの「JNDI名」を指定し、「データ・サーバー名」を選択します。このデータソースは、Java EEエージェントがデプロイされるマシンからこのデータ・サーバーに接続するために使用されます。

7. 「OK」をクリックします。

8. 「保存」をクリックして、変更内容を物理エージェントに保存します。

物理エージェントのテンプレートを作成するには:

1. 「参照」ナビゲーション・タブを選択します。

2. 「トポロジ」→「エージェント」→「物理エージェント」の順に移動します。

3. 管理するエージェントを選択します。

4. ナビゲーション・タブのツールバーで「編集」をクリックします。

5. 「エージェント・デプロイ」をクリックします。

6. エージェント・デプロイ・ウィザードのステップに従います。このウィザードによって、サーバー・テンプレート生成ウィザードがWebインタフェースに再作成されます。詳細は、「Java EEアプリケーション・サーバーでのエージェントのデプロイ」を参照してください。

9.3 ODIドメイン

ODIドメインには、Enterprise Managerを使用して管理できるOracle Data Integratorコンポーネントが含まれます。ODIドメインに含まれるコンポーネントは次のとおりです。

- 1つのマスター・リポジトリとそれにアタッチされた1つ以上の作業リポジトリ。

- マスター・リポジトリにアタッチされた1つまたは複数のランタイム・エージェント。これらのエージェントをドメインに含めるには、マスター・リポジトリで宣言する必要があります。これらのエージェントは、スタンドアロン・エージェント、スタンドアロン・コロケート・エージェントまたはJava EEエージェントです。マスター・リポジトリでエージェントを宣言する方法の詳細は、「トポロジの設定」を参照してください。

- 1つまたは複数のOracle Data Integratorコンソール・アプリケーション。Oracle Data Integratorコンソール・アプリケーションは、マスター・リポジトリおよび作業リポジトリをブラウズするために使用されます。

「マスター・リポジトリ」ページおよび「エージェント」ページには、マスター・リポジトリと作業リポジトリ両方のアプリケーション・メトリックと情報が表示されます。たとえば、セッションの詳細を表示するために、これらのページからOracle Data Integratorコンソールにナビゲートすることもできます。Oracle Data Integratorコンソールをブラウズするには、作業リポジトリとマスター・リポジトリへの接続をOracle Data Integratorコンソールで宣言する必要があります。ドメインを作成および構成する方法の詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

9.4 Oracle Enterprise Manager Fusion Middleware Control

Oracle Enterprise Manager Fusion Middleware Controlでは、様々なパフォーマンス・データおよび管理機能を、ファーム、クラスタ、ドメイン、サーバー、コンポーネントおよびアプリケーションの個別のWebベースのホームページに編成します。

Oracle Data Integratorには、Oracle Enterprise Manager Fusion Middleware Controlと統合するプラグインが用意されています。このプラグインを使用すると、Oracle Enterprise Manager Fusion Middleware ControlをODIコンソールとともに使用して、ODIエージェント、リポジトリ、セッションおよびロード計画実行に関する情報を取得できます。

このセクションでは、次のトピックについて説明します。

- ODIプラグインによるOracle Fusion Middleware Controlの構成

- Oracle Data Integratorコンソールの構成

- Oracle Data Integratorの管理

- ODIスタンドアロン・エージェントの構成

- マスター・リポジトリの構成

- セッションの検索

- ロード・プラン実行の検索

9.4.1 ODIプラグインによるOracle Fusion Middleware Controlの構成

Oracle Enterprise Manager Fusion Middleware Controlから、ODIメニュー項目を展開し、「デプロイメント」ペインでエージェント名をクリックします。

図9-2は、「デプロイメント」ペイン内のエージェントを示しています。

図9-2 Oracle Enterprise Manager Fusion Middleware Control内のODIコンソール

注意:
エージェントが別のドメインに存在する場合、Oracle Enterprise ManagerをOracle Data Integratorコンソールで使用するには、最初にOracle Enterprise Managerの適切な資格証明ストア・エントリを作成する必要があります。詳細は、『Oracle Data Integratorのインストールと構成』のスーパーバイザ資格証明の指定に関する項を参照してください。

次のプロセスでドメインの検出が行われます。

1. Oracle Enterprise Managerは、Oracle Data Integratorコンソールで宣言されたリポジトリ接続を解析し、このドメインで使用可能なすべてのマスター・リポジトリへの接続を試行して、それらのステータスとエージェント・リストを取得します。エージェントまたはリポジトリは、停止している場合でもOracle Enterprise Managerに表示されます。

2. ドメイン上のすべてのエージェントがステータスとともにドメインに表示され、通知の投稿が開始されます(開始されている場合)。

注意:
Oracle Enterprise Managerが検出したURLとは異なるURLを使用して、Oracle Enterprise ManagerをOracle Data Integratorコンソールまでドリルダウンさせるには、このURLをOracle Enterprise Managerで再構成する必要があります。再構成は必須ではありませんが、Oracle Data IntegratorコンソールへのHTTPロード・バランシングにファイアウォールを使用している場合は必要になることがあります。

Oracle Enterprise Managerの使用方法の詳細は、Oracle Fusion Middlewareの管理を参照してください。

9.4.2 Oracle Data Integratorコンソールの構成

Fusion Middleware ControlでOracle Data Integratorコンソールを構成して、Fusion Middleware ControlおよびOracle Data Integratorコンソールのリンクを定義できます。

デフォルトでは、このページのフィールドに、Oracle Data Integratorコンソールのホスト、Oracle Data Integratorコンソールの管理対象サーバー・ポートおよびデフォルト・コンテキスト・ルートが移入されます。別の構成を使用してOracle Data Integratorコンソールにアクセスする必要がある場合は、このページで構成を変更できます。

このプロセスの手順は次のとおりです。

1. ODIエージェント・ホーム・ページにナビゲートします。

2. 「エージェント」メニューから、「管理」→「ODIコンソール管理」を選択します。

3. パラメータは次の要領で指定してください。

- ホスト: アプリケーションがデプロイされているサーバーの名前

- ポート: HTTPリスナー・ポート番号

- コンテキスト・ルート: Webアプリケーションのコンテキスト・ルート

- プロトコル: 接続用のプロトコル

4. Fusion Middleware ControlのODI-ESS統合機能を有効にするには、「EMでのODI-ESS統合機能の有効化」を選択します。

9.4.3 Oracle Data Integratorの管理

Oracle Data Integratorコンソールを管理する際に実行するタスクのサマリーを次に示します。

1. Oracle Data Integratorコンソールを起動および停止します。

2. ODIエージェントを起動および停止します。

3. ODIスタンドアロン・エージェントを構成します。

4. マスター・リポジトリを構成します。

5. セッションを検索します。

6. ロード・プラン実行を検索します。

7. ログ・メッセージを表示します。

9.4.4 ODIスタンドアロン・エージェントの構成

Oracle Data Integratorのスタンドアロン・エージェントの情報を変更できます。デフォルトでは、このページのフィールドには、スタンドアロン・エージェントに関する情報が入力されています。

このプロセスの手順は次のとおりです。

1. 「スタンドアロン・エージェント」ホーム・ページにナビゲートします。

2. 「エージェント」メニューから、「管理」→「ODIスタンドアロン・エージェント構成」を選択します。

3. 新しい値を入力して、ODIスタンドアロン・エージェント構成を変更します。

4. 構成を変更するには「適用」をクリックし、前の設定に戻すには「元に戻す」をクリックします。

9.4.5 マスター・リポジトリの構成

スタンドアロン・エージェントのマスター・リポジトリ構成パラメータを変更できます。

このプロセスの手順は次のとおりです。

1. 「スタンドアロン・エージェント」ホーム・ページにナビゲートします。

2. 「エージェント」メニューから、「管理」→「マスター・リポジトリ構成」を選択します。

3. 新しい値を入力して、マスター・リポジトリの構成を変更します。

4. 構成を変更するには「適用」をクリックし、前の設定に戻すには「元に戻す」をクリックします。

9.4.6 セッションの検索

管理対象のODIドメインで実行されたセッションを検索できます。

このプロセスの手順は次のとおりです。

1. 「エージェント」または「マスター・リポジトリ」ホーム・ページにナビゲートします。

2. 「エージェント」のメニューから、「セッションの検索」を選択します。

3. 「セッションの検索」ページが開きます。検索基準を入力します。

4. 「検索」をクリックします。結果が「セッション」セクションに表示されます。

9.4.7 ロード・プラン実行の検索

管理対象のODIドメインで実行されたロード・プラン実行を検索できます。

このプロセスの手順は次のとおりです。

1. 「エージェント」または「マスター・リポジトリ」ホーム・ページにナビゲートします。

2. 「エージェント」メニューから、「ロード・プラン実行の検索」を選択します。

3. 「ロード・プラン実行の検索」ページが開きます。検索基準を入力します。

4. 「検索」をクリックします。結果が「ロード・プラン実行」セクションに表示されます。

9.5 Management Pack for Oracle Data Integrator

Management Pack for Oracle Dataを使用すると、Oracle Enterprise Manager Cloud Controlのベストインクラス・アプリケーション・パフォーマンス管理、サービス・レベル管理および構成管理の機能を活用することにより、Oracle Data Integrator Enterprise Editionの集中管理ソリューションを実現できます。

Management Pack for ODIには、ODIインフラストラクチャの統合ビューが用意されており、Oracle Enterprise Manager Cloud Controlからすべてのコンポーネントを集中的にモニターおよび管理できます。

Management Pack for ODIを使用すると、次のことが可能です。

- 単一の場所からの複数のOracle Data Integratorドメインの管理。Oracle Data Integratorの詳細は、「ODIドメイン」を参照してください。

- Oracle Data Integratorコンポーネントの可用性とパフォーマンスのモニター、履歴データへのアクセス、ログの追跡、および潜在的な問題に関する通知の受信。

- エンドツーエンドのOracle Data Integratorセッション・アクティビティのトレース、実行統計の確認、および特定のステップやタスクからOracle Databaseアクティビティの詳細レポートへのドリルダウン。

- 堅牢でスケーラブルなアラート機能を含むControlのサービス・レベル契約(SLA)の制御。

- Oracle Data Integratorスタンドアロン・エージェント(11g)、スタンドアロン・コロケート・エージェント(12c)およびJava EEエージェント(11gおよび12c)のリアルタイム・パフォーマンス統計と履歴パフォーマンス統計の取得。

- Oracle Data Integratorと各種コンポーネント(データベースや他のOracle Fusion Middlewareなど)の間の依存性の検出およびモデル化。

- Oracle Data Integratorコンポーネントの構成の取得、および一定期間にわたる変更の追跡。一定期間にわたる構成パラメータの比較。

Oracle Data Integratorの管理時に実行する必要のあるタスクの詳細は、Oracle Enterprise Manager Cloud Control Oracle Fusion Middleware Management Plug-inスタート・ガイドの「Oracle Data Integratorの構成とモニタリング」を参照してください。

第IV部

セキュリティ設定の管理

この部では、Oracle Data Integratorでのセキュリティ設定の管理方法について説明します。

第IV部は次の章で構成されています。

- 第10章「Oracle Data Integratorでのセキュリティの管理」

10 Oracle Data Integratorでのセキュリティの管理

この章では、Oracle Data Integratorでのセキュリティの設定方法について説明します。また、Oracle Data Integratorのセキュリティの概念およびコンポーネントの概要も示します。

この章の内容は次のとおりです。

- Oracle Data Integratorのセキュリティの概要

- ユーザー管理

- Advanced Encryption Standard

- パスワードで保護されたウォレットを使用したログイン資格証明の格納

- 外部パスワード記憶域の設定

- 認証モードの管理

- 外部認証の構成

- パスワード・ポリシーの実施

- 安全な転送を使用するためのスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントの構成

- Webプロキシ・サーバーによるOracle Data Integratorの構成

- Oracle Access Manager 11gを使用したOracle Data IntegratorコンソールおよびEnterprise Managerのシングル・サインオン(SSO)の構成

- Oracle Data Integratorのセキュリティのベスト・プラクティス

10.1 Oracle Data Integratorのセキュリティの概要

Oracle Data Integratorのセキュリティは、Oracle Data Integratorの設計時アーティファクト、ランタイム・アーティファクトおよびコンポーネントに対して認証されたユーザーが実行したすべてのアクションを保護するために使用されます。

Oracle Data Integratorのセキュリティ・モデルでは、メソッド、オブジェクト・タイプまたは特定のオブジェクト・インスタンスに関する権限をユーザーに付与することが基本になっています。

Oracle Data Integratorに関するすべてのセキュリティ情報はマスター・リポジトリに格納されます。

この項は、次の項目を含んでいます。

- オブジェクト、インスタンスおよびメソッド

- プロファイル

- ユーザー

- ロール

10.1.1 オブジェクト、インスタンスおよびメソッド

オブジェクトは、Oracle Data Integratorを介して処理されたデザインタイム・アーティファクトまたはランタイム・アーティファクトの表現です。オブジェクトの例には、エージェント、プロジェクト、モデル、データストア、シナリオ、マッピング、リポジトリなどが含まれます。特定のオブジェクトには、エージェント/コンテキストおよびプロファイル/メソッドなど2つの名前があります。これらのオブジェクトは、オブジェクト間のリンクを表し、これらのリンクもオブジェクトです。たとえば、エージェント/コンテキストは、コンテキストを介して関連付けられた物理/論理エージェントに対応しています。このオブジェクトに対する権限により、トポロジでこの関連付けを変更することが可能になります。

インスタンスは、オブジェクトに関する特定の発生例です。たとえば、データウェアハウス・プロジェクトは、プロジェクト・オブジェクトのインスタンスです。

メソッドは、編集、削除など、オブジェクトに対して実行できるアクションです。各オブジェクトには、事前定義された一連のメソッドがあります。

注意:
Oracle Data Integratorのオブジェクト・インスタンスとメソッドの概念は、オブジェクト指向プログラミングで使用されている概念に類似しています。

注意:

オブジェクトとメソッドはセキュリティ・ナビゲータに表示されますが、Oracle Data Integratorに事前定義されているオブジェクトとメソッドは変更できません。

10.1.2 プロファイル

プロファイルには、Oracle Data Integratorを使用するための権限セットが含まれています。1つ以上のプロファイルをユーザー(またはロール)に割り当て、それらのプロファイルに含まれるすべての権限をユーザー(またはロール)に付与できます。

プロファイル・メソッドは、オブジェクト・タイプのメソッドのプロファイルに付与される認可です。付与された各メソッドにより、このプロファイルを持つユーザーは、あるオブジェクト・タイプのすべてのインスタンスに対してアクションを実行できます。

Oracle Data Integrator Studioでは、プロファイルに付与されたメソッドは、セキュリティ・ナビゲータの「プロファイル」ナビゲーション・ツリーにあるこのプロファイルの下に表示されます。特定プロファイルにメソッドが表示されない場合、そのプロファイルからメソッドにアクセスすることはできません。

メソッドは、次のように一般権限または一般以外の権限として付与できます。

- 一般権限として付与されるメソッドは、オブジェクトのすべてのインスタンスにデフォルトで付与されます。

- 一般以外の権限として付与されるメソッドは、オブジェクトのすべてのインスタンスにはデフォルトで付与されませんが、インスタンスごとに付与できます。

汎用プロファイルと非汎用プロファイル

汎用プロファイルでは、すべてのオブジェクト・メソッドに対して一般権限オプションが選択されます。これは、このようなプロファイルのユーザーまたはロールは、汎用プロファイルが認可されているオブジェクトのすべてのインスタンスに関するすべてのメソッドに対して、デフォルトで認可されることを意味します。

非汎用プロファイルでは、すべてのオブジェクト・メソッドに対して一般権限オプションが選択されないため、インスタンスのすべてのメソッドがデフォルトで認可されません。各インスタンスのメソッドに対する権限をユーザーまたはロールに付与する必要があります。

ユーザーまたはロールにどのインスタンスに対する権限もデフォルトで付与せず、インスタンスごとに権限を付与する場合は、そのユーザーまたはロールに非汎用プロファイルを指定する必要があります。

ユーザーまたはロールにオブジェクト・タイプのすべてのインスタンスに対する権限をデフォルトで付与する場合は、そのユーザーまたはロールに汎用プロファイルを指定する必要があります。

組込みプロファイル

Oracle Data Integratorには組込みプロファイルがあり、作成したユーザーまたはロールに割り当てることができます。

表10-1に、Oracle Data Integratorに付属の組込みプロファイルを示します。

表10-1 組込みプロファイル

プロファイル名

説明

CONNECT

Oracle Data Integratorに接続するための基本権限を付与するプロファイル。別のプロファイルとともに付与する必要があります。

CONSOLE

Oracle Data Integratorを使用するための権限を付与するプロファイル。

DESIGNER

開発操作を実行するための権限を付与するプロファイル。このプロファイルは、主にプロジェクトで作業するユーザーに対して使用します。

METADATA_ADMIN

メタデータを管理するための権限を付与するプロファイル。このプロファイルは、主にモデルで作業するユーザーに対して使用します。

NG_CONSOLE

非汎用バージョンのCONSOLEプロファイル。

NG_DESIGNER

非汎用バージョンのDESIGNERプロファイル。

NG_METADATA_ADMIN

非汎用バージョンのMETATADA_ADMINプロファイル。

NG_VERSION_ADMIN

非汎用バージョンのVERSION_ADMINプロファイル。

OPERATOR

ランタイム・オブジェクトを管理するための権限を付与するプロファイル。このプロファイルは、本番のユーザーに対して使用します。

SECURITY_ADMIN

セキュリティを編集するための権限を付与するプロファイル。このプロファイルはセキュリティ管理者に対して使用します。

TOPOLOGY_ADMIN

トポロジを編集するための権限を付与するプロファイル。このプロファイルは、システム管理者またはOracle Data Integrator管理者に対して使用します。

VERSION_ADMIN

バージョンおよびソリューションを作成、リストアおよび編集するための権限を付与するプロファイル。このプロファイルは、プロジェクト・マネージャや、バージョン管理操作の実行を担当する開発者に対して使用します。

注意:
組込みプロファイルはOracle Data Integratorの新規機能の保護に関連しているため変更しないようにしてください。自分のプロファイルまたは既存のプロファイルをカスタマイズする場合は、組込みプロファイルのコピーを作成し、そのコピーをカスタマイズすることをお薦めします。

10.1.3 ユーザー

ユーザーは、Oracle Data Integratorのユーザーです。ユーザーは、次の権限を継承します。

- 様々なプロファイルに付与されているすべての権限

- ユーザーに割り当てられているオブジェクトまたはインスタンス(あるいはその両方)に対する権限

ユーザー・メソッドは、ユーザーに付与されるオブジェクト・タイプのメソッドに対する権限です。付与された各メソッドによって、ユーザーは、オブジェクト・タイプ(プロジェクト、モデル、データストアなど)のインスタンスに対してアクション(編集、削除など)を実行できます。これらのメソッドは、ユーザーに適用されている点以外はプロファイル・メソッドに類似しています。

ユーザーには、特定の作業リポジトリのインスタンスに対する権限を付与できます(インスタンスが存在する場合)。たとえば、開発者ユーザーに、PRODUCTIONリポジトリではなく、DEVELOPMENTリポジトリのLOAD_DATAWAREHOUSEシナリオに対する編集権限を付与できます。

オブジェクト・インスタンス別認可をオブジェクト・インスタンス上のユーザーに付与します。このオブジェクト・インスタンスのこのユーザー特定のメソッドに権限を付与できます。

ユーザーのツリーに表示されるある特定のインスタンスに、オブジェクト・インスタンス別認可が存在する場合、そのユーザーに、そのインスタンスのオブジェクト・メソッドに対する特定の権限が付与されていることを示します。これらの権限は、オブジェクト・インスタンス・エディタで指定します。インスタンスがユーザーのインスタンスのツリーに表示されない場合は、そのオブジェクト・タイプに対してユーザー・メソッド権限またはプロファイル・メソッド権限が適用されます。

インスタンスはマスター・リポジトリに連結されている別の作業リポジトリにレプリケートできるため、オブジェクト・インスタンス別認可は、マスター・リポジトリに連結されている作業リポジトリの1つまたは複数、あるいはすべてに対して定義できます。たとえば、LOAD_DATAWAREHOUSEシナリオ・インスタンスは、DEVELOPMENT、TESTおよびPRODUCTIONの各リポジトリにバージョニングなどを使用してレプリケートできます。インスタンスの権限は、リポジトリに応じて変更できます。たとえば、一般的に、開発リポジトリのプロジェクトはテスト・リポジトリにレプリケートされます。開発者に対して、開発リポジトリ内のその開発者のプロジェクトに対する編集権限を付与することはできますが、テスト・リポジトリ内のプロジェクトには付与できません。テスト・リポジトリで開発者に付与されるのは、プロジェクトに対する表示権限のみです。

10.1.4 ロール

Oracle Data Integratorが、外部認証(「外部認証の構成」を参照)を使用するように構成されている場合は、Oracle Data Integratorのエンタープライズ・ロール統合機能を利用できます。Oracle Data Integratorのエンタープライズ・ロール統合は、Oracle Platform Security Services (OPSS)の認可モデルに基づいています。この機能を利用すると、エンタープライズ・ロールをOracle Data Integratorロールにマップできるため、特定のエンタープライズ・ロールのエンタープライズ・ユーザーは、マッピングでOracle Data Integratorロールに付与された権限を使用して、Oracle Data Integratorにアクセスできます。

Oracle Data Integratorのエンタープライズ・ロール統合を使用すると、次の操作を実行できます。

- Oracle Data Integratorロールのセットの作成。

- Oracle Data IntegratorロールへのOracle Data Integrator権限(インスタンス・レベルおよびタイプ・レベル)およびプロファイルの付与。

- Oracle Data Integratorロールへの、外部アイデンティティ・ストアで定義されたエンタープライズ・プリンシパル(つまり、ユーザーまたはロール)のマップ。

- Oracle Data Integratorへのアクセスが認証されたユーザーに付与された権限の、ユーザーが直接的またはエンタープライズ・ロールを介して間接的にマップされたすべてのOracle Data Integratorロールを評価することによる決定。(権限は、認可中に自動的に計算されます。)

エンタープライズ・ロールの概要は、『Oracle Platform Security Servicesによるアプリケーションの保護』の「ユーザーおよびロールの理解」を参照してください。Oracle Data Integratorでのエンタープライズ・ロール統合の機能およびOracle Data Integrator Studioでのロールの管理方法の詳細は、「アイデンティティ・ストアで定義されたプリンシパルのOracle Data Integratorロールへのマッピング」を参照してください。

10.2 ユーザー管理

この項では、様々なセキュリティ機能を使用してOracle Data Integratorでセキュリティを実施する方法について説明します。

この項は、次の項目を含んでいます。

- セキュリティ・ポリシーの手法

- プロファイルの管理

- ユーザーの管理

- 権限の管理

10.2.1 セキュリティ・ポリシーの手法

Oracle Data Integratorのセキュリティを定義するには、主に次の2つの手法があります。

- 保護強化手法: ユーザーにはオブジェクトに対する認可がデフォルトで付与されません。この手法で使用するのは、非汎用プロファイルのみです。セキュリティ管理者は、ユーザーにオブジェクト・インスタンスに対する認可を付与する必要があります。このポリシーの構成は、権限をインスタンス別に管理する必要があるため複雑です。

- 一般的手法: ユーザーは、保持しているプロファイルの権限を継承します。このポリシーは、ほとんどの環境に適しており、構成が簡単です。

保護強化手法を実装するには:

1. ユーザーを作成します。

2. ユーザーに非汎用プロファイル(組込みまたはカスタマイズ)を指定します。

3. オブジェクト・インスタンスの作成後に、それらのインスタンスの権限をユーザーに付与します。この操作は、新規のインスタンスすべてについて繰り返す必要があります。

一般的手法を実装するには:

1. ユーザーを作成します。

2. ユーザーに汎用プロファイル(組込みまたはカスタマイズ)を指定します。

注意:
汎用プロファイルと非汎用プロファイルを同時に使用すると、2つの手法を組み合せることができます。たとえば、ユーザーに対してDESIGNERとNG_METADATA_ADMINを使用すると、一般的手法でプロジェクトを管理し、保護強化手法でモデルを管理できます。

10.2.2 プロファイルの管理

作成、削除または複製できます。プロファイルの作成または複製により、ユーザーに割り当てたプロファイルのカスタマイズが可能です。次の各トピックでは、Oracle Data Integrator Studioでこれらの処理を実行する手順を説明します。

10.2.2.1 新規プロファイルの作成

プロファイルを作成するには、次のようにします。

1. セキュリティ・ナビゲータで、「プロファイル」ナビゲーション・ツリーを展開します。

2. 「プロファイル」ナビゲーション・ツリーのツールバーで、「新規プロファイル」をクリックします。

3. 「名前」フィールドに、プロファイルの名前を入力します。

4. 「ファイル」メイン・メニューから「保存」を選択します。

新規プロファイルが表示されます。

10.2.2.2 プロファイルの複製

プロファイルを複製するには:

1. セキュリティ・ナビゲータで、「プロファイル」ナビゲーション・ツリーを展開します。

2. プロファイルのリストから複製するプロファイルを選択します。

3. 右クリックして「複製」を選択します。

新規プロファイルが表示されますが、これは元のプロファイルのコピーです。

10.2.2.3 プロファイルの削除

プロファイルを削除するには、次のようにします。

1. セキュリティ・ナビゲータで、「プロファイル」ナビゲーション・ツリーを展開します。

2. プロファイルのリストから削除するプロファイルを選択します。

3. 右クリックして「削除」を選択します。

4. 「確認」ダイアログで、「OK」をクリックします。

プロファイルがリストから削除されます。このプロファイルが付与されているすべてのユーザーは、このプロファイルに関連付けられている権限を失います。

10.2.3 ユーザーの管理

ユーザーの管理方法は、ある程度、ユーザーが定義されている場所によって異なります。デフォルトでは、ユーザーはリポジトリへの接続に使用されるログイン名に対応し、Oracle Data Integratorの内部リポジトリに維持されます。ただし、Oracle Data Integratorコンポーネントに対して外部認証が有効になっている場合は、次のようになります。

- Oracle Data Integratorへのアクセスが認証されたユーザーは、Oracle Internet Directoryなどの外部アイデンティティ・ストアで作成および管理されます。ストアに用意されているツールおよびユーティリティを使用して、ユーザーを作成、更新および削除します。

- 外部ユーザーによるOracle Data Integratorへのアクセスを許可するには、次のいずれかの操作を行います。

- 外部ユーザーをOracle Data Integratorロールにマップする。

- この外部ユーザーが属しているエンタープライズ・ロールのいずれかをOracle Data Integratorロールにマップする。

- 以前のリリースと同様に、セキュリティ・ナビゲータを使用して外部ユーザーをOracle Data Integratorに登録する。

- Oracle Data Integratorに登録されている外部ユーザーには、プロファイルまたはその他のセキュリティ権限を直接割り当てることが可能です。または、プロファイルやその他のセキュリティ権限をOracle Data Integratorロールに割り当ててから、外部ユーザー(または、外部ユーザーのエンタープライズ・ロールのいずれか)をそのOracle Data Integratorロールにマップすることもできます。2つ目の方法の場合、外部ユーザーはOracle Data Integratorロールに付与されたすべてのプロファイルおよび権限を継承することが可能です。
エンタープライズ・ユーザー(または、ユーザーのエンタープライズ・ロール)を複数のOracle Data Integratorロールにマップすることもできます。ユーザーが認証されると、ユーザーの権限が、マッピングですべてのOracle Data Integratorロールに付与されたすべての権限の和集合として計算されます。

外部認証の詳細は、「外部認証の構成」を参照してください。エンタープライズ・ロール統合の詳細は、「アイデンティティ・ストアで定義されたプリンシパルのOracle Data Integratorロールへのマッピング」を参照してください。

10.2.3.1 内部リポジトリへの新規ユーザーの作成

Oracle Data Integratorの内部リポジトリにユーザーを作成するには:

1. セキュリティ・ナビゲータで、「ユーザー」ナビゲーション・ツリーを展開します。

2. 「ユーザー」ナビゲーション・ツリーのツールバーで、「新規ユーザー」をクリックします。

3. 「名前」フィールドに、ユーザーの名前を入力します。

4. ユーザーの「イニシャル」を入力します。

5. 次のいずれかの操作を行います。

- 内部認証を使用する場合は、「パスワードを入力してください」をクリックし、このユーザーのパスワードを入力します。

- 外部認証を使用する場合は、「GUIDの取得」をクリックし、新規ユーザーを外部アイデンティティ・ストアのユーザーに関連付けます。Oracle Data Integratorでのユーザー名とアイデンティティ・ストアでのユーザー名が一致している必要があります。一致が検出されると、グローバルの一意IDが「外部GUID」フィールドに表示されます。

6. 「ファイル」メイン・メニューから「保存」を選択します。

新規ユーザーが「ユーザー」ナビゲーション・ツリーに表示されます。「ユーザー」エディタから、ODIスーパーバイザ・ユーザーは他のODIユーザー・アカウント(他のスーパーバイザ・アカウントを含む)を無効にできます。

警告:

常に、少なくとも1つのスーパーバイザ・ユーザー・アカウントを保持する必要があります。すべてのスーパーバーザ・ユーザー・アカウントの有効期限が切れた場合は、Oracleサポートに連絡してください。

10.2.3.2 ユーザーへのプロファイルの割当て

プロファイルをユーザーに割り当てるには:

1. セキュリティ・ナビゲータで、「ユーザー」ナビゲーション・ツリーおよび「プロファイル」ナビゲーション・ツリーを展開します。

2. 割り当てるプロファイルを選択し、割当先のユーザーにドラッグします。

3. 「確認」ダイアログで、「OK」をクリックします。

このプロファイルが、割当先ユーザーのプロファイルの下に表示されます。このプロファイルに関連付けられている権限がユーザーに即時に付与されます。

注意:
外部認証が有効な場合、プロファイルをロールに割り当てることができます。特定のOracle Data Integratorロールに定義されているユーザーには、そのロールに割り当てられているすべてのプロファイルが付与されます。エンタープライズ・ロール統合では、より便利で大雑把な手法を使用してユーザーに付与された権限を管理します。詳細は、「Oracle Data Integratorロールへの権限またはプロファイルの割当て」を参照してください。

10.2.3.3 ユーザーのプロファイルの削除

ユーザーのプロファイルを削除するには:

1. セキュリティ・ナビゲータで、「ユーザー」ナビゲーション・ツリーを展開します。

2. ユーザーの下にある「プロファイル」ノードを展開します。

3. 削除するプロファイルを右クリックします。

4. 「削除」を選択します。

5. 「確認」ダイアログで、「OK」をクリックします。

このユーザーに割り当てられているプロファイルのリストから、該当のプロファイルが削除されます。このプロファイルによってユーザーに付与されていたすべての権限が削除されます。

注意:
外部認証が有効な場合、ロールからプロファイルを削除できます。特定のOracle Data Integratorロールに定義されているユーザーには、そのロールに割り当てられているプロファイルのみが付与されます。詳細は、「Oracle Data Integratorロールへの権限またはプロファイルの割当て」を参照してください。

10.2.3.4 内部リポジトリのユーザーの削除

Oracle Data Integratorの内部リポジトリに定義されているユーザーを削除するには:

1. セキュリティ・ナビゲータで、「ユーザー」ナビゲーション・ツリーを展開します。

2. ユーザーのリストから削除するユーザーを選択します。

3. 右クリックして「削除」を選択します。

4. 「確認」ウィンドウで「OK」をクリックします。

ユーザーがリストから削除されます。

10.2.4 権限の管理

ユーザーおよびプロファイルを作成した後は、これらのユーザーに権限を付与できます。付与できるのは、オブジェクト・タイプに適用するプロファイル・メソッドとユーザー・メソッド、および特定のオブジェクト・インスタンスに適用するオブジェクト・インスタンス別認可(ユーザー用のみ)です。

注意:
Oracle Data Integratorコンポーネントで外部認証が有効な場合、エンタープライズ・ロール統合機能を使用してユーザーの権限をより適切に管理できます。詳細は、「ロール・エディタの使用」を参照してください。

10.2.4.1 プロファイル・メソッドまたはユーザー・メソッドの付与

プロファイル・メソッドまたはユーザー・メソッドを付与するには:

1. セキュリティ・ナビゲータで、「ユーザー」ナビゲーション・ツリーまたは「プロファイル」ナビゲーション・ツリーを展開します。

2. 「オブジェクト」ナビゲーション・ツリーを展開し、権限を付与するオブジェクトのノードを展開します。

3. 付与するメソッドを選択し、そのメソッドを付与するユーザーまたはプロファイルにドラッグします。

4. 「確認」ウィンドウで「OK」をクリックします。

メソッドがユーザーまたはプロファイルに付与されます。このメソッドは、ユーザーのオブジェクト・ノードの下またはプロファイルの下に表示されます。

注意:
オブジェクトのすべてのメソッドに対する権限を付与するには、メソッドの1つをドラッグするかわりに、オブジェクト自体をユーザーまたはプロファイル上にドラッグします。

10.2.4.2 プロファイル・メソッドまたはユーザー・メソッドの取消し

プロファイル・メソッドまたはユーザー・メソッドを取り消すには:

1. セキュリティ・ナビゲータで、「ユーザー」ナビゲーション・ツリーまたは「プロファイル」ナビゲーション・ツリーを展開します。

2. 権限を取り消す「プロファイル」、またはユーザーの下にある「オブジェクト」ノードを展開し、取り消す必要があるオブジェクトのメソッドを展開します。

3. メソッドを右クリックし、「削除」を選択します。

4. 「確認」ダイアログで、「OK」をクリックします。

ユーザーまたはプロファイルからメソッドが取り消されます。このユーザーまたはプロファイルのオブジェクト・ノードの下のメソッド・リストから、このメソッドの表示が消去されます。

10.2.4.3 オブジェクト・インスタンス別認可の付与

オブジェクト・インスタンス別認可をユーザーに付与するには:

1. セキュリティ・ナビゲータで、「ユーザー」ナビゲーション・ツリーを展開します。

2. デザイナ・ナビゲータ、オペレータ・ナビゲータまたはトポロジ・ナビゲータで、権限を付与するオブジェクトが格納されているナビゲーション・ツリーを展開します。

3. このオブジェクトを選択して、「ユーザー」ナビゲーション・ツリーにドラッグします。オブジェクト・インスタンス別認可のエディタが表示されます。このエディタには、このインスタンスで使用可能なメソッドのリストと、このオブジェクトに格納されているインスタンスが表示されます。たとえば、プロジェクト・インスタンスの権限を付与する場合は、そのプロジェクトに格納されているフォルダおよびマッピングがエディタに表示されます。

4. 付与する権限をオブジェクトおよびメソッドごとに微調整します。リストから選択したメソッドには、次の簡単な権限ポリシーを実装できます。

- すべてのリポジトリのすべてのメソッドを付与するには「すべてのリポジトリ内の選択したメソッドを許可」をクリックします。

- すべてのリポジトリのすべてのメソッドを拒否するには「すべてのリポジトリ内の選択したメソッドを拒否」をクリックします。

- 特定の作業リポジトリのすべてのメソッドを付与するには、「選択したリポジトリ内の選択したメソッドを許可」をクリックし、リストからリポジトリを選択します。

5. 「ファイル」メイン・メニューから「保存」を選択します。

注意:
オブジェクト・インスタンス別認可をサポートしているのは、特定のオブジェクトのみです。これらのオブジェクト・タイプは、各ユーザーの「インスタンス」ノードの下にリストされています。
ユーザーに一般権限があるメソッドは、オブジェクト・インスタンス・エディタにリストされません。

10.2.4.4 オブジェクト・インスタンス別認可の取消し

オブジェクト・インスタンス別認可をユーザーから取り消すには:

1. セキュリティ・ナビゲータで、「ユーザー」ナビゲーション・ツリーを展開します。

2. 権限を取り消すユーザーの下にある「インスタンス」ノードを展開します。

3. 認可を取り消すインスタンスを右クリックし、「削除」を選択します。

4. 「確認」ダイアログで、「OK」をクリックします。

オブジェクト・インスタンスの認可が、ユーザーから取り消されます。

注意:
オブジェクト・インスタンス別認可を編集し、特定のメソッドをユーザーに対して拒否することで、メソッドごとに権限を取り消すこともできます。この操作の後に、インスタンスに対する権限がユーザーになくなると、そのインスタンスはセキュリティ・マネージャのツリーから削除されます。

10.2.4.5 未使用認可のクリーン・アップ

オブジェクト・インスタンス別認可は、マスター・リポジトリに格納されています。すべての作業リポジトリからオブジェクトを削除した場合でも、その認可の削除が必要とは限りません。特定の未使用認可が、エクスポート・ファイルやストアド・ソリューションに現在格納されているオブジェクトを参照している場合などは、それらの認可を保持することをお薦めします。

未使用認可をマスター・リポジトリから削除するには、セキュリティ・クリーンアップ・ツールを定期的に使用する必要があります。未使用認可は、それらの認可がマスター・リポジトリまたはすべての作業リポジトリに存在しないオブジェクトを参照している場合に削除されます。

注意:
マスター・リポジトリに連結されているすべての作業リポジトリは、リポジトリ内にオブジェクトが存在するか確認できるようにアクセス可能である必要があります。

未使用認可をクリーン・アップするには:

1. セキュリティ・ナビゲータのツールバー・メニューから、「セキュリティ設定のクリーンアップ」を選択します。「セキュリティ・クリーンアップ・ツール」ダイアログが表示されます。

2. 「クリーニング可能」タブで、削除するクリーニング可能セキュリティ設定に対して「クリーン」を選択します。削除できないセキュリティ設定は、「クリーニング不可」タブに表示されます。

3. 「OK」をクリックして、選択したセキュリティ設定をクリーン・アップします。

10.3 Advanced Encryption Standard

Oracle Data Integrator 12c (12.1.3)は、Federal Information Processing Standardの1つであるAdvanced Encryption Standard (AES)を使用してセキュリティを強化しています。AESアルゴリズムは、デジタル情報の暗号化および復号化に使用できるブロック暗号です。AESアルゴリズムでは、128ビット、192ビットおよび256ビットの暗号化鍵を使用できます。ODIではパスワードの暗号化にAES-128が使用されますが、AES-256を使用するようにODIを構成することもできます。

AESは対称型ブロック暗号化アルゴリズムであり、AESによってプレーンテキストが暗号文に変換されるとき、また逆に暗号文がプレーンテキストに変換されるときに、秘密鍵またはマスター・キーが使用されます。セキュリティに関する考慮事項により、マスター・キーは自動生成する必要があり、ハードコードすることはできません。ODIでは、マスター・リポジトリの作成中に、AESアルゴリズムのマスター・キー文字列が生成されます。各リポジトリは異なるマスター・キーを持ち、ODIで異なるリポジトリ間で暗号文が移行されるときは、エクスポート・キーを入力する必要があります。このエクスポート・キーは、エクスポート済オブジェクトに含まれる機密データの暗号化に使用されます。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のエクスポート・キーに関する項を参照してください。

注意:
AES-256を使用するには、Oracle Java DownloadサイトからJava Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policyファイルをダウンロードし、ダウンロードの諸条件に同意して、既存のポリシー・ファイルをJRE_HOME/lib/securityにダウンロードしたポリシー・ファイルで置き換えます。

10.4 パスワードで保護されたウォレットを使用したログイン資格証明の格納

Oracle Data Integrator Studioに初めてログインする前に、Oracle Data Integratorのログイン資格証明を指定するログイン名を作成する必要があります。これらの資格証明には、Oracle Data Integratorのユーザー名およびパスワードの他、Oracle Data Integratorのマスター・リポジトリ・データベースのユーザー名およびパスワードが含まれます。Oracle Data Integratorでは、これらの資格証明を暗号化されたログインXMLファイルかまたはパスワードで保護されたウォレットに保存できます。デフォルトでは、パスワードで保護されたウォレットに保存されます。

オラクル社では、データベースのログイン資格証明をパスワードで保護されたウォレットに格納することをお薦めします。パスワードで保護されたウォレットを生成するために、Oracle Data Integratorでは、Oracle Platform Security Services (OPSS)のOracleウォレット機能を利用します。パスワードで保護されたウォレットでは、強力な暗号化アルゴリズムを使用してウォレットのコンテンツを保護します。

Oracle Data Integrator Studioでパスワードで保護されたウォレットを使用する際は、次の点に注意してください。

- ウォレットを作成するときに、ウォレットのパスワードとそのパスワードの有効期限が切れるまでの日数を指定します。Oracle Data Integratorにより、リポジトリのログイン資格証明がウォレットに格納されます。

- Oracle Data Integratorリポジトリに接続する場合は、ウォレットのパスワードを入力するだけです。これにより、すべてのリポジトリのログイン資格証明がウォレットから自動的に取得されます。

- ウォレット・ファイルはewallet.p12と命名され、次のディレクトリに配置されます。
Windows: %APPDATA%\odi\oracledi\ewallet

UNIX: $HOME/.odi/oracledi/ewallet

注意:
使用環境によっては、最初にウォレット用のルート・ディレクトリの作成が必要となる場合があります。詳細は、「パスワードで保護されたウォレットの作成」を参照してください。

- ウォレットのパスワードの有効期限が切れると、Oracle Data Integrator Studioにログインする際に、Studioより自動的にメッセージが表示されるので新しい有効期限を入力してください。

- ウォレットのパスワードと有効期限はStudioからいつでも変更できます。

次の各項では、Oracle Data Integratorのログイン資格証明を格納するためのパスワードで保護されたウォレットの作成方法および使用方法について説明します。

- パスワードで保護されたウォレットの作成

- 他のユーザーへのリポジトリ・アクセスの許可

- ウォレット・パスワードの変更

- ログイン資格証明の保存方法のカスタマイズ

10.4.1 パスワードで保護されたウォレットの作成

Studioに初めてログインするときに、次の手順を使用して、パスワードで保護されたウォレットを作成できます。

1. ウォレットを格納するためのルート・ディレクトリがマシンにない場合はこれを作成します。
Windows:

Windowsマシンの場合は、ルート・ディレクトリ・パスodi\\oraclediを環境変数%APPDATA%で表される場所に作成する必要があります。例:

c:\> mkdir %APPDATA%\odi\oracledi

UNIX:

UNIXマシンの場合は、ルート・ディレクトリ・パスodi\\oraclediを環境変数$HOMEで表される場所に作成する必要があります。例:

prompt> mkdir -p $HOME/.odi/oracledi/

2. ORACLE_HOME/odi/studioディレクトリに移動します。

3. 次のコマンドを実行してOracle Data Integrator Studioを起動します。
Windows:

odi.exe

UNIX:

./odi.sh

Studioのメイン・ウィンドウが表示されます。

4. 「リポジトリへの接続」をクリックします。
図10-1に示すような「新規ウォレット・パスワード」ダイアログ・ボックスが表示されます。

図10-1 「新規ウォレット・パスワード」ダイアログ・ボックス

5. デフォルト・オプションの「セキュアなウォレットにパスワードを格納する」を選択して、「ウォレット・パスワード」および「ウォレット・パスワードの確認」の各フィールドにパスワードを入力します。
オプションで、パスワードの有効期限を変更できます。

6. 「OK」をクリックします。
マスター・リポジトリのログイン資格証明を入力するよう促されます。必要な資格証明の詳細は、「マスター・リポジトリの作成」を参照してください。

今後、Studioにログインしてリポジトリに接続するたびにウォレット・パスワードを入力するよう促されます。

10.4.2 他のユーザーへのリポジトリ・アクセスの許可

Oracle Data Integratorユーザーにリポジトリへのアクセスを許可するには、次のどちらかの方法を使用して、パスワードで保護されたウォレットをユーザーに配布します。

- 作成したewallet.p12ファイルのコピーを、指定したパスワードとともに各ユーザーに配布します。

- 各Oracle Data Integratorユーザーに対して個別にパスワードで保護されたウォレットを作成します。この場合、各ウォレットに異なるパスワードを設定できます。

他のユーザー用にウォレットを作成する場合は、次の点に注意してください。

1. 新規ウォレットを作成する前に、既存のewallet.p12ファイルを別のディレクトリに移動します。

2. 他のユーザー用のウォレットを作成する場合は、有効期限を0日に設定します。こうすることで、ユーザーが初めてリポジトリに接続するときに、各自のウォレットに新しいパスワードを設定するよう促されます(「ウォレット・パスワードの変更」を参照)。

「パスワードで保護されたウォレットの作成」の説明のとおり、Oracle Data Integrator Studioで使用されるすべてのパスワードで保護されたウォレットのファイルはewallet.p12と命名され、そのファイルが使用されるマシンの~oracledi/ewalletディレクトリに配置される必要があります。

10.4.3 ウォレット・パスワードの変更

ウォレットのパスワードの有効期限が切れると、リポジトリに接続する際に、自動的に新しいパスワードを入力するよう促されます。ただし、ウォレット・パスワードは次の方法でStudioからいつでも変更できます。

1. Oracle Data Integrator Studioを起動します。

2. 「ODI」メニューから「ウォレット・パスワードの変更...」を選択します。
図10-2に示すような「ウォレット・パスワードの変更」ダイアログ・ボックスが表示されます。

図10-2 「ウォレット・パスワードの変更」ダイアログ・ボックス

3. 現在のパスワードおよび新しいパスワードを入力し、新しいパスワードを確認します。
オプションで、有効期限を変更することも可能です。

4. 「OK」をクリックします。

10.4.4 ログイン資格証明の保存方法のカスタマイズ

Oracle Data Integrator Studioには、ログイン資格証明の格納について次のオプションが用意されています。

- ログイン資格証明の保存を有効または無効にできます。

- ログイン資格証明を保存する場合、それらをパスワードで保護されたウォレットに保存するかまたはログインXMLファイルに保存するかを選択できます。

ログイン資格証明を変更するかどうか、またはログイン資格証明の保存方法を変更するには、次の手順を実行します。

1. Oracle Data Integrator Studioを起動します。

2. 「ツール」メニューから、「プリファレンス」を選択します。
「プリファレンス」ダイアログ・ボックスが表示されます。

3. 「プリファレンス」ダイアログ・ボックスで「ODI」ノードを展開し「ユーザー・インタフェース」を選択します。
「プリファレンス」ダイアログ・ボックス(図10-3に表示)に、ログイン資格証明を保存するための次のオプションが表示されます。

- ログイン資格証明の保存: 資格証明を保存する場合は、このオプションを選択します。

- ウォレットへのログイン資格証明の保存: Oracle Data Integratorのログイン資格証明を、パスワードで保護されたウォレットに格納する場合は、このオプションを選択します。
「ログイン資格証明の保存」を選択して「ウォレットへのログイン資格証明の保存」の選択を解除した場合、ログイン資格証明はログインXMLファイルに保存されます。

デフォルトでは両方のオプションが選択されています。オラクル社ではこの設定をお薦めします。

4. いずれかのプリファレンスを変更した場合は「OK」をクリックします。

図10-3 ログイン資格証明を保存するための「プリファレンス」ダイアログ・ボックス

10.5 外部パスワード記憶域の設定

Oracle Data Integratorでは、すべてのセキュリティ情報がデフォルトでマスター・リポジトリに格納されます。このパスワード記憶域オプションは内部パスワード記憶域と呼ばれます。

Oracle Data Integratorでは、オプションで、重要なセキュリティ情報を格納するためにOPSSを使用できます。Oracle Data IntegratorでOPSSを使用すると、データ・サーバー・パスワードおよびコンテキスト・パスワードがOPSS資格証明ストア・フレームワーク(CSF)に格納されます。このパスワード記憶域オプションは、外部パスワード記憶域と呼ばれます。

注意:
外部パスワード記憶域を使用した場合、ユーザー名、パスワード、権限などの他のセキュリティ詳細はマスター・リポジトリに残ります。外部認証を使用すると、認証を外部化し、ユーザーとパスワードをアイデンティティ・ストアに格納できます。その他の注意: 外部パスワード記憶域オプションは、外部認証機能とは関係ありません。外部認証の詳細は、「外部認証の構成」を参照してください。

外部パスワード記憶域オプションを使用するには:

1. OPSSが構成されたWebLogic Serverインスタンスをインストールする必要があります。

2. ランタイム・エージェントなどのすべてのOracle Data Integratorコンポーネントには、リモートの資格証明ストアへのアクセス権が必要です。

詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のOPSSを使用するためのJava EEアプリケーションの構成に関する項を参照してください。

10.5.1 パスワード記憶域の設定

パスワード記憶域を設定または変更するには、次の4つの方法があります。

- マスター・リポジトリのインポート(『Oracle Data Integratorでの統合プロジェクトの開発』のマスター・リポジトリのインポートに関する項を参照): パスワード記憶域を変更できます。

- マスター・リポジトリの作成(「マスター・リポジトリの作成」を参照): パスワード記憶域を定義できます。

- パスワード記憶域の切替え: 既存のマスター・リポジトリのパスワード記憶域を変更します。

- パスワード記憶域のリカバリ: 資格証明ストアのキャッシュをリカバリできます。

10.5.2 パスワード記憶域の切替え

Oracle Data Integratorリポジトリのパスワード記憶域を切り替えると、データ・サーバーとコンテキストのパスワードの格納方法が変更されます。この操作は、スーパーバイザ・ユーザーが実行する必要があります。

データ・サーバーのパスワードのパスワード記憶域オプションを変更するには、「パスワード記憶域の切替え」ウィザードを使用します。

「パスワード記憶域の切替え」ウィザードを起動する前に、次のタスクを実行します。

- Oracle Data Integrator Studioをリポジトリから切断します。

- Oracle Data Integratorリポジトリを使用しているすべてのコンポーネントをシャットダウンします。

「パスワード記憶域の切替え」ウィザードを起動するには:

1. 「ODI」メイン・メニューから「パスワード記憶域」→「切替え」の順に選択します。

2. Oracle Data Integratorのマスター・リポジトリのログイン詳細を、マスター・リポジトリへの接続のときに定義したとおりに指定します(「マスター・リポジトリへの接続」を参照)。

3. 「次へ」をクリックします。

4. パスワード記憶域を次のように選択します。

- パスワードをOracle Data Integratorリポジトリに格納する場合は、「内部パスワード記憶域」を選択します。

- OPSS資格証明ストア・フレームワーク(CSF)を使用して、データ・サーバーおよびコンテキストのパスワードを格納する場合は、「外部パスワード記憶域」を選択します。
外部パスワード記憶域を選択した場合は、表10-2の説明に従って「MBeanサーバー・パラメータ」を指定し、資格証明ストアにアクセスした後、「テスト接続」をクリックし、MBeanサーバーへの接続を確認します。

表10-2 MBeanサーバー・パラメータ

サーバー

ホスト

JMXポート

ユーザー

パスワード

リストからアプリケーション・サーバーを選択します。

MBeansサーバー・ホスト。例: mymachine.oracle.com

MBeansサーバー・ポート。例: 7001

MBeansサーバー・ユーザー名。例: weblogic

MBeanサーバー・パスワード

5. 「終了」をクリックします。

パスワード記憶域オプションが変更されました。これで、Oracle Data Integratorリポジトリに再接続できます。

10.5.3 パスワード記憶域のリカバリ

Oracle Data Integratorでは、外部パスワード記憶域がクラッシュした場合にのみ使用されるパスワード・リカバリ・サービスを提供しています。この手順を使用すると、外部記憶域を使用できなくなるため、パスワード記憶域は強制的に内部パスワード記憶域になります。この操作は、スーパーバイザ・ユーザーが実行する必要があります。

注意:

パスワード記憶域のリカバリを実行すると、コンテキストのパスワード、データ・サーバーのパスワード、作業リポジトリのJDBCパスワードおよびエンタープライズ・スケジューラ関連のパスワードが失われるため、トポロジ・ナビゲータで手動で再入力する必要があります。

パスワードのリカバリを開始には、パスワード記憶域のリカバリ・ウィザードを使用します。

パスワード記憶域のリカバリ・ウィザードを起動するには:

1. 「ODI」メイン・メニューから「パスワード記憶域」→「リカバリ」の順に選択します。

2. Oracle Data Integratorのマスター・リポジトリのログイン詳細を、マスター・リポジトリへの接続のときに定義したとおりに指定します(「マスター・リポジトリへの接続」を参照)。

3. 「終了」をクリックします。

4. データ・サーバーおよびコンテキストのパスワードを手動で再入力します。詳細は、「トポロジの設定」を参照してください。

10.6 認証モードの管理

デフォルトでは、Oracle Data Integratorユーザーは、マスター・リポジトリに格納されたアイデンティティ情報を使用して認証されます。ただし、Oracle Data Integratorユーザーは外部認証サービスを使用して認証を受けることも可能です。つまり、Oracle Data Integratorユーザーは、Oracle Platform Security Services (OPSS)を使用して、外部エンタープライズ・アイデンティティ・ストア(Oracle Internet Directory、Microsoft Active DirectoryなどのLDAPサーバー)に対して認証されます。このようなアイデンティティ・ストアでは、中央の場所にエンタープライズ・ユーザーおよびエンタープライズ・ロールが格納されています。

外部認証が有効な場合、マスター・リポジトリではOracle Data Integrator固有の権限が保持されます。Oracle Data Integratorの内部リポジトリに外部ユーザーを作成する必要はありません。そのかわり、外部ユーザーの資格証明は集中管理されたアイデンティティ・ストアに依存し、この外部ストアに対して常に認証が行われます。

認証モード(内部または外部)はリポジトリ作成時に定義でき、「マスター・リポジトリでの認証モードの設定」の説明のとおり、既存のリポジトリ用に切り替えることができます。

外部認証の構成の詳細は、「外部認証の構成」を参照してください。

10.6.1 マスター・リポジトリでの認証モードの設定

認証モードを設定するには、次の2つの方法があります。

- マスター・リポジトリの作成時。マスター・リポジトリ作成ウィザードには、認証モードを設定するためのオプションが含まれています。マスター・リポジトリの作成時に外部認証を設定する方法の詳細は、「マスター・リポジトリ作成時の外部認証の設定」を参照してください。詳細は、「マスター・リポジトリの作成」を参照してください。

- Studioからの認証モードの切替え時。「認証モードの切替え」ウィザードを使用すると、既存のマスター・リポジトリで使用される認証モードを変更できます。Studioで外部認証モードに切り替えるための詳細な手順は、「既存のマスター・リポジトリから外部認証モードへの切替え」を参照してください。

注意:
マスター・リポジトリで外部認証モードを選択する前に、「外部認証の構成」の説明に従って.外部認証を構成する必要があります。

10.7 外部認証の構成

デフォルトでは、Oracle Data Integratorは、すべてのユーザー情報およびユーザーの権限をマスター・リポジトリに格納します。ユーザーがOracle Data Integratorにログインすると、マスター・リポジトリに対して認証が行われます。この認証方法は、内部認証と呼ばれます。

ただし、Oracle Platform Security Services (OPSS)を使用してエンタープライズ・アイデンティティ・ストア(Oracle Internet Directory、Microsoft Active DirectoryなどのLDAPサーバー)に定義されているユーザーを認証するようにOracle Data Integratorをカスタマイズできます。アイデンティティ・ストアには、エンタープライズ・ユーザーおよびエンタープライズ・ロールが含まれています。このようなアイデンティティ・ストアは、ユーザー定義を集中管理し、シングル・サインオン(SSO)をサポートするために、アプリケーションではエンタープライズ・レベルで使用されます。Oracle Data Integratorでは、この認証方法を外部認証と呼びます。外部認証を構成することにより、OPSSで提供される標準のJavaセキュリティ・モデル認証および認可サービスを利用できます。外部認証を使用する場合、ODIではLDAP共通名(cn)属性を使用してODIユーザーとLDAPユーザーの照合が行われます。

外部認証を使用するには、エンタープライズ・アイデンティティ・ストアを構成し、各Oracle Data Integratorコンポーネントがそのアイデンティティ・ストアを参照するように構成する必要があります。

注意:
外部認証を使用した場合、外部化されるのはユーザーおよびパスワードのみです。Oracle Data Integratorの権限は、リポジトリ内に残ります。

次の各項では、Studioへの外部認証の設定方法およびスタンドアロン・エージェントの設定方法について説明します。

- 外部認証のためのOracle Data Integrator Studioの構成

- 既存のマスター・リポジトリから外部認証モードへの切替え

- 外部認証への切替え後のユーザーの再アクティブ化

- 外部認証用のスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントの構成

- アイデンティティ・ストアに定義されたプリンシパルのOracle Data Integratorへのマッピング

10.7.1 外部認証のためのOracle Data Integrator Studioの構成

Oracle Data Integrator Studioで外部認証を構成するには、次の操作を行う必要があります。

1. OPSS構成ファイルの設定

2. LDAPブートストラップ・ユーザーのためのウォレット・ファイルの作成

3. マスター・リポジトリ作成時の外部認証の設定

10.7.1.1 OPSS構成ファイルの設定

アイデンティティ・ストアに接続して使用するための構成は、jps-config-jse.xmlファイルと呼ばれるOPSS構成ファイルにあります。Oracle Data Integratorコンポーネントで外部認証を構成するには、使用する予定の外部アイデンティティ・ストアに対応するようにこの構成ファイルを設定する必要があります。

OPSS構成ファイルを更新するには、次の手順を実行します。

1. マシン上にodi/oraclediディレクトリがない場合は、これを作成します。例:
Windows:

c:\> mkdir %APPDATA%\odi\oracledi

UNIX:

prompt> mkdir -p $HOME/.odi/oracledi/

2. 次のファイルをodi/oraclediディレクトリにコピーします。

- ORACLE_HOME/oracle_common/modules/oracle.jps_12.1.2/domain_config/jse/jps-config.xml

- ORACLE_HOME/oracle_common/modules/oracle.jps_12.1.2/domain_config/jse/system-jazn-data.xml

3. odi/oraclediディレクトリに移動します。

4. jps-config.xmlをjps-config-jse.xmlという名前に変更します。

5. エディタでjps-config-jse.xmlを開きます。

6. アイデンティティ・ストア・プロバイダのサービス・インスタンスを追加し、次のプロパティを含めます。

- サービス・インスタンス名。たとえば、Oracle Internet Directoryの場合は、name="idstore.oid"。

- idstore.typeプロパティ。

- bootstrap.security.principal.mapプロパティ。

- bootstrap.security.principal.keyプロパティ。

サービス・インスタンスの構成例は、例10-1を参照してください。

これらのプロパティをアイデンティティ・ストアに指定するための詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPアイデンティティ・ストア・プロパティに関する項を参照してください。

7. Oracle Internet Directoryのアイデンティティ・ストア・タイプを設定する次の例のように、デフォルトのjpsコンテキストで、serviceInstanceRef name="idstore.xml"値を"idstore.<your-idstore-type>"に変更します。

<serviceInstanceRef ref="idstore.oid"/>

8. デフォルトのjpsコンテキストで、keystoreおよびauditのサービス・インスタンス参照をコメント・アウトします。例:

<jpsContext name="default">
<serviceInstanceRef ref="credstore"/>
<!--  <serviceInstanceRef ref="keystore"/>  -->
<serviceInstanceRef ref="policystore.xml"/>
<!--  <serviceInstanceRef ref="audit"/>  -->

9. その他すべてのプロパティ属性値をアイデンティティ・ストアに適した値に設定します。OPSS構成ファイルの詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の「OPSSを使用するためのJava SEアプリケーションの構成」を参照してください。

例10-1は、構成ファイルのサービス・インスタンス・セクションのOracle Internet Directoryの構成を示しています。

例10-1 サービス・インスタンスの構成例

<!-- OID LDAP Identity Store Service Instance -->
<serviceInstance name="idstore.oid" provider="idstore.ldap.provider">
<property name="subscriber.name" value="dc=us,dc=oracle,dc=com" />
<property name="idstore.type" value="OID" />
<property name="bootstrap.security.principal.map" value="BOOTSTRAP_JPS"/>
<property name="bootstrap.security.principal.key" value="bootstrap_idstore"/>
<property name="username.attr" value="uid"/>
<property name="groupname.attr" value="cn"/>
<property name="ldap.url" value="ldap://hostname:port" />
<extendedProperty>
<name>user.search.bases</name>
<values>
<value>cn=users,dc=us,dc=oracle,dc=com</value>
</values>
</extendedProperty>
<extendedProperty>
<name>group.search.bases</name>
<values>
<value>cn=groups,dc=us,dc=oracle,dc=com</value>
</values>
</extendedProperty>
</serviceInstance>
.
.
.
<serviceInstanceRef ref="idstore.oid"/>

10.7.1.2 LDAPブートストラップ・ユーザーのためのウォレット・ファイルの作成

アイデンティティ・ストア・ブートストラップ・ユーザーの資格証明を格納するためのウォレット・ファイルを作成する必要があります。このウォレット・ファイルは、OPSS構成ファイルから参照され、OPSS構成ファイルに構成されたアイデンティティ・ストアへの接続を確立するためにOracle Data Integratorによって使用されます。

注意:
このウォレット・ファイルは、Oracle Data Integrator Studioのログイン資格証明を格納するためのパスワードで保護されたウォレットとは異なります。

このウォレット・ファイルを作成するには、次の手順を実行します。

1. ORACLE_HOME/odi/sdk/binディレクトリに移動します。

2. odi_credtoolスクリプトを実行します。
次のパラメータを入力するよう促されます。

パラメータ

入力する値

User name

必要な権限を使用してアイデンティティ・ストアに接続するために使用されているブートストラップ・ユーザー・アカウントの識別名(DN)。
たとえば、Microsoft Active Directoryの場合は、このユーザーを次のように指定します。

CN=Administrator,CN=Users,DC=ad,DC=vm,DC=mycompany,DC=com

Password

アイデンティティ・ストアへの接続に使用されるブートストラップ・ユーザー・アカウントのパスワード。

ブートストラップ・ユーザー・アカウントの資格証明を正しく入力すると、次のメッセージが表示されます。

The credentials have been successfully added to the boostrap credential store.

10.7.1.3 マスター・リポジトリ作成時の外部認証の設定

マスター・リポジトリを作成し、外部認証を使用するように設定するには:

1. ORACLE_HOME/odi/studioディレクトリに移動します。

2. 次のコマンドを実行してOracle Data Integrator Studioを起動します。
Windows:

odi.exe

UNIX:

./odi.sh

3. Oracle Data Integrator Studioで、「ファイル」→「新規」を選択し、「マスター・リポジトリ作成ウィザード」を選択して「OK」をクリックします。

4. マスター・リポジトリ作成ウィザードのリポジトリ選択画面で、マスター・リポジトリを格納するデータベースへの接続パラメータを入力し、「テスト接続」をクリックして、パラメータが正しいことを確認します。このデータベースの構成の詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。
テスト接続が成功した場合は、「OK」をクリックします。

5. マスター・リポジトリ作成ウィザードの認証画面で、「外部認証の使用」を選択します。

マスター・リポジトリでのスーパーバイザ権限を持つプリンシパルの選択方法については、「アイデンティティ・ストアに定義されたプリンシパルのOracle Data Integratorロールへのマッピング」を参照してください。

外部認証を使用するための既存のマスター・リポジトリの更新方法については、「既存のマスター・リポジトリから外部認証モードへの切替え」を参照してください。

10.7.2 既存のマスター・リポジトリから外部認証モードへの切替え

既存のマスター・リポジトリで認証モードを内部から外部に切り替えるには、次の手順を実行します。

1. ORACLE_HOME/odi/studioディレクトリに移動します。

2. 次のコマンドを実行してOracle Data Integrator Studioを起動します。
Windows:

odi.exe

UNIX:

./odi.sh

3. Oracle Data Integrator Studioで、「ODI」→「認証モードの切替え」を選択します。
図10-4に示す「認証モードの切替え」ウィザードの「ログイン」画面が表示されます。

図10-4 「認証モードの切替え」ダイアログ・ボックスの「ログイン」画面

4. マスター・リポジトリのログイン名、JDBC接続パラメータ、マスター・リポジトリ・データベース・ユーザーのユーザー名およびパスワードを入力し、「次へ」をクリックします。
図10-5に示すような「認証モードの切替え」ウィザードの「資格証明」画面が表示されます。

図10-5 「認証モードの切替え」ウィザードの「資格証明」画面

5. 検索フィールドに隣接する緑色のプラス記号で表される「追加」ボタンをクリックして、図10-6が示す「エンタープライズ・ロールおよびユーザー取得」ダイアログ・ボックスを表示します。

図10-6 「エンタープライズ・ロールおよびユーザー取得」ダイアログ・ボックス

「エンタープライズ・ロールおよびユーザー取得」ダイアログ・ボックスは、次のどちらかの目的に使用します。

- フィルタ式を入力して、フィルタに一致するロールおよびユーザーをアイデンティティ・ストアに表示します。

- アイデンティティ・ストアを検索して、特定のロールまたはユーザー名を見つけます。

エンタープライズ・ロールおよびエンタープライズ・ユーザーの各ノードを展開して、アイデンティティ・ストアで利用可能なエンタープライズ・ロールおよびユーザーを参照できます。

6. SUPERVISOR_ROLEロールに割り当てるユーザーまたはロールを選択して、「終了」をクリックします。

外部認証モードへの切替えに成功すると、図10-7のようなダイアログ・ボックスが表示されます。

図10-7 外部認証モードへの切替えに成功した場合のメッセージ・ボックス

10.7.3 外部認証への切替え後のユーザーの再アクティブ化

定義済のOracle Data Integratorユーザーの既存のセットがある場合は、この項の説明に従って外部認証に切り替えた後で再有効化できます。ユーザーを再有効化するには、最初に、内部Oracle Data Integratorリポジトリに格納されたパスワードではなく外部アイデンティティ・ストアに指定されたパスワードを使用して、スーパーバイザ権限を持つユーザー(たとえば、SUPERVISOR)としてStudioに再接続します。次の手順を実行します。

1. セキュリティ・ナビゲータで、「ユーザー」ナビゲーション・ツリーを展開します。

2. 表示されたユーザー・リストから、再有効化するユーザーを選択します。

3. 右クリックし、「開く」を選択します。図10-8に示すようなユーザー・エディタが表示されます。

図10-8 「USER管理者を開く」ダイアログ・ボックス

「名前」フィールドに、手順2で選択したユーザーが表示されます。

4. 「GUIDの取得」をクリックします。ユーザー名がアイデンティティ・ストアで一致した場合は、この外部ユーザーのGUIDが「外部GUID」フィールドに表示されます。

5. 「ファイル」メイン・メニューから、「保存」をクリックして接続を切断します。

6. 外部アイデンティティ・ストアのパスワードを使用して、このユーザー(たとえば、図10-8に表示されているSUPERVISOR)として再接続します。

これで、外部認証を使用して、Oracle Data Integrator Studioに接続できるようになります。

次の点に注意してください。

- LDAPサーバー問題のトラブルシューティングの場合は、いずれかのLDAPクライアントを使用してLDAPツリーを参照すると有用です。LDAPクライアントは、次のURLからダウンロードできます。
http://www.ldapbrowser.com/

- Microsoft Active Directory以外のLDAPディレクトリの場合、プロパティuser.filter.object.classesが、ユーザーのオブジェクト・クラスに対して正しく設定されているか確認してください。デフォルトでは、特に指定のないかぎりUSERに設定されています。

- 使用環境にOracle Data IntegratorコンソールおよびJava EEエージェントがインストールされている場合にOracle Data Integrator Studioを外部認証に切り替えると、Oracle Data Integratorコンソールにログインできない場合およびJava EEエージェントが機能しない場合があります。このような問題が発生する場合は、同じ外部アイデンティティ・ストアを使用して、Oracle Data IntegratorコンソールおよびJava EEエージェントを外部認証対応に構成する必要があります。この手順については、My Oracle SupportのNote 1510434.1に記載されており、次のURLでアクセスできます。
https://support.oracle.com/epmos/faces/DocumentDisplay?id=1510434.1

10.7.4 外部認証用のスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントの構成

外部認証用にスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントを構成するには、次の手順を実行します。

1. DOMAIN_HOME/config/fmwconfigディレクトリに次のファイルがない場合は、これをコピーします。DOMAIN_HOMEは、Oracle Data Integratorドメインのルート・ディレクトリを表します。

- ORACLE_HOME/oracle_common/modules/oracle.jps_12.1.2/domain_config/jse/jps-config.xml

- ORACLE_HOME/oracle_common/modules/oracle.jps_12.1.2/domain_config/jse/system-jazn-data.xml

注意:
Oracle Data Integratorドメインの作成の詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

2. DOMAIN_HOME/config/fmwconfigディレクトリに移動します。

3. jps-config.xmlをjps-config-jse.xmlという名前に変更します。

4. エディタでjps-config-jse.xmlを開きます。

5. アイデンティティ・ストア・プロバイダのサービス・インスタンスを追加し、次のプロパティを含めます。

- サービス・インスタンス名。たとえば、Oracle Internet Directoryの場合は、name="idstore.oid"。

- idstore.typeプロパティ。

- bootstrap.security.principal.mapプロパティ。

- bootstrap.security.principal.keyプロパティ。

サービス・インスタンスの構成例は、例10-1を参照してください。

これらのプロパティをアイデンティティ・ストアに指定するための詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPアイデンティティ・ストア・プロパティに関する項を参照してください。

6. Oracle Internet Directoryのアイデンティティ・ストア・タイプを設定する次の例のように、デフォルトのjpsコンテキストで、serviceInstanceRef name="idstore.xml"値を"idstore.<your-idstore-type>"に変更します。

<serviceInstanceRef ref="idstore.oid"/>

7. デフォルトのjpsコンテキスト・エレメントで、keystoreおよびauditのサービス・インスタンス参照をコメント・アウトします。例:

<jpsContext name="default">
<serviceInstanceRef ref="credstore"/>
<!--  <serviceInstanceRef ref="keystore"/>  -->
<serviceInstanceRef ref="policystore.xml"/>
<!--  <serviceInstanceRef ref="audit"/>  -->

8. 変更をjps-config-jse.xmlに保存して、エディタを終了します。

9. DOMAIN_HOME/binディレクトリに移動します。

10. odi_credtoolスクリプトを実行します。
次のパラメータを入力するよう促されます。

パラメータ

入力する値

User name

これは、管理者権限を使用してアイデンティティ・ストアに接続するために使用されているブートストラップ・ユーザー・アカウントの識別名(DN)です。
たとえば、Microsoft Active Directoryの場合は、このユーザーを次のように指定します。

CN=Administrator,CN=Users,DC=ad,DC=vm,DC=mycompany,DC=com

Password

アイデンティティ・ストアへの接続に使用されるブートストラップ・ユーザー・アカウントのパスワード。

ブートストラップ・ユーザー・アカウントの資格証明を正しく入力すると、次のメッセージが表示されます。

The credentials have been successfully added to the boostrap credential store.

10.7.5 アイデンティティ・ストアに定義されたプリンシパルのOracle Data Integratorへのマッピング

Oracle Data Integratorのエンタープライズ・ロール統合機能では、Oracle Platform Security Services (OPSS)の認可モデルを利用するため、エンタープライズ・ロールをOracle Data Integratorロールにマップできます。マップされたエンタープライズ・ロールに属するエンタープライズ・ユーザーは、マップされたOracle Data Integratorロールに付与された権限を継承することによりOracle Data Integratorにアクセスできます。エンタープライズ・ロール統合を利用すると、Oracle Data Integratorにユーザーを個別に登録してアクセスを付与したり、ユーザーごとに権限を管理する必要がなくなるため、ユーザーおよび権限の管理が簡素化されます。

次の各項では、エンタープライズ・ロール統合の仕組みの説明およびこの機能を使用して、オブジェクト、インスタンスおよびプロファイルに割り当てられた権限を管理する方法を説明します。

- エンタープライズ・ロール統合の仕組み

- Oracle Data Integratorロールの定義および管理

10.7.5.1 エンタープライズ・ロール統合の仕組み

外部認証が有効の場合、ユーザーは、Oracle Internet Directory、Microsoft Active Directoryなどの外部アイデンティティ・ストアで管理されます。

エンタープライズ・ロール統合を使用すると、次のようになります。

- アイデンティティ・ストア内でOracle Data Integratorロールにマップ可能なすべてのエンタープライズ・プリンシパルは、そのロールに付与された権限を得る資格があります。たとえば、エンタープライズ・ロールDESIGNERSが、Oracle Data IntegratorロールDESIGNERS_ROLEにマップされた場合、Oracle Data Integratorへのアクセスが認証されると、アイデンティティ・ストアでDESIGNERSのメンバーであるエンタープライズ・ユーザーには、DESIGNERS_ROLEに付与されたすべての権限が与えられます。

- 複数のエンタープライズ・ユーザーおよびロールを単一のOracle Data Integratorロールにマップできます。また、単一のエンタープライズ・ユーザーまたはロールを複数のOracle Data Integratorロールにマップすることも可能です。(Oracle Data Integratorロールを別のOracle Data Integratorロールにマップすることはできません。)

- ユーザーがOracle Data Integratorへのアクセスを認証されると、ユーザーが直接的またはエンタープライズ・ロールを介して間接的にマップされたすべてのOracle Data Integratorロールの和集合によって、そのユーザーに付与される権限が決まります。
また、外部ユーザーをOracle Data Integratorに直接登録する場合、そのユーザーに与えられる全権限セットは、以前のリリースと同様に次の和集合から構成されます。

- ユーザーがマップされるOracle Data Integratorロール

- そのユーザーに直接付与されたすべての権限

- Oracle Data Integratorへのアクセスを付与するために、Oracle Data Integrator内でユーザーの作成および登録を行う必要はありません。

- 「ユーザー」で説明したように、個々のユーザーに割り当てられた既存の権限およびプロファイルはすべてそのまま有効です。このため、Oracle Data Integratorの以前のリリースとの後方互換性があります。

10.7.5.2 Oracle Data Integratorロールの定義および管理

マスター・リポジトリを作成し、外部認証を使用するように構成すると、次のことが生じます。

1. Oracle Data IntegratorロールSUPERVISOR_ROLEが自動的に作成されます。これは、Oracle Data Integratorのメイン管理者ロールです。

2. このSUPERVISOR_ROLEがマップされるアイデンティティ・ストアから1つ以上のエンタープライズ・ロールまたはエンタープライズ・ユーザーを選択するよう促されます。Oracle Data Integratorでは、「OPSS構成ファイルの設定」の説明のとおり、jps-config-jse.xmlファイルに構成されているアイデンティティ・ストアに存在するすべての利用可能なエンタープライズ・ロールまたはエンタープライズ・ユーザーを取得できることに注意してください。

Oracle Data Integratorへのアクセスが認証されSUPERVISOR_ROLEロールにマップされた後は、Studioから利用可能なロール・エディタを使用して別のエンタープライズ・プリンシパルをこのロールにマップできます。結果として、このロールにマップされたどのユーザーも、このロール・エディタを使用して別のOracle Data Integratorロールの作成、これらのロールへの権限およびプロファイルの割当て、アイデンティティ・ストアからその他のプリンシパル・マッピングの作成を行うことができます。

次の各項では、エンタープライズ・プリンシパルをSUPERVISOR_ROLEロールにマップする方法およびロール・エディタを使用してOracle Data Integratorロールの作成、更新および削除を行う方法について説明します。

スーパーバイザ・ロールのためのエンタープライズ・ロールの構成

「マスター・リポジトリ作成時の外部認証の設定」の説明に従って、マスター・リポジトリを作成する際に「外部認証の使用」を選択した場合は、エンタープライズ・ロールを構成する必要があります。最初に構成するエンタープライズ・ロールは、Oracle Data Integrator SUPERVISOR_ROLEにマップされる、アイデンティティ・ストアのプリンシパル(1つ以上)です。

マスター・リポジトリで、SUPERVISOR_ROLEのためのエンタープライズ・ロールを構成するには、次のようにします。

1. 「マスター・リポジトリ作成時の外部認証の設定」の説明に従って、マスター・リポジトリ作成ウィザードを起動します。

2. マスター・リポジトリ作成ウィザード: ステップ2/3ページで、図10-9に示すように、「追加」ボタンをクリックして外部アイデンティティ・ストアから利用可能なエンタープライズ・ロールおよびユーザーを取得します。

図10-9 マスター・リポジトリ作成ウィザードの「認証」画面

「追加」ボタンをクリックすると、図10-10に示すような「エンタープライズ・ロールおよびユーザー取得」ダイアログ・ボックスが表示されるので、次のどちらかが可能です。

- フィルタ式を入力して、フィルタに一致するロールおよびユーザーをアイデンティティ・ストアに表示します。

- アイデンティティ・ストアを検索して、特定のロールまたはユーザー名を見つけます。

エンタープライズ・ロールおよびエンタープライズ・ユーザーの各ノードを展開して、アイデンティティ・ストアで定義された個々のロールおよびユーザーを表示できます。

図10-10 「エンタープライズ・ロールおよびユーザー取得」ダイアログ・ボックス

3. 「エンタープライズ・ロールおよびユーザー取得」ダイアログ・ボックスからSUPERVISOR_ROLEロールに割り当てるエンタープライズ・ユーザーまたはロールを選択して、「OK」をクリックします。

4. 「マスター・リポジトリの作成」の説明に従って、マスター・リポジトリの作成を終了します。

10.7.5.3 ロール・エディタの使用

次の各項では、ロール・エディタを使用してOracle Data Integratorでエンタープライズ・ロール統合を管理する方法について説明します。

- ロール・エディタの起動

- Oracle Data Integratorでのロールの作成

- エンタープライズ・プリンシパルのOracle Data Integratorロールへのマップ

- Oracle Data Integratorロールへの権限またはプロファイルの割当て

- Oracle Data Integratorロールの削除

10.7.5.3.1 ロール・エディタの起動

ロール・エディタを使用して、Oracle Data Integratorロールの作成、更新および削除を行うことができます。

ロール・エディタを起動するには:

1. Oracle Data Integrator Studioで、必要に応じて「リポジトリへの接続」をクリックし、使用するリポジトリへの接続に必要な資格証明を入力します。

2. Studioで、「セキュリティ・ナビゲータ」を選択し、「ロール」ナビゲーション・ツリーを選択します。

3. 次のどちらかの方法でロール・エディタを起動します。

- 「ロール」ナビゲーション・ツリーのツールバーで、「新規ロール」をクリックします。この操作により、新しいOracle Data Integratorロールを作成できます。

- 「ロール」ナビゲーション・ツリーに表示されたロール・リストから、ロール名を右クリックして「開く」を選択します。この操作により、既存のロールを更新できます。

4. 右クリックし、「開く」を選択します。

図10-11に示すようなロール・エディタが表示されます。

図10-11 ロール・エディタ

10.7.5.3.2 Oracle Data Integratorでのロールの作成

Oracle Data Integratorロールを作成するには:

1. 必要に応じて、Studioでロール・エディタを起動します。

2. 「セキュリティ・ナビゲータ」を選択し、「ロール」ナビゲーション・ツリーを選択します。

3. 「ロール」ナビゲーション・ツリーのツールバーで、「新規ロール」をクリックします。

4. 「名前」フィールドに、作成するOracle Data Integratorロールの名前を入力します。

5. 「ファイル」メイン・メニューから「保存」を選択します。

新規ロール名が「ロール」ナビゲーション・ツリーに表示されます。

10.7.5.3.3 エンタープライズ・プリンシパルのOracle Data Integratorロールへのマップ

エンタープライズ・プリンシパルをOracle Data Integratorロールへマップするには:

1. 変更するOracle Integratorロールがロール・エディタで開かれていない場合は、「ロール」ナビゲーション・ツリーでロール名を右クリックして「開く」を選択します。

2. ロール・エディタの「ロールにプリンシパルを追加」パネルで、「追加」ボタン(プラス記号)をクリックして、「エンタープライズ・ロールおよびユーザー取得」ダイアログ・ボックスを表示します。
このダイアログから、次のいずれかを行うことができます。

- フィルタ式を入力して、フィルタに一致するロールおよびユーザーをアイデンティティ・ストアに表示します。

- アイデンティティ・ストアを検索して、特定のロールまたはユーザー名を見つけます。

3. 次の一方または両方を行います:

- 1つ以上のエンタープライズ・ロールを選択してOracle Data Integratorロールにマップするには、エンタープライズ・ロール・ノードを展開して該当するロールを選択します。

- 1つ以上のエンタープライズ・ユーザーを選択してOracle Data Integratorロールにマップするには、エンタープライズ・ユーザー・ノードを展開して該当するユーザーを選択します。

4. 「ファイル」メイン・メニューから「保存」を選択します。

10.7.5.3.4 Oracle Data Integratorロールへの権限またはプロファイルの割当て

Studioでは、次の2つの方法でOracle Data Integratorロールへ権限またはプロファイルを割り当てられます。

- ロール・エディタの使用

- 権限、プロファイルおよびインスタンス・オブジェクトをクリックして、「ロール」ナビゲーション・ツリーのロール名上にドラッグする

ロール・エディタを使用する場合:

1. 権限を割り当てるOracle Data Integratorロールがロール・エディタで開かれていない場合は、「ロール」ナビゲーション・ツリーでロール名を右クリックして「開く」を選択します。

2. ロールにスーパーバイザ権限を割り当てる場合は、ロール・エディタの「スーパーバイザ・アクセス権限」セクションから「スーパーバイザ」を選択します。

3. ロール・エディタの「ロール・プロファイル」パネルで、ロールに割り当てたいプロファイルを選択します。

注意:
ロールにスーパーバイザ権限を割り当てた場合は、この手順は必要ありません。

4. 「ファイル」メイン・メニューから「保存」を選択します。

クリック・アンド・ドラッグの場合:

次のアイテムに関する権限は、クリックして「ロール」ナビゲーション・ツリーのロール名上にドラッグすることにより、ロールに追加できます。

- 「オブジェクト」ナビゲーション・ツリーにリストされている、オブジェクト・ノードまたはオブジェクト・ノード内のエントリ。

- 「プロファイル」ナビゲーション・ツリーにリストされている、プロファイル・ノードまたはプロファイル・ノードを持つエントリ。

- デザイナ・ナビゲータ、オペレータ・ナビゲータまたはトポロジ・ナビゲータのナビゲーション・ツリーにリストされているオブジェクト・インスタンス。オブジェクト・インスタンス権限をOracle Data Integratorユーザーに付与する方法と同様に、インスタンスを選択して目的のロール名までドラッグします(「オブジェクト・インスタンス別認可の付与」を参照)。

Oracle Data Integratorロールの権限を更新した後で、「ファイル」メイン・メニューから「保存」を選択します。

10.7.5.3.5 Oracle Data Integratorロールの削除

Oracle Data Integratorロールを削除するには:

1. セキュリティ・ナビゲータの「ロール」ナビゲーション・ツリーで、削除するロールを選択します。

2. 右クリックして「削除」を選択します。

3. 選択内容の確認を要求されたら、「はい」をクリックします。

10.8 パスワード・ポリシーの実施

パスワード・ポリシーは、内部認証の使用時にユーザー・パスワードに適用するルールのセットで構成されています。この一連のルールは、ユーザーがパスワードを定義したり、変更した場合に適用されます。

パスワード・ポリシーを定義するには:

1. セキュリティ・ナビゲータのツールバー・メニューから「パスワード・ポリシー」を選択します。
「パスワード・ポリシー」ダイアログが表示されます。このダイアログには、ルールのリストが表示されます。

2. パスワードを自動的に期限切れにする場合は、「パスワード有効日数」を選択し、パスワードの変更が必要になるまでの日数を設定します。

3. 「ポリシーの追加」をクリックします。「ポリシー定義」ダイアログが表示されます。ポリシーは、パスワードをチェックする一連の条件です。

4. この新規ポリシーに「名前」と「説明」を設定します。

5. 「ルール」セクションで、パスワードのテキストまたは長さに対する条件をいくつか追加します。たとえば、パスワードの最小文字数を定義できます。

6. 「一致する条件」リストで、パスワードが少なくとも1つの条件に一致する必要があるのか、またはすべての条件に一致する必要があるのかを選択します。

7. 「OK」をクリックします。

8. 必要な数のポリシーを追加し、アクティブ化するルールのポリシーに対して「アクティブ」を選択します。すべてのポリシーを満たすパスワードのみが、現在のポリシーで有効とみなされます。

9. 「OK」をクリックし、パスワード・ポリシーを更新します。

10.9 安全な転送を使用するためのスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントの構成

Hyper-Text Transfer Protocol Secure (HTTPS)は、Hyper Text Transfer Protocol (HTTP)の安全なバージョンであり、さらにレベルの高いセキュリティを実現するために使用されます。この項では、次のトピックにより、Oracle Data IntegratorでHypertext Transfer Protocol Secure (HTTPS)サポートを設定する方法について説明します。

- SSL証明書の作成

- スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントのためのSSLの構成

- SSL対応エージェントと接続するためのODI Studioの構成

- SSL対応エージェントと通信するためのOracle Data Integratorクライアント・ツールの構成

- パスワードのエンコード

- SSL対応のスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントに対する弱い暗号スイートの無効化

10.9.1 SSL証明書の作成

SSL証明書は、インターネット経由で送信されるデータの暗号化に役立ちます。

SSL証明書を作成するには、次の手順を実行します。

1. 次のコマンドを使用して、キーストアからデフォルトのSSL証明書demoidentityを削除します。

keytool –delete –alias demoidentity -keystore <domain>/security/DemoIdentity.jks
Enter the keyStore password, DemoIdentityKeyStorePassPhrase

注意:
keyStore、keyおよびtrustStoreのパスワードはそれぞれ、DemoIdentityKeyStorePassPhrase、DemoIdentityPassPhraseおよびDemoTrustKeyStorePassPhraseです。ただし、keyStoreとkeyのパスワードはDemoIdentityKeyStorePassPhraseにする必要があります。

2. 別名をdemoidentity (デフォルト証明書の場合)またはagent (ユーザー定義証明書の場合)で置き換え、証明書を生成します。

Default Certificate <aliasName>: demoidentity
User defined Certificate <aliasName>: agent

3. Keytoolユーティリティを使用して、エージェントのキーを生成します。エージェントは完全修飾ホスト名を使用して、キーストアからキーをフェッチします。

keytool -genkey -alias <aliasName> -keyalg RSA -keystore <domain>/security/DemoIdentity.jks
Enter keystore password:  DemoIdentityKeyStorePassPhrase
What is your first and last name?
[Unknown]:agenthostname.us.oracle.com
What is the name of your organizational unit?
[Unknown]:  ODI
What is the name of your organization?
[Unknown]:  Oracle
What is the name of your City or Locality?
[Unknown]:  San Jose
What is the name of your State or Province?
[Unknown]:  CA
What is the two-letter country code for this unit?
[Unknown]:  US
Is CN=agent.us.oracle.com, OU=ODI, O=Oracle, L=San Jose, ST=CA, C=US correct?
[no]:  yes
Enter key password for <agent>
(RETURN if same as keystore password) : <return>

キーは別名<aliasName>で作成されます。

4. 次のkeytoolコマンド構文を使用して、キーをエクスポートします。

keytool -export -alias <aliasName> -keystore <domain>/security/DemoIdentity.jks
-rfc -file public.cert
Enter keystore password:  DemoIdentityKeyStorePassPhrase
Certificate stored in file <public.cert>

5. 次のkeytoolコマンド構文を使用して、キーをクライアント・トラストストアにインポートします。

keytool -import -alias <aliasName> -file public.cert -storetype JKS -keystore
<MW_HOME>/Oracle_Home/wlserver/server/lib/DemoTrust.jks
Enter keystore password: DemoTrustKeyStorePassPhrase

...
…
Trust this certificate? [no]:  yes

自己署名証明書が作成され、クライアント・トラストストアに追加されます。

10.9.2 スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントのためのSSLの構成

スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントのためにSSLを構成するには、HTTPSプロトコルを使用してエージェントを作成する必要があります。

HTTPSプロトコルを使用してスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントを作成するには、次の手順を実行します。

1. Oracle Data Integratorドメインを作成し、エージェント・テンプレートを構成します。

- ODIスタンドアロン・インストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

- ODI Enterpriseインストール・タイプを使用している場合、ODIドメインを作成し、Oracle Data Integrator - スタンドアロン・コロケート・エージェント・テンプレートを構成してODIインスタンス構成を作成します。

詳細は、『Oracle Data Integratorのインストールと構成』を参照してください。

2. HTTPSプロトコルを使用して、マスター・リポジトリにエージェントを作成します。エージェントがすでに存在する場合は、マスター・リポジトリ内のそのエージェントのプロトコルをhttpsに変更します。詳細は、「物理エージェントの作成」を参照してください。

3. 次の場所にあるinstance.propertiesファイルを編集し、PROTOCOLをhttpsに設定します。

<domain>/config/fmwconfig/components/ODI/<agentName>

次に示すように、暗号化された形式でSSLパスワード・パラメータを設定します。

ODI_KEYSTORE_ENCODED_PASS=<Encrypted password>
ODI_KEY_ENCODED_PASS=<Encrypted password>
ODI_TRUST_STORE_ENCODED_PASS=<Encrypted password>

パスワードの暗号化方法の詳細は、「パスワードのエンコード」を参照してください。

4. 次に示すように、instance.shファイル内に、他のキーストアの場所およびトラストストアのSSLパラメータの場所とタイプを構成します。

ODI_INSTANCE_JAVA_OPTIONS="
-Djavax.net.ssl.keyStore=<domain>/security/DemoIdentity.jks
-Djavax.net.ssl.keyStoreType=JKS -Djavax.net.ssl.trustStore= <MW_HOME>/Oracle_Home/wlserver/server/lib/DemoTrust.jks
-Djavax.net.ssl.trustStoreType=JKS $ODI_ADDITIONAL_JAVA_OPTIONS"

5. 次のコマンドを入力して、エージェントを起動します。

<domain>/bin/agent.sh -INSTANCE=agentName

10.9.3 SSL対応エージェントと接続するためのODI Studioの構成

SSLパラメータの値はODI Studioに移入されます。これは、Studio内部エージェントがSSLサーバーに接続するときにODI Studioによって使用されるデフォルトで唯一の資格証明セットです。

Oracle Data Integrator StudioからSSL対応エージェントに接続するには、次の手順を実行します。

1. 「ツール」→「プリファレンス」→「資格証明」に移動します。

2. 「クライアントの信頼する証明書キーストア」フィールドおよびクライアントの信頼するキーストアのパスワード・フィールドを編集します。

別のtrustStoreを指すようにするには、前述のフィールドを編集します。詳細は、『Oracle Data Integratorでの統合プロジェクトの開発』のHTTPアナライザでのSSLの使用に関する項を参照してください。

10.9.4 SSL対応エージェントと通信するためのOracle Data Integratorクライアント・ツールの構成

ODIクライアント・ツールはマスター・リポジトリにアクセスできないため、instance.propertiesファイルに格納されているSSLパスワードを復号化できません。SSL対応エージェントに接続するOracle Data Integratorクライアント・ツールを実行するには、keyStorePasswordシステム・プロパティのクリアテキスト・パスワードを設定します。keyStorePasswordシステム・プロパティを、次の場所にあるODI_INSTANCE_JAVA_OPTIONS変数に追加する必要があります。

<domain>/config/fmwconfig/components/ODI/OracleDIAgent1/bin/instance.sh

次のコマンドを使用して、パラメータを追加します。

ODI_INSTANCE_JAVA_OPTIONS="-Djavax.net.ssl.keyStorePassword=<clear_text-password>
-Djavax.net.ssl.keyStore=<domain>/security/DemoIdentity.jks   -Djavax.net.ssl.keyStoreType=JKS
-Djavax.net.ssl.trustStore=<Domain>/oracle/work/middleware/wlserver/server/lib/DemoTrust.jks
-Djavax.net.ssl.trustStoreType=JKS $ODI_ADDITIONAL_JAVA_OPTIONS"

keyStorePasswordシステム・プロパティを必要とするODIクライアント・ツールの例を次に示します。

./agentstop.sh -NAME= OracleDIAgent1
./startcmd.sh -INSTANCE=OracleDIAgent1 OdiPingAgent -AGENT_NAME=OracleDIAgent1
./startcmd.sh -INSTANCE=OracleDIAgent1 OdiKillAgent -NAME=OracleDIAgent1 -IMMEDIATE=YES -MAX_WAIT=0
./startscen.sh -INSTANCE=OracleDIAgent1 OdiStartScen -SCEN_NAME=SAM -SCEN_VERSION=001 -CONTEXT=GLOBAL -SYNC_MODE=1
./startscen.sh -INSTANCE=OracleDIAgent1 SAM 001 GLOBAL -AGENT_URL=https://<hostname>:<port>/oraclediagent

ODIクライアント・ツールの詳細は、Oracle Data Integratorツール・リファレンスを参照してください。

10.9.5 パスワードのエンコード

クリアテキスト・パスワードをエンコードするには、次の手順を実行します。

1. agentNameを使用して次のスクリプトを実行します。

<domain>/bin/encode.sh -INSTANCE=<agentName>

2. 次に示すプロンプトで、パスワードを入力します。

Enter password to encode: <password>

暗号化されたパスワードが表示されます。

10.9.6 SSL対応のスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントに対する弱い暗号スイートの無効化

この項では、SSL対応のスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントに対して弱い暗号スイートを無効にする方法について説明します。環境内の暗号スイートを表示する場合、スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントを起動すると、使用可能なスイートのリストが表示されます。

弱い暗号スイートを無効にするには、次の手順を実行します。

1. instance.propertiesファイルから除外する必要のある暗号スイートを設定します。例:

ODI_EXCLUDED_CIPHERS=TLS_KRB5_EXPORT_WITH_DES_CBC_40_MD5,TLS_KRB5_EXPORT_WITH_DES_CBC_40_SHA

2. 次のコマンドを使用して、SSLモードでエージェントを起動します。

./agent.sh-NAME=OracleDIAgent -PORT=20910

使用可能な暗号スイートのリストが表示され、SSL対応のスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントで使用可能な暗号スイートのリストも表示されます。

10.10 Webプロキシ・サーバーによるOracle Data Integratorの構成

この項では、ネットワーク設定でWebプロキシが構成されている場合に外部http接続を使用する方法について説明します。

Oracle Data Integrator StudioからWebプロキシを設定してOracle Data Integratorを構成するには、「ツール」→「プリファレンス」に移動し、Webブラウザおよびプロキシ・ページでプロキシを設定します。

Oracle Data Integratorスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントがインストールされている場合は、コマンド行からWebプロキシ設定を設定できます。Java EEエージェントの場合、Webプロキシ設定はWebLogic ServerのsetDomainEnv.shファイル内に設定する必要があります。java.netパッケージの様々なクラスのメカニズムおよび動作を変更するための標準のシステム・プロパティの詳細は、ネットワーク・プロパティを参照してください。

注意:
標準のJavaプロキシ・パスワード・プロパティhttp.proxyPasswordはクリアテキスト・パスワードしか受け入れないため、Oracle Data Integratorでは、必要に応じてクリアテキスト・パスワードのかわりに暗号化されたプロキシ・サーバー・パスワードを設定できるように追加プロパティoracle.odi.http.encoded.proxyPasswordが導入されました。
暗号化されたプロキシ・サーバー・パスワードは、次の方法で設定できます。

- スタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェント: instance.shファイル内に、Javaコマンドの-Dオプションを使用してoracle.odi.http.encoded.proxyPasswordプロパティをODI_INSTANCE_JAVA_OPTIONS変数に追加します(次の場所にあります)。

<DOMAIN_HOME>/config/fmwconfig/components/ODI/<INSTANCE_NAME>/bin

- Java EEエージェント: WebLogic ServerのsetDomainEnv.shファイルを編集します。setDomainEnv.shファイルは次の場所にあります。

<DOMAIN_HOME>/bin

10.11 Oracle Access Manager 11gを使用したOracle Data IntegratorコンソールおよびEnterprise Managerのシングル・サインオン(SSO)の構成

このセクションでは、Oracle Access Manager (OAM) 11gを使用して、Oracle Data IntegratorコンソールおよびEnterprise Managerのシングル・サインオンをオプションで構成する方法について説明します。

Oracle Data IntegratorコンソールおよびEnterprise Managerのシングル・サインオンを構成するには:

1. ブラウザを使用して、OAMコンソールにログインします。

http://host:port/oamconsole

2. 「ポリシー構成」→「アプリケーション・ドメイン」に移動します。
「ポリシー・マネージャ」ペインが表示されます。

3. WebGateエージェントの登録時の名前を使用して作成したアプリケーション・ドメインを探します。

4. 「リソース」ノードを展開して、「作成」をクリックします。
リソース・ページが表示されます。

5. セキュリティ保護が必要なリソースを追加します。リソースごとに次の手順を行います。

1. 「リソース・タイプ」としてhttpを選択します。

2. WebGateエージェントの登録時に作成したホスト識別子を選択します。

3. 「リソースURL」を次のように入力します。

リソースURL

ODIコンポーネント

/odiconsole*

ODIコンソール

/odiconsole/.../*

ODIコンソール

/em*

Enterprise Manager

/em/.../*

Enterprise Manager

4. リソースの「説明」を入力し、「適用」をクリックします。

6. 「認証ポリシー」→保護されているリソース・ポリシーに移動し、新しく作成したリソースを追加します。

7. 「認可ポリシー」→保護されているリソース・ポリシーで同じ作業を行います。

8. WebTierで、(WT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/の)mod_wl_ohs.confファイルを変更し、ODIコンソールとEnterprise Managerを追加するために、新しい2つのLocationエントリを追加して、WebLogicHostにWebCenter Portal管理サーバーの実際のホストIDを使用します。

<Location /odiconsole*>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 7001
</Location>
<Location /em*>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 7001
</Location>

9. 変更を有効にするために、Oracle HTTP Serverを再起動します。
これで、次のリンクを使用してODIコンソールおよびEnterprise Managerにアクセスできるようになりました。

http://host:OHS port/odiconsole

http://host:OHS port/em

OAMのSSOログイン・フォームのプロンプトが表示されます。

OAM 11gをインストールし、ODI用に構成する方法の詳細は、『Oracle Data Integratorのインストールと構成』の「ODIとOracle Access Manager 11gの統合」を参照してください。

10.12 Oracle Data Integratorのセキュリティのベスト・プラクティス

表10-3は、Oracle Data Integrator環境を保護するためのベスト・プラクティスのリストです。

表10-3 Oracle Data Integrator環境におけるセキュリティのベスト・プラクティス

セキュリティ・アクション

説明

Oracle Data Integrator Studioの保護

Oracle Data Integrator Studioに対して最適なセキュリティを実施するには、次のように構成します。

- パスワードで保護されたウォレット・ファイル: Oracle Data Integrator Studioのログイン資格証明を格納するためにパスワードで保護されたウォレットを作成します。詳細は、「パスワードで保護されたウォレットを使用したログイン資格証明の格納」を参照してください。

- 外部認証: デフォルトの内部認証モードではなく外部認証モードを使用します。マスター・リポジトリの作成時に、オプションの1つとして外部認証モードを選択できます。詳細は、「外部認証の構成」を参照してください。

- 外部パスワード記憶域: データ・サーバー接続パスワードに関して、Oracle Data Integratorでは、内部パスワード記憶域と外部パスワード記憶域の2つのオプションを用意しています。オラクル社では、安全な本番環境を実現するために外部パスワード記憶域をお薦めします。マスター・リポジトリを作成するときに外部パスワード記憶域オプションを選択できます。詳細は、「外部パスワード記憶域の設定」を参照してください。

安全な転送を使用するためのスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントの構成

安全な転送を使用するためにスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントを構成する方法の詳細は、「安全な転送を使用するためのスタンドアロン・エージェントまたはスタンドアロン・コロケート・エージェントの構成」を参照してください。

安全な転送を使用するためのOracle Data Integratorコンソールの構成

オラクル社では、安全な転送を使用してOracle Data Integratorコンソールにアクセスすることをお薦めします。たとえば、Oracle Data IntegratorコンソールがデフォルトのSSLリスニング・ポートであるポート7002を使用するように構成できます。このように構成することで、次のURLを使用してOracle Data Integratorコンソールにアクセスできます。

https://<host>:7002/odiconsole

WebLogic Server管理コンソールを使用すると、Oracle Data Integratorコンソールが使用する転送を保護できます。詳細は、『Oracle WebLogic Serverセキュリティの管理』の「SSLの構成」を参照してください。

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2015, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。