Oracle® Fusion Middleware

Enterprise Data Qualityと外部システムの統合

12c (12.2.1.2.0)

E88272-01(原本部品番号:E78151-02)

2016年10月

外部のアプリケーションおよび機能とのOracle Enterprise Data Qualityの統合方法を説明します。

Oracle Fusion Middleware Enterprise Data Qualityと外部システムの統合, 12c (12.2.1.2.0)

E88272-01

Copyright © 2016 Oracle and/or its affiliates.All rights reserved.

原本著者:  Preeti Shukla

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

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

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

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および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およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

1 Subversionとの統合

- 1.1 ソフトウェア要件

- 1.2 統合アーキテクチャの理解

- 1.3 リポジトリの設定

- 1.4 SubversionでのEDQの構成

- 1.4.1 新規EDQインストールの構成

- 1.4.2 既存の構成情報の保持

- 1.5 統合要素の理解

- 1.6 デプロイメントの例の確認

- 1.7 エラーのトラブルシューティング

2 IBM Global Name Recognitionとの統合

- 2.1 システム要件

- 2.2 EDQサーバーの構成

- 2.3 検索ライブラリの作成

- 2.4 GNRコネクタの構成

- 2.4.1 EDQ GNRプロパティ・ファイルの作成

- 2.5 検索構成ファイルの作成

- 2.5.1 検索構成ファイルのGNR 3.2およびGNR 4.2のサポート

3 Experian QASとの統合

- 3.1 ソフトウェア要件

- 3.2 EDQとExperian QASとの統合

- 3.3 QAS統合の移行

4 Capscan Matchcodeとの統合

- 4.1 ソフトウェア要件

- 4.2 Capscan MatchcodeライブラリのEDQへの統合

- 4.3 Matchcode APIのカスタマイズ

5 EDQコマンドライン・インタフェースの使用

- 5.1 コマンドライン・インタフェースの実行

- 5.2 コマンドおよび引数の理解

- 5.2.1 runjob

- 5.2.2 runopsjob

- 5.2.3 droporphans

- 5.2.4 listorphans

- 5.2.5 scriptorphans

- 5.2.6 list

- 5.2.7 showlogs

- 5.2.8 shutdown

- 5.2.9 version

- 5.3 例の確認

- 5.3.1 使用可能なすべてのコマンドのリスト表示

- 5.3.2 コマンドで使用可能なパラメータのリスト表示

- 5.3.3 指定したジョブの実行

- 5.3.4 操作モードでの指定したジョブの実行

6 追加のデータベース接続の構成

- 6.1 JNDIを使用したデータ・ストアへの接続

- 6.2 tnsnames.oraを使用したOracle Databaseへの接続

- 6.2.1 TNSを介して接続するためのEDQの構成

- 6.3 Oracle Internet Directory (LDAP)を使用したOracle Databaseへの接続

7 XMLデータ・ファイルを処理するためのEDQの構成

- 7.1 単純なXMLデータ・ストアの使用

- 7.1.1 単純なXMLファイルの読取り

- 7.1.2 単純なXMLファイルの書込み

- 7.2 XMLおよびスタイルシート・データ・ストアの使用

- 7.2.1 DN-XMLの使用

- 7.2.2 カスタムXMLファイルの読取り

- 7.2.2.1 データ・ストアの構成

- 7.2.3 カスタムXMLファイルの書込み

- 7.2.3.1 データ・ストアの構成

8 EDQ構成APIの使用

- 8.1 プロジェクト用のRESTインタフェース

- 8.1.1 EDQプロジェクトのリストの取得

- 8.1.2 プロジェクトの作成

- 8.1.3 プロジェクトの削除

- 8.2 データ・ストア用のRESTインタフェース

- 8.2.1 データ・ストアのリストの取得

- 8.2.2 データ・ストアの作成

- 8.2.3 データ・ストアの削除

- 8.3 スナップショット用のRESTインタフェース

- 8.3.1 スナップショットのリストの取得

- 8.3.2 スナップショットの作成

- 8.3.3 スナップショットの削除

- 8.4 プロセス用のRESTインタフェース

- 8.4.1 プロセスのリストの取得

- 8.4.2 プロセスの削除

- 8.4.3 単純なプロセスの作成

- 8.5 ジョブ用のRESTインタフェース

- 8.5.1 ジョブのリストの取得

- 8.5.2 ジョブの削除

- 8.5.3 単純なジョブの作成

- 8.5.4 ジョブの実行

- 8.5.5 実行中のジョブの取消し

- 8.5.6 ジョブのステータスの取得

- 8.5.7 実行中のすべてのジョブに関する詳細の取得

- 8.6 参照データ用のRESTインタフェース

- 8.6.1 参照データのリストの取得

- 8.6.2 参照データのコンテンツの取得

- 8.6.3 参照データの作成

- 8.6.4 参照データの削除

- 8.7 Webサービス用のRESTインタフェース

- 8.7.1 Webサービスのリストの取得

- 8.7.2 Webサービスの作成または更新

- 8.7.3 Webサービスの削除

- 8.8 例: 外部アプリケーションによるプロファイリング

はじめに

外部システムおよびアプリケーションとのEnterprise Data Qualityの統合方法を説明します。

対象読者

このドキュメントの対象読者は、EDQとサード・パーティ・アプリケーションとの統合を担当するEDQおよび管理者の上級ユーザーです。

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

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

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 (聴覚障害者向け)を参照してください。

関連ドキュメント

詳細は、http://docs.oracle.com/middleware/12212/edq/index.htmlにあるOracle Fusion Middlewareドキュメント・セットの次のドキュメントを参照してください

EDQドキュメント・ライブラリ

次の刊行物がEDQのインストールおよび使用に役立てるために提供されます。

- 『Oracle Fusion Middleware Enterprise Data Qualityリリース・ノート』

- Oracle Fusion Middleware Enterprise Data Qualityのインストールと構成

- 『Oracle Fusion Middleware Enterprise Data Qualityの管理』

- 『Oracle Fusion Middleware Enterprise Data Qualityの理解』

- Oracle Fusion Middleware Enterprise Data Qualityの外部システムとの統合

- Oracle Fusion Middleware Enterprise Data Qualityの保護

- Oracle Enterprise Data Quality Address Verification Serverインストレーションおよびアップグレード・ガイド

- Oracle Enterprise Data Quality Address Verification Serverリリース・ノート

次の場所で、これらのガイドおよびすべてのOracle製品ドキュメントの最新バージョンを検索してください。

https://docs.oracle.com

オンライン・ヘルプ

オンライン・ヘルプはすべてのOracle Fusion Middlewareユーザー・アプリケーションに提供されています。各アプリケーションで、[F1]キーを押すか、「ヘルプ」アイコンをクリックすることで表示できます。Directorプロジェクトのブラウザの主なノードには、ヘルプ・ページへの統合されたリンクが含まれています。それらにアクセスするには、ノードを選択して[F1]を押すか、またはプロジェクト・ブラウザでオブジェクトを右クリックして「ヘルプ」を選択します。Directorのツール・パレットのEDQプロセッサにも、統合されたヘルプ・トピックが含まれています。これにアクセスするには、キャンバスでプロセッサを右クリックして「プロセッサ・ヘルプ」を選択するか、キャンバスかツール・パレットでプロセッサを左クリックして[F1]を押します。

表記規則

このドキュメントでは次の表記規則を使用します。

規則

意味

太字

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

イタリック体

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

固定幅フォント

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

1 Subversionとの統合

この章では、EDQをSubversionバージョン・コントロール・システムと統合して使用する方法について説明します。

この節の内容は以下のとおりです。

- ソフトウェア要件

- 統合アーキテクチャの理解

- リポジトリの設定

- SubversionでのEDQの構成

- 統合要素の理解

- デプロイメントの例の確認

- エラーのトラブルシューティング

1.1 ソフトウェア要件

EDQでは、Subversion 1.6、1.7および1.8との統合がサポートされます。Subversionの詳細は、http://subversion.apache.org/にあるApache SubversionのWebサイトを参照してください。

注意:
EDQでは、現在、Subversion 1.6、1.7および1.8との統合のみがサポートされます。他のバージョンと統合しようとすると、エラーが発生します。

EDQと統合するSubversionサーバーは、次の前提条件を満たしている必要があります。

- Hypertext Transfer Protocol (HTTP)およびDistributed Authoring and Versioning (DAV)アクセスのサポート。

- コミット時の認証が必要。

- チェックアウトまたは更新時の認証は不要。

Subversionを構成情報のストアとしてEDQと統合する場合、次の制限が適用されます。Subversionを使用した統合バージョン・コントロールを構成する前に、次の点を考慮してください。

- ディレクタ・インタフェースまたはSubversionサーバーで開かれているアイテムを更新したり、元に戻すことはできません。

- プロジェクトが一度バージョン・コントロールの対象になると、プロジェクト名を変更することはできません。これは、プロジェクトの参照プロセッサ名の重複を避けるために非常に重要です。

- プロジェクトを削除してもSubversionリポジトリからは削除されません。

- 名前の一致では、大/小文字の区別はありません。

1.2 統合アーキテクチャの理解

EDQサーバーは、Subversionサーバーを構成情報のストアとして認識するように構成できます。

注意:
この例での構成情報とは、プロジェクトやシステム・レベルのデータなど、ディレクタUIを使用して管理される情報を意味します。

標準のEDQインスタンスでは、プロジェクト情報などの構成情報は、ディレクタ・データベースに格納されます。

次の図は、Subversionと統合されたEDQインスタンスを示しています。

注意:
ディレクタ・データベースは、アプリケーションにより問合せできるように正規化されたファイル管理の構成から導出されるデータを格納するため、引き続き必要です。

Subversionリポジトリで管理および格納されるEDQ構成ファイルがある場合、Subversionクライアントを使用してそれをコミットするか、それにアクセスできます。EDQには埋込みSubversionクライアントが含まれるため、一度EDQとSubversionとの統合が有効になると、構成変更を制御するSubversionクライアントの操作は、ディレクタで直接実行できます。

1.3 リポジトリの設定

構成の最初の手順では、チェックアウトしたデータが格納されるワークスペース・ディレクトリを作成します。

1. ディスク上の適切な場所にディレクトリを作成し(C:\MyRepositoryなど)、それをSubversionに追加してコミットします。

2. 新しく作成したディレクトリ内で、次のSubversionプロパティを設定します。

svn propset edq:systemversion 12.1.3:base .

3. 次の変更をSubversionにコミットします。ワークスペースに次のプロパティが表示されます。

svn proplist -v .
Properties on '.':
edq:systemversion
12.1.3:base

4. 新しく作成したディレクトリ内に次のサブディレクトリを作成します。

- Data Stores

- Hidden Reference Data

- Images

- Projects

- Published Processors

- Reference Data

5. これらのディレクトリを追加してコミットします。これで、リポジトリはEDQ用に正しく設定されました。

前述の手順は、1つのリポジトリに対して1回実行すれば済みます。残りの変更は、すべてEDQを使用して実行できます。

1.4 SubversionでのEDQの構成

Subversionは、EDQのフレッシュ・インストールと統合する必要があります。

注意:
EDQインスタンスをSubversionと統合すると、既存のものを含めすべての構成情報が失われます。この情報を保持するには、最初にそれをパッケージ化してエクスポートする必要があります。詳細は、1.4.2項「既存の構成情報の保持」を参照してください。

注意:
単一のEDQインスタンスのワークスペース間で移動することは困難であるため、EDQのインスタンスごとに1つのワークスペースを割り当てることをお薦めします。

1.4.1 新規EDQインストールの構成

新しいEDQインストールを構成するには、次の手順を実行します。

1. アプリケーション・サーバーを停止します。

2. Subversionからワークスペースをチェックアウトします。ツリー全体をチェックアウトする必要はありません(ワークスペース・ディレクトリ自体が必要です)。

3. ORACLE_HOME/user_projects\domains\domains\edq_domain\edq\oedq.local.homeディレクトリのdirector.propertiesファイルを編集します。

4. ディレクトリ・パスを、ルート・ワークスペース・ディレクトリの絶対パスに置き換える次の行を追加します。次に例を示します。

sccs.workspace = C\:\\MyRepository

注意:
この例では、バックスラッシュが含まれるパスのコロン(:)およびバックスラッシュ(\)文字をエスケープする必要があります。バックスラッシュが含まれるパスの空白文字もエスケープする必要があります。

5. EDQサーバーを起動し、次にディレクタを起動します。

6. Main0.logファイルの一番上で、追加したSCCSワークスペースの名前をリストしたINFOメッセージを確認します。次に例を示します。

INFO: 02-Sep-2013 10:05:21: SCCS workspace is C:\MyRepository

7. このメッセージの後にエラーがなければ、EDQはSubversionを使用するように構成されています。エラーがある場合、1.7項「エラーのトラブルシューティング」で適用可能な解決策を参照してください。

1.4.2 既存の構成情報の保持

前述のとおり、Subversionは、EDQのフレッシュ・インストールと統合する必要があります。そのため、EDQインストールの既存のプロジェクトや他の構成アイテムは、次のように統合を開始する前にパッケージ化し、後で新しいインストールにインポートする必要があります。

1. 現在のEDQインスタンスに含まれるすべての構成アイテムをDXIファイルにパッケージ化します。

2. Subversion統合を有効にしてEDQの新しいインスタンスをインストールします。

3. 新しいインスタンスにDXIファイルをインポートし、Subversionワークスペースにそれらのファイルをコミットします。

4. 構成アイテムがすべて有効で、適切に動作することを確認します。
構成のインポート後に、データ・ストアのすべてのパスワードを再入力する必要があります。

5. 前のインスタンスの使用を中止します。

1.5 統合要素の理解

Subversionが有効な状態でEDQが統合されると、ディレクタ・アプリケーション内に次のインタフェース要素が表示されます。

- プロジェクト・ブラウザにSubversionのステータス・アイコンが重ねて表示されます(プロジェクト・ブラウザには、ノードの3つのSubversionステータスを示すために使用される2つのアイコンがあります)。

- アイコンなし - ノード(およびそのサブノード)はすべて最新です。

- 緑色のアイコン - このノード(およびそのサブノード)には変更があります。

- 青色のアイコン - このノード(およびそのサブノード)は、新しいものであるか、現在バージョン・コントロールの対象ではありません。

たとえば、次の図は、使用中の2つのアイコンを示しています。「参照データ」ノードは、そのサブノードの1つに変更があるため、変更されています(緑色のアイコン)。「参照データ」の新しいアイテムである「ビジネス用語」が追加され、青色のアイコンでマークされています。

- 「バージョン・コントロール」タブ - 「プロパティ」ダイアログ(プロジェクト・ブラウザのアイテムを右クリックして「プロパティ」を選択して表示)に、最終更新日時、Subversionのリビジョン、現在有効であるかどうかといったアイテムの状態を記述した「バージョン・コントロール」タブが含まれるようになりました。

- バージョン・コントロールの新しいコンテキスト・メニュー - プロジェクト・ブラウザの右クリック・メニューに、バージョン・コントロール・オプションが含まれるようになりました。選択すると、Subversionのオプションを含んだサブメニューが表示され、そのアイテムの更新、コミット、回復、比較またはログ表示を行うことができます。これらのオプションは再帰的です。たとえば、1つのプロセスを対象にログの表示を実行すると、そのプロセスのログのみが表示されますが、「プロセス」ノードを対象にログの表示を実行すると、すべてのプロセスの変更が表示されます。

- コミット時のコメントおよび資格証明のダイアログ - リポジトリに変更をコミットすると、ディレクタに「コミット・ログ」ダイアログが表示されます。

このダイアログの「コメント」フィールドに、変更を説明するコメントを入力できます。または、現在のセッションで前に入力したコメントのリストからコメントを選択して、自動的にフィールドに移入することもできます。

現在のセッションでまだ自分の資格証明を入力していない場合、「コミット・ログ」ダイアログで「OK」をクリックすると、ディレクタに「バージョン・コントロール資格証明」ダイアログが表示されます。

このダイアログで、Subversionリポジトリ用のユーザー名とパスワードを入力し、「OK」をクリックします。

1.6 デプロイメントの例の確認

次に、デプロイメントの例を示します。この図には、4つのEDQインストールに対応する構成の3つのコピーを保持する1つのSubversionサーバーがあります。

構成のコピーは次のとおりです。

- trunk - すべての開発作業が実行される従来の場所。構成の新しい機能はここで開発され、保存されます。

- branchesおよびUAT - このブランチは、UATテストのための構成のコピーを表します。

- branchesおよびproduction - このブランチは、構成の本番コピーを表します。

構成を格納するためにSubversionサーバーを使用する4つのEDQインストールは、次のとおりです。

- 既存のプロジェクトの設計作業とメンテナンスが実行される2つの開発ラップトップ。

- ユーザー受入れテストの変更のためのUATサーバー。

- 本番環境の実行のための本番サーバー。

このデプロイメントの例では、ラップトップ・ユーザーは、各自のラップトップで個々のプロジェクトの構成を開発し、"trunk"のSubversionリポジトリに変更をコミットします。開発者が連携してプロジェクトを開発する環境では、各自のローカル・インストールを定期的に更新して、他の開発者による変更を取得します。

ある時点で、開発は、テストのためにUATにリリースする必要がある段階まで到達します。リリース・マネージャは、必要なプロジェクトをSubversionサーバーの"trunk"から"UAT"にコピーします。

たとえば、次のSubversionコマンドを使用できます。

svn cp -m"Release Project X to UAT" http://svn/repos/config/trunk/ProjectX http://svn/repos/config/branches/UAT

テスト・マネージャは、UATサーバーのプロジェクトを更新して、新しい構成をEDQサーバーにロードします。一定の期間、テストが続けられます。検出された問題は、UAT環境で修正され、Subversionリポジトリにコミットして戻されます。

UAT環境が受入れ可能なテスト・レベルに到達したら、リリースに昇格されます。この実行方法は、開発からUATへのリリースとほぼ同じです。必要なプロジェクトがバージョン・コントロール・リポジトリ内でコピーされ、本番サーバーがこの構成を使用するように更新されます。

1.7 エラーのトラブルシューティング

原因と解決策がわかっている次のエラーが発生することがあります。

エラー

原因と解決策

構成データベースがワークスペースと互換性がありません

データベースが異なるワークスペースで使用されました。このエラーは、通常、Subversionバージョン・コントロールが有効になる前に操作がEDQで実行されると発生します。ディレクタ・データベースを削除して再作成する方法と、EDQを再インストールする方法の2つの解決策があります。

URLに対してra_localセッションを開くことができません

これは、無効なリポジトリにファイルをコミットしようとした場合に発生することがあります。EDQ統合は、ファイルベースのリポジトリ(file:///またはC:\exampleで始まるリポジトリ)とは互換性がありません。リポジトリに対するhttp://の完全宣言パスを作成する必要があります。

2 IBM Global Name Recognitionとの統合

この章では、EDQとIBM Global Name Recognition (GNR)を統合する方法について説明します。

IBM GNRに接続するようにEDQを構成し、名前の言語分析や、言語学的見地による名前検索を容易に実行できます。

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

- システム要件

- EDQサーバーの構成

- 検索ライブラリの作成

- GNRコネクタの構成

- 検索構成ファイルの作成

2.1 システム要件

EDQとIBM GNRとの接続を有効にするには、次のものが必要です。

- 64ビットJavaが稼働する64ビットAIXオペレーティング・システムまたはLinuxオペレーティング・システムにインストールされたEDQ 12c (12.2.1.1.0および12.2.1.2.0)。

- GNR 4.2.2 (4.2 +4.2.2修正パック)に基づく修正プログラムを含むIBM GNR 4.2.1 (4.2 + 4.2.1修正パック)以上。詳細は、http://www.ibm.comにあるIBMのWebサイトを参照してください。
EDQは、GNRで提供されるどのWebサービスも使用しないため、GNRのインストール中にそれらを構成する必要はありません。

注意:
GNRは、オラクル社とIBM社の双方と必要なライセンス契約を締結している場合にのみ、EDQインスタンスにインストールできます。

2.2 EDQサーバーの構成

インストール環境の要件に従ってLD_LIBRARY_PATHを設定する必要があります。

EDQ GNR分析プロセッサでは、GNRインストールのlib64ディレクトリの共有ライブラリ(.so)を使用します。このディレクトリは、EDQサーバーに渡される環境変数に指定する必要があります。

Linux 64ビット環境では、環境変数は次のようにLD_LIBRARY_PATHです。

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:gnr-installation-dir/lib64

gnr-installation-dirは、GNRのインストール・パスです(/opt/GNR/GNMなど)。

AIX環境では、環境変数名はLD_LIBRARY_PATHではなくLIBPATHです。

注意:
環境変数は、アプリケーション・サーバー・プロセスで使用可能である必要があります。

2.3 検索ライブラリの作成

GNR検索プロセッサでは、GNRライブラリにリンクされている必要のあるネイティブ・ライブラリを使用します。

ライブラリの作成用に次のファイルが提供されています。

- 2つのMakefileテンプレート(プラットフォームごとに用意された、検索ライブラリの作成方法を記述したファイル)

- namehunter.oオブジェクト・モジュール・ファイル

AIXシステムでライブラリを作成する場合、IBM C++が使用できる必要があります。Linuxシステムでライブラリを作成する場合、GCC C++コンパイラが使用可能で、かつ、IBM GNRドキュメントに指定されているとおり、GNRライブラリの作成時に使用したものと同じバージョンである必要があります。

64ビットAIXオペレーティング・システムのMakefileテンプレートは、次のとおりです。

# Build library from object file
# ------------------------------

GNR=/opt/GNR/GNM
CFLAGS=-qmkshrobj
LIBS=-lNameHunter -lNameTransliterator -lsicui18n -lsicuuc -lsicudata
SDK=aix61_64-xlc9-release
LIBDIRS=-L$(GNR)/sdk/$(SDK)/lib -L$(GNR)/sdk/icu4c/$(SDK)/lib

all: libnimrod.so

libnimrod.so: namehunter.o
xlc++_r -q64 $(CFLAGS) -o $@ $? $(LIBDIRS) -lNameHunter -lNameTransliterator
-lsicui18n -lsicuuc -lsicudata

64ビットLinuxオペレーティング・システムのMakefileテンプレートは、次のとおりです。

# Build 64-bit library from object file
# --------------------------------------

GNR=/opt/GNR/GNM
CFLAGS=-shared -fPIC

all: libnimrod.so

libnimrod.so: namehunter.o
g++ -m64 $(CFLAGS) -o $@ $? -L$(GNR)/sdk/rhel4_64-gcc34-release/lib
-L$(GNR)/sdk/icu4c/rhel4_64-gcc34-release/lib -lNameHunter -lNameTransliterator
-lsicui18n -lsicuuc -lsicudata

使用中のプラットフォームでMakefileスクリプトを実行する前に、MakefileテンプレートのGNRの値が、GNRインストール・ディレクトリの場所に従って正しく設定されていることを確認してください。同様に、AIXオペレーティング・システムでは、SDKの値がシステム・アーキテクチャに従って正しく設定されていることを確認してください。

編集済のMakefileの実行後、新しく作成したlibnimrod.so共有ライブラリ・ファイルは、任意の場所にインストールしたり、GNRインストールが含まれる他のシステムにコピーできます。

2.4 GNRコネクタの構成

EDQ GNRコネクタには、GNRと統合するために次の3つのタイプの構成ファイルが必要です。

- EDQインストールのgnr.propertiesプロパティ・ファイル

- GNRインストールのnameworks.config構成ファイル

- EDQインストールの検索構成ファイル

2.4.1 EDQ GNRプロパティ・ファイルの作成

gnr.propertiesファイルとそれを格納するgnrサブディレクトリを手動で作成し、EDQ構成ディレクトリのgnrサブディレクトリに配置する必要があります。これには次のプロパティが含まれる必要があります。

gnr.install

GNRのインストール・パス。これは、次のGNRサブディレクトリを格納するディレクトリへのパスです。

- bin

- bin64

- data (GNRデータ・ファイルを格納)

- lib

- lib64

analytics.config

GNRインストールのnameworks.config構成ファイルの絶対位置。

search.jnilib

Makefileテンプレートを使用して作成されたlibnimrod.so共有ライブラリの絶対位置。

nameworks.config

GNRのインストール中に、nameworks.configファイルが作成され、GNR dataディレクトリに格納されます。

nameworks.configファイルで特に重要な部分は、次の参照ファイル・セクションです。

[Reference Files]
NameSifter=/opt/GNR/GNM/data/SifterRules.ibm

NameSifterの値は、GNRインストールのSifterRules.ibmファイルを参照している必要があります。

2.5 検索構成ファイルの作成

検索構成ファイルは、EDQ構成ディレクトリのgnr/searchサブディレクトリにあります。これらはコネクタに読み取られ、検索機能のパラメータを設定するために使用されます。

search.configというサンプルの検索構成ファイルが、EDQインストールのsupport/data/searchサブディレクトリにあります。検索構成ファイルを作成するには、このサンプル・ファイルをEDQ構成ディレクトリのgnr/searchサブディレクトリにコピーして、そのコピーを必要に応じて編集します。

2.5.1 検索構成ファイルのGNR 3.2およびGNR 4.2のサポート

検索構成ファイルの形式は、GNR 3.2からGNR 4.2への移行で若干変更されており、EDQ GNRコネクタでは、可能なかぎり両方のバージョンがサポートされます。また、組織検索でもデータが処理されます。

GNR 3.2とGNR 4.2の検索構成ファイル間の基本的な違いは、次のとおりです。

- GNR 4.2では、[hunter]セクションにパラメータ・ファイル(タグやバリアントなど)を指定します。GNR 3.2では、[search]セクションを使用します。EDQ GNRコネクタは、最初に[hunter]セクションを検索し、次に[search]セクションを検索します。

- GNR 4.2のタグおよびバリアント・ファイルは、ibmTaqFileやcustTaqFileなどのキーによって指定されます。GNR 3.2では、単純にtaqFileが使用されます。EDQ GNRコネクタは、taqFile、ibmTaqFileおよびcustTaqFileを検索し、それぞれ検出されたものをロードします。バリアントおよび用語ファイルにも同じルールが使用されます。

- 汎用正規化ファイルは、特定のgenericRegFile設定によって設定されますが、GNR 3.2では、これは常にデフォルトでanglo正規化ファイルに設定されます。

- [parms]セクションに追加された設定と、削除された設定があります。

3 Experian QASとの統合

この章では、EDQをExperian QAS APIと統合する方法と、以前のバージョンのQAS統合をEDQバージョン8.1.3以上に移行する方法について説明します。

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

- 3.2項「EDQとExperian QASとの統合」

- 3.3項「QAS統合の移行」

3.1 ソフトウェア要件

EDQには、Experian QAS Batch APIに対するコネクタが含まれます。使用中のプラットフォームに適したExperian QAS Batch APIソフトウェアのインストール済バージョンが存在する必要があります。詳細は、http://www.qas.com/にあるExperian Data QualityのWebサイトを参照してください。

3.2 EDQとExperian QASとの統合

EDQとExperian QAS Batchとの統合を実現するには、EDQとともに配布されているqas.propertiesファイルを編集します。qas.propertiesファイルは、ORACLE_HOME/user_projects\domains\domains\edq_domain\edq\oedq.home\qasディレクトリにあります。

EDQとQAS Batchソフトウェアの両方をインストールしたら、統合の要件に応じてqas.propertiesのプロパティを編集します。ファイルに指定するプロパティは次のとおりです。

プロパティ名

説明

デフォルト値

qas.install.path

Experian QAS Batchインストールの場所。

C:\\Program Files (x86)\\QAS\\QuickAddress Batch API

qas.qaworld.ini

使用するQAWorld.iniファイルへのパス。これにより、Experian QAS Batch APIとともに配布されている元のQAWorld.iniファイルのコピーを作成して編集できます。このプロパティに値を指定しない場合、Experian QAS Batch APIインストール内のQAWorld.iniファイルが使用されます。

なし

max.number.connections

EDQがAPIに対して作成する接続の最大数。これは、32より大きい値に設定できません。
注意: Experian QAS Batch APIバージョン6.85、6.89および6.95には、スレッドおよびメモリーに関する既知の問題があり、最大使用量の32インスタンスと8スレッドに到達すると、Batch APIがクラッシュする可能性があります。これを回避するには、このプロパティの値を18以上22以下に設定します。

32

connection.pool.timeout

このプロパティでは、プール管理機能によってクローズする前に接続のアイドル状態を許容するミリ秒数を指定します。これを-1に設定すると、アイドル状態の接続はクローズされません。

60,000

connection.pool. timer.interval

このプロパティでは、接続プールでアイドル状態の接続をスキャンする頻度をミリ秒単位で指定します。

60,000

default.layout

使用するデフォルト・レイアウト。指定した名前のレイアウトが特定のQAWorld.iniファイルで使用できない場合、このプロパティは無視されます。

GBR

3.3 QAS統合の移行

以前のバージョンのEDQの一部(8.1.3より前のバージョン)には、QAWorld.iniのカスタマイズ・バージョンが付属しており、Experian QAS内に含まれるバージョンのかわりに使用されていました。これらのバージョンのExperian QAS統合からそれ以降のバージョンに自動的に移行することはできません。以前のExperian QAS統合を移行するには、次の作業が必要です。

- QAWorld.iniのローカル・コピーを検索し、そのファイルに指定されているカスタム・レイアウトをExperian QAS内に含まれるQAWorld.iniのバージョンにコピーします。

- qas.propertiesの設定を更新します(3.2項「EDQとExperian QASとの統合」を参照)。

また、QASプロセッサを使用する既存のプロセスおよび結果ブックを次のように更新する必要があります。

- 各構成済QASプロセッサを開いて、新しいQAWorld.iniファイルのものと一致するように出力属性名を変更します。

- QASプロセッサの結果グリッドに基づいて作成された結果ブックを開き、フィールドを新しい出力属性名に再マップします。

EDQの各バージョンで影響を受けるリリースは、次の表を参照してください。7.2より前のEDQのすべてのバージョン(旧称dn:Director)が影響を受けます。

バージョン

影響を受けるリリース

EDQ (dn:Director) 7.2

リリース7.2.9とそれより前のすべての7.2リリース

EDQ (dn:Director) 8.0

リリース8.0.21とそれより前のすべての8.0リリース

EDQ (dn:Director) 8.1

リリース8.1.2とそれより前のすべての8.1リリース

4 Capscan Matchcodeとの統合

このドキュメントでは、GBGroup Capscan Matchcodeの住所検証およびクレンジング機能をEDQと統合する方法について説明します。このドキュメントの対象読者は、EDQアプリケーションのインストールおよび管理を担当するシステム管理者です。

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

- ソフトウェア要件

- Capscan MatchcodeライブラリのEDQへの統合

- Matchcode APIのカスタマイズ

4.1 ソフトウェア要件

Capscan MatchcodeソフトウェアがEDQサーバーからアクセスできるシステムにインストールされている必要があります。詳細は、http://www.gbgplc.com/products/matchcode/にあるGBGroup MatchcodeのWebサイトを参照してください。

4.2 Capscan MatchcodeライブラリのEDQへの統合

EDQには、Capscan Matchcode APIに対するコネクタが含まれます。EDQには、GBGroupのCapscan Matchcode APIに対するコネクタが含まれます。このAPIでは、住所検証およびクレンジング機能が提供されます。このAPIでは、住所検証およびクレンジング機能が提供されます。次のようにCapscan MatchcodeライブラリをEDQに統合します。

1. capscan.jarクライアントAPIファイルを、Capscan MatchcodeインストールからORACLE_HOME/user_projects\domains\edq_domain\servers\edq_server1\tmp\_WL_user\edq\iz3lfy\war\WEB-INF\widgetjarsディレクトリにコピーします。
Capscan Matchcodeインストールのcapscan.jarファイルの場所は、インストール・プラットフォームに応じて異なります(たとえば、WindowsではCapscan\SDK\Matchcode client API\Javaディレクトリにあります)。

注意:
capscan.jarファイルは、この手順に示されているデフォルト・ディレクトリ以外のディレクトリにコピーできます。その場合、capscan.propertiesファイルのcapscan.jarプロパティを編集して、ファイルの場所を指定します。相対パスを指定する場合、そのパスは、EDQ構成パス内のいずれかのディレクトリを基準とする必要があります。

2. ORACLE_HOME/user_projects\domains\domains\edq_domain\edq\oedq.home\capscanディレクトリのcapscan.propertiesファイルを編集します。

3. Capscan Matchcodeが実行されているシステムを参照するようにserver.hostプロパティを編集します。

4. EDQサーバーを再起動します。

4.3 Matchcode APIのカスタマイズ

Capscan Matchcode APIの様々な動作は、capscan.propertiesファイルを使用して制御できます。次のプロパティを設定できます。

capscan.jar

EDQインストールのcapscan.jarクライアントAPIファイルの場所。相対パスを指定する場合、そのパスは、EDQ構成パス内のいずれかのディレクトリを基準とする必要があります。デフォルト値は、相対パスのcapscan/capscan.jarです。

server.host

Capscan Matchcodeが実行されているマシンのIPアドレス。

connection.timeout

Capscan Matchcode APIが検索と返却を中断するまでの秒単位のタイムアウト期間(0 (ゼロ)のタイムアウト期間は検索の時間制限がないことを示します)。

connection.type

Capscan Matchcode APIとの通信時に使用する接続モード。デフォルトの接続モードは、CONNECTIONLESSです。それ以外のオプションは次のとおりです。

- CONNORIENTED

- STATELESS

- WEBCONNECTION

- ONDEMAND

これらの接続モードの詳細は、Capscan Matchcode APIのドキュメントを参照してください。

number.capscan.connections

EDQがCapscan Matchcode APIに対して作成する接続の数。

number.threads

Capscan Matchcode APIとの通信時に使用するスレッドの数。

capscan.propertiesファイルのデフォルトの内容は、次のとおりです。

# This configuration file is configuring the CapScan processor
# to be able to communicate with the CapScan server
#
# Capscan server name
server.host = 127.0.0.1
#
# Connection timeout in seconds (0 means no time out)
connection.timeout = 30
#
# The connection type to make to the CapScan server.
# Possible values are:
#
# CONNORIENTED
# CONNECTIONLESS
# STATELESS
# WEBCONNECTION
# ONDEMAND
connection.type = CONNECTIONLESS
#
# The number of connections the director server should
# make to the CapScan server
number.capscan.connections = 1
#
# The number of threads that should be used to
# communicate with the CapScan server
number.threads = 1

5 EDQコマンドライン・インタフェースの使用

この章では、EDQコマンドライン・インタフェースの使用方法について説明します。

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

- コマンドライン・インタフェースの実行

- コマンドおよび引数の理解

- 例の確認

EDQコマンドライン・インタフェースのjmxtools.jarにより、複数のEDQ機能にアクセスできます。

5.1 コマンドライン・インタフェースの実行

EDQコマンドライン・インタフェースは、toolsディレクトリで自己完結型.jarファイルとして配布され、次のコマンドラインの起動により実行されます。

java -jar jmxtools.jar commandname arguments

次の項で、コマンドおよび引数について説明します。

5.2 コマンドおよび引数の理解

コマンドライン・インタフェースにより、複数のコマンドを実行でき、次のような機能を使用できます。

- ジョブの実行

- 孤立した結果表のリスト表示および削除

- ユーザー・セッション・ログの表示

- リアルタイム・ジョブの停止

- EDQバージョン番号の確認

後続の項では、使用可能なコマンド、引数およびオプションの完全なガイドを示します。

EDQでは、RESTベースのEDQ構成APIインタフェースを通じたジョブのサポートも提供されます。これらのインタフェースを使用して様々なジョブを実行する方法の詳細は、『Enterprise Data Qualityと外部システムの統合』の「ジョブ用のRESTインタフェース」を参照してください。

5.2.1 runjob

runjobコマンドは、ディレクタUIを使用してジョブを実行する場合と同じ方法で、指定されたジョブを実行します。runjobコマンドには、次の引数を指定します。

引数

用途

-job job_name

実行するジョブの名前を指定します。

-project project_name

ジョブを含むプロジェクトの名前を指定します。

-u user_name

EDQサーバーへの接続に使用するユーザー名を指定します。ユーザーは、ジョブを実行する権限と、ジョブを含むプロジェクトに対する権限を持っている必要があります。

-p password

接続ユーザーのパスワードを指定します。-pオプションを設定しないと、ユーザーはパスワードの入力を求められます。

-nolockwait

ジョブに使用されるいずれかのリソースがロックされている場合に、ジョブでそれらが使用可能になるまで待機しないことを示します。かわりに、それは失敗コード付きで終了し、コマンドラインに制御が戻されます。-nolockwait引数にその他の値は不要です。

-nowait

コマンドラインでジョブが完了するまで待機しないことを示します。-nowait引数にその他の値は不要です。

server:port

JMX (管理)インタフェースのサーバーおよびポートを指定します。

5.2.2 runopsjob

runopsjobコマンドは、サーバー・コンソールのユーザー・インタフェースを使用してジョブを実行する場合と同じ方法で、指定されたジョブを実行します。これは、runjobコマンドに対して、実行ラベルと実行プロファイルを使用する機能が追加されたものです。実行ラベルを使用すると、結果を同じジョブの他の実行結果と分けて保存することができます。実行プロファイルを使用すると、外部化された構成設定を実行時に上書きできます。

runopsjobコマンドには、次の引数を指定します。

引数

用途

-job job_name

実行するジョブの名前を指定します。

-project project_name

ジョブを含むプロジェクトの名前を指定します

-u user_name

EDQサーバーへの接続に使用するユーザー名を指定します。ユーザーは、ジョブを実行する権限と、ジョブを含むプロジェクトに対する権限を持っている必要があります。

-p password

接続ユーザーのパスワードを指定します。-pオプションを設定しないと、ユーザーはパスワードの入力を求められます。

-nolockwait

ジョブに使用されるいずれかのリソースがロックされている場合に、ジョブでそれらが使用可能になるまで待機しないことを示します。かわりに、それは失敗コード付きで終了し、コマンドラインに制御が戻されます。-nolockwait引数にその他の値は不要です。

-nowait

コマンドラインでジョブが完了するまで待機しないことを示します。-nowait引数にその他の値は不要です。

-runlabel run_label_name

ステージング済出力結果を格納する実行ラベルの名前を指定します。これは、実行プロファイルまたは-D runlabel = run_label_nameで指定された実行ラベルをオーバーライドするため、注意してください。

-props run_profile_name

ジョブの外部化された構成オプションのオーバーライド設定を含む実行プロファイルのプロパティ・ファイルへのフルパスを指定します。

-D externalized_option=value

ジョブの特定の外部化されたオプションを個別にオーバーライドできます。外部化されたオプションおよび値の構文は、実行プロファイルのプロパティ・ファイルで使用されるものと同じです。文字はコマンドラインによって解釈されるため、一部の文字は、使用している環境のシェルの表記規則に従ってエスケープする必要があることに注意してください。また、個別の指定による外部化されたオプション設定は、それらが同じ実行で使用される実行プロファイルに指定されている場合、同じオプションの設定をオーバーライドすることに注意してください。

server:port

JMX (管理)インタフェースのサーバーおよびポートを指定します。

5.2.3 droporphans

droporphansコマンドは、プロセスが予期せず終了したときに作成されることのある孤立した結果表を削除するために使用します。これは、EDQサーバーでジョブまたはプロセスが実行されている場合には実行できません。

droporphansコマンドには、次の引数を指定します。

オプション

用途

-u user name

EDQサーバーへの接続に使用するユーザー名を指定します。ユーザーは、ジョブを取り消す権限と、ジョブを含むプロジェクトに対する権限を持っている必要があります。

-p password

接続ユーザーのパスワードを指定します。-pオプションを設定しないと、ユーザーはパスワードの入力を求められます。

server:port

JMX (管理)インタフェースのサーバーおよびポートを指定します。

5.2.4 listorphans

listorphansコマンドは、孤立した結果表を識別するために使用します。listorphansコマンドには、droporphansコマンドと同じ引数を指定します。

5.2.5 scriptorphans

scriptorphansコマンドは、孤立した結果表を削除するためにSQLコマンドのリストを作成します。これは、表を削除するときに結果データベースに対して実行するコマンドが正確かどうかを確認する場合、または表を手動で削除する場合に役立ちます。

5.2.6 list

listコマンドは、使用可能なすべてのコマンドをリスト表示します。

5.2.7 showlogs

showlogsコマンドは、ユーザー・セッション・ログを取得できる小さなグラフィカル・ユーザー・インタフェース・アプリケーションを起動します。

5.2.8 shutdown

shutdownコマンドは、すべてのリアルタイム・ジョブを停止します。これらは、リアルタイム・レコード・プロバイダ(WebサービスまたはJava Message Service)で実行されているジョブです。

shutdownコマンドには、次の引数を指定します。

オプション

用途

-u user name

EDQサーバーへの接続に使用するユーザー名を指定します。ユーザーは、ジョブを取り消す権限と、ジョブを含むプロジェクトに対する権限を持っている必要があります。

-p password

接続ユーザーのパスワードを指定します。-pオプションを設定しないと、ユーザーはパスワードの入力を求められます。

-nowait

コマンドラインでジョブが完了するまで待機しないことを示します。-nowait引数にその他の値は不要です。

server:port

JMX (管理)インタフェースのサーバーおよびポートを指定します。

5.2.9 version

versionコマンドは、EDQの現在インストールされているインスタンスのバージョンを識別するために使用します。

コマンドラインに、次の引数を入力します。

java -jar jmxtools.jar version

バージョン番号が戻されます。

5.3 例の確認

この項では、コマンドライン・インタフェースで使用可能ないくつかの起動例を示します。

- 使用可能なすべてのコマンドのリスト表示

- コマンドで使用可能なパラメータのリスト表示

- 指定したジョブの実行

- 操作モードでの指定したジョブの実行

5.3.1 使用可能なすべてのコマンドのリスト表示

次のコマンドライン・インタフェースの起動例では、使用可能なすべてのコマンドをリストします。

java -jar jmxtools.jar -list

出力は次のようになります。

Available launch names:
<Job tools>
runjob Run named job
shutdown Shutdown realtime jobs
runopsjob Run named job in operations mode

<Logging>
showlogs Show session logs

<Database Tools>
listorphans List orphaned results tables
droporphans Drop orphaned results tables
scriptorphans Create script for dropping orphaned results tables

<System Information>
version Display version number of tools

5.3.2 コマンドで使用可能なパラメータのリスト表示

対応するパラメータなしでコマンドを指定してコマンドライン・インタフェースを起動すると、そのコマンドの詳細なヘルプが出力されます。たとえば、runjobコマンドの詳細なヘルプを取得するには、次のようにコマンドライン・インタフェースを起動します。

java -jar jmxtools.jar runjob

出力は次のようになります。

Usage: runjob -job jobname -project project [-u user] [-p pw] [-nowait] [-nolockwait] [-sslprops props | -ssltrust store] server:port

5.3.3 指定したジョブの実行

この例では、(マシン名とポートの指定に従って)特定のEDQインスタンスで指定したプロジェクトの指定したジョブを実行する方法を示します。

ポート8090でJMXサーバーが稼働するローカル・マシンで、"dnadmin"というユーザー名を使用して"Audit"というプロジェクトの"rulecheck"というジョブを実行する場合、コマンドは次のようになります。

java -jar jmxtools.jar runjob -job rulecheck -project audit -u dnadmin localhost:8090

ユーザーは、dnadminユーザーのパスワードの入力を求められます。

5.3.4 操作モードでの指定したジョブの実行

この例では、Windows環境で、操作モードで指定したジョブを実行する方法を示します。操作モードでは、実行ラベルと実行プロファイルの機能にアクセスできるため、ジョブの構成を動的に指定したり、ジョブの結果を実行ラベルによって格納できます。

実行ラベル"Nov2011"および実行プロファイル・ファイルFile1.propertiesを使用して、ポート8090でJMXサーバーが稼働する"prod01"というサーバーで、"MDM"というプロジェクトの"profiling"というジョブを実行する場合、コマンドは次のようになります。

java -jar jmxtools.jar runopsjob -job profiling -project MDM -runlabel Nov2011 -props c:\ProgramData\Oracle\"Enterprise Data Quality\oedq_local_home\File1.properties" -u dnadmin prod01:8090

6 追加のデータベース接続の構成

この章では、EDQディレクタで使用するために追加のデータベース接続を構成する方法について説明します。

- JNDIを使用したデータ・ストアへの接続

- tnsnames.oraを使用したOracle Databaseへの接続

- Oracle Internet Directory (LDAP)を使用したOracle Databaseへの接続

ディレクタでデータ・ストアに接続するための標準オプションは、オンライン・ヘルプに記載されています。一度実装すると、これらのオプションは、ディレクタの新規データ・ストア・ウィザードの「データ・ストア構成」ステップに表示されます。このウィザードの使用に関するヘルプは、ディレクタのオンライン・ヘルプを参照してください。

6.1 JNDIを使用したデータ・ストアへの接続

Java Naming and Directory Interface (JNDI)データ・ストア接続を使用するようにEDQを構成できます。

1. JNDIデータ・ストアを定義します。JNDIは、ホストするアプリケーション・サーバーによって提供されます。Oracle WebLogic ServerでJNDIデータソースを定義する方法の詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCアプリケーションの開発』のデータソース・リソース定義の使用に関する項を参照してください。

2. EDQデータ・ストア・ウィザードで、データ・ストアのタイプとしてJNDIを指定し、次にJNDI名を指定します。

6.2 tnsnames.oraを使用したOracle Databaseへの接続

Oracle Transparent Network Substrate (TNS)データ・ストア接続を使用するようにEDQを構成できます。この接続方法を使用するには、データソース・ウィザードの使用時にデータソースとしてtnsnames.oraファイルからの名前を指定します。tnsnames.oraファイルのみが必要です。他のOracleクライアント・ソフトウェアは不要です。

6.2.1 TNSを介して接続するためのEDQの構成

TNSを介してEDQに接続するには、次の手順を実行します。

1. oracle.net.tns_admin Javaシステム・プロパティに、tnsnames.oraファイルを含むローカル・ディレクトリを設定します。

2. EDQローカル構成ディレクトリ(デフォルトではoedq_local_home)にjvm.propertiesというファイルを作成し、oracle.net.tns_admin = c:\\tempなどのエントリを追加します。このプロパティは、EDQのインストール時にアプリケーション・サーバーですでに設定されている可能性があります。

tnsnames.oraファイルの詳細は、『Oracle Database Net Services管理者ガイド』のローカル・ネーミング・メソッドの構成に関する項を参照してください。

6.3 Oracle Internet Directory (LDAP)を使用したOracle Databaseへの接続

必要なJavaシステム・プロパティを設定して、Oracle Lightweight Direct Access Protocol (LDAP)データ・ストア接続を使用するようにEDQを構成できます。これらのプロパティは次のとおりです。

dn.oracle.directory.servers = ldap://servername:port

dn.oracle.default.admin.context = dc=domaincontext1,dc=domaincontext2

最初のプロパティでは、LDAPサーバーの場所を指定します。2番目のプロパティでは、LDAPツリー内のコンテキストを設定します。これらのプロパティの組合せにより、EDQでは、次のようなOracleとLDAP JDBCの接続文字列を構成できます。

jdbc:oracle:thin:@ldap://servername:port/unicode,cn=Oraclecontext,dc=domaincontext1,dc=domaincontext2

7 XMLデータ・ファイルを処理するためのEDQの構成

この章では、XMLデータ・ファイルの読取りと書込みを行うためにEDQを構成する方法について説明します。

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

- 単純なXMLデータ・ストアの使用

- XMLおよびスタイルシート・データ・ストアの使用

スナップショットのXMLデータ・ファイルを使用して、ファイルに含まれるデータの読取りと書込みを行うことができます。スナップショットは、データ・ストアにステージングされたデータのコピーで、1つ以上のプロセスで使用されます。EDQでは、XMLデータ・ファイルを処理するために、単純なXMLと、XMLおよびスタイルシートという2つのタイプのデータ・ストアを提供しています。両方とも、サーバー側とクライアント側のデータ・ストアで使用できます。

7.1 単純なXMLデータ・ストアの使用

単純なXMLデータ・ストアでは、単純な2レベル構造のXMLファイル(最上位レベルのタグがエンティティを表し、下位レベルのタグがそのエンティティの属性を表す構造)の読取りと書込みを行うことができます。Microsoft AccessからエクスポートされたXMLファイルがその一例です。

次に、EDQで使用できる単純なXMLファイル形式の例を示します。

<dataroot>
<Person>
<Id>1</Id>
<FirstName>Fred</FirstName>
<LastName>Bloggs</LastName>
<DateOfBirth>1972-01-31T00:00:00.000+0000</DateOfBirth>
<Weight>85</Weight>
</Person>
<Person>
<Id>2</Id>
<FirstName>Jane</FirstName>
<LastName>Smith</LastName>
<DateOfBirth>1985-07-16T00:00:00.000+0100</DateOfBirth>
<Weight>63</Weight>
</Person>
</dataroot>

7.1.1 単純なXMLファイルの読取り

EDQで単純なXMLファイルを読み取る場合、次のように動作します。

- ルート要素名は使用されないため、任意に指定できます。

- レコード要素名は、スナップショット・ウィザードのダイアログの「表選択」ページに表名として表示されます。

- 下位レベルの要素名は、スナップショット・ウィザードの「列選択」ページに列名として表示されます(そのため、EDQ属性名になります)。

7.1.2 単純なXMLファイルの書込み

データ・ストアに対するEDQエクスポートを使用して単純なXMLファイルを生成すると、データ・ストアの名前でレコードXML要素名が定義されます。7.1項の例にあるPerson要素は、このXMLでの表示方法を示しています。

下位レベルのタグのXML要素名は、EDQ属性名から取得されます。EDQ名は、無効なXMLが生成されないようにエンコードされます。たとえば、名前に含まれる空白文字は、文字列_x0020_で置き換えられるため、Date Of BirthというEDQ属性により、次の形式のXML要素が生成されます。

<Date_x0020_Of_x0020_Birth>

7.2 XMLおよびスタイルシート・データ・ストアの使用

単純なXMLとは異なる構造のXMLを処理する必要がある場合、XMLおよびスタイルシート・データ・ストアを使用します。

これらのデータ・ストアでは、DN-XMLスキーマに準拠するXMLの読取りと書込みを行いますが、オプションで、カスタム・スタイルシートを使用して次のことを実行できます。

- データ・スナップショット時におけるカスタムXML形式からDN-XMLへのXMLの変換

- データ・エクスポート時におけるDN-XMLからカスタムXML形式へのXMLの変換

XMLスタイルシートの詳細は、http://www.w3.org/Style/XSL/およびhttp://www.w3.org/standards/xmlにあるW3CのWebサイトを参照してください。

7.2.1 DN-XMLの使用

DN-XMLは、EDQでカスタムXMLを処理する場合に使用する形式です。

DN-XMLの例は次のとおりです。

<dn:data xmlns:dn="http://www.datanomic.com/2008/dnx">
<dn:record skip="true">
<dn:value name="Id" type="string"/>
<dn:value name="FirstName" type="string"/>
<dn:value name="LastName" type="string"/>
<dn:value name="DateOfBirth" type="date"/>
<dn:value name="Height" type="number"/>
<dn:value name="Weight" type="number"/>
</dn:record>
<dn:record>
<dn:value name="Id">1</dn:value>
<dn:value name="FirstName">Fred</dn:value>
<dn:value name="LastName">Bloggs</dn:value>
<dn:value name="DateOfBirth">1972-01-31</dn:value>
<dn:value name="Height">1.85</dn:value>
<dn:value name="Weight">85</dn:value>
</dn:record>
<dn:record>
<dn:value name="Id">2</dn:value>
<dn:value name="FirstName">Jane</dn:value>
<dn:value name="LastName">Smith</dn:value>
<dn:value name="DateOfBirth">1985-07-16</dn:value>
<dn:value name="Height">1.65</dn:value>
<dn:value name="Weight">63</dn:value>
</dn:record>
</dn:data>

これは、7.1項「単純なXMLデータ・ストアの使用」の例に対応する同等のDN-XMLです。

DN-XMLでは、EDQ属性名が単純なXMLとは異なる方法で定義されていることに注意してください。DN-XMLでは、属性の内容を使用してEDQ属性名を指定するため、名前に空白などの特殊文字を含むEDQ属性を作成することが可能です。

前の例では、<dn:record skip="true"> XML要素とその内容によって、フィールド名とそのデータ型を含むソースの構造を定義しています。他のすべてのレコード要素では、EDQのデータの行を定義しています。これは、カンマ区切りの値ファイルにおけるヘッダー行に似ています。使用できるデータ型は次のとおりです。

- string

- date

- number

注意:
DN-XMLファイルの日付値は、XSD日付書式(ISO 8601)で指定する必要があります。たとえば、'2008-10-31T15:07:38.6875000-05:00'とするか、時間の構成要素なしで単に'2008-10-31'とします。

データ・レコード内で、値要素はレコードのEDQ属性値を指定するために使用します。名前属性は、目的のEDQ属性を指定するために使用し、属性のテキスト・コンテンツでそのEDQ属性の値を指定します。たとえば、XMLフラグメントの<dn:value name="FirstName">Fred</dn:value>は、値'Fred'をEDQ属性の'FirstName'に割り当てます。

EDQでDN-XMLファイルを読み取るには、XMLおよびスタイルシート・データ・ストアを作成して、XMLソース・ファイルの場所を指定します(「XSLTファイル」オプションは空白のままにします)。

同様に、EDQでDN-XMLファイルを書き込むには、XSLTオプションを空白のままにして、データをXMLおよびスタイルシート・データ・ストアにエクスポートします。

7.2.2 カスタムXMLファイルの読取り

カスタムXMLスタイルシート(XSLT)を使用してデータ・スナップショット時にカスタム・スキーマからDN-XMLスキーマに変換するように構成されたXMLおよびスタイルシート・データ・ストアを使用して、カスタム形式のXMLファイルをEDQで読み取ることができます。

次に、EDQで読み取ることができるカスタムXMLファイルの例を示します。

<crmdata>
<contacts>
<contact id="1">
<name>
<firstname>Fred</firstname>
<surname>Bloggs</surname>
</name>
<dob>1972-01-31</dob>
<properties>
<property name="height" value="1.85"/>
<property name="weight" value="85"/>
</properties>
</contact>
<contact id="2">
<name>
<firstname>Jane</firstname>
<surname>Smith</surname>
</name>
<dob>1985-07-16</dob>
<properties>
<property name="height" value="1.68"/>
<property name="weight" value="63"/>
</properties>
</contact>
<contacts>
</crmdata>

次のXMLスタイルシートは、前述の例のカスタムXMLを適切なDN-XML形式に変換する1つの方法を示しています。

<xsl:stylesheet version="1.0" xmlns:dn="http://www.datanomic.com/2008/dnx"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:fn="http://www.w3.org/2005/02/xpath-functions">

<xsl:output method="xml"/>

<xsl:template match="/">
<dn:data>

<!-- Write out the header record -->
<dn:record skip="true">
<dn:value name="Id" type="string"/>
<dn:value name="FirstName" type="string"/>
<dn:value name="LastName" type="string"/>
<dn:value name="DateOfBirth" type="date"/>
<dn:value name="Height" type="number"/>
<dn:value name="Weight" type="number"/>
</dn:record>

<!-- Get each contact record -->
<xsl:apply-templates select="/crmdata/contacts/contact"/>

</dn:data>
</xsl:template>

<xsl:template match="contact">

<!-- Write out a data record -->
<dn:record>
<dn:value name="Id"><xsl:value-of select="@id"/></dn:value>
<dn:value name="FirstName"><xsl:value-of select="name/firstname"/></dn:value>
<dn:value name="LastName"><xsl:value-of select="name/surname"/></dn:value>
<dn:value name="DateOfBirth"><xsl:value-of select="dob"/></dn:value>
<dn:value name="Height">
<xsl:value-of select="properties/property[@name='height']/@value"/>
</dn:value>
<dn:value name="Weight">
<xsl:value-of select="properties/property[@name='weight']/@value"/>
</dn:value>
</dn:record>

</xsl:template>

</xsl:stylesheet>

7.2.2.1 データ・ストアの構成

EDQでデータを読み取るには、XMLおよびスタイルシート・データ・ストアを作成して、XMLソース・ファイルおよびXSLTファイル(スタイルシート)の場所を指定します。

EDQは、レコード境界でファイルを分割し、チャンク単位で効率的にソースXMLファイルを読み取ります。デフォルトで、EDQは、レコード要素としてルートの直下にある要素を使用します。ソースXMLファイルでこれを適用できない場合、ルートからレコード要素に対するXPath-style式を指定する必要があります。

7.2.3 カスタムXMLファイルの書込み

カスタムXSLTを使用してデータ・エクスポート時にDN-XMLスキーマからカスタム・ターゲット・スキーマに変換するように構成されたXMLおよびスタイルシート・データ・ストアを使用して、カスタム形式のXMLファイルをEDQで書き込むことができます。

次に、EDQで生成する必要のあるターゲットのカスタムXML形式の例を示します。

<Report>
<Person Id="1" FullName="Fred Bloggs"/>
<Person Id="2" FullName="Jane Smith"/>
</Report>

次のXMLスタイルシートは、DN-XML形式をターゲットのカスタムXML形式に変換する1つの方法を示しています。

<xsl:stylesheet version="1.0"
xmlns:dn="http://www.datanomic.com/2008/dnx"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:fn="http://www.w3.org/2005/02/xpath-functions">

<xsl:output method="xml"/>

<xsl:template match="/">
<Report>
<xsl:apply-templates select="/dn:data/dn:record"/>
</Report>
</xsl:template>

<xsl:template match="dn:record">
<Person>
<xsl:attribute name="Id">
<xsl:value-of select="dn:value[@name = 'Id']"/>
</xsl:attribute>
<xsl:attribute name="FullName">
<xsl:value-of select="dn:value[@name = 'FirstName']"/>
<xsl:text> </xsl:text>
<xsl:value-of select="dn:value[@name = 'LastName']"/>
</xsl:attribute>
</Person>
</xsl:template>

</xsl:stylesheet>

7.2.3.1 データ・ストアの構成

EDQでデータを書き込むには、XMLおよびスタイルシート・データ・ストアを作成して、カスタムXMLファイルおよびXSLT (スタイルシート)ファイルの宛先を指定します。

8 EDQ構成APIの使用

EDQには、希望するプログラミング言語を使用して様々な構成タスクをプログラム的に実行できるRESTベースのインタフェースのセットが用意されています。

この章では、EDQサービスが次の場所にインストールされていると仮定します。

http://edqserver:8001/edq

この章では、これらのインタフェースと、そのインタフェースを使用して実行できる操作について詳細に説明します。次のトピックが含まれています:

- プロジェクト用のRESTインタフェース

- データ・ストア用のRESTインタフェース

- スナップショット用のRESTインタフェース

- プロセス用のRESTインタフェース

- ジョブ用のRESTインタフェース

- 参照データ用のRESTインタフェース

- Webサービス用のRESTインタフェース

- 例: 外部アプリケーションによるプロファイリング

8.1 プロジェクト用のRESTインタフェース

EDQプロジェクトを操作するためのRESTインタフェースは、次のとおりです

http://edqserver:8001/edq/config/projects

このインタフェースでは、次のタスクを実行できます。

- EDQプロジェクトのリストの取得

- プロジェクトの作成

- プロジェクトの削除

8.1.1 EDQプロジェクトのリストの取得

現在のEDQインストールで使用可能なすべてのプロジェクトのリストを取得するには、次のコードに示すとおり、EDQプロジェクト用のRESTインタフェースでHTTP GET操作を実行する必要があります。

GET http://edqserver:8001/edq/config/projects

このコードが正常に実行されると、次のようにプロジェクトのリストがJSON形式で生成されます。

[
{
"id":10,
"name":"My Project"
},
{
"id":12,
"name":"Scratch Project"
}
]

8.1.2 プロジェクトの作成

新しいプロジェクトを作成するには、作成対象のプロジェクトを記述するJSONオブジェクトを作成し、HTTP POSTを使用してRESTコールのリクエスト本体でそれを送信する必要があります。

次に例を示します。

POST http://edqserver:8001/edq/config/projects

{ "name" : "Profile Customer Names" ,
"description" : "Profile my customers" }

このコードでは、次のようなレスポンス本体とともに"OK"タイプのレスポンスが戻されます。

{"id":14,"name":"Profile Customer Names"}

ただし、プロジェクトの作成中にエラーが発生すると、次のようなエラー・メッセージとともに"500 Internal Server Error"タイプのレスポンスが生成されます。

"Profile Customer Names" already exists (Code: 205,130)

8.1.3 プロジェクトの削除

プロジェクトを削除するには、RESTインタフェースでHTTP DELETEをコールし、問合せパラメータとして削除対象のプロジェクトを指定する必要があります。

削除対象のプロジェクトを指定するには、次の2つの方法があります。

- pid=<NN>を使用したIDによる方法

- pname=<Name>を使用した名前による方法

IDを使用してプロジェクトを削除するには、次のようにします。

DELETE http://edqserver:8001/edq/config/projects?pid=14

名前を使用してプロジェクトを削除するには、次のようにします。

DELETE http://edqserver:8001/edq/config/projects?pname=Profile%20Customer%20Names

どちらの方法でも、結果は次のように文字列になります。

Project Profile Customer Names deleted

無効なプロジェクトが指定されると、次のように適切な文字列メッセージとともに406 'Not Acceptable'タイプのレスポンスが戻されます。

Bad project ID "14" (Code: 205,454)

または

No project named "Profile Customer Names" (Code: 205,453)

8.2 データ・ストア用のRESTインタフェース

次のインタフェースを使用して、EDQのデータ・ストアを問い合せて操作できます。

http://edqserver:8001/edq/config/datasources

このインタフェースでは、次のタスクを実行できます。

- データ・ストアのリストの取得

- データ・ストアの作成

- データ・ストアの削除

8.2.1 データ・ストアのリストの取得

データ・ストアのリストを取得するには、有効なプロジェクト名を使用してインタフェースをコールします。

次に例を示します。

GET http://edqserver:8001/edq/config/datasources?pid=14

成功すると、レスポンス本体のデータ・ストアのリストとともにOKレスポンスが戻されます。

次に例を示します。

[
{
"client":false,
"id":36,
"name":"Individuals",
"properties":[
{
"name":"quote",
"value":"\""
},
{
"name":"encoding",
"value":"ISO-8859-1"
},
{
"name":"file",
"value":"Customer/customerindividuals.csv"
},
{
"name":"cols",
"value":""
},
{
"name":"project",
"value":"59"
},
{
"name":"hdr",
"value":"1"
},
{
"name":"usepr",
"value":"0"
},
{
"name":"skip",
"value":""
},
{
"name":"sep",
"value":","
}
],
"species":"servertxt"
}
]

8.2.2 データ・ストアの作成

データ・ストアを作成するには、データ・ストアを記述するJSONオブジェクトを作成し、データ・ストアを所有するプロジェクトを名前またはIDで指定してそれをエンドポイントに送信(POST)する必要があります。

次に例を示します。

ランディング領域に配置されたサーバーベースの.csvファイル。

POST http://edqserver:8001/edq/config/datasources?pid=14

{
"client":false,
"name":"Individuals",
"properties":[
{
"name":"quote",
"value":"\""
},
{
"name":"encoding",
"value":"ISO-8859-1"
},
{
"name":"file",
"value":"Customer/customerindividuals.csv"
},
{
"name":"hdr",
"value":"1"
},
{
"name":"usepr",
"value":"0"
},
{
"name":"sep",
"value":","
}
],
"species":"servertxt"
}

サーバーベースのOracleスキーマ:

POST http://edqserver:8001/edq/config/datasources?pid=14

{
"client":false,
"name":"Staging",
"properties":[
{
"name":"service",
"value":"sid"
},
{
"name":"sid",
"value":"orcl"
},
{
"name":"user",
"value":"staging"
},
{
"name":"port",
"value":"1521"
},
{
"name":"password",
"value":"staging"
},
{
"name":"host",
"value":"localhost"
}
],
"species":"oracle"
}

成功すると、次の例に示すとおり、データ・ストアの名前およびIDとともにOKレスポンスが戻されます。

{"id":42,"name":"Staging"}

speciesパラメータの値は、プロジェクトで使用されるデータ・ストアのタイプに応じて異なります。たとえば、Oracle Databaseを使用している場合、speciesの値は"oracle"になります。各speciesパラメータには独自のプロパティ・セットがあります。

次の表は、speciesが"oracle"のプロパティを示しています。

プロパティ

タイプ

必須

説明

host

文字列

はい

データベースをホストするマシン

port

数値

はい

データベースのポート番号

sid

文字列

はい

データベース識別子

service

sidまたはsrvの選択

はい

前述のデータベース識別子がSIDであるかサービス(srv)名であるか

user

文字列

はい

ログインするユーザー

password

文字列

いいえ

ユーザーのパスワード

schema

文字列

いいえ

使用するスキーマ(通常は空のまま)

次の表は、speciesが"servertext"のプロパティを示しています。

プロパティ

タイプ

必須

説明

file

文字列

はい

ランディング領域のファイルの名前と場所

userpr

ブール

はい

プロジェクト固有のランディング領域の使用

hdr

ブール

はい

最初の行をヘッダーとして処理

sep

文字列

いいえ

フィールド・デリミタ

quote

選択

いいえ

引用符

cols

整数

いいえ

読み取る列の数

encoding

文字列

はい

テキストの文字エンコーディング

skip

整数

いいえ

開始時にスキップする行の数

注意:

ブール型では、falseの場合は0を、trueの場合は1を使用します。

引用符の値には、二重引用符として""\""、一重引用符として"'"、または空の値として""を指定する必要があります。

次の表は、speciesが"other" (JDBC接続を使用)のプロパティを示しています。

プロパティ

タイプ

必須

説明

driver

文字列

はい

JDBCドライバのJavaクラス

url

文字列

はい

データベースのアドレス

user

文字列

いいえ

ログインするユーザー

password

文字列

いいえ

ユーザーのパスワード

8.2.3 データ・ストアの削除

データ・ストアを削除するには、次のようにデータ・ストアIDを指定するか、有効なプロジェクト(名前またはIDで特定)とデータストア名を指定してエンドポイントでHTTP DELETEをコールします。

DELETE http://edqserver:8001/edq/config/datasources?id=42

または

DELETE http://edqserver:8001/edq/config/datasources?pid=14&name=Staging

削除に成功すると、レスポンス本体なしでOKレスポンスが戻されます。

8.3 スナップショット用のRESTインタフェース

スナップショット用のRESTインタフェースは、次のとおりです。

http://edqserver:8001/edq/config/snapshots

このダイアログを使用すると、次のタスクを実行できます。

- スナップショットのリストの取得

- スナップショットの作成

- スナップショットの削除

8.3.1 スナップショットのリストの取得

スナップショットのリストを取得するには、次のように有効なプロジェクトを指定します。

GET http://edqserver:8001/edq/config/snapshots?pid=14

または

GET http://edqserver:8001/edq/config/snapshots?pname=Profile%20Customer%20Names

成功すると、レスポンス本体のスナップショットのリストとともにOKレスポンスが戻されます。

次に例を示します。

[
{
"columns":[
"TITLE",
"FULLNAME",
"GIVENNAMES",
"FAMILYNAME",
"NAMETYPE",
"PRIMARYNAME",
"ADDRESS1",
"ADDRESS2",
"ADDRESS3",
"ADDRESS4",
"CITY",
"STATE",
"POSTALCODE"
],
"datasource":"Individuals",
"name":"Individuals",
"table":"customerindividuals.csv"
}
]

8.3.2 スナップショットの作成

スナップショットを作成するには、スナップショットを記述するJSONオブジェクトを作成し、作成先のプロジェクトを指定する必要があります。

次に例を示します。

POST http://edqserver:8001/edq/config/snapshots?pid=14

{
"name":"Individuals",
"description":"Customer data",
"datasource":"Individuals",
"table":"customerindividuals.csv",
"columns":[
"TITLE",
"FULLNAME",
"GIVENNAMES",
"FAMILYNAME",
"NAMETYPE",
"PRIMARYNAME",
"ADDRESS1",
"ADDRESS2",
"ADDRESS3",
"ADDRESS4",
"CITY",
"STATE",
"POSTALCODE"
],
"sampling":{
"number":100,
"offset":0,
"ordering":"ascending",
"count":"true"
}
}

成功すると、レスポンス本体のスナップショットIDとともにOKレスポンスが戻されます。

次に例を示します。

{"id":68,"name":"Individuals"}

8.3.3 スナップショットの削除

スナップショットを削除するには、スナップショットIDを指定するか、有効なプロジェクトとスナップショット名を指定する必要があります。

次に例を示します。

DELETE http://edqserver:8001/edq/config/snapshots?id=68

または

DELETE http://edqserver:8001/edq/config/snapshots?pid=14&name=Individuals

または

DELETE http://edqserver:8001/edq/config/snapshots?pname=Profile%20Customer%20Names&name=Individuals

指定したスナップショットの削除に成功すると、次のようなレスポンス本体の文字列メッセージとともにOKレスポンスが戻されます。

Snapshot Individuals deleted

8.4 プロセス用のRESTインタフェース

EDQプロセス用のインタフェースは次のとおりです。

http://edqserver:8001/edq/config/processes

このインタフェースを使用して、次のタスクを実行できます。

- プロセスのリストの取得

- プロセスの削除

次のサブレベル・インタフェースでは、単純なプロファイリング・プロセスを作成できます。

http://edqserver:8001/edq/config/processes/simpleprocess

詳細は、「単純なプロセスの作成」を参照してください。

8.4.1 プロセスのリストの取得

プロジェクトのプロセスのリストを取得するには、有効なプロジェクト名を使用してプロセス・インタフェースでHTTP GETをコールする必要があります。

例:

GET http://edqserver:8001/edq/config/processes?pid=14

または

GET http://edqserver:8001/edq/config/processes?pname=Profile%20Customer%20Names

プロセスのリストとともにOKレスポンスが戻されます。

例:

[{"name":"Profile Names","id":31}]

リクエストに失敗すると、エラーを説明するレスポンス本体の文字列とともに、404 'Not Found'または500 'Internal Server Error'というエラー・レスポンスが戻されます。

8.4.2 プロセスの削除

プロセスを削除するには、プロセスIDを指定するか、プロジェクトIDまたはプロジェクト名とプロセス名を指定します。次に例を示します。

DELETE http://edqserver:8001/edq/config/processes?id=31

または

DELETE http://edqserver:8001/edq/config/processes?pid=14&name=Profile%20Names

または

DELETE http://edqserver:8001/edq/config/processes?pname=Profile%20Customer%20Names&name=Profile%20Names

削除に成功すると、次の例に示すとおり、文字列メッセージおよびレスポンス本体とともにOKレスポンスが戻されます。

Process Profile Names deleted

削除に失敗すると、レスポンス文字列とともに次のエラーのいずれかが戻されます。

- 404 "Not Found"

- 500 "Internal Server Error"

8.4.3 単純なプロセスの作成

インタフェースでは、現在、単純なプロファイリング・プロセスの作成のみがサポートされます。単純なプロセスを作成するには、作成対象のプロセスを記述するJSONオブジェクトを作成し、作成先のプロジェクトを指定する必要があります。HTTP POST操作を使用して、この情報をインタフェースに送信します。

次に例を示します。

POST http://edqserver:8001/edq/config/processes/simpleprocess?pid=14
{
"name":"Profile Names",
"description":"Profile Individuals Names",
"reader":{
"name":"Read from Individuals",
"stageddata":"Individuals"
},
"processors":[
{
"name":"Do Quickstats",
"type":"dn:quickstatsprofiler",
"columnlist":[
"GivenNames",
"FamilyName"
]
},
{
"name":"Do Frequency Profiling",
"type":"dn:attributefrequencycountsprofiler"
}
]
}

単純なプロセスの作成に成功すると、レスポンス本体のプロセスの名前およびIDとともに、OKレスポンスが戻されます。

次に例を示します。

{"id":33,"name":"Profile Names"}

次の場合はエラー・レスポンスが生成されます。

- 404 'Not Found': プロジェクトが存在しない場合

- 400 'Bad Request': JSONオブジェクトの形式が不正な場合

- 500 'Internal Server Error': 作成中に、エラーを説明するレスポンス本体の文字列とともにサーバー・エラーが発生した場合。

次の表は、サポートされるプロセッサの完全なリストを示しています。

プロセッサ

タイプ

クイック統計プロファイラ

dn:quickstatsprofiler

データ型プロファイラ

dn:datatypesprofiler

最大/最小プロファイラ

dn:maxandminprofiler

長さプロファイラ

dn:lengthprofiler

レコード完全度プロファイラ

dn:recordcompletenessprofiler

文字プロファイラ

dn:characterprofiler

頻度プロファイラ

dn:attributefrequencycountsprofiler

パターン・プロファイラ

dn:attributepatternsprofiler

8.5 ジョブ用のRESTインタフェース

/config/jobsインタフェースでは、EDQジョブに対して次のタスクを実行できます。

- ジョブのリストの取得

- ジョブの削除

- 単純なジョブの作成

このインタフェースのURLは、次のようになります。

http://edqserver:8001/edq/config/jobs

もう1つのRESTインタフェース/jobsでは、次のタスクを実行できます。

- ジョブの実行

- 実行中のジョブの取消し

- ジョブのステータスの取得

- 実行中のすべてのジョブに関する詳細の取得

このインタフェースのURLは、次のようになります。

http://edqserver:8001/edq/jobs

8.5.1 ジョブのリストの取得

HTTP GETを使用してプロジェクトのジョブのリストを取得できます。問合せパラメータとして少なくとも1つのプロジェクト(2つ以上のプロジェクトも可)を指定する必要があります。

プロジェクトは、次の例に示すとおり、問合せパラメータのpidまたはpnameを使用して指定できます。

GET http://edqserver:8001/edq/config/jobs?pid=14

または

GET http://edqserver:8001/edq/config/jobs?pname=Profile%20Customer%20Names

この操作に対するレスポンスにより、次の例に示すとおり、特定のプロジェクトのすべてのジョブがリストされます。

[
{
"id":99,
"name":"Profile Names Job"
},
{
"id":98,
"name":"Profile Individuals Job"
}
]

8.5.2 ジョブの削除

ジョブを削除するには、有効なジョブIDを指定するか、有効なプロジェクト(問合せパラメータのいずれかを使用)と有効なジョブ名を指定する必要があります。

ジョブIDでジョブを削除するには、次のようにします。

DELETE http://edqserver:8001/edq/config/jobs?id=99

ジョブ名でジョブを削除するには、次のようにします。

DELETE http://edqserver:8001/edq/config/jobs?pid=14&name=Profile%20Names%20Job

または

DELETE http://edqserver:8001/edq/config/jobs?pname=Profile%20Customer%20Names&name=Profile%20Names%20Job

ジョブの削除に成功すると、削除を確認するメッセージが表示されます。

ジョブProfile Names Jobが削除されました

8.5.3 単純なジョブの作成

単純なジョブには、1つのフェーズと1つのプロセスが含まれます。単純なジョブを作成するには、そのジョブを所有する有効なプロジェクトを(問合せパラメータのいずれかを使用して)指定する必要があります。また、作成対象のジョブを記述するJSONオブジェクトも作成する必要があります。

次に例を示します。

POST http://edqserver:8001/edq/config/jobs/simplejob?pid=14
{
"name" : "Profile Names Job" ,
"process" : "Profile Names" ,
"description" : "Profile Customer Names"
"resultsdrilldown" : "none"
}

属性resultsdrilldownには、none、sample、limited、allのいずれかの値を使用できます。ただし、sampleとlimitedの値は、同じ意味です。

8.5.4 ジョブの実行

/jobs/runインタフェースでは、HTTP POSTを使用して、指定したジョブを実行できます。必須パラメータは、プロジェクト名またはプロジェクトIDとジョブ名です。オプションで、実行ラベルおよびオーバーライドを指定できます。

次の例は、プロジェクト"Profile Customer Name"の"Real-time Start All"というジョブを実行する際のインタフェースのURL表現を示しています。

POST http://edqserver:8001/edq/jobs/run

{
"project":"Profile Customer Name",
"job":"Real-time Start All",
"overrides":[
{
"name":"a",
"value":"b"
},
{
"name":"c",
"value":"d"
}
]
}

このリクエストに対するJSONレスポンスは、次のようになります。

{
"executionID": 2
"runeverywhere": false
}

この例では、ジョブ"Real-time Start All"により、"runeverywhere"の値がfalseとして返されているため、このジョブは1つの場所でのみ実行できます。このような場合、ジョブに対してexecutionIDが戻されます。このexecutionIDを使用して、ジョブを取り消したり、ジョブのステータスを問い合せることができます。

ただし、"runeverywhere"の値がtrueの場合、JSONレスポンスでは"jobtype"のみが戻されます。"runeverywhere"ジョブでは、取消しおよび問合せのコールはサポートされません。

8.5.5 実行中のジョブの取消し

実行中のジョブを取り消すには、HTTP POST操作を使用します。インタフェースのURLは、次のようになります。

POST http://edqserver:8001/edq/jobs/cancel

取消し対象のジョブのexecutionIDのみが必要です。次の例では、executionID 12のジョブの取消しを示します。

{
"executionID": 12,
"type" : "immediate"
}

"type"パラメータでは次のオプションを使用できます。

- immediate: このオプションは、可能なかぎり早くジョブを取り消します。

- keepresults: このオプションは、ジョブを取り消しますが、それまでに生成された結果は保持します。

- shutdown: このオプションは、Webサービスを実行しているジョブを取り消すか、停止するために使用します。

ジョブの取消しに成功すると、レスポンスは戻されません。取消しに失敗すると、"404 File Not Found"や"Internal Server Error"などのHTTPエラーが表示されます。

8.5.6 ジョブのステータスの取得

個々のジョブのステータスを取得するには、URLにexecutionIDを渡します。URLは次のようになります。

GET http://edqserver:8001/edq/jobs/status?xid=executionID

たとえば、ジョブ"Real-time Start All"の実行IDが14の場合、URLは次のようになります。

GET http://edqserver:8001/edq/jobs/status?xid=14

JSONレスポンスは次のようになります。

{   "complete": true,
"endtime": "2016-04-20T08:45:22+01:00",
"executionid": 14,
"job": "Real-time START ALL",
"project": "Profile Customer Name",
"server": "edqserver",
"starttime": "2016-04-20T08:44:48+01:00",
"status": "finished"}

この例で、"Real-time Start All"ジョブは、他のジョブを起動します。プロジェクトのすべてのジョブが起動されると、executionID 14のステータスは、finishedを示します。ただし、"Real-time Start All"ジョブによって起動されたジョブは、引き続きrunningのステータスを示すことがあります。

8.5.7 実行中のすべてのジョブに関する詳細の取得

プロジェクトで実行中のすべてのジョブのステータスは、次のようなURLで表現される/jobs/runningインタフェースを使用して取得できます。

GET http://edqserver:8001/edq/jobs/running

次の例では、JSON形式の出力を示します。

{
"complete": false,
"executionid": 4,
"job": "Real-time Individual Clean",
"project": "Profile Customer Name",
"server": "edqserver",
"starttime": "2016-04-19T10:05:30.74+01:00",
"status": "running"
},
{
"complete": false,
"executionid": 8,
"job": "Real-time Address Match",
"project": "Profile Customer Name",
"server": "edqserver",
"starttime": "2016-04-19T10:06:11.755+01:00",
"status": "running"
},
{
"complete": false,
"executionid": 5,
"job": "Real-time Entity Clean",
"project": "Profile Customer Name",
"server": "edqserver",
"starttime": "2016-04-19T10:05:32.778+01:00",
"status": "running"
},
{
"complete": false,
"executionid": 6,
"job": "Real-time Address Clean",
"project": "Profile Customer Name",
"server": "edqserver",
"starttime": "2016-04-19T10:05:32.782+01:00",
"status": "running"
}

オプションで、プロジェクト名、ジョブ名、実行ラベルなどの他の問合せパラメータを指定できます。実行ラベルのないジョブの場合、実行ラベル・パラメータを省略して、実行ラベルのない空のフィルタ・ジョブとして設定します。この場合のURLは、次のようになります。

/jobs/running?[project=project[&job=job][&runlabel=]

8.6 参照データ用のRESTインタフェース

参照データは、プロジェクト内に存在することも、システム・レベルのすべてのプロジェクトの外部に存在することもあります。システム・レベルの参照データを参照するには、プロジェクトIDを0に(pid=0)指定します。

参照データ用のインタフェースは、次のとおりです。

http://edqserver:8001/edq/config/referencedata

参照データのコンテンツ用のインタフェースは、次のとおりです。

http://edqserver:8001/edq/config/referencedata/contents

このインタフェースを使用して、次のタスクを実行できます。

- 参照データのリストの取得

- 参照データのコンテンツの取得

- 参照データの作成

- 参照データの削除

8.6.1 参照データのリストの取得

システム・レベルで定義されているすべての参照データのリストを取得するには、次のパラメータのいずれかを使用してプロジェクトを指定します。

pid = 0による方法:

GET http://edqserver:8001/edq/config/referencedata?pid=0

pnameによる方法:

GET http://edqserver:8001/edq/config/referencedata?pname=Profile%20Customer%20Names

参照データを表すJSONオブジェクトのリストが戻されます。出力は、次のようになります。

[
{
"activerows":2,
"category":"charactertokeymap",
"columns":[
{
"key":true,
"name":"Name",
"type":"STRING",
"unique":true
},
{
"name":"Value",
"type":"STRING",
"value":true
}
],
"id":39,
"name":"Tokens",
"totalrows":2
}
]

8.6.2 参照データのコンテンツの取得

参照データのコンテンツをリストするには、参照データのコンテンツ用のインタフェースを使用します。有効なプロジェクトを指定するか、システム・レベルではpid=0を使用する必要があります。

次に例を示します。

GET http://edqserver:8001/edq/config/referencedata/contents?pid=0&id=40

または

GET http://edqserver:8001/edq/config/referencedata/contents?pid=0&name=ShortNameMap

これにより、次のコード・スニペットに示すとおり、参照データの行に関する情報が戻されます。

{
"activerows":4,
"columns":[
{
"key":true,
"name":"ShortName",
"type":"STRING",
"unique":true,
"value":true
},
{
"key":true,
"name":"LongName",
"type":"STRING",
"value":true
}
],

"description":"Map short names to long names",
"id":43,
"name":"ShortNameMap",
"rows":[
{
"data":[
"Jeff",
"Jeffrey"
]
},
{
"data":[
"Jon",
"Jonathan"
]
}
],
"totalrows":4
}

8.6.3 参照データの作成

参照データを作成するには、参照データを記述するJSONオブジェクトを作成し、pid=0を指定するか(システム・レベルの場合)、有効なプロジェクト名を指定してそれをインタフェースに送信する必要があります。

次に例を示します。

POST
http://edqserver:8001/edq/config/referencedata?pname=Profile%20Customer%20Names

{
"name" : "ShortNameMap",
"description" : "Map short names to long names",
"columns":
[
{
"key": true,
"name": "ShortName",
"type": "STRING",
"unique": true,
"value": true
},
{
"key": true,
"name": "LongName",
"type": "STRING",
"value": true
}
],
"rows":
[
{
"data":
[
"Jeff",
"Jeffrey"
]
},
{
"data":
[
"Jon",
"Jonathan"
]
}
]
}

作成に成功すると、次のようなレスポンスが戻されます。

{"id":40,"name":"ShortNameMap"}

8.6.4 参照データの削除

参照データを削除するには、有効な参照データIDを指定するか、有効なプロジェクト(システム・レベルの場合はpid=0を含む)と有効な参照データ名を指定して、参照データ・インタフェースでHTTP DELETEをコールする必要があります。

参照データIDで削除するには、次のようにします。

DELETE http://edqserver:8001/edq/config/referencedata?id=40

参照データ名で削除するには、次のようにします。

DELETE http://edqserver:8001/edq/config/referencedata?pid=0&name=ShortNameMap

削除に成功すると、レスポンスで次のような文字列メッセージが戻されます。

Reference data ShortNameMap deleted

8.7 Webサービス用のRESTインタフェース

Webサービス用のインタフェースは、次のとおりです。

http://edqserver:8001/edq/config/webservices

これにより、それぞれ取得、送信または削除操作をコールして、次のタスクを実行できます。

- Webサービスのリストの取得

- Webサービスの作成または更新

- Webサービスの削除

8.7.1 Webサービスのリストの取得

Webサービス・インタフェースでHTTP GET操作を使用して、有効なプロジェクトに対して定義されたWebサービスのリストを取得できます。Webサービスのリストを取得するには、pidまたはpnameパラメータを使用して有効なプロジェクトを指定します。

次に例を示します。

GET http://edqserver:8001/edq/config/webservices?pid=14&pid=20

コールに成功すると、レスポンス本体の入力および出力インタフェースとともに、Webサービスのリストが戻されます。

[
{
"id":1,
"inputs":{
"attributes":[
{
"name":"Name",
"type":"STRING"
}
],
"multirecord":false
},
"name":"Long Names",
"outputs":{
"attributes":[
{
"name":"LongName",
"type":"STRING"
}
],
"multirecord":false
}
}
]

8.7.2 Webサービスの作成または更新

適切なJSONオブジェクトを作成してWebサービスを作成および更新し、Webサービス・インタフェースに送信(POST)できます。

Webサービスを作成するには、次の例に示すとおり、名前またはIDで有効なプロジェクトを指定する必要があります。

POST http://edqserver:8001/edq/config/webservices?pid=14

{
"name":"Name Gender",
"inputs":{
"attributes":[
{
"name":"Name",
"type":"STRING"
}
],
"multirecord":false
},
"outputs":{
"attributes":[
{
"name":"Gender",
"type":"STRING"
}
],
"multirecord":false
}
}

成功すると、Webサービスの名前とIDがレスポンス本体で戻されます。

例:

{"id":4,"name":"Name Gender"}

Webサービスを更新するには、構造が同一で、既存のWebサービスを識別するための追加のID属性が含まれるJSONオブジェクトが必要です。更新の場合、プロジェクトは指定しません。

例:

POST http://edqserver:8001/edq/config/webservices

{
"id":4,
"name":"Name Gender",
"inputs":{
"attributes":[
{
"name":"First Name",
"type":"STRING"
},
{
"name":"Last Name",
"type":"STRING"
}
],
"multirecord":false
},
"outputs":{
"attributes":[
{
"name":"Gender",
"type":"STRING"
}
],
"multirecord":false
}
}

成功すると、次の例に示すとおり、Webサービスの名前とIDがレスポンス本体で戻されます。

{"id":4,"name":"Name Gender"}

8.7.3 Webサービスの削除

Webサービスを削除するには、Webサービス・インタフェースでHTTP DELETEをコールします。WebサービスIDを指定するか、有効なプロジェクト(名前またはIDで特定)とWebサービス名を指定します。

次に例を示します。

DELETE http://edqserver:8001/edq/config/webservices?id=5

または

DELETE http://edqserver:8001/edq/config/webservices?pid=14&name=Name%20Gender

成功すると、レスポンス本体なしでOKレスポンスが戻されます。

8.8 例: 外部アプリケーションによるプロファイリング

EDQを使用して、外部アプリケーションでOracle Databaseの表のデータをプロファイリングする必要があるシナリオを検討します。この場合、RESTベースのAPIを使用してプログラム的にこの表をプロファイリングできます。この例では、CustomerDBデータベースのCUSTOMERS表を使用します。

プロファイリング・ジョブを生成してCUSTOMERS表に対して実行するには、次のタスクを実行します。

1. 次のURLを使用してプロジェクトを作成します。
POST http://edqserver:8001/edq/config/projects

プロジェクト名(pname)は、"Profile Customer"です。JSONコードは次のとおりです。

{
"name":"Profile Customer",
"description": "Profiling customers in the CUSTOMERS table"
}

2. 次のURLを使用してOracle DatabaseのCustomerDBを使用するデータ・ストアを作成します。
POST http://edqserver:8001/edq/config/datasources?pid=4

データ・ストアを作成するためのJSONコードの例は、次のとおりです。

{
"client":false,
"name":"CustomersDB",
"properties":[
{
"name":"service",
"value":"sid"
},
{
"name":"sid",
"value":"orcl"
},
{
"name":"user",
"value":"CRM"
},
{
"name":"port",
"value":"1521"
},
{
"name":"password",
"value":"welcome123"
},
{
"name":"host",
"value":"localhost"
}
],
"species":"oracle"
}

注意:
プロジェクト"Profile Customer"のpidまたはプロジェクトIDを確認するには、次のURLでHTTP GET操作を使用します。
GET http://edqserver:8001/edq/config/projects

3. 次のURLを使用してスナップショットを作成します。
POST http://edqserver:8001/edq/snapshots?pid=4

スナップショットを作成するためのJSONコードは、次のとおりです。

{
"name":"CustomersDB.Customers",
"description":"Customer details",
"datasource":"CustomersDB",
"table":"Customers",
"columns":[
"ID",
"FULLNAME",
"GIVENNAME",
"FAMILYNAME",
"Street",
"City",
"State",
"PostalCode",
"State",
"Phone",
"Cell",
"Work",
"eMail",
"DoB",
"Gender",
"Active",
"CreditLimit",
"StartDate",
"EndDate"
],
"sampling":{
"number":100,
"offset":0,
"ordering":"ascending",
"count":"true"
}
}

この結果は次のように表示されます。

{
"id": 85,
"name": "CustomersDB.Customers"
}

"CustomersDB.Customers"という名前のスナップショットが作成されます。

4. 次のURLを使用して単純なプロセスを作成します。
POST http://edqserver:8001/edq/config/processes/simpleprocess?pid=4

この例では、どちらも名前フィールドのみをプロファイリングするQuickstats ProfilerおよびFrequency Profilerで単純なプロセスを作成します。これを行うには、次のJSONの例を使用します。

{
"name":"Profile Names",
"description":"Profile Customer Names",
"reader":{
"name":"Read from Customers",
"stageddata":"Connection to Customers"
},
"processors":[
{
"name":"Do Quickstats",
"type":"dn:quickstatsprofiler",
"columnlist":[
"GIVENNAME",
"FAMILYNAME"
]
},
{
"name":"Do Frequency Profiling",
"type":"dn:attributefrequencycountsprofiler"
}
]
}

このリクエストに対するレスポンスは次のとおりです。

{
"id": 267,
"name": "Profile Names"
}

5. 次のURLを使用して単純なジョブを作成します。
POST http://edqserver:8001/edq/jobs/simplejob?pid=4

{
"name":"Profile Customer Job",
"process":"Profile Names",
"description":"Profiling Customer Names",
"resultsdrilldown":"none"
}

このリクエストに対するレスポンスは次のとおりです。

{
"id": 211,
"name": "Profile Customer Job"
}

6. 次のURLを使用してジョブを実行します。
POST http://edqserver:8001/edq/jobs/run

ジョブ"Profile Customer Job"を実行してからプロファイリング・プロセスを実行するためのJSONコードは、次のとおりです。

{
"project":"Profile Customer",
"job":"Profile Customer Job"
}

レスポンスは次のとおりです。

{
"executionID": 20,
"runeverywhere": false
}

このジョブの実行後、次のURLを使用してジョブの実行のステータスを確認できます。

GET http://edqserver:8001/edq/jobs/status?xid=20

このURLを実行すると、次のコードに示すとおり、ジョブのステータスが表示されます。

{
"complete": true,
"endtime": "2016-04-29T14:05:41+01:00",
"executionid": 1,
"job": "Profile Customer Job",
"project": "Profile Customer",
"server": "edq_server1",
"starttime": "2016-04-29T14:05:38+01:00",
"status": "finished"
}

必要な場合は、次のURLを使用してジョブを取り消すことができます。

POST http://edqserver:8001/edq/jobs/cancel

ジョブを取り消すJSONコードは、次のとおりです。

{
"executionID": 12345,
"type" : "immediate"
}

これにより、結果を保存することなく、ジョブは即座に取り消されます。"type"で使用できる他のオプションは、「実行中のジョブの取消し」を参照してください。

EDQディレクタにログインして、実行に成功したプロファイリング・ジョブの結果を表示するには、次のURLを使用します。

http://edqserver:8001/edq/blueprints/director/jnlp?projectid=1&processid=1&processornum=2

projectidとprocessidは同じで、対応するREST APIコールを使用して生成され、processornum値には2 (リーダー後の最初のプロセッサ)を設定します。

このURLにより、ジョブの最初のプロファイリング・プロセッサがフォーカスされたディレクタUIが表示されるため、その結果を即座に確認できます。

外部アプリケーションには、生成されたジョブを削除するオプションを含めて、関連する削除コールに対するコールを実行できます。この最も簡単なバージョンでは、プロジェクト全体を削除できます。プロジェクトの削除の詳細は、「プロジェクトの削除」を参照してください。

Oracleの法律上の注意点

コピーライト

Copyright © 1994-2017, Oracle and/or its affiliates. All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

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

保証免責

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

制限付権利について

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

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 Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

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およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

Pre-General Availability (一般提供前)版のドキュメントについて

このドキュメントがPre-General Availability (一般提供前)版の場合:

このドキュメントはPre-General Availability (一般提供前)版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のPre-General Availability (一般提供前)版のドキュメントについて

このドキュメントが非公開のPre-General Availability (一般提供前)版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のPre-General Availability Trial Agreement (Pre-GAトライアル契約)のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle Partner Network Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティ

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

Oracle Supportへのアクセス

サポートをご契約のお客様には、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)を参照してください。