Oracle® Data Miner

インストレーションおよび構成ガイド

リリース17.2

E89948-01(原本部品番号:E88345-01)

2017年6月

Oracle Data Minerインストレーションおよび管理ガイド、リリース17.2

E89948-01

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

原本著者: Moitreyee Hazarika

原本協力者: Alex Sakharov、Ari Mozes、Charlie Berger 、Denny Wong 、Dongfang Bai、Eros Espinola、Jim Dadashev、Gloria Castillo、Mark McCracken、Mark Kelly、Marat Spivak、Pedro Reta、Zabdiel Jaramillo Roman

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

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

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

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 Oracle Data Minerシステムの概要

- Oracle Data Minerのアーキテクチャ

- Oracle Data Minerリポジトリについて

- Oracle Data Minerで使用されるDatabaseの機能

- Oracle Data MinerとOracle Advanced Analytics

- データ・マイニングAPIについて

- データ・マイニングPL/SQLパッケージ

- データ・マイニングSQLスコアリング関数

- データ・マイニングのデータ・ディクショナリ・ビュー

- Oracle Data Minerの詳細を知るためのリソース

2 データベースのインストールによるOracle Data Minerのサポート

- Oracle Data Minerのデータベース要件

- Oracle TextとOracle Data Miner

- XML DBとOracle Data Miner

- Oracle Data Minerの記憶域構成

- Oracle Database 11.2.0.4以降のインストール

- Oracle Cloud Databaseスキーマへの接続

3 Oracle Data Minerのインストール

- Oracle Data Minerのインストールの概要

- Oracle Data Minerのサンプル・データについて

- SQL Developerのダウンロード

- スクリプトを使用したリポジトリのインストール

- スクリプトを使用したサンプル・データのロード

- SQL Developer GUIを使用したリポジトリのインストール

- JSONパーサーとデータ・ガイドのインストール

- JSONサポートをインストールするスクリプトについて

- JSONパーサーをインストールするスクリプトを実行するための前提条件

- リモート・データベースへのJSONパーサーのインストール

- データベース・ホスト上へのJSONパーサーのローカル・インストール

4 Oracle Data Minerユーザーの管理

- ユーザー・オブジェクトとリポジトリ・オブジェクトについて

- ユーザーのスキーマのサイズの制御

- Oracle Data Minerユーザーのスキーマ内のオブジェクト

- Oracle Data Minerの内部表について

- Oracle Data Minerのプロキシ・ユーザーについて

- JVMプロパティの設定

- Oracle Data Minerのアクセス・モデルの選択

- 単一ユーザー・アクセス

- 複数ユーザー・アクセス

- 共有ユーザー環境

- ドキュメント使用中条件について

- Oracle Data Minerリポジトリに対するアクセス権の付与と削除

- GUIを使用したアクセス権の付与

- スクリプトを使用したアクセス権の付与

- スクリプトを使用したアクセス権の削除

- データへのアクセスの付与

5 Oracle Data Minerリポジトリの管理

- Oracle Data Miner管理スクリプトについて

- Oracle Data Minerスクリプトのパスの設定

- リポジトリのステータスとバージョンの判定

- リポジトリのバックアップとリストア

- 全体バックアップとリストア

- Database 11.2.0.4以降のフル・バックアップおよびリストア

- ワークフローのみのバックアップ

- ワークフローのみのリストア

- ワークフローのみのリストアの例

- リポジトリの移行

- ODMRSYSのアップグレード

- リポジトリを移行するスクリプト

- 新しいODMRSYS表領域のオブジェクト・リレーショナルからバイナリへのアップグレード

- ODMRSYSのオブジェクト・リレーショナルからバイナリへのアップグレード

- リポジトリの削除

6 Oracle Data Minerのシステム・リソースの管理

- Oracle Data Minerのリソース管理の概要

- Oracle Data Minerユーザー・セッションへのリソースの割当て

- モデル構築の管理

- ワークフロー実行の管理

- パラレル処理の管理

- システム管理用のOracle Data Minerリポジトリ・プロパティのサマリー

7 SQLスクリプトの生成とデプロイ

- SQLスクリプト生成機能の概要

- SQLスクリプト生成ユースケースの概要

- SQLスクリプト生成ユースケースの前提

- デモ・ワークフロー・ファイルの場所

- サンプル・ワークフローについて

- 前提条件となるタスクの実行

- ワークフローのインポートと実行

- ワークフローからのSQLスクリプト・ファイルの生成

- 生成されたSQLスクリプト・ファイルのリスト

- スクリプト・ファイルの変数定義

- 制御表

- 制御表の構造

- 制御表の列

- ワークフロー・スクリプト・ファイルのスケジューリング

- ワークフロー・スクリプト・ファイルのスケジューリングの前提条件

- マスター・スクリプトへの完全なディレクトリ・パスの追加

- データベース・ホストとデータベース用の資格証明の作成

- SQL Developerを使用したSQLスクリプトのスケジュール

- データベース・ホストとデータベース用の資格証明の作成

- ジョブ・ウィザードを使用したSchedulerジョブの定義

- Oracle Enterprise Managerを使用したSQLスクリプトのスケジューリング

- ターゲット・データベースへのSQLスクリプトのデプロイ

- 制御表の問合せ

8 PL/SQL APIを使用したワークフローの管理

- PL/SQL APIについて

- PL/SQL API

- PROJECT_CREATE

- PROJECT_RENAME

- PROJECT_DELETE

- WF_RUN

- WF_RUNのパラメータ

- プロジェクト名、ワークフロー名およびノード名を伴うWF_RUN

- プロジェクト名、ワークフロー名、ノード名および時間間隔を伴うWF_RUN

- プロジェクトID、ワークフローID、ノードIDおよび時間間隔を伴うWF_RUN

- プロジェクトID、ワークフローIDおよびノードIDを伴うWF_RUN

- WF_STOP

- WF_RENAME

- WF_DELETE

- WF_IMPORT

- WF_EXPORT

- リポジトリ・ビュー

- ODMR_USER_PROJECT_WORKFLOW

- ODMR_USER_WORKFLOW_ALL

- ODMR_USER_WORKFLOW_LOG

- ODMR_USER_WORKFLOW_NODES

- ODMR_USER_WORKFLOW_MODELS

- ODMR_USER_WF_CLAS_TEST_RESULTS

- ODMR_USER_WF_REGR_TEST_RESULTS

- ODMR_USER_WF_TEST_RESULTS

- ODMR_USER_WORKFLOW_ALL_POLL

- PL/SQL APIのユースケース

- PL/SQLユースケースの前提

- APPLYワークフローをスケジュールおよび実行するユースケース

- スコアリング結果の問合せ

- 構築ワークフローをスケジュールおよび実行するユースケース

- MODEL_COEFFICIENT表の問合せ

- 名前付きオブジェクトの問合せ

- テスト結果の問合せ

A Oracle Data Minerのリリース

索引

はじめに

Oracle Data Minerインストレーションおよび管理ガイドでは、SQL Developerに付属するData Minerのスクリプトを使用して、Oracle DatabaseでData Minerリポジトリをインストールおよび管理する方法について説明します。

- 対象読者

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

- 関連ドキュメント

- 表記規則

対象読者

このマニュアルは、データベース管理者およびデータベース開発者を対象としています。

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

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 Databaseのオンライン・ドキュメント・ライブラリにある次の関連ドキュメントを参照してください。

Oracle Database 12cリリース2 (12.2)

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

- Oracle Data Minerユーザーズ・ガイド

- Oracle SQL Developerユーザーズ・ガイド

- Oracle Data Mining概要

- Oracle Data Miningユーザーズ・ガイド

- 『Oracle R Enterpriseユーザーズ・ガイド』

Oracle Database 12c リリース1(12.1)

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

- Oracle Data Minerユーザーズ・ガイド

- Oracle SQL Developerユーザーズ・ガイド

- Oracle Data Mining概要

- Oracle Data Miningユーザーズ・ガイド

- 『Oracle R Enterpriseユーザーズ・ガイド』

Oracle Database 11gリリース2(11.2)

- Oracle SQL Developerユーザーズ・ガイド

- Oracle Data Mining概要

- Oracle Data Miningユーザーズ・ガイド

- Oracle Data Mining APIガイド(仮想ブック)

- 『Oracle R Enterpriseインストレーションおよび管理ガイド』

- 『Oracle R Enterpriseユーザーズ・ガイド』

表記規則

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

規則

意味

太字

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

イタリック体

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

固定幅フォント

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

1 Oracle Data Minerシステムの概要

この章では、Oracle Data Minerと、Oracle Data Miningのプログラム的なインタフェースについて説明します。製品の詳細を知るためのリソースへのリンクも示します。

- Oracle Data Minerのアーキテクチャ
Oracle Data Minerは、Oracle SQL Developerの拡張機能であり、Oracle SQLのためのグラフィカルな開発環境です。

- Oracle Data Minerリポジトリについて
Oracle Data Minerには、データベース・サーバーにリポジトリとしてODMRSYSスキーマをインストールする必要があります。Oracle Data Minerユーザーには、ODMRSYSのオブジェクトにアクセスできる権限が必要です。

- Oracle Data Minerで使用されるDatabaseの機能
Oracle Data Minerは、Oracle Data Mining、Oracle XML DB、Oracle R Enterpriseなど多数のOracle Databaseの機能を使用します。

- Oracle Data MinerとOracle Advanced Analytics
Oracle Data Minerは、Oracle Databaseのデータ・マイニング・エンジンであるOracle Data Miningのグラフィカル・ユーザー・インタフェース(GUI)です。

- ータ・マイニングAPIについて
Oracle Data Minerは、Oracle DatabaseのData Mining APIに基づくアプリケーションです。

- Oacle Data Minerについて学ぶためのリソース
この項では、Oacle Data Minerのドキュメント、フォーラム、ブログ、トレーニング、チュートリアルなどのリソースを示します。

Oracle Data Minerのアーキテクチャ

Oracle Data Minerは、Oracle SQL Developerの拡張機能であり、Oracle SQLのためのグラフィカルな開発環境です。

Oracle Data Minerは、Oracle Databaseに組み込まれているデータ・マイニング技術を利用して、データ・マイニング操作をカプセル化したワークフローを作成、実行および管理します。ODMRSYSスキーマを専用のシステム・リポジトリとして使用します。

Oracle Data Minerのアーキテクチャを、図1-1に図式します。

図1-1 ビッグ・データ用のOracle Data Minerアーキテクチャ

Oracle Data Minerリポジトリについて

Oracle Data Minerには、データベース・サーバーにリポジトリとしてODMRSYSスキーマをインストールする必要があります。Oracle Data Minerユーザーには、ODMRSYSのオブジェクトにアクセスできる権限が必要です。

Oracle Data Minerリポジトリは、次のものを管理します。

- 記憶域: リポジトリには、このデータベースへの接続を確立したOracle Data Minerユーザーすべてのプロジェクトとワークフローが格納されます。

- ランタイム関数: リポジトリは、Oracle Data Minerのアプリケーション層です。ワークフローと、他のランタイム操作の実行を制御します。

Oracle Data Minerで使用されるDatabaseの機能

Oracle Data Minerは、Oracle Data Mining、Oracle XML DB、Oracle R Enterpriseなど多数のOracle Databaseの機能を使用します。

Oracle Data Minerは、Oracle Databaseの次の機能を使用します。

- Oracle Data Mining: Oracle Data Minerのモデル構築、テストおよびスコアリングの各機能を提供します。

- Oracle XML DB: Oracle Data Minerリポジトリのメタデータを管理します。

- Oracle Text: テキスト・マイニングをサポートします。

- Oracle Scheduler: ワークフローの実行をスケジュールします。

- Oracle R Enterprise: ユーザーが指定した埋め込みRスクリプトを実行します。

注意:

Oracle R Enterpriseを除き、これらの機能はすべてOracle Database Enterprise Editionにデフォルトで含まれています。Oracle R Enterpriseには追加のインストール手順が必要です。

関連項目

- 『Oracle XML DB開発者ガイド』

- 『Oracle Textアプリケーション開発者ガイド』

- Oracle Database管理者ガイド

- 『Oracle R Enterpriseインストレーションおよび管理ガイド』

Oracle Data MinerとOracle Advanced Analytics

Oracle Data Minerは、Oracle Databaseのデータ・マイニング・エンジンであるOracle Data Miningのグラフィカル・ユーザー・インタフェース(GUI)です。

Oracle Data Miningは、Oracle Database Enterprise EditionのオプションであるOracle Advanced Analyticsの構成要素です。

Oracle Advanced Analyticsのコンポーネント:

- Oracle Data Mining (Oracle Data Minerで必須)
Oracle Data Miningは、Oracle Databaseのカーネルに組み込まれている強力なデータ・マイニング・エンジンです。Oracle Data Miningでは、分類、回帰、クラスタリング、特徴選択、特徴抽出および関連付け(マーケット・バスケット分析)のアルゴリズムがサポートされています。Data Mining PL/SQLのアプリケーション・プログラミング・インタフェース(API)は、データの準備と作成、評価を実行し、マイニング・モデルを保持します。Data MiningのSQLファンクションは、マイニング・モデルまたは予測問合せを使用してデータをスコアリングします。

- Oracle R Enterprise (Oracle Data Minerで必須ではない)
Oracle Data Minerは、Oracle R Enterpriseを限定的にサポートします。ユーザーが、Oracle Data MinerのSQL問合せノードに埋め込みRを含むスクリプトを指定する場合、Oracle Data MinerはOracle R Enterpriseを使用してスクリプトを実行します。

Oracle R Enterpriseは、オープン・ソースのR統計プログラミング言語および環境をOracle Databaseに統合します。Oracle R Enterpriseでは透過層がサポートされるため、RはOracleデータと埋め込みRの実行を透過的に扱うことができ、結果的にデータベースでRスクリプトの実行が可能になります。

関連項目

- Oracle Data Mining概要

- 『Oracle R Enterpriseユーザーズ・ガイド』

データ・マイニングAPIについて

Oracle Data Minerは、Oracle DatabaseのData Mining APIに基づくアプリケーションです。

このAPIは公開されているので、直接アプリケーション開発に利用することができます。このAPIは、次のトピックでまとめています。

- データ・マイニングPL/SQLパッケージ
PL/SQL APIは、マイニング・モデルを操作します。これはデータベース・スキーマ・オブジェクトです。

- データ・マイニングSQLスコアリング関数
特殊化した一連のSQLファンクションには、Oracle Data Miningでデータをスコアリングする主要なメカニズムが用意されています。単一行のファンクションとして呼び出した場合、SQL Data Miningファンクションはユーザー指定のマイニング・モデルを入力データの各行に適用します。

- データ・マイニングのデータ・ディクショナリ・ビュー
データ・ディクショナリ・ビューは、Oracle Databaseシステム・カタログに、マイニング・モデルに関する情報を格納します。すべてのビューは、DBA、USERおよびALLアクセス権で使用できます。

データ・マイニングPL/SQLパッケージ

PL/SQL APIは、マイニング・モデルを操作します。これはデータベース・スキーマ・オブジェクトです。

表1-1に、PL/SQLパッケージとその説明をリストします。

表1-1 Oracle Data Mining PL/SQLパッケージ

パッケージ

説明

DBMS_DATA_MINING

マイニング・モデルを管理するDDLプロシージャ。

マイニング・モデルの設定。

マイニング・モデル、マイニング・モデルを問い合せるファンクション、およびバッチ・スコアリングに使用するAPPLYプロシージャをテストするプロシージャ。

DBMS_DATA_MINING_TRANSFORM

変換式を指定し、データの列に変換を適用するプロシージャ。

変換は、モデル構築プロセスに渡して、モデル定義に組み込まれるか、外部のデータ・ビューに適用することができます。

DBMS_PREDICTIVE_ANALYTICS

ユーザー作成のマイニング・モデルを使用せずに予測、説明、プロファイル操作を実行するプロシージャ。

注意:

DBMS_PREDICTIVE_ANALYTICSパッケージにおけるマイニング操作は、Oracle Data Minerのコード・スニペットで使用できます。

関連項目

- Oracle Data Minerユーザーズ・ガイド

- Oracle Database PL/SQLパッケージ・プロシージャおよびタイプ・リファレンス

データ・マイニングSQLスコアリング関数

特殊化した一連のSQLファンクションには、Oracle Data Miningでデータをスコアリングする主要なメカニズムが用意されています。単一行のファンクションとして呼び出した場合、SQL Data Miningファンクションはユーザー指定のマイニング・モデルを入力データの各行に適用します。

Oracle Database 12cでは、ファンクションを分析ファンクションとして呼び出すこともでき、アルゴリズム処理はユーザー指定のマイニング・モデルを使用せず動的に実行されます。「予測問合せ」という用語は、このモードのスコアリングを意味しています。

表1-2 データ・マイニングSQLスコアリング関数

関数名

関数の説明

CLUSTER_DETAILS

入力データの各行についてクラスタ詳細を戻す。

CLUSTER_DISTANCE

各行と重心との距離を戻す。

CLUSTER_ID

各行について最も確率の高いクラスタのIDを戻す。

CLUSTER_PROBABILITY

各行について最も確率の高いクラスタを戻す。

CLUSTER_SET

各行について一連のクラスタIDとその確率とのペアを戻す。

FEATURE_COMPARE

キーワード・フレーズなどの短いものを含む2つの異なるドキュメントまたは2つの属性リストを比較して、類似点または相違点を調べる。

FEATURE_DETAILS

各行について一連のファンクションと値のペアを戻す。

FEATURE_ID

入力データの各行について機能の詳細を戻す。

FEATURE_SET

各行について一連の機能IDと機能値とのペアを戻す。

FEATURE_VALUE

各行について最も値の大きい機能の値を戻す。

PREDICTION

入力の各行について予測を戻す。

PREDICTION_BOUNDS

各行について予測の上限と下限を戻す(GLMのみ)。

PREDICTION_COST

各行のコストを戻す。

PREDICTION_DETAILS

各行について予測の詳細を戻す。

PREDICTION_PROBABILITY

各予測の確率を戻す。

PREDICTION_SET

各行について、確率の予測またはコストを戻す。

注意:

SQLスコアリング・ファンクションは、Oracle Data Minerのコード・スニペットで使用できます。

関連項目

- Oracle Data Minerユーザーズ・ガイド

- Oracle Database SQL言語リファレンス

- Oracle Data Miningユーザーズ・ガイド

データ・マイニングのデータ・ディクショナリ・ビュー

データ・ディクショナリ・ビューは、Oracle Databaseシステム・カタログに、マイニング・モデルに関する情報を格納します。すべてのビューは、DBA、USERおよびALLアクセス権で使用できます。

表1-3に、データ・マイニングのデータ・ディクショナリ・ビューとその説明をリストします。

表1-3 Data Miningデータ・ディクショナリ・ビュー

ビュー名

説明

ALL_MINING_MODELS

アクセス可能なすべてのマイニング・モデルに関する情報を示します。

ALL_MINING_MODEL_ATTRIBUTES

アクセスできるすべてのマイニング・モデルの属性に関する情報を提供する。

ALL_MINING_MODEL_SETTINGS

アクセスできるすべてのマイニング・モデルの設定に関する情報を提供する。

ALL_MINING_MODEL_PARTITIONS

ユーザーがアクセスできるすべてのモデル・パーティションを提供する。

ALL_MINING_MODEL_VIEWS

ユーザー独自のモデル・ビューの説明を示す。このビューの列はOWNERを除き、ALL_MINING_MODEL_VIEWSの列と同じである。

ALL_MINING_MODEL_XFORMS

ユーザーがアクセスできるすべてのモデルに埋め込まれたユーザー指定変換を提供する。

関連項目

- Oracle Databaseリファレンス

Oracle Data Minerの詳細を知るためのリソース

この項では、Oacle Data Minerのドキュメント、フォーラム、ブログ、トレーニング、チュートリアルなどのリソースを示します。

- Oracle Data Minerのドキュメント

- Oracle Data Minerユーザーズ・ガイド

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

- Oracle Data Minerオンライン・ヘルプ

- Oracle Data Mining 12.2のドキュメント

- Oracle Data Mining概要

- Oracle Data Miningユーザーズ・ガイド

- Oracle Data Mining 12.1のドキュメント

- Oracle Data Mining概要

- Oracle Data Miningユーザーズ・ガイド

- チュートリアル

- Oracle Data Mining 4.1 OBE (Oracle By Example)

- Oracle Data Mining 4.0 OBE (Oracle By Example)

- Oracle Data Miner 4.1におけるテキスト・マイニング

- Oracle Data Miner 4.1を使用するスター・スキーマ

- Oracle Data Mining Forum

- Oracle Data Miningブログ

- Oracle Technology Network - Data Mining

2 データベースのインストールによるOracle Data Minerのサポート

この章では、Oracle Data MinerをサポートするOracle Databaseのインストールおよび構成方法について説明します。

- Oracle Data Minerのデータベース要件
Oracle Data Miner 17.2には、Oracle Database Enterprise EditionまたはPersonal Editionの11.2.0.4以降が必要です。

- Oracle TextとOracle Data Miner
Oracle Data Minerは、Oracle Textを利用してテキスト・マイニングをサポートします。Oracle Textは、Oracle Database Enterprise Editionにデフォルトで付属しており、Oracle Data Minerのインストールに必須です。

- XML DBとOracle Data Miner
Oracle Data Minerは、XML DBを使用して、ワークフローをOracle Data Minerリポジトリに格納します。XML DBは通常、Oracle Database Enterprise Editionにデフォルトで付属しており、Oracle Data Minerのインストールに必須です。

- Oracle Data Minerの記憶域構成
Oracle Data Minerで使用される記憶域の形式は、データベースのバージョンによって異なります。

- Oracle Database 11.2.0.4以降のインストール
Oracle Databaseをインストールするには、ご使用のプラットフォームのインストール手順およびその他のすべての手順に従ってください。

- Oracle Cloud Databaseスキーマへの接続
SQL DeveloperインターフェイスからOracle Cloud Databaseスキーマに接続できます。

Oracle Data Minerのデータベース要件

Oracle Data Miner 17.2には、Oracle Database Enterprise EditionまたはPersonal Editionの11.2.0.4以上が必要です。

データベースがこの要件を満たしているかどうかを確認するには、database_compatible_level設定を問い合せます。この値が11.2以上である必要があります。

SELECT VALUE FROM database_compatible_level;

注意:

Oracle Data Miner 17.2の一部の機能には、Oracle Database 12.2が必要です。

表2-1に、Oracle Data Minerに関するデータベースのインストールおよび構成の要件を示します。

表2-1 Oracle Data Minerのデータベース要件チェックリスト

機能

要件

詳細な情報へのリンク

データベースのバージョン

11.2.0.4以上

Oracle Database 11.2.0.4以降のインストール

Oracle Advanced Analytics

Oracle Data Minerのインストールに必要。

Oracle Data MinerとOracle Advanced Analytics

Oracle Text

Oracle Data Minerのインストールに必要

Oracle TextとOracle Data Miner

XML DB

Oracle Data Minerのインストールに必要

XML DBとOracle Data Miner

記憶域構成

データベースのバージョンにより、バイナリXML記憶域またはオブジェクト・リレーショナル記憶域に構成が必要

Oracle Data Minerの記憶域構成

AL32UTF8キャラクタ・セット

マルチバイト文字データや、その他のデータ形式に必要

データベースは、AL32UTF8をサポートするように構成することを推奨

Oracle Database 12.2: Oracle Databaseグローバリゼーション・サポート・ガイド

Oracle Database 12.1: Oracle Databaseグローバリゼーション・サポート・ガイド

Oracle R Enterprise

Oracle Data MinerのSQL問合せノードで埋め込みRスクリプトの実行に必要

『Oracle R Enterpriseインストレーションおよび管理ガイド』

Oracle Database Examples

Oracle Data Minerのサンプル・データに必要Oracle Textのナレッジ・ベースで必要になる可能性あり

Oracle Database 12.2: Oracle Database Examplesインストレーション・ガイド

Oracle Database 12.1: Oracle Database Examplesインストレーション・ガイド

サンプル・スキーマ

Oracle Data Minerの一部のサンプル・データに必要

Oracle Database 12.2: SHサンプル・スキーマはOracle Database 12.2には付属していません。サンプル・データをインストールするには、Oracle Databaseサンプル・スキーマに移動します

Oracle Database 12.1: Oracle Databaseサンプル・スキーマ

関連項目

- Oracle Data Minerで使用されるDatabaseの機能

Oracle TextとOracle Data Miner

Oracle Data Minerは、Oracle Textを利用してテキスト・マイニングをサポートします。Oracle Textは、Oracle Database Enterprise Editionにデフォルトで付属しており、Oracle Data Minerのインストールに必須です。

テキスト変換中のテーマ生成をサポートするには、Oracle Textナレッジ・ベースが必要です。Oracle Textのこの機能をサポートする場合、Oracle Databaseでデフォルトでは使用できず、Oracle Database Examplesのインストールで入手できます。Oracle Textナレッジ・ベースは、英語とフランス語で使用できます。

関連項目

- 『Oracle Textアプリケーション開発者ガイド』

- 『Oracle Textリファレンス』

- Oracle Database Examplesインストレーション・ガイド

XML DBとOracle Data Miner

Oracle Data Minerは、XML DBを使用して、ワークフローをOracle Data Minerリポジトリに格納します。XML DBは通常、Oracle Database Enterprise Editionにデフォルトで付属しており、Oracle Data Minerのインストールに必須です。

XML DBがデータベースに存在するかどうかを確認する、あるいはXML DBを手動でインストールする手順は、『Oracle XML DB開発者ガイド』を参照してください

Oracle Data Minerリポジトリにあるワークフロー・ドキュメントは、XMLType型であり、これは次の記憶域モデルを提供する抽象データ型です。

- オブジェクト・リレーショナル記憶域: XMLTypeデータは、一連のオブジェクトとして格納されます。

- バイナリXML記憶域: XMLTypeデータは、XMLデータ専用に設計された事後解析のバイナリ形式で格納されます。

Oracle Data Minerは以前のバージョンのOracle Databaseではオブジェクト・リレーショナル記憶域を使用し、一定のバージョン以降ではバイナリXML記憶域を使用します。

関連項目

- 『Oracle XML DB開発者ガイド』

Oracle Data Minerの記憶域構成

Oracle Data Minerで使用される記憶域の形式は、データベースのバージョンによって異なります。

Oracle Database 11.2.0.4以上では、Oracle Data MinerはバイナリXML記憶域を使用します。

バイナリ記憶域では、200MBの表領域割当てに、およそ1000の適度に複雑なワークフロー(およそ35のノード)を格納できます。バイナリ記憶域を使用するには、ODMRSYSを、Automatic Segment Space Management (ASSM)で管理される表領域に作成する必要があります。

次の文は、Oracle ASSM表領域の作成方法を示しています。

CREATE TABLESPACE DMUSER_AUTO DATAFILE 'DMUSER_AUTO.dat' size 20m
autoextend on next 32m maxsize UNLIMITED extent management local
AUTOALLOCATE SEGMENT SPACE MANAGEMENT AUTO;

関連項目

- Oracle Database管理者ガイド

Oracle Database 11.2.0.4以降のインストール

Oracle Databaseをインストールするには、ご使用のプラットフォームのインストール手順およびその他のすべての手順に従ってください。

インストール手順およびその他のすべての手順は、「Oracle Data Minerのデータベース要件」で指定されています。

一部のOracle Databaseインストレーション・ガイドのリストを次に示します。

- Linux:

- Oracle Database 12.2: Oracle Databaseインストレーション・ガイドfor Linux

- Oracle Database 12.1:Oracle Databaseインストレーション・ガイドfor Linux

- Oracle Database 11.2.0.4: Oracle Databaseインストレーション・ガイドfor Linux

- Oracle Solaris:

- Oracle Database 12.2: Oracle Databaseインストレーション・ガイドfor Oracle Solaris

- Oracle Database 12.1: Oracle Databaseインストレーション・ガイドfor Oracle Solaris

- Oracle Database 11.2: Oracle Databaseインストレーション・ガイドfor Oracle Solaris

- Microsoft Windows:

- Oracle Database 12.2: Oracle Databaseインストレーション・ガイドfor Microsoft Windows

- Oracle Database 12.1: Oracle Databaseインストレーション・ガイドfor Microsoft Windows

- Oracle Database 11.2.0.4: Oracle Databaseインストレーション・ガイドfor Microsoft Windows

他のプラットフォームにOracle Databaseをインストールするには、Oracle Help Centerを検索し、ご使用のプラットフォームに固有のインストール手順に従ってください。

関連項目

- Oracle Help Center

- Oracle Data Minerのデータベース要件

Oracle Cloud Databaseスキーマへの接続

SQL DeveloperインターフェイスからOracle Cloud Databaseスキーマに接続できます。

SQL Developerインターフェイスから、Oracle Cloud Databaseインスタンスへの接続を作成または編集できます。ここでは、Oracle Net (SQL*Net)へのアクセスを提供しません。Oracle Data MinerはOracle Database Cloud Service (Database as a Service)とOracle Database Exadata Cloud Serviceをサポートしています。

関連項目:
Oracle Cloud Database Schema Serviceインスタンスへの接続の作成または編集の詳細は、『Oracle SQL Developerユーザーズ・ガイド』を参照してください。

関連項目

- Oracle SQL Developerユーザーズ・ガイド

3 Oracle Data Minerのインストール

この章では、SQL DeveloperとOracle Data Minerリポジトリのインストール方法について説明します。

- Oracle Data Minerのインストールの概要
Oracle Data Minerのインストールとは、Oracle Data MinerリポジトリをOracle Databaseにインストールすることを意味します。リポジトリは、Oracle Data Minerのアプリケーション・マネージャおよび記憶域マネージャとして機能します。

- Oracle Data Minerのサンプル・データについて
Oracle Data Minerには、表やビューを含むサンプル・データが含まれています。

- SQL Developerのダウンロード
Oracle SQL Developerは、Oracle Technology Networkから無償ダウンロードできます。

- スクリプトを使用したリポジトリのインストール
installodmrスクリプトを実行してOracle Data Minerリポジトリをインストールできます。

- スクリプトを使用したサンプル・データのロード
スクリプトを使用してリポジトリをインストールしたら、第2のスクリプトを実行して、Oracle Data Minerチュートリアルで使用されるサンプル・データをロードできます。

- SQL Developer GUIを使用したリポジトリのインストール
SQL Developerグラフィカル・ユーザー・インタフェースを使用してOracle Data Minerリポジトリをインストールできます。

- JSONパーサーとデータ・ガイドのインストール
JSON問合せ処理は、リリース12.1.0.2以降のOracle Databaseで使用できます。

Oracle Data Minerのインストールの概要

Oracle Data Minerのインストールとは、Oracle Data MinerリポジトリをOracle Databaseにインストールすることを意味します。リポジトリは、Oracle Data Minerのアプリケーション・マネージャおよび記憶域マネージャとして機能します。

Oracle Data Minerをインストールするには、次の手順に従います。

1. Oracle Databaseをインストールします。すでにデータベースがある場合は、要件を満たしていることを確認します。
SQL Developerをダウンロードします。

2. Oracle Data Minerリリース・ノートのOracle Data Minerの前提条件に関する項を確認します

3. Oracle Data Minerリポジトリをインストールします。SQL Developerを使用して、またはスクリプトを実行してインストールを実行できます。

関連項目

- SQL Developerのダウンロード

- データベースのインストールによるOracle Data Minerのサポート

- Oracle Data Minerユーザーズ・ガイド

- Oracle Data Minerのデータベース要件

Oracle Data Minerのサンプル・データについて

Oracle Data Minerには、表やビューを含むサンプル・データが含まれています。

注意:
SHサンプル・スキーマはOracle Database 12.2には付属していません。サンプル・データをインストールするには、DBサンプル・スキーマに移動します。

サンプルの表およびビューは次のとおりです。

- MINING_DATA_BUILD_V, MINING_DATA_TEST_V, MINING_DATA_APPLU_V: SHスキーマの表に基づくビューです。このデータは、Oracle Data Miningアプリケーション開発者ガイドおよびOracle Data Mining管理者ガイドの説明に従ってOracle Data Miningサンプル・プログラムで使用されます。

- MINING_DATA_TEXT_BUILD_V, MINING_DATA_TEXT_TEST_V, MINING_DATA_TEXT_APPLU_V: SHスキーマの表に基づくビューです。ビューには、OBEのテキスト・マイニングの例とData Miningのサンプル・プログラムで使用される追加のCOMMENTS列が含まれます。

- ODMR_CARS_DATA: 米国の自動車に関するサンプル・データです(グラフ・ノードでの実験用)。

- INSUR_CUST_LVT_SAMPLE: Oracle By Example (OBE)でData Mining用のチュートリアルに使用するサンプル・データです。

- ODMR_SALES_JSON_DATA: Oracle Database 12.1.0.2以降においてJSON問合せノードで実験するためのサンプル・データです。

- ODMR_MINING_DATA_TEXT, ODMR_SALES_DATA: SHスキーマを容易に利用できない場合、このサンプル・データを部分置換として使用できます。Oracle Data Minerデモ・データのインストール時にロードされます(SH依存性はありません)。

- WIKISAMPLE: 明示的特徴抽出ノードを示すサンプル・データです。

関連項目

- Oracle Databaseサンプル・スキーマ

SQL Developerのダウンロード

Oracle SQL Developerは、Oracle Technology Networkから無償ダウンロードできます。

SQL Developerをインストールするには、ダウンロードしてシステムに解凍するだけです。SQL Developerに、インストール・プログラムは含まれていません。

SQL Developerをダウンロードする手順:

1. Oracle SQL Developerホーム・ページの「ダウンロード」タブに移動します。

2. ドキュメントのリンクを選択して、リリース・ノート、新規機能の一覧、SQL Developerのドキュメント・ライブラリを表示します。

注意:

ドキュメント・ライブラリのドキュメントは、オンライン・ビューアで閲覧できるほか、PDF、Mobi (Kindle用)、ePub (iBook用)の各フォーマットでダウンロードもできます。ドキュメント・ライブラリのページをブックマークしておくと、後で参照しやすくなります。

3. プラットフォームに対応したインストレーション手順を選択し、SQL Developerのダウンロードと起動の手順に従います。

注意:

SQL Developerには、Java Development Kit (JDK) 1.7以上が必要です。JDKがSQL Developerソフトウェア・ダウンロード・バンドルに含まれず、システムにインストールされていない場合は、別途ダウンロードしてインストールする必要があります。

SQL Developerのインストール手順に、JDKのダウンロード・ページへのリンクがあります。

4. SQL Developerを初めて起動するときには、JDKのパスを指する必要があります。

関連項目

- SQL Developerダウンロード・ページ。

- SQL Developerドキュメントの索引。

スクリプトを使用したリポジトリのインストール

installodmrスクリプトを実行してOracle Data Minerリポジトリをインストールできます。

リポジトリをインストールする前に、ディスクの空き容量を確認してください。初期記憶域割当てには4 MBのディスク領域が必要です。追加の記憶域については、20ノードそれぞれの10のワークフローを処理するには、平均1 MBのディスク領域が必要です。

注意:

Oracle Database 11.2.0.4以上の場合、リポジトリのデフォルト表領域にはセグメント領域管理のためにautoを指定する必要があります。

Oracle Data Minerリポジトリをインストールする手順:

1. DBAロールでデータベースにログインします。

2. installodmrスクリプトを実行します。

installodmr.sql default_tablespace temp_tablespace

たとえば、デフォルトの検索パスを設定している場合には、次の文でリポジトリがインストールされ、デフォルト表領域USERSと一時表領域TEMPが設定されます。

@installodmr USERS TEMP

データベースがリモートで、リポジトリがXML DBオブジェクト・リレーショナル記憶域を使用している場合、インストール・スクリプトの実行にはおよそ10分かかります。データベースがリモートで、リポジトリがバイナリ記憶域を使用している場合(Oracle Database 11.2.0.4以降)、インストールはおよそ3分で完了します。

注意:

リポジトリをインストールしたら、少なくとも1人のデータベース・ユーザーに対してOracle Data Minerのアクセスを有効にする必要があります。

関連項目

- Oracle Data Minerスクリプトのパスの設定

- Oracle Data Minerの記憶域構成

- Oracle Data Minerリポジトリに対するアクセス権の付与と削除

- Oracle Data Miner管理スクリプトについて

スクリプトを使用したサンプル・データのロード

スクリプトを使用してリポジトリをインストールしたら、第2のスクリプトを実行して、Oracle Data Minerチュートリアルで使用されるサンプル・データをロードできます。

SQL Developer GUIを使用してリポジトリをインストールする場合、チェック・ボックスを選択することでサンプル・データをインストールできます。

instDemoDataスクリプトを実行すると、Oracle Data Minerユーザー用のデモ・データが作成されます。このスクリプトは、示されているデータへのアクセスを付与します。データベースにSHスキーマが存在しない場合、スクリプトはSHに依存しないデモ・データのみを準備します。

ユーザー用のOracle Data Minerサンプル・データをインストールする手順:

1. DBAロールでデータベースにログインします。

2. SHスキーマがデータベースに存在することを確認します。

3. instDemoDataスクリプトを実行します。

instDemoData.sql user

たとえば、デフォルトの検索パスを設定している場合には、次の文でユーザーdmuser1用のサンプル・データがインストールされます。

@instDemoData dmuser1

ユーザー用のサンプル・データを削除する手順:

1. DBAロールでデータベースにログインします。

2. dropDemoDataスクリプトを実行します。

dropDemoData.sql user

たとえば、デフォルトの検索パスを設定している場合には、次の文でユーザーdmuser1用のサンプル・データが削除されます。

@dropDemoData dmuser1

関連項目

- スクリプトを使用したリポジトリのインストール

- Oracle Data Minerスクリプトのパスの設定

- Oracle Data Minerのサンプル・データについて

SQL Developer GUIを使用したリポジトリのインストール

SQL Developerグラフィカル・ユーザー・インタフェースを使用してOracle Data Minerリポジトリをインストールできます。

リポジトリをインストールする前に、ディスクの空き容量を確認してください。初期記憶域割当てには4 MBのディスク領域が必要です。追加の記憶域については、20ノードそれぞれの10のワークフローを処理するには、平均1 MBのディスク領域が必要です。

SQL Developer GUIからOracle Data Minerリポジトリをインストールする手順:

1. SQL Developerの「接続」タブで、ターゲット・データベースへの管理接続を選択するか、新しい接続を作成します。

2. Oracle Data Minerユーザーを作成します。

a. 管理接続についてドリルします。

b. 「他のユーザー」を右クリックし、「ユーザーの作成」を選択します。

c. ユーザーにCONNECTロールを付与し、デフォルト表領域に無制限の割当てを指定します。

3. 「接続」タブに、Oracle Data Minerユーザーの接続を作成します。

4. 「表示」メニューから、「Data Miner」、「Data Minerの接続」の順に選択します。

5. SQL Developerの「接続」タブの下に、Data Minerの「接続」タブが開きます。

6. 「Data Miner」タブのプラス記号をクリックし、「接続の選択」ダイアログを表示します。ドロップダウン・リストからData Minerユーザーを選択します。

7. 「Data Miner」タブに新しい接続が表示されます。

8. 新しい接続についてドリルしようとすると、次のダイアログ・ボックスが表示されます。

図3-1 リポジトリがインストールされていません

9. 「はい」 をクリックして、リポジトリをインストールします。

10. パスワードを指定すると、リポジトリに関する情報が表示されます。次に例を示します。

図3-2 リポジトリのインストール設定

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

12. 「リポジトリのインストール設定」ダイアログ・ボックスが表示されます。
「デモ・データのインストール」チェック・ボックスを選択して、ユーザー接続のスキーマにサンプル・データをインストールします。データベースにSHスキーマが存在する場合、すべてのサンプル・データがインストールされます。SHがインストールされていない場合、ODMR_CARS_DATA、INSUR_CUST_LVT_SAMPLE、ODMR_SALES_JSON_DATA ODMR_MINING_DATA_TEXT、ODMR_SALES_DATA、WIKISAMPLE(データベース12.1のみ)のみがインストールされます。

注意:
SHサンプル・スキーマはOracle Database 12.2には付属していません。サンプル・データをインストールするには、DBサンプル・スキーマに移動します。

図3-3 Data Minerリポジトリのインストール

注意:

リポジトリをインストールすると、Oracle Data Minerユーザーに必要なデータベース権限が自動的に付与されます。

Oracle Data Minerによって必要とされる権限は、Oracle Data Mining APIを直接使用するために必要な権限とは異なります。

13. インストールが完了したら、「閉じる」.をクリックします

関連項目

- Oracle Data Minerのサンプル・データについて

- Oracle Databaseサンプル・スキーマ

- データ・マイニング API

JSONパーサーとデータ・ガイドのインストール

JSON問合せ処理は、リリース12.1.0.2以降のOracle Databaseで使用できます。

Oracle Database 12.2以降では、Oracle Data Minerはデータベースに付属するJSONパーサーを使用するため、JSONパーサーをインストールする必要はありません。

注意:
スクリプトを使用してリポジトリをインストールまたは移行した場合、Oracle Data MinerでJSONサポートを有効にする別途のインストール後手順は不要です。

- JSONサポートをインストールするスクリプトについて
Oracle Data Miner用のJSONパーサーとスキーマ・ジェネレータをインストールするために、2つのスクリプトを使用できます。

- JSONパーサーをインストールするスクリプトを実行するための前提条件
スクリプトloadjsonschemagen.sqlおよびloadjsonschemagenWithSN.sqlはOracle Data Miner用のJSONパーサーとスキーマ・ジェネレータをインストールします。

- リモート・データベースへのJSONパーサーのインストール
loadjsonschemagenまたはloadjsonschemagenWithSNスクリプトを実行して、JSONサポートをリモート・データベースにインストールできます。

- データベース・ホスト上へのJSONパーサーのローカル・インストール
スクリプトloadjsonschemagen.sql、validateODMRSYS.sql、org.glassfish.javax.json.jarおよびJSONSchemaGenerator.jarを使用して、データベース・ホスト上にローカルにJSONパーサーをインストールできます。

JSONサポートをインストールするスクリプトについて

Oracle Data Miner用のJSONパーサーとスキーマ・ジェネレータをインストールするために、2つのスクリプトを使用できます。

2つのスクリプトの違いは引数だけで、一方はOracle SIDを受け入れ、もう一方はOracleサービス名を受け入れます。お使いのデータベース・インストール環境に最も適したスクリプトを選択してください。プラガブル・データベースを使用している場合は、Oracleサービス名が必要です。

- loadjsonschemagen.sqlは、Oracle SIDを使用します。

loadjsonschemagen.sql user password host port SID jar_path

- loadjsonschemagenWithSN.sqlは、Oracleサービス名を使用します。

loadjsonschemagenWithSN.sql  user password host port service_name jar_path

どちらのスクリプトでも、DBAユーザーとパスワード、データベース・ホスト名とポート番号とjarファイルへのパスを指定します。

org.glassfish.javax.json.jar

JSONSchemagenerator.jar

JSONパーサーをインストールするスクリプトを実行するための前提条件

スクリプトloadjsonschemagen.sqlおよびloadjsonschemagenWithSN.sqlはOracle Data Miner用のJSONパーサーとスキーマ・ジェネレータをインストールします。

スクリプトを実行するには、次の前提条件を確認します。

- jar_path引数には、現在のデータベース・システムでアクセス可能なディレクトリを指定します。

- スクリプトを実行するシステムで、Oracleデータベースのコマンドライン・ユーティリティloadjavaおよびdropjavaを使用できる必要があります。

リモート・データベースへのJSONパーサーのインストール

loadjsonschemagenまたはloadjsonschemagenWithSNスクリプトを実行して、JSONサポートをリモート・データベースにインストールできます。

1. SQL Developerがインストールされているコンピュータにログインします。

2. scriptsディレクトリに移動します。
cd SQL_Developer_Home\sqldeveloper\dataminer\scripts

3. DBA権限でSQL*Plusを起動します。

SQLPLUS / as sysdba

4. いずれかのバージョンの(SIDとサービス名のいずれかを必要とする)スクリプトを実行します。
@loadjsonschemagen user password host port SID jar_path
または

@loadjsonschemagenWithSN user password host port service_name jar_path

ここで、jar_pathの値は次のとおりです。

c:\SQL_Developer_home\sqldeveloper\extensions\oracle.dmt.dataminer\lib

データベース・ホスト上へのJSONパーサーのローカル・インストール

スクリプトloadjsonschemagen.sql、validateODMRSYS.sql、org.glassfish.javax.json.jarおよびJSONSchemaGenerator.jarを使用して、データベース・ホスト上にローカルにJSONパーサーをインストールできます。

データベース・ホスト上でJSONパーサーをローカルにインストールするには:

1. スクリプトloadjsonschemagen.sqlをコピーしてODMRSYS.sqlを検証します。コピー元:

\SQL_Developer_home\sqldeveloper\dataminer\scripts

コピー先: データベース・ホスト・コンピュータのステージング・ディレクトリ。例: /scratch。

2. org.glassfish.javax.json.jarとJSONSchemaGenerator.jarをコピーします。コピー元:

\SQL_Developer_home\sqldeveloper\extensions\oracle.dmt.dataminer\lib

コピー先: データベース・ホスト・コンピュータのステージング・ディレクトリ。例: /scratch。

3. ホスト・コンピュータのステージング・ディレクトリ(たとえば/scratch)に移動し、DBA権限でSQL*Plusを起動します。

SQLPLUS / as sysdba

4. いずれかのバージョンの(SIDとサービス名のいずれかを必要とする)スクリプトを実行します。

関連項目

- JSONサポートをインストールするスクリプトについて

4 Oracle Data Minerユーザーの管理

この章では、Oracle Data Minerユーザー・アカウントを管理する方法を説明します。

- ユーザー・オブジェクトとリポジトリ・オブジェクトについて
Oracle Data Minerのインストール環境は、1つのリポジトリと1つ以上のユーザー・アカウントで構成されます。ユーザーは、リポジトリに対するアクセス権と、データベースにおけるデータ・マイニング操作に必要な権限、およびデータに対する適切なアクセス権を持っている必要があります。

- Oracle Data Minerのプロキシ・ユーザーについて
SQL Developerには、独自のログイン資格証明を持ちながら同じターゲット・データベース・ユーザー・アカウントを共有するプロキシ・ユーザーをサポートする機能があります。

- JVMプロパティの設定
プロキシまたはターゲット・ユーザー・プロトコルを利用しているOracle SQL Developer LDAP接続は、SQL問合せノードで実行すると、SQLランタイム・エラーが生成されることがあります。

- Oracle Data Minerのアクセス・モデルの選択
Oracle Data Minerのアクセスを単一のデータベース・ユーザーに制限することも、複数のデータベース・ユーザーにアクセスを許可することもできます。いずれの場合も、プロキシ・サーバーを作成すれば、ユーザーをグループ化してデータベースで1つのData Minerユーザー・アカウントを共有できます。

- Oracle Data Minerリポジトリに対するアクセス権の付与と削除
GUIを使用するか、スクリプトを実行することによって、Oracle Data Minerリポジトリへのアクセス権を付与できます。スクリプトを実行することによっても、アクセス権を取り消せます。

ユーザー・オブジェクトとリポジトリ・オブジェクトについて

Oracle Data Minerのインストール環境は、1つのリポジトリと1つ以上のユーザー・アカウントで構成されます。ユーザーは、リポジトリに対するアクセス権と、データベースにおけるデータ・マイニング操作に必要な権限、およびデータに対する適切なアクセス権を持っている必要があります。

Oracle Data Minerは、情報を、Oracle Data Minerユーザーのスキーマと、リポジトリ・スキーマ(ODMRSYS)に格納します。ワークフローをサポートするマイニング・モデルとデータは、ユーザーのスキーマに格納されます。プロジェクトとワークフローの構造を定義するメタデータは、XMLドキュメントとしてODMRSYSに格納されます。

- ユーザーのスキーマのサイズの制御
ユーザーのスキーマのサイズを制御して、スキーマの記憶域を節約する必要があります。

- Oracle Data Minerユーザーのスキーマ内のオブジェクト
ワークフローは、オブジェクト、表およびビューを作成します。Oracle Data Minerは、次のオブジェクトをユーザーのスキーマに格納します。

- Oracle Data Minerの内部表について
ユーザーのスキーマにある内部表には、サポート・ワークフローとデータ・マイニング活動に関する情報が格納されます。

関連項目

- Oracle Data Minerのアーキテクチャ

- Oracle Data Minerリポジトリについて

ユーザーのスキーマのサイズの制御

ユーザーのスキーマのサイズを制御して、スキーマの記憶域を節約する必要があります。

ユーザーのスキーマの記憶域を節約するには:

- ワークフローが不要になったら削除します。

- ワークフローをエクスポートし、ユーザーのスキーマで削除します。

- ODMRSYSに別個の表領域を使用して、リポジトリの記憶域消費をユーザーの表領域から分離します。

関連項目

- Oracle Data Minerリポジトリの管理

Oracle Data Minerユーザーのスキーマ内のオブジェクト

ワークフローは、オブジェクト、表およびビューを作成します。Oracle Data Minerは、次のオブジェクトをユーザーのスキーマに格納します。

ユーザーのスキーマ:

- Data Minerノード・エディタを使用してユーザーが直接指定したモデル、表、ビュー。これには、モデル・ノードによって作成されるマイニング・モデルと、表作成ノードによって作成される表が含まれます。

- 生成された結果を格納および表示するために、Data Minerノードによって作成されたが、Data Minerノード・エディタを使用してユーザーが直接指定していない表およびビュー。たとえば、モデル構築時に作成されるテスト結果表は、内部表です。表の名前はユーザーに表示されませんが、ユーザーはテスト結果ビューアで表の内容を参照できます。

Oracle Data Minerの内部表について

ユーザーのスキーマにある内部表には、サポート・ワークフローとデータ・マイニング活動に関する情報が格納されます。

内部表は、次を実行します。

- データ・マイニング・エンジンは、データベースにDM$接頭辞を持つ表を作成します。これらの表には、マイニング・モデルに関する情報が格納されます。

- Oracle Data Minerは、ODMR$接頭辞を持つ表を作成します。これらの表には、ワークフローに関する情報が格納されます。

SQL Developerスキーマ・ナビゲータを使用してOracle Data Minerユーザーが所有するオブジェクトを表示すると、内部表とビューは表示に含まれます。SQL Developerでフィルタを作成して内部表とビューを非表示にできます。Oracle Data Minerインタフェースを使用してユーザーのスキーマを表示すると、内部表とビューは自動的にフィルタされます。

Oracle Data Minerのプロキシ・ユーザーについて

SQL Developerには、独自のログイン資格証明を持ちながら同じターゲット・データベース・ユーザー・アカウントを共有するプロキシ・ユーザーをサポートする機能があります。

SQL Developer接続は通常、データベースに定義されている単一のユーザーにデータベース・アクセス権を提供します。SQL Developerには、プロキシ・ユーザーの作成に対応したいくつかの接続タイプがあります。

接続は、SQL Developerのオブジェクトであり、特定のユーザーのログイン資格証明を特定のデータベースに指定します。Data Miner接続はSQL Developer接続の1つで、Data Minerユーザーに必要な権限を含んでいます。Oracle Data Miner接続は、「Data Minerの接続」タブのナビゲータにリストされます。

Oracle Data Minerは、ベーシック・タイプおよびTNS接続タイプのプロキシ認証をサポートします。図4-1に、SQL Developerの「詳細プロパティ」ダイアログ・ボックスを示します。このダイアログ・ボックスで、既存のBasic接続でプロキシ・ユーザーを作成できます。

図4-1 SQL DeveloperにおけるBasic接続のプロキシ・ユーザー

SQL DeveloperのLDAPサービスを使用して、機能的にプロキシ・ユーザーと同等のユーザーを作成することもできます。LDAPを使用する場合、個々の(プロキシ)ユーザーを作成し、それぞれを既存のデータベース・ユーザー接続に関連付けます。

関連項目

- データベース接続

- プロキシ認証による接続

- データベース接続の作成および編集

- 認証の構成

JVMプロパティの設定

プロキシまたはターゲット・ユーザー・プロトコルを利用しているOracle SQL Developer LDAP接続は、SQL問合せノードで実行すると、SQLランタイム・エラーが生成されることがあります。

プロキシ・ユーザーとして問合せを実行しているときに無効な名前パターン・エラーが発生した場合、JVMプロパティoracle.jdbc.createDescriptorUseCurrentSchemaForSchemaNameをtrueに設定します。
JVMプロパティを設定するには、Oracle SQL Developerを開き、コマンド・プロンプトから次を実行します: C:\<SQL Developer Installation Directory>\sqldeveloper\ide\bin\sqldeveloper.exe -JDoracle.jdbc.createDescriptorUseCurrentSchemaForSchemaName=true

永続的に変更するには、sqldeveloper.confファイルを更新し、次のプロパティ定義を含めます。

1. Oracle SQL Developerを停止します。

2. sqldeveloper.confファイルを開き、プロパティ定義を使用して更新します。
C:\<SQL Developer Installation Directory>\sqldeveloper\ide\bin\sqldeveloper.exe -JDoracle.jdbc.createDescriptorUseCurrentSchemaForSchemaName=true

3. sqldeveloper.confファイルを<SQL Developer Installation Directory>\sqldeveloper\bin\sqldeveloper.confに保存します。これにより既存のファイルが上書きされます。
更新されたsqldeveloper.conf ファイルを使用して、コマンド・ラインからOracle SQL Developerを起動する必要はありません。

新しいテキストを太字にして、sqldeveloper.confファイルの最初の部分を次に示します
IncludeConfFile ../../ide/bin/ide.conf

SetJavaHome ../../jdk

#Workaround for LDAP Proxy failure

AddVMOption

-Doracle.jdbc.createDescriptorUseCurrentSchemaForSchemaName=true

Oracle Data Minerのアクセス・モデルの選択

Oracle Data Minerのアクセスを単一のデータベース・ユーザーに制限することも、複数のデータベース・ユーザーにアクセスを許可することもできます。いずれの場合も、プロキシ・サーバーを作成すれば、ユーザーをグループ化してデータベースで1つのData Minerユーザー・アカウントを共有できます。

選択するアクセス・モデルは、サポートの必要なユーザーの数によっても、またユーザーが共有環境での作業を必要とするかプライベート環境で単独で作業するかによっても異なります。

- 単一ユーザー・アクセス
単一ユーザー・アクセスでは、ユーザー・スキーマは1つです。ある人がOracle Data Minerを使用できるか、プロキシ・アカウントをもつ1つのグループの人々がOracle Data Minerを使用できるかのどちらかです。プロキシ・ユーザーは、同じモデルとデータベース・オブジェクトにアクセスできます。

- 複数ユーザー・アクセス
複数ユーザー・アクセスでは、複数のユーザー・スキーマがあります。スキーマは、個々のユーザーをサポートするか、プロキシ・ユーザーのワークグループをサポートします。

- 共有ユーザー環境
共有ユーザー環境はコラボレーションを推進します。複数のプロキシ・ユーザーが単一のデータベース・アカウントへのアクセスを共有する場合、Oracle Data Minerはロック・メカニズムを使用してワークフローへのアクセスを調整します。

- ドキュメント使用中条件について
データベースでワークフロー・セッションを実行中に、ユーザーがワークフローを編集しようとすると、ドキュメント使用中のメッセージが生成されます。

単一ユーザー・アクセス

単一ユーザー・アクセスでは、ユーザー・スキーマは1つです。ある人がOracle Data Minerを使用できるか、プロキシ・アカウントをもつ1つのグループの人々がOracle Data Minerを使用できるかのどちらかです。プロキシ・ユーザーは、同じモデルとデータベース・オブジェクトにアクセスできます。

すべてのユーザーが、データベース・オブジェクトを作成、変更、削除でき、すべてのユーザーが他のユーザーの作業を見ることができます。単一ユーザー・アクセスでは、プライベートなワークスペースが保証されますが、コラボレーションには向きません。

プロキシを使用しない場合、ユーザーはそれぞれのスキーマ内で自律的に機能します。Oracle Databaseのセキュリティ・メカニズムによって、ユーザーは他のユーザーのスキーマに属するオブジェクトを変更できないようになっています。

複数ユーザー・アクセス

複数ユーザー・アクセスでは、複数のユーザー・スキーマがあります。スキーマは、個々のユーザーをサポートするか、プロキシ・ユーザーのワークグループをサポートします。

個別アクセスと共有アクセスの組合せをいくつか設定できます。共有していないユーザーも含め、あらゆるユーザーに対してプロキシ認証を使用できます。

共有ユーザー環境

共有ユーザー環境はコラボレーションを推進します。複数のプロキシ・ユーザーが単一のデータベース・アカウントへのアクセスを共有する場合、Oracle Data Minerはロック・メカニズムを使用してワークフローへのアクセスを調整します。

実行中や実行の待機中、または編集中のワークフローはロックされます。

ワークフローのネームスペースはプロジェクトです。複数のユーザーが同じプロジェクトで作業する場合は、各自のワークフローには、他のユーザーのワークフローと区別できるような名前を付けるように留意してください。たとえば、各ユーザーのイニシャルを接頭辞として追加することに合意するなどが考えられます。

データベース・オブジェクト、たとえばマイニング・モデルや表のネームスペースは、共有スキーマ内で一意です。一意の名前を維持できるように、Oracle Data Minerはデータベース・オブジェクトのネーミング規則に従います。他のワークフローで参照される表に対してシステム生成された名前をユーザーが変更すると、警告が生成されます。

ドキュメント使用中条件について

データベースでワークフロー・セッションを実行中に、ユーザーがワークフローを編集しようとすると、ドキュメント使用中というメッセージが生成されます。

Oracle Data Minerクライアントがネットワークから切断された場合(たとえば、ケーブルが取り外されたか、ラップトップが休止状態になった場合)、ワークフローのロックは解放されません。切断されたセッションは、まだロックされ、データベースで実行されています。別のユーザーがワークフローを編集しようとすると、ドキュメント使用中のメッセージが生成されます。

ツールバー上のロックをクリックすることによって、ロックを再取得できます。ロックを再取得できない場合、ロックを保持しているデータベース・セッションを停止する必要があります。詳細は、『Oracle Database管理者ガイド』の、セッション終了に関する項を参照してください。

関連項目

- Oracle Database管理者ガイド

Oracle Data Minerリポジトリに対するアクセス権の付与と削除

GUIを使用するか、スクリプトを実行することによって、Oracle Data Minerリポジトリへのアクセス権を付与できます。スクリプトを実行することによっても、アクセス権を取り消せます。

- UIを使用したアクセス権の付与
グラフィカル・ユーザー・インタフェース(GUI)を使用してOracle Data Minerリポジトリをインストールした場合、リポジトリへのアクセス権はユーザーIDに自動的に付与されます。プロキシまたはLDAPユーザーとしてログインした場合、Oracle Data Minerはターゲット・ユーザーにアクセス権を自動的に付与します。

- スクリプトを使用したアクセス権の付与
リポジトリへのアクセス権を付与するには、usergrantsスクリプトを実行して、ユーザー名を指定します。リポジトリは、スクリプトを実行する前に、すでにインストールされている必要があります。

- スクリプトを使用したアクセス権の削除
Oracle Data Minerリポジトリへのアクセス権を削除するには、dropusergrantsスクリプトを実行します。

- データへのアクセスの付与
ユーザーは、マイニング・モデルの構築またはスコアリングに使用するデータへの読取りアクセスまたはSELECT権限を持っている必要があります。

GUIを使用したアクセス権の付与

グラフィカル・ユーザー・インタフェース(GUI)を使用してOracle Data Minerリポジトリをインストールした場合、リポジトリへのアクセス権はユーザーIDに自動的に付与されます。プロキシまたはLDAPユーザーとしてログインした場合、Oracle Data Minerはターゲット・ユーザーにアクセス権を自動的に付与します。

リポジトリがすでにインストールされているデータベースへの接続を初めて選択すると、アクセス権の付与と、(オプションで)サンプル・データのインストールの確認を求められます。

関連項目

- Oracle Data Minerのサンプル・データについて

- SQL Developer GUIを使用したリポジトリのインストール

スクリプトを使用したアクセス権の付与

リポジトリへのアクセス権を付与するには、usergrantsスクリプトを実行して、ユーザー名を指定します。リポジトリは、スクリプトを実行する前に、すでにインストールされている必要があります。

usergrants.sql user_access

たとえば、次の文はユーザーdmuser1にOracle Data Minerアクセス権を付与します。

@usergrants dmuser1

指定するユーザー名は、ターゲット・ユーザーである必要があります。このターゲット・ユーザーに基づいて認証されるすべてのプロキシまたはLDAPユーザーは、ターゲット・ユーザーの権限を自動的に取得します。

スクリプトを使用したアクセス権の削除

Oracle Data Minerリポジトリへのアクセス権を削除するには、dropusergrantsスクリプトを実行します。

dropusergrants.sql user_access

たとえば、次の文は、dmuser1に付与されたアクセス権を削除します。

@dropusergrants dmuser1

usergrantsスクリプトと同様に、指定するユーザー名は、ターゲット・ユーザーである必要があります。このターゲット・ユーザーに基づいて認証されるすべてのプロキシまたはLDAPユーザーは、ターゲット・ユーザーの権限を自動的に取得します。ターゲット・ユーザーのアクセス権を削除すると、そのターゲット・ユーザーに基づくすべてのプロキシとLDAPユーザーは、リポジトリへのアクセスを自動的に失います。

関連項目

- スクリプトを使用したアクセス権の削除

データへのアクセスの付与

ユーザーは、マイニング・モデルの構築またはスコアリングに使用するデータへの読取りアクセスまたはSELECT権限を持っている必要があります。

ターゲット・ユーザーに直接、SELECT権限を付与する必要があります。間接的にユーザー・ロールに権限を付与しないでください。Oracle Data Minerがユーザーに代わってビューを作成できるように、SELECT権限は直接付与する必要があります。Oracle Data Minerがビューを作成できない場合、ユーザーはデータにアクセスできない場合があります。

5 Oracle Data Minerリポジトリの管理

この章では、スクリプトを使用したOracle Data Minerリポジトリの管理方法について説明します。

- Oracle Data Miner管理スクリプトについて
Oracle Data Minerには、リポジトリのインストールと管理に使用する一連のSQLスクリプトが用意されています。

- Oracle Data Minerスクリプトのパスの設定
SQL*PlusまたはSQL Developer Webシートを使用して、Oracle Data Minerスクリプトのパスを設定できます。

- リポジトリのステータスとバージョンの判定
リポジトリのバージョンは、Oracle Data Minerクライアントのバージョンと互換である必要があります。クライアントとサーバーのバージョンに互換性がない場合、クライアントはサーバーに接続できません。

- リポジトリのバックアップとリストア
Oracle Data Minerリポジトリをアップグレードするか、データベース・アップグレードを実行する前に、ODMRSYSとOracle Data Minerユーザー・スキーマを含む、Oracle Data Minerのフル・バックアップを実行する必要があります。

- リポジトリの移行
この項では、リポジトリの移行に関連するトピックについて説明します。

- リポジトリの削除
dropRepositoryAndUserObjectsスクリプトは、Data Minerリポジトリと、ユーザーのスキーマにある関連オブジェクトを削除します。

Oracle Data Miner管理スクリプトについて

Oracle Data Minerには、リポジトリのインストールと管理に使用する一連のStructured Query Language (SQL)スクリプトが用意されています。

SQLスクリプトは、SQL Developerとともに次のディレクトリにインストールされます。

SQL_Developer_Home\sqldeveloper\dataminer\scripts

SQLスクリプトは、SQL*PlusまたはSQL Developer Worksheetで実行できます。Oracle Data Minerのスクリプトはすべて、DBA権限で実行する必要があります。

注意:

Oracle Data Minerスクリプトの多くはSQL Developerと統合されているため、データ・グラフィカル・ユーザー・インタフェースを介していくつかの管理機能を使用できます。

Oracle Data Minerスクリプトのパスの設定

SQL*PlusまたはSQL Developer Webシートを使用して、Oracle Data Minerスクリプトのパスを設定できます。

スクリプトのデフォルトの検索パスを設定する手順:

- SQL*Plus: scriptsディレクトリからSQL*Plusを起動します。
SQL_Developer_Home\sqldeveloper\dataminer\scripts

- SQL Developer Worksheet: Worksheetのプロパティで、デフォルトの検索パスをscriptsディレクトリに設定します。
SQL Developer Worksheetのプロパティについては、スクリプトで出力する最大行数を500000に変更することも必要です。

リポジトリのステータスとバージョンの判定

リポジトリのバージョンは、Oracle Data Minerクライアントのバージョンと互換である必要があります。クライアントとサーバーのバージョンに互換性がない場合、クライアントはサーバーに接続できません。

次の問合せは、リポジトリのバージョンとステータスを返します。

set echo on;
-- value of VERSION and REPOSITORY_STATUS
SELECT property_name, property_str_value
FROM ODMRSYS.ODMR$REPOSITORY_PROPERTIES
WHERE property_name IN ('VERSION','REPOSITORY_STATUS', 'WF_VERSION');
PROPERTY_NAME             PROPERTY_STR_VALUE
------------------------------ ------------------------------
REPOSITORY_STATUS         LOADED
VERSION                   12.1.0.2.3
WF_VERSION                12.1.0.2.3

Oracle Data Minerリポジトリには、ステータスを示す値としてNOT_LOADEDとLOADEDの2つがあります。ステータスNOT_LOADEDは通常、SQL Developerの新しいバージョンまたは新しいパッチ・リリースをサポートするためにリポジトリをアップグレード中であることを示します。アップグレードが完了すると、ステータスがLOADEDになります。

リポジトリのバックアップとリストア

Oracle Data Minerリポジトリをアップグレードするか、データベース・アップグレードを実行する前に、ODMRSYSとOracle Data Minerユーザー・スキーマを含む、Oracle Data Minerのフル・バックアップを実行する必要があります。

Oracle Data Minerには、ユーザー・スキーマを含まずにODMRSYS内のワークフロー・メタデータをバックアップするためのスクリプトも用意されています。

- フル・バックアップおよびリストア
Oracle Database 11.2.0.4以降では、フル・データベース・バックアップと独立に、Oracle Data Minerリポジトリとユーザー・スキーマの、フル・バックアップおよびリストアを実行することができます。

- ワークフローのみのバックアップ
Oracle Data Minerには、ワークフローによって生成されるユーザーのスキーマ内のオブジェクトを含まず、リポジトリ内のワークフロー・メタデータをバックアップするスクリプトが用意されています。

- ワークフローのみのリストア
createxmlworkflowsbackup2で作成されたバックアップ表からワークフローをリストアできます。

- ワークフローのみのリストアの例
このトピックでは、選択的ワークフロー・リストアとフル・ワークフロー・リストアの例を示します。

関連項目

- ユーザー・オブジェクトとリポジトリ・オブジェクトについて

- Oracle Data Minerのアーキテクチャ

全体バックアップとリストア

Oracle Database 11.2.0.4以降では、フル・データベース・バックアップと独立に、Oracle Data Minerリポジトリとユーザー・スキーマの、フル・バックアップおよびリストアを実行することができます。

- Database 11.2.0.4以降のフル・バックアップおよびリストア
Oracle Database 11.2.0.4以降では、Oracle Data MinerリポジトリのXML記憶域はバイナリです。これらのデータベースでは、Oracle Data Pumpを使用して、データベースのフル・バックアップおよびリストアと独立に、ODMRSYSとユーザー・スキーマをバックアップおよびリストアできます。

Database 11.2.0.4以降のフル・バックアップおよびリストア

Oracle Database 11.2.0.4以降では、Oracle Data MinerリポジトリのXML記憶域はバイナリです。これらのデータベースでは、Oracle Data Pumpを使用して、データベースのフル・バックアップおよびリストアと独立に、ODMRSYSとユーザー・スキーマをバックアップおよびリストアできます。

Oracle Data Pumpを使用して、個々のスキーマをバックアップおよびリストアできます。別の方法としては、Oracle RMANでOracle Data Minerをバックアップおよびリストアできます。

関連項目

- Oracle Databaseユーティリティ

ワークフローのみのバックアップ

Oracle Data Minerには、ワークフローによって生成されるユーザーのスキーマ内のオブジェクトを含まず、リポジトリ内のワークフロー・メタデータをバックアップするスクリプトが用意されています。

この簡略化されたバックアップ戦略はワークフロー仕様を保護し、ワークフローをうっかり削除してもリストアできるようにします。ワークフローがリストアされたら、それを再実行して、すべてのサポート・オブジェクトがユーザーのスキーマに存在することを確認する必要があります。creatxmlworkflowsbackup2スクリプトは、ODMRSYS内のすべてのワークフローを、別個のバックアップ・アカウントのODMR$WORKFLOWS_BACKUPと呼ばれる表にバックアップします。スクリプトを実行する前に、バックアップ・スキーマが存在し、利用できることを確認します。

構文:

createxmlworkflowsbackup2.sql backup_account

パラメータ:

backup_accountは、バックアップ表ODMR$WORKFLOWS_BACKUPのスキーマの名前です。

この例は、BACKUPACCTと呼ばれるバックアップ・アカウントのワークフローをバックアップします:

set serveroutput on
@createxmlworkflowsbackup2l BACKUPACCT

注意:

dropRepositoryAndUserObjectsスクリプトは、リポジトリを削除するときに、すべてのバックアップ表を削除します。dropRepositoryAndUserObjectsスクリプトを実行してリポジトリを削除すると、すべてのワークフロー・バックアップが失われます。

createxmlworkflowsbackup2を実行するたびに、ワークフローの完全なセットがバックアップ表に追加されます。バックアップ・スクリプトには、バックアップ表内に30個までのバックアップが保持されます。古いバックアップは自動的に削除されます。たとえば、毎日バックアップを実行する場合、最大30日間、各ワークフローのリストアを要求できます。

バックアップ・スクリプトでは、DEFINE_MAX_VERSIONSが、バックアップ表に維持されるバックアップの数を指定します。30以上のバックアップを維持する場合、バックアップ・スクリプトcreatexmlworkflowsbackup2で、DEFINE_MAX_VERSIONSの値を希望する数に変更します。

関連項目

- リポジトリの削除

ワークフローのみのリストア

createxmlworkflowsbackup2で作成されたバックアップ表からワークフローをリストアできます。

createxmlworkflowsbackup2で作成されたバックアップ表からワークフローをリストアするには、restorexmlworkflowfrombackup2スクリプトを実行します。

restorexmlworkflowfrombackup2.sqlは、バックアップ表からOracle Data Minerリポジトリにワークフローをリストアします。使用方法は次のとおりです。

構文:

restorexmlworkflowfrombackup2.sql [option] [backup_account] [workflow_definition]

パラメータ:

option は、次の値を1つ取るオプションのパラメータです。

- ADD_ONLY - リポジトリにすでに存在していないワークフローをリストアし、存在しないプロジェクトを必要に応じて作成します。(デフォルト)

- DROP_AND_ADD - リポジトリにある既存のワークフローとプロジェクトを削除したうえで、すべてのワークフローをバックアップからリストアし、存在しないプロジェクトは必要に応じて作成します。

- OVERRIDE_ONLY - リポジトリにすでに存在するワークフローのみをリストアします。

- OVERRIDE_AND_ADD - OVERRIDE_ONLYとADD_ONLYの両方のオプションを適用します。

backup_accountは、workflow_definitionが指定されない限りオプションで、指定された場合には必須です。バックアップ・アカウントを指定しない場合、ワークフローはリポジトリにあるバックアップ表からリストアされます。バックアップ表が存在しない場合、例外が発生します。

workflow_definitionは、どのワークフローをバックアップからリストアするかを指定する表またはビューを特定する、オプションのパラメータです。表またはビューには、USER_NAME、PROJECT_NAME、WORKFLOW_NAME、VERSIONの4つの列が必要です。表の各行が、リストアするワークフローを特定します。VERSIONの値がnullの場合は、最新バージョンの値がリストアに使用されます。ワークフロー定義を何も指定しない場合は、最新のバックアップ・バージョンがデフォルトになります

例:

この例は、リポジトリ内のすべてのワークフローを削除して、BACKUPACCT内のバックアップ表からワークフローをリストアします。

set serverput on
@restorexmlworkflowfrombackup2 DROP_AND_ADD BACKUPACCT

関連項目

- ワークフローのみのバックアップ

ワークフローのみのリストアの例

このトピックでは、選択的ワークフロー・リストアとフル・ワークフロー・リストアの例を示します。

例5-1 選択的ワークフロー・リストア

先週、ユーザーSCOTTが誤ってすべてのワークフローを削除してしまったと仮定しましょう。ADD_ONLYオプションを使用して、ワークフローをリストアできます。削除してしまったワークフローがどのバージョンのバックアップに含まれているかを確認するには、バックアップの問合せが必要です。バージョンが12の場合、次のスクリプト例はDBA権限で実行され、それらのワークフローのみをリロードします。

@restorexmlworkflowfrombackup2.sql ADD_ONLY BACKUPACCT BACKUPACCT.WORKFLOW_V

次に示すWORKFLOW_Vビューは、ユーザーSCOTTに存在するすべてのワークフローを、指定したバージョンのバックアップから選択します。

CREATE VIEW BACKUPACCT.WORKFLOW_V AS
SELECT user_name, project_name, workflow_name, version
FROM backupacct.odmr$workflows_backup
WHERE user_name='SCOTT' AND version = 12;

例5-2 フル・ワークフロー・リストア

致命的なリポジトリ障害が発生し、最新のバックアップからすべてのワークフローを完全に再ロードすることが必要になった仮定します。DROP_AND_ADDオプションを使用すると、古いワークフローをすべて削除して、バックアップにあるすべてのワークフローを再ロードすることができます。この例では、ODMRSYSアカウントとは異なる別のアカウントにバックアップ表が存在します。リカバリには最新バージョンのバックアップが使用されるので、ワークフロー定義のパラメータは必要ありません。

@restorexmlworkflowfrombackup2.sql DROP_AND_ADD BACKUPACCT

リポジトリの移行

この項では、リポジトリの移行に関連するトピックについて説明します。

内容は次のとおりです。

- ODMRSYSのアップグレード
migratebinaryodmrスクリプトは、バイナリXML記憶域を使用するODMRSYSスキーマ内のワークフロー・データをアップグレードします。ODMRSYS表領域は、Oracle Automatic Segment Space Management (ASSM)表領域です。

- リポジトリを移行するスクリプト
SQL Developer 4.0からは、特定のアップグレード・パスにOracle Data Minerの移行スクリプトを使用できます。

- 新しいODMRSYS表領域のオブジェクト・リレーショナルからバイナリへのアップグレード
upgradeRepoWithNewTableSpaceスクリプトは、指定された表領域を、オブジェクト・リレーショナルからバイナリXML記憶域にアップグレードし、ODMRSYS内のワークフロー・データを新しい表領域に移行します。新しい表領域は、Oracle Automatic Segment Space Management (Oracle ASSM)表領域である必要があります。

- ODMRSYSのオブジェクト・リレーショナルからバイナリへのアップグレード
upgradeRepoFromORtoBinaryスクリプトは、ODMRSYSワークフロー・データを、オブジェクト・リレーショナルのXML記憶域からバイナリXML記憶域に移行します。アップグレードされたODMRSYS表領域は、Oracle Automatic Segment Space Management (ASSM)表領域です。

ODMRSYSのアップグレード

migratebinaryodmrスクリプトは、バイナリXML記憶域を使用するODMRSYSスキーマ内のワークフロー・データをアップグレードします。ODMRSYS表領域は、Oracle Automatic Segment Space Management (ASSM)表領域です。

ODMRUSERロールを持つセッションが現在実行中の場合、セッション・オブジェクト・ロックによりアップグレードがブロックされます。session_disconnectパラメータを使用してアクティブなセッションをすべて切断し、それによりアップグレード・プロセスの進行を可能にすることができます。

構文:

@migratebinaryodmr.sql session_disconnect

パラメータ:

session_disconnectは、次の値の1つを持つことができます。

R - アクティブなセッションをレポートします。切断はしません。

D — アクティブなセッションを切断します。レポートはしません。

DRまたはRD - アクティブなセッションを切断し、レポートします。

例:

この例はODMRSYS内のバイナリXMLワークフロー・データをアップグレードして、アクティブなODMRUSERセッションをすべて切断し、レポートします。

@migratebinaryodmr DR

リポジトリを移行するスクリプト

SQL Developer 4.0からは、特定のアップグレード・パスにOracle Data Minerの移行スクリプトを使用できます。

表5-1 Oracle Data Minerのアップグレード・スクリプト

SQL Developerのバージョン

データベースのバージョン

スクリプト

説明

4.0以降

11.2.0.4以降

migratebinaryodmr.sql

今後のリリースで、オブジェクト記憶域からバイナリ記憶域へのXML変換が不要になったときに該当します。

4.0以降

当初は11.2.0.3以前。データベースを11.2.0.4以降にアップグレード

upgradeRepoWithNewTableSpace.sqlまたはupgradeRepoFromORtoBinary.sql

データベースは、Oracle Data Minerリポジトリとは別にアップグレードできるので、これを考慮する必要があります。スクリプトの選択は、ODMRSYS表領域がASSMかどうかによって異なります。

3.2.2以前

11.2.0.4以降(デフォルトのODMRSYS表領域がASSMベースではない)

upgradeRepoWithNewTableSpace.sql

入力パラメータとしてASSM表領域が必要です。これは、ワークフロー・データをXMLオブジェクト記憶域からXMLバイナリ記憶域に移行するために使用されます。

3.2.2以前

11.2.0.4以降(デフォルトのODMRSYS表領域がASSMベース)

upgradeRepoFromORtoBinary.sql

ワークフロー・データが、XMLオブジェクト記憶域からXMLバイナリ記憶域に移行されます。

新しいODMRSYS表領域のオブジェクト・リレーショナルからバイナリへのアップグレード

upgradeRepoWithNewTableSpaceスクリプトは、指定された表領域を、オブジェクト・リレーショナルからバイナリのXML記憶域にアップグレードし、ODMRSYS内のワークフロー・データを新しい表領域に移行します。新しい表領域は、Oracle Automatic Segment Space Management (Oracle ASSM)表領域である必要があります。

ODMRUSERロールを持つセッションが現在実行中の場合、セッション・オブジェクト・ロックによりアップグレードがブロックされます。session_disconnectパラメータを使用してアクティブなセッションをすべて切断し、アップグレード・プロセスの進行を可能にできます。

構文:

upgradeRepoWithNewTableSpace.sql ASSMtablespace session_disconnect

パラメータ:

ASSMtablespaceは、ASSM表領域の名前です。

session_disconnectは、次の値の1つを持つことができます。

R - アクティブなセッションをレポートします。切断はしません。

D — アクティブなセッションを切断します。レポートはしません。

DRまたはRD - アクティブなセッションを切断し、レポートします。

例:

この例は、ODMRSYS内のオブジェクト・リレーショナルXMLデータを、バイナリXML記憶域を使用する新しいASSM表領域、my_ASSM_spaceに移行します。いずれかのODMRUSERセッションがアクティブである場合、それは切断され、レポートされます。

@upgradeRepoWithNewTableSpace my_ASSM_space DR

関連項目

- Oracle Database管理者ガイド

ODMRSYSのオブジェクト・リレーショナルからバイナリへのアップグレード

upgradeRepoFromORtoBinaryスクリプトは、ODMRSYSワークフロー・データを、オブジェクト・リレーショナルのXML記憶域からバイナリXML記憶域に移行します。アップグレードされたODMRSYS表領域は、Oracle Automatic Segment Space Management (ASSM)表領域です。

ODMRUSERロールを持つセッションが現在実行中の場合、セッション・オブジェクト・ロックによりアップグレードがブロックされます。session_disconnectパラメータを使用してアクティブなセッションをすべて切断し、それによりアップグレード・プロセスの進行を可能にすることができます。

構文:

@upgradeRepoFromORtoBinary.sql session_disconnect

パラメータ:

session_disconnectは、次の値の1つを持つことができます。

R - アクティブなセッションをレポートします。切断はしません。

D — アクティブなセッションを切断します。レポートはしません。

DRまたはRD - アクティブなセッションを切断し、レポートします。

例:

この例は、ODMRSYSをオブジェクト・リレーショナルXML記憶域からバイナリXML記憶域にアップグレードします。アップグレードされた表領域は、ASSMベースです。いずれかのODMRUSERセッションがアクティブである場合、それは切断され、レポートされます。

@upgradeRepoFromORtoBinary DR

関連項目

- Oracle Automatic Storage Management管理者ガイド

リポジトリの削除

dropRepositoryAndUserObjectsスクリプトは、Data Minerリポジトリと、ユーザーのスキーマにある関連オブジェクトを削除します。

ODMRUSERロールを持つセッションが現在実行中の場合、セッション・オブジェクト・ロックによりアップグレードがブロックされます。session_disconnectパラメータを使用してアクティブなセッションをすべて切断し、アップグレード・プロセスの進行を可能にできます。

構文:

dropRepositoryAndUserObjects.sql session_disconnect

パラメータ:

session_disconnectは、次の値の1つを持つことができます。

R - アクティブなセッションをレポートします。切断はしません。

D — アクティブなセッションを切断します。レポートはしません。

DRまたはRD - アクティブなセッションを切断し、レポートします。

例:

この例は、ODMRSYS、スキーマおよびOracle Data Minerユーザーのスキーマ内の関連オブジェクトを削除し、すべてのアクティブなODMRUSERセッションを切断およびレポートします。

@dropRepositoryAndUserObjects DR

関連項目

- ユーザー・オブジェクトとリポジトリ・オブジェクトについて

- Oracle Data Minerのアーキテクチャ

- ワークフローのみのバックアップ

6 Oracle Data Minerのシステム・リソースの管理

この章では、Oracle Data Minerをサポートするためのシステム最適化の助けになる情報を提供します。

- Oracle Data Minerのリソース管理の概要
Oracle Databaseの機能とOracle Data Minerリポジトリに用意されているオプションを使用して、Oracle Data Minerのシステム・リソースを効果的に管理できます。

- Oracle Data Minerユーザー・セッションへのリソースの割当て
Database Resource Managerを使用して、セッションのグループに、セッション属性に基づいてシステム・リソースを割り当てるリソース・プランを作成できます。

- モデル構築の管理
マイニング・モデルを構築するプロセスは、大量のシステム・リソースを消費することがあります。MAX_NUM_THREADSリポジトリ・プロパティの値を増減して、システム・リソース全体へのモデル構築の影響を制御できます。

- ワークフロー実行の管理
Oracle Data Minerは、ワークフローを、Schedulerジョブとして実行するために、Oracle Database Schedulerに送信します。Oracle Schedulerは、システム・リソースの割り当て方法を制御する様々な機能をサポートしています。Oracle Schedulerを構成すると、実行リクエストの大きなプールを効果的に管理できます。

- パラレル処理の管理
Oracle Data Minerのワークフローとビューア、および大部分のData Miningアルゴリズムは、データベースでパラレル処理が有効である場合、その利点を活用できます。INIT.ORAのパラメータは、パラレル処理の動作を制御します。デフォルトでは、パラレル実行は無効になっています(PARALLEL_DEGREE_POLICY=MANUAL)。

- システム管理用のOracle Data Minerリポジトリ・プロパティのサマリー
Oracle Data Minerリポジトリでシステム管理プロパティのサマリーを利用できます。

Oracle Data Minerのリソース管理の概要

Oracle Databaseの機能とOracle Data Minerリポジトリに用意されているオプションを使用して、Oracle Data Minerのシステム・リソースを効果的に管理できます。

次の方法で、Oracle Data Minerのシステム・リソースを効果的に管理できます。

- Oracle Data Minerセッションを管理するには、Oracle Database Resource Managerを使用して適切なリソース・プランを開発します。

- ワークフロー実行を管理するには、Oracle Schedulerで使用されるOracle Data Minerのデフォルトのジョブ・クラスを、適切なリソース・プランを持つジョブ・クラスに変更します。

- モデル構築プロセスを管理するには、Oracle Data Minerのデフォルトの最大同時モデル構築数を変更します。

- パラレル問合せ処理を管理するには、Oracle Data Minerのデフォルトのパラレル問合せ設定を変更して、ユーザーが個々のノードとワークフローのパラレル処理を指定しないようにします。

Oracle Data Minerユーザー・セッションへのリソースの割当て

Database Resource Managerを使用して、セッションのグループに、セッション属性に基づいてシステム・リソースを割り当てるリソース・プランを作成できます。

Database Resource Managerは、CPU時間を割り当て、パラレル問合せ処理を構成し、セッション数を制限し、通常はオペレーティング・システムによって制御されるシステム動作の様々な面を制御します。複数のアプリケーションが同時実行されてシステム・リソースを奪い合うデータベースでは、Oracle Database Resource Managerを使用してワークロードを分散し、全体的なパフォーマンスを最適化することができます。たとえば、データベースで同時に実行されている、ETL、OLAP、データ・マイニングおよびレポーティングといった各ワークロードの要求をバランスすることができます。

Oracle Data Minerワークフローは、特に変換や大きなデータ・セットが関与する場合に、システム・リソースに対して大量の要求をする可能性があります。複数のアプリケーションの要求に対処する必要があるデータベースでは、他のアプリケーションでのOracle Data Minerセッションの影響を限定するリソース・プランを作成して、他のアプリケーションによりOracle Data Minerのパフォーマンスが損なわれるのを防止できます。

例6-1は、Oracle Data Minerの単純なリソース・プランの作成例です。SIMPLE_RESOURCE_PLANと呼ばれるリソース・プランは、DATA_MINER_GROUPおよびOTHER_GROUPSという、2つのコンシューマ・グループを作成します。このプランは、CPUリソースの50%をOTHER_GROUPSに、残りをDATA_MINER_GROUPに割り当てます。DATA_MINER_GROUPはDMUSERアカウントにマップされ、他のユーザーはOTHER_GROUPSグループにマップされます。

例6-1 Oracle Data Minerセッションの単純なリソース・プラン

CONNECT sys as sysdba;
Enter password: password
-- creating a pending area is the first step in defining
-- consumer groups and resource plans
EXEC dbms_resource_manager.create_pending_area();
-- delete old plan (optional)
EXEC dbms_resource_manager.delete_plan_cascade(
plan => 'SIMPLE_RESOURCE_PLAN');
-- create a custom consumer group for data miner workload
EXEC dbms_resource_manager.create_consumer_group(
consumer_group => 'DATA_MINER_GROUP',
comment => 'Sessions for data miner operations');
-- map DMUSER account to the consumer group
EXEC dbms_resource_manager.set_consumer_group_mapping(
attribute => dbms_resource_manager.oracle_user,
value => 'DMUSER',
consumer_group => 'DATA_MINER_GROUP');
-- create a custom resource plan
EXEC dbms_resource_manager.create_plan(
plan => 'SIMPLE_RESOURCE_PLAN',
comment => 'Resource plan for database operations');
-- specifies how much CPU and parallelism
-- should be allocated to the consumer group
EXEC dbms_resource_manager.create_plan_directive(
plan => 'SIMPLE_RESOURCE_PLAN',
group_or_subplan => 'DATA_MINER_GROUP',
comment => 'Percentage of CPU for DATA_MINER_GROUP',
mgmt_p1 => 50,
utilization_limit => 55,
parallel_degree_limit_p1 => 8,
parallel_server_limit => 4);
-- specifies how much CPU should be allocated to the required OTHER_GROUPS
EXEC dbms_resource_manager.create_plan_directive(
plan => 'SIMPLE_RESOURCE_PLAN',
group_or_subplan => 'OTHER_GROUPS',
comment => 'Percentage of CPU for OTHER_GROUPS',
mgmt_p1 => 50);
-- persist plan to the database
EXEC dbms_resource_manager.submit_pending_area();
-- Now that the resource plan is defined, enable it by setting
-- the resource_manager_plan parameter with the resource plan name
ALTER SYSTEM SET resource_manager_plan = 'SIMPLE_RESOURCE_PLAN';
-- DBA can also enable a resource plan for the period of time corresponding
-- to a job scheduler Window (via the dbms_scheduler.create_window procedure)

関連項目

- Oracle Database管理者ガイド

モデル構築の管理

マイニング・モデルを構築するプロセスは、大量のシステム・リソースを消費することがあります。MAX_NUM_THREADSリポジトリ・プロパティの値を増減して、システム・リソース全体へのモデル構築の影響を制御できます。

MAX_NUM_THREADSは、Oracle Data Minerセッションのすべてのワークフロー全体で同時実行できるマイニング・モデル構築の最大数を指定します。MAX_NUM_THREADSは、個別に起動された、ワークフローに属していないモデル構築には影響を及ぼしません。

たとえば、あるワークフローが25のモデルを構築しようとしていて、別のワークフローが15のモデルを構築しようとしており、MAX_NUM_THREADSが10である場合、10のモデル構築操作が同時に発生し、残り30のモデル構築はキューに入れられます。遅延された構築プロセスは、完了時に、遅延の理由を説明する警告メッセージを表示します。2つの追加のプロパティ、THREAD_WAIT_TIMEおよびMAX_THREAD_WAITは、モデル構築のキューイングを制御します。詳細は、表6-1を参照してください。

例6-2に、最大同時モデル構築数を10(デフォルト)から15に増やす方法を示します。

このスクリプトにより、次のログが作成されます。

-- value of MAX_NUM_THREADS before update
SELECT property_name, property_num_value
FROM ODMRSYS.ODMR$REPOSITORY_PROPERTIES
WHERE property_name = 'MAX_NUM_THREADS';
PROPERTY_NAME PROPERTY_NUM_VALUE
------------------------------ ----------------------
MAX_NUM_THREADS 10
-- update MAX_NUM_THREADS
UPDATE ODMRSYS.ODMR$REPOSITORY_PROPERTIES
SET property_num_value = 15
WHERE property_name = 'MAX_NUM_THREADS';
1 rows updated
-- commit change
commit
committed
-- value of MAX_NUM_THREADS after update
SELECT property_name, property_num_value
FROM ODMRSYS.ODMR$REPOSITORY_PROPERTIES
WHERE property_name = 'MAX_NUM_THREADS';
PROPERTY_NAME PROPERTY_NUM_VALUE
------------------------------ ----------------------
MAX_NUM_THREADS 15

例6-2 最大同時モデル構築数の変更

set echo on;
-- value of MAX_NUM_THREADS before update
SELECT property_name, property_num_value
FROM ODMRSYS.ODMR$REPOSITORY_PROPERTIES
WHERE property_name = 'MAX_NUM_THREADS';
-- update MAX_NUM_THREADS
UPDATE ODMRSYS.ODMR$REPOSITORY_PROPERTIES
SET property_num_value = 15
WHERE property_name = 'MAX_NUM_THREADS';
-- commit change
COMMIT;
-- value of MAX_NUM_THREADS after update
SELECT property_name, property_num_value
FROM ODMRSYS.ODMR$REPOSITORY_PROPERTIES
WHERE property_name = 'MAX_NUM_THREADS';

ワークフロー実行の管理

Oracle Data Minerは、ワークフローを、Schedulerジョブとして実行するために、Oracle Database Schedulerに送信します。Oracle Schedulerは、システム・リソースの割り当て方法を制御する様々な機能をサポートしています。Oracle Schedulerを構成すると、実行リクエストの大きなプールを効果的に管理できます。

Oracle Data Minerは、デフォルトのSchedulerジョブ・クラス、DEFAULT_JOB_CLASSを、自身のデフォルトとして使用します。リソース・プランでは、DEFAULT_JOB_CLASSとして実行されるジョブはいかなるコンシューマ・グループにも割り当てられず、デフォルト・クラスを持つジョブの場合、システム・リソースへのアクセスは制限されません。ジョブ・クラスをコンシューマ・グループに基づくクラスに変更するには、Oracle Data Minerリポジトリ・プロパティWORKFLOW_JOB_CLASSを設定します。

例6-3は、負荷の高いワークロード・ジョブにCPUを多く割り当てるために以前に作成されたコンシューマ・グループHEAVY_LOAD_RESOURCE_GROUPに基づいてMINING_CLASSジョブ・クラスを作成できることを示しています。WORKFLOW_JOB_CLASSを更新する場合、ワークフローは、このコンシューマ・グループに制限されたシステム・リソースへのアクセスを伴って実行されます。ワークフローの実行時に、割り当てられたHEAVY_LOAD_RESOURCE_GROUPグループのリソース・プランがアクティブである必要があります。Schedulerのウィンドウを設定して、特定の期間に特定のリソース・プランをアクティブにできます。

例6-3 Oracle Data MinerワークフローのSchedulerジョブ・クラスの変更

connect sys as sysdba;
Enter password: password
EXEC DBMS_SCHEDULER.CREATE_JOB_CLASS(
job_class_name => 'MINING_CLASS',
resource_consumer_group => 'HEAVY_LOAD_RESOURCE_GROUP');
GRANT EXECUTE ON MINING_CLASS to DMUSER;
-- update WORKFLOW_JOB_CLASS
UPDATE ODMRSYS.ODMR$REPOSITORY_PROPERTIES
SET property_str_value = 'MINING_CLASS'
WHERE property_name = 'WORKFLOW_JOB_CLASS';
-- commit change
commit;
-- verify value of WORKFLOW_JOB_CLASS after update
SELECT property_name, property_str_value
FROM ODMRSYS.ODMR$REPOSITORY_PROPERTIES
WHERE property_name = 'WORKFLOW_JOB_CLASS';

関連項目

- Oracle Database管理者ガイド

- Oracle Database PL/SQLパッケージ・プロシージャおよびタイプ・リファレンス

パラレル処理の管理

Oracle Data Minerのワークフローとビューア、および大部分のData Miningアルゴリズムは、データベースでパラレル処理が有効である場合、その利点を活用できます。INIT.ORAのパラメータは、パラレル処理の動作を制御します。デフォルトでは、パラレル実行は無効になっています(PARALLEL_DEGREE_POLICY=MANUAL)。

問合せのパラレル処理は、システムによって決定することも、並列度に設定することもできます。パラレル処理がシステムで決定される場合、データベースが、すべてのSQL文の並列度の値を動的に決定します。

より多くのリソースを使用すれば操作がより早く完了するとの想定で、Oracle Databaseのパラレル機能は最大リソースを使用するように設計されています。マルチユーザー環境では、並列度の使用を増やすとシステム・リソースが速く枯渇し、同時にパラレル文を実行する他のユーザーのリソースを低下させます。

Oracle Data Minerワークフローはパラレル問合せ機能をサポートしているため、ユーザーは特定のノードまたはワークフロー全体のパラレル処理を手動で有効化できます。この機能を無効にするには、Oracle Data Minerリポジトリ・プロパティPARALLEL_QUERY_ON_ALLOWEDをFALSEに設定します。デフォルトでは、このプロパティはTRUEに設定されます。例6-4に、Oracle Data Minerのパラレル問合せ処理機能を無効にする方法を示します。

Oracle Data Minerのモデル構築プロセスにより、データベース構成で許可されている場合、多数のパラレル・セッションが生成されることがあります。システム全体への影響を限定するためには、適切なリソース・プランを実装し、必要に応じて、ユーザーがData Minerセッション内でパラレル問合せを設定しないようにします。

例6-4 Oracle Data Minerのワークフローおよびノードのパラレル問合せ機能の無効化

connect sys as sysdba;
Enter password: password
-- value of PARALLEL_QUERY_ON_ALLOWED before update
SELECT property_name, property_str_value
FROM ODMRSYS.ODMR$REPOSITORY_PROPERTIES
WHERE property_name = 'PARALLEL_QUERY_ON_ALLOWED';
-- update PARALLEL_QUERY_ON_ALLOWED
UPDATE ODMRSYS.ODMR$REPOSITORY_PROPERTIES
SET property_str_value = 'FALSE'
WHERE property_name = 'PARALLEL_QUERY_ON_ALLOWED';
-- commit change
COMMIT;
-- verify value of PARALLEL_QUERY_ON_ALLOWED after update
SELECT property_name, property_str_value
FROM ODMRSYS.ODMR$REPOSITORY_PROPERTIES
WHERE property_name = 'PARALLEL_QUERY_ON_ALLOWED';

connect sys as sysdba;
Enter password: password
-- value of PARALLEL_QUERY_ON_ALLOWED before update
SELECT property_name, property_str_value
FROM ODMRSYS.ODMR$REPOSITORY_PROPERTIES
WHERE property_name = 'PARALLEL_QUERY_ON_ALLOWED';
-- update PARALLEL_QUERY_ON_ALLOWED
UPDATE ODMRSYS.ODMR$REPOSITORY_PROPERTIES
SET property_str_value = 'FALSE'
WHERE property_name = 'PARALLEL_QUERY_ON_ALLOWED';
-- commit change
COMMIT;
-- verify value of PARALLEL_QUERY_ON_ALLOWED after update
SELECT property_name, property_str_value
FROM ODMRSYS.ODMR$REPOSITORY_PROPERTIES
WHERE property_name = 'PARALLEL_QUERY_ON_ALLOWED';

関連項目

- 『Oracle Database VLDBおよびパーティショニング・ガイド』

システム管理用のOracle Data Minerリポジトリ・プロパティのサマリー

Oracle Data Minerリポジトリでシステム管理プロパティのサマリーを利用できます。

表6-1に、Oracle Data Minerリポジトリで利用できるシステム管理プロパティのサマリーを示します。

表6-1 システム管理用のOracle Data Minerリポジトリ・プロパティ

プロパティ

タイプ

説明

PARALLEL_QUERY_ON_ALLOWED

ブール値

ユーザーがノードまたはワークフローに対するパラレル問合せを指定できるかどうかを示します。値はTRUEまたはFALSEです。デフォルトはTRUEです。

MAX_NUM_THREADS

整数

最大同時モデル構築数。デフォルトは10です。

THREAD_WAIT_TIME

整数

MAX_NUM_THREADSに達すると、パラレル・モデル構築数がMAX_NUM_THREADS未満になるまで、未処理のモデル構築プロセスがキューに入れられます。THREAD_WAIT_TIME設定は、パラレル・モデル構築数を確認するまでの待機時間の長さを決定します。デフォルトの待機時間は5秒です。

MAX_THREAD_WAIT

整数

キューに入っているモデル構築プロセスのタイムアウト間隔(単位は秒)。タイムアウトが発生すると、構築プロセスは、プロセス・ロック待機タイムアウト間隔を超えたことを示すエラー・メッセージとともに終了します。値がNULLの場合、タイムアウトは発生しません。デフォルトはNULLです

MAX_STRING_SIZE

VARCHAR2、NVARCHAR2

Oracle Data Minerによって生成された表内のデータ型VARCHAR2およびNVARCHAR2の最大サイズを制御します。このプロパティは、MAX_STRING_SIZEデータベース・プロパティの値から初期化されます。このプロパティはOracle Data Miner17.2で利用できます。

注意:
MAX_STRING_SIZEデータベース・プロパティを変更した場合は、値が一致するようにODMR$REPOSITORY_PROPERTIESのMAX_STRING_SIZEプロパティを更新する必要があります。値が同期していない場合、ODMrランタイム・エラーが発生することがあります。

WORKFLOW_JOB_CLASS

Varchar

ワークフロー用のOracle Schedulerジョブ・クラス。デフォルトは、DEFAULT_JOB_CLASSです。

POLLING_IDLE_RATE

NUMBER

明らかに実行中と検出されるワークフローがない場合に、Oracle Data Minerクライアントがデータベースをポーリングするレートです。デフォルトは　30000ミリ秒(内部デフォルト)です。リポジトリ・プロパティ表の実際の値は0です。管理者が値をゼロ以外の値に変更した場合、それがアクティブな設定になります。

POLLING_ACTIVE_RATE

NUMBER

実行中と検出されるワークフローがある場合に、Oracle Data Minerクライアントがデータベースをポーリングするレートです。デフォルトは　1500ミリ秒(内部デフォルト)です。リポジトリ・プロパティ設定の実際のデフォルトは0です。ゼロ以外の値に変更した場合、それがアクティブな設定になります。

POLLING_COMPLETED_WINDOW

NUMBER

完了したワークフローをポーリング問合せ結果に含めるための時間です。リポジトリのデフォルトは0です。クライアント・レベルのデフォルトは24.です。ゼロ以外の値に変更された場合、この設定が、ユーザーが利用できるクライアント・レベルのプリファレンス設定より優先されます。

PURGE_WORKFLOW_SCHEDULER_OBJS

VARCHAR2

実行中のワークフローによって生成された古いOracle Schedulerオブジェクトをパージします。

- TRUE (デフォルト)。Oracle Schedulerオブジェクトを自動的にパージします。

- FALSE。Oracle Schedulerオブジェクトをパージしません。ワークフローが検出された場合、Oracle Schedulerオブジェクトはパージされます。
ワークフローの問題に優先順位を付ける必要がある場合は、FALSEオプションを使用することをお薦めします。優先順位を付け終わった後は、TRUEに設定する必要があります。

PURGE_WORKFLOW_EVENT_LOG

NUMBER

イベント・ログに保持される各ワークフローのワークフロー実行数を制御します。この制限内に収まるように、古いワークフローのイベントはパージされます。デフォルトは2です。

注意:
値0を指定した場合、Oracle Data Minerはワークフロー・イベントをパージしません。イベント・ログのサイズが上昇し、問合せのパフォーマンスに影響を与えるため、これはお薦めしません。

7 SQLスクリプトの生成とデプロイ

SQLスクリプトの生成は、Oracle Data Minerで利用できる機能です。この章では、この機能の説明となる概要とユースケースを提供します。

- SQLスクリプト生成機能の概要
Oracle Data MinerにはSQLスクリプト生成機能が用意されており、この機能を使用して、ワークフロー内の1つまたはすべてのノード用にSQLスクリプトを生成できます。その後で、SQLスクリプトを別のアプリケーションに統合できます。

- SQLスクリプト生成ユースケースの概要
SQLスクリプト生成機能について、サンプル・ワークフローcodegen_workflowとデモ・データベーステーブルINSUR_CUST_LTV_SAMPLEを使用するユースケースを援用しつつ説明します。

- ワークフローからのSQLスクリプト・ファイルの生成
SQLスクリプトを生成する前に、ワークフローを実行する必要があります。

- ワークフロー・スクリプト・ファイルのスケジューリング
生成されたすべてのSQLスクリプト・ファイルは、データベース・インスタンスがアクセスできるターゲットまたは本番データベース・ホストにデプロイする必要があります。SQLスクリプト・ファイルは、同じディレクトリに一緒に格納する必要があります。

- ターゲット・データベースへのSQLスクリプトのデプロイ
SQLスクリプトのデプロイには、ベース・ディレクトリからのマスター・スクリプト・ファイルの実行が必要です。

SQLスクリプト生成機能の概要

Oracle Data MinerにはSQLスクリプト生成機能が用意されており、この機能を使用して、ワークフロー内の1つまたはすべてのノード用にSQLスクリプトを生成できます。その後で、SQLスクリプトを別のアプリケーションに統合できます。

このように、Oracle Data Minerは、データ・マイニングを別のエンド・ユーザー・アプリケーションと統合するためのスコープを提供します。ユースケースを援用しつつ、この機能について詳しく説明します。

関連項目

- SQLスクリプト生成ユースケースの概要

SQLスクリプト生成ユースケースの概要

SQLスクリプト生成機能について、サンプル・ワークフローcodegen_workflowとデモ・データベーステーブルINSUR_CUST_LTV_SAMPLEを使用するユースケースを援用しつつ説明します。

このユースケースは、次を行う方法を示します。

- ワークフローcodegen_workflowのインポート、実行およびデプロイ

- ワークフローcodegen_workflowからのSQLスクリプトの生成

- 次を使用する、データベース上でのSQLスクリプトの実行のスケジューリング

- Oracle SQL Developer

- Oracle Enterprise Manager

- 生成されたSQLスクリプトの、ターゲットまたは本番データベース上へのデプロイ

- SQLスクリプト生成ユースケースの前提
この項で説明するSQLスクリプト生成ユースケースは、次の前提に基づいています。

- サンプル・ワークフローについて
サンプル・ワークフローcodegen_workflow,はデータ・モデリングとデータ・スコアリングを示します。

- 前提タスクの実行
ワークフローをデプロイする前に、実行する必要のあるタスクがあります。

- ワークフローのインポートと実行
事前定義済のワークフローをプロジェクトにインポートできます。

関連項目

- デモ・ワークフロー・ファイルの場所

SQLスクリプト生成ユースケースの前提

この項で説明するSQLスクリプト生成ユースケースは、次の前提に基づいています。

- データ・アナリストが、モデル構築とスコアリングのワークフローを定義します。

- データ・アナリストは、新しいスクリプト生成機能を使用して、SQLスクリプト一式をデプロイメントのためにアプリケーション開発者に渡します。

- アプリケーション開発者は、スクリプトをターゲットまたは本番データベースにデプロイし、そこで、定期的なスクリプトの実行をスケジュールすることができます。これにより、スクリプト実行のたびに、新しい顧客データを使用してモデルを作成できます。

- デモ・データベース: このユースケースは、ユーザー・アカウントにインストールできるデモ・データベース表INSUR_CUST_LTV_SAMPLEを使用します。

- 事前定義済ワークフロー: このユースケースでは、事前定義済ワークフローcodegen_workflowを援用して手順を説明します。

- デモ・ワークフロー・ファイルの場所
事前定義済ワークフローを含むワークフロー・ファイルcodegen_workflow.xmlは、SQL Developerのインストール場所(sqldeveloper_home\dataminer\demos\workflows)から利用できます。

関連項目

- サンプル・ワークフローについて

- 前提条件となるタスクの実行

- スクリプトを使用したサンプル・データのロード

デモ・ワークフロー・ファイルの場所

事前定義済ワークフローを含むワークフロー・ファイルcodegen_workflow.xmlは、SQL Developerのインストール場所(sqldeveloper_home\dataminer\demos\workflows)から利用できます。

サンプル・ワークフローについて

サンプル・ワークフローcodegen_workflow,は、データ・モデリングとデータ・スコアリングを示します。

このユースケースcodegen_workflowのサンプル・ワークフローは、単一の系統に含まれる2つの異なったプロセス(図7-1に示すモデリング(上)とスコアリング(下))から構成されます。どちらの処理も、入力データ・ソースとしてデモ・データINSUR_CUST_LTV_SAMPLEを使用します。

図7-1 サンプル・ワークフロー - codegen_workflow

- モデリング: モデリング・プロセスにより、分類サポート・ベクター・マシン(SVM)モデルが構築されます。顧客が保険を買うかどうかを予測します。モデル係数は、表示のためにデータベース表に永続化されます。この表がアプリケーション統合の基盤になる場合があります。

- スコアリング: スコアリング・プロセスは、モデリング系統によって作成されたサポート・ベクター・マシン(SVM)モデルを使用して顧客データを予測します。予測結果は、表示のためにデータベース・ビューに永続化されます。このビューは、次のものを提供します。

- 現在の入力データの予測。たとえば、入力表が新しいデータでリフレッシュされた場合、このビューは新しいデータの予測を自動的に取得します。

- アプリケーション統合の基礎。

関連項目

- SQLスクリプト生成ユースケースの前提

- 前提条件となるタスクの実行

- デモ・ワークフロー・ファイルの場所

前提条件となるタスクの実行

ワークフローをデプロイする前に、実行する必要のあるタスクがあります。

必須のタスクは次のとおりです。

1. システム上にOracle Data Miner をインストールします。

2. Oracle Data Minerユーザー・アカウントを作成します。

Data Miningユーザー・アカウントを作成するサンプル文の例を示します。この文は、権限のあるユーザーによって発行される必要があります。

grant create session, create table, create view,

create mining model, create procedure,

unlimited tablespace

to <username>;

3. データベース表をロードします。

4. ワークフローをインポートして、実行します。

関連項目

- Oracle Data Minerのインストール

- Oracle By Exampleチュートリアル

- ワークフローのインポートと実行

- スクリプトを使用したサンプル・データのロード

ワークフローのインポートと実行

事前定義済のワークフローをプロジェクトにインポートできます。

事前定義済のworkflow_codegen.xmlをインポートする手順:

1. SQL Developerで、「Data Miner」タブに移動し、接続を展開します。

2. 接続を右クリックして、「新規プロジェクト」をクリックします。

3. 作成したばかりのプロジェクトを右クリックして、「ワークフローのインポート」を選択します。

4. 「ワークフローのインポート」ダイアログ・ボックスで、サンプル・ワークフロー・ファイルcodegen_workflow.xmlをダウンロードして保存した場所を参照します。codegen_workflow.xmlを選択し、「OK」をクリックします。図7-2に示すように、インポートしたワークフローcodegen_workflowが、Oracle Data MinerのUIに表示されるようになりました。

図7-2 インポート後のcodegen_workflow

5. INSUR_CUST_LTV_SAMPLE_BUILDノードを右クリックし、「実行の強制」をクリックします。

6. 「実行の強制」サブメニューで、オプション「選択されたノードと子」を選択します。これにより、codegen_workflow内のすべてのノードが実行されます。ワークフローが正常に実行されると、図7-3に示すように、ワークフローのすべてのノードが、緑のチェック・マークで表されます。

図7-3 実行後のcodegen_workflow

これにより、ワークフローをインポートおよび実行するタスクが完了します。

関連項目

- ワークフロー・スクリプト・ファイルのスケジューリング

- ターゲット・データベースへのSQLスクリプトのデプロイ

- デモ・ワークフロー・ファイルの場所

ワークフローからのSQLスクリプト・ファイルの生成

SQLスクリプトを生成する前に、ワークフローを実行する必要があります。

ワークフローからSQLスクリプト・ファイルを生成する手順:

1. 任意のノードを右クリックして、「デプロイ」を選択します。このユースケースでは、INSUR_CUST_LTV_SAMPLE BUILDノードを右クリックし、「デプロイ」の下の、「選択したノードと接続ノード」オプションを選択します。

注意:

このユースケースの場合、事前定義済ワークフローcodegen_workflowが使用されます。

スクリプト・デプロイメント・オプションは次のとおりです。

- 選択したノードと接続ノード: このオプションは、選択したノードとそのすべての親ノードのためのSQLスクリプトを生成します。たとえば、図7-3に示すように、適用ノードが選択された場合、次のノードのためのスクリプトが生成されます。

- INSUR_CUST_LTV_SAMPLE BUILD

- 分類構築

- INSUR_CUST_LTV_SAMPLE APPLY

- 適用

- 選択したノード、依存ノード、子ノード: このオプションは、選択したノードとそのすべての親および子ノードのためのスクリプトを生成します。たとえば、図7-3に示すように、適用ノードが選択された場合、次のノードのためのスクリプトが生成されます。

- INSUR_CUST_LTV_SAMPLE BUILD

- 分類構築

- INSUR_CUST_LTV_SAMPLE APPLY

- 適用

- SCORED_CUSTOMERS

- 選択したノードと接続ノード: このオプションは、選択したノードと、選択したノードに接続されるすべてのノードのためのスクリプトを生成します。たとえば、図7-3に示すように、適用ノードが選択された場合、ワークフロー内の適用ノードに接続されたすべてのノードのためのスクリプトが生成されます。

注意:

ワークフロー全体のためのスクリプトを生成するには、ワークフロー内のすべてのノードを選択して([Ctrl]キーを同時に押しながらすべてのノードをクリック)、前述の3つのデプロイメント・オプションのいずれかを選択します。

2. 「デプロイ」オプションを選択した後、図7-4に示すように、SQLスクリプトの生成 - ステップ1/2ウィザードが開きます。

図7-4 SQLスクリプトの生成 - ステップ1/2ウィザード

3. 「ターゲット・データベースのバージョン」フィールドで、データベース・バージョンを選択します。生成されたスクリプトに、ここで選択したデータベースのバージョンとの互換性があることを確認します。これは、SQLスクリプトが実行されるデータベースです。

4. 「次へ」をクリックします。図7-5に示すように、SQLスクリプトの生成 - ステップ2/2ウィンドウが開きます。

図7-5 SQLスクリプトの生成 - ステップ1/2ウィザード

5. スクリプトの生成ウィザード・ダイアログ・ボックスのステップ2で、次の情報を入力します。

- スクリプト・ディレクトリ: これは、生成されたスクリプトが格納されるディレクトリの名前です。

- ベース・ディレクトリ: 「参照」をクリックして別の場所に移動して、スクリプトのディレクトリを作成します。

- ディレクトリ・パス: スクリプト・ディレクトリのパスを表示します。

6. 「終了」をクリックします。これは、スクリプト生成プロセスを起動します。スクリプトが正常に生成されると、図7-6に示すように、次のメッセージが表示されます。「OK」をクリックします。

図7-6 「コードのデプロイ」ダイアログ・ボックス

ステップ5で定義したスクリプト・ディレクトリで、生成されたスクリプトのリストを確認できます。

- 生成されたSQLスクリプト・ファイルのリスト
codegen_workflow,から生成されたStructured Query Language (SQL)スクリプト・ファイルは、関連オブジェクトのクリーンアップおよびその他のノード固有の操作であるジョブを実行します。

- スクリプト・ファイルの変数定義
ノードのために生成されたSQLスクリプトには、スクリプトによって作成されたパブリック・オブジェクトにオブジェクト名を提供する変数定義があります。マスター・スクリプトは、基礎となるノード・レベル・スクリプトをすべて、適切な順序で起動します。そのため、すべての変数定義は、マスター・スクリプトで定義される必要があります。

- 制御表
マスター・スクリプトworkflow name_Run.sqlが実行されているとき、制御表名変数で指定された名前を使用して、制御表が先に作成されます。

生成されたSQLスクリプト・ファイルのリスト

codegen_workflow,から生成されたStructured Query Language (SQL)スクリプト・ファイルは、関連オブジェクトのクリーンアップおよびその他のノード固有の操作であるジョブを実行します。

表7-1に、codegen_workflowから生成されたSQLスクリプト・ファイルとその説明をリストします。

表7-1 生成されたスクリプト・ファイルとその説明

スクリプト・ファイルのタイプ

スクリプト・ファイル名

codegen_workflowから生成されたスクリプト・ファイルの例

説明

マスター・スクリプト

workflow name_Run.sql

codegen_workflow_Run.sql

必要なすべてのノード・レベル・スクリプトを正しい順序で起動します。それは次のタスクを実行します:

- スクリプト・ファイルのバージョンの、Data Minerリポジトリのバージョンとの互換性を検証します。

- ワークフロー・スクリプトによって作成されたすべての基礎オブジェクトのエントリを含む、ワークフローのマスター表を作成します。

クリーンアップ・スクリプト

workflow name_Drop.sql

codegen_workflow_Drop.sql

マスター・スクリプトによって作成されたすべてのオブジェクトを削除します。次を削除します。

- データ・ノードの参照用に生成された表などの非表示オブジェクト。

- 構築ノードによって作成されたモデル名などのパブリック・オブジェクト。

- 表作成ノードによって作成された表。

ワークフローのイメージ

workflow name.png

codegen_workflow.png

これは、スクリプト生成時におけるワークフローのイメージです。

ノード・スクリプト

node name.sql

- Apply.sql

- Class Build.sql

- Coefficients.sql

- INSUR_CUST_LTV_SAMPLE APPLY.sql

- INSUR_CUST_LTV_SAMPLE BUILD.sql

- MODEL_COEFFICIENTS.sql

- SCORED_CUSTOMERS.sql

構築ノードのモデル作成など、ノード固有の操作を実行します。スクリプト生成に参加する各ノードにつき、1つのノード・スクリプトが生成されます。

スクリプト・ファイルの変数定義

ノードのために生成されたSQLスクリプトには、スクリプトによって作成されたパブリック・オブジェクトにオブジェクト名を提供する変数定義があります。マスター・スクリプトは、基礎となるノード・レベル・スクリプトをすべて、適切な順序で起動します。そのため、すべての変数定義は、マスター・スクリプトで定義される必要があります。

次の変数がサポートされます。

- 表またはビューおよびモデルなど、ノード・レベル・スクリプトに入力されるオブジェクトの名前の変更を可能にする変数。デフォルトでは、これらの名前は、表またはビュー名、およびモデルの元の名前です。

- 制御表の名前の変更を可能にする変数。デフォルトで、制御表の名前は、ワークフロー名です。

- 名前付きオブジェクトを、スクリプトによって生成される前に、先に削除するべきかどうかを示す変数。

制御表

マスター・スクリプトworkflow name_Run.sqlが実行されているとき、制御表名変数で指定された名前を使用して、制御表が先に作成されます。

制御表は、次を実行します。

- ビュー、モデル、テキスト仕様など、生成されたオブジェクトを登録します

- ワークフロー内で入力オブジェクトが論理ノードによって参照されるのを可能にし、出力オブジェクトを登録します

- クリーンアップ・スクリプトによって削除する必要があるオブジェクトを決定します

- ワークフローを介してすぐにアクセスできないオブジェクトの内部名を提供します。たとえば、ユーザーは、制御表の表示によって、モデル・テスト結果表を見つけることができます。

- 異なる制御ファイル名と異なる出力変数名を使用すると、生成されたスクリプトを使用して、異なる結果を同時に生成、管理できます。これは、入力データ・ソースが、独立にマイニングするデータの異なるセットを継続する場合に、役に立つ場合があります。このユースケースでは、アプリケーションは、生成された結果の再実行または削除時に利用できるように、制御表の名前を保存する役割を果たします。

- 制御表の構造
マスター・スクリプトworkflow name_Run.sqlが実行されているときに、制御表名変数で指定された名前を使用して、制御表が先に作成されます

- 制御表の列
制御表の列には、ノードとモデルに関連する情報が含まれます。

関連項目

- 制御表の問合せ

制御表の構造

マスター・スクリプトworkflow name_Run.sqlが実行されているときに、制御表名変数で指定された名前を使用して、制御表が先に作成されます

制御表の構造は、次のとおりです。

CREATE TABLE "&WORKFLOW_OUTPUT"

(

NODE_ID VARCHAR2(30) NOT NULL,

NODE_NAME VARCHAR2(128) NOT NULL,

NODE_TYPE VARCHAR2(30) NOT NULL,

MODEL_ID VARCHAR2(30),

MODEL_NAME VARCHAR2(128),

MODEL_TYPE VARCHAR2(35),

OUTPUT_NAME VARCHAR2(30) NOT NULL,

OUTPUT_TYPE VARCHAR2(30) NOT NULL,

ADDITIONAL_INFO VARCHAR2(65),

CREATION_TIME TIMESTAMP(6) NOT NULL,

COMMENTS VARCHAR2(4000 CHAR)

)

制御表の列

制御表の列には、ノードとモデルに関連する情報が含まれます。

表7-2に、制御表の列と、その説明および例をリストします。

表7-2 制御表の列とその説明

列名

説明

例

NODE_ID

これは、ワークフローの一部を構成するノードのIDです。ノードを一意に識別します。

10001, 10002

NODE_NAME

これは、ワークフローの一部を構成するノードの名前です。

分類構築、MINING_DATA_BUILD_V

NODE_TYPE

これは、ノードのカテゴリです。

データソース・ノード、分類構築ノードなど。

MODEL_ID

これは、ワークフロー・モデルのIDです。ワークフロー内で参照される各モデルを一意に識別します。

10101, 10102

MODEL_NAME

これは、モデルの名前です。

CLAS_GLM_1_6

MODEL_TYPE

モデル・タイプは、モデルが使用するアルゴリズム・タイプです。

一般化線形モデル、Support Vector Machineなど

OUTPUT_NAME

これは、出力の名前です。名前がユーザーの管理下にあるのでない限り、これは内部的に生成された名前です。

表/ビュー名、モデル名、テキスト・オブジェクト名。例:

ODMR$15_37_21_839599RMAFRXI - 表名

"DMUSER"."CLAS_GLM_1_6" - 完全修飾モデル名

OUTPUT_TYPE

出力オブジェクトのタイプを制限します。

表、ビュー、モデル

ADDITIONAL_INFO

これは、スクリプト実行に関するオブジェクトの目的を修飾する情報です。

テスト・リフト結果のためのターゲット・クラス

CREATION_TIME

これは、オブジェクト作成時刻です。

11-DEC-12 03.37.25.935193000 PM (形式はロケールにより決定)

COMMENTS

スクリプト実行に関するオブジェクトのロールを修飾するコメント。

出力データ(データソースのようなノードに表示される)

データの使用方法(モデル構築に渡されるビューに表示される)

重みの設定(モデル構築に渡される重みの表に表示される)

構築設定(モデル構築に渡される構築設定表に表示される)

モデル(モデル・オブジェクトに表示される)

ワークフロー・スクリプト・ファイルのスケジューリング

生成されたすべてのSQLスクリプト・ファイルは、データベース・インスタンスがアクセスできるターゲットまたは本番データベースにデプロイする必要があります。SQLスクリプト・ファイルは、同じディレクトリに一緒に格納する必要があります。

この項では、SQL DeveloperとOracle Enterprise Managerを使用して、マスター・スクリプトの実行をスケジュールする方法を説明します。

- ワークフロー・スクリプト・ファイルのスケジューリングの前提条件
ワークフロー・スクリプト・ファイルをスケジューリングする前に、Oracle Database、SQLスクリプト・ファイル、Oracle Data MinerリポジトリおよびOracle Data Minerユーザー・アカウントに関連する特定のタスクを実行する必要があります。

- SQL Developerを使用したSQLスクリプトのスケジューリング
Oracle SQL Developerには、Schedulerジョブを定義するためのグラフィカル・ユーザー・インタフェースがあります。

- Oracle Enterprise Managerを使用したSQLスクリプトのスケジューリング
Oracle Enterprise Managerを使用すると、データベース管理者はジョブを定義できます。ジョブの定義は、完全なファイル・パスを使用して、スクリプト・ファイルとしてマスター・スクリプトの起動を定義します。

ワークフロー・スクリプト・ファイルのスケジューリングの前提条件

ワークフロー・スクリプト・ファイルをスケジューリングする前に、Oracle Database、SQLスクリプト・ファイル、Oracle Data MinerリポジトリおよびOracle Data Minerユーザー・アカウントに関連する特定のタスクを実行する必要があります。

SQLスクリプト・ファイルをスケジュールする前提条件は、次のとおりです。

- Oracle Database: 生成されたSQLスクリプト・ファイルをスケジュールするには、Oracle Databaseのインスタンスが必須です。

- SQLスクリプト・ファイル: 生成されたすべてのSQLスクリプト・ファイルは、データベース・インスタンスがアクセスできるターゲットまたは本番データベース・ホストにデプロイする必要があります。すべてのスクリプト・ファイルを、同じディレクトリに一緒に格納する必要があります。

- Oracle Data Minerリポジトリ: リポジトリが提供するサービスを一部のノード・スクリプトが実行時に使用するため、スクリプトを実行するにはData Minerリポジトリが必須です。リポジトリが提供するサービスの例には、Explorerノードのための統計計算、テキストの構築ノードのためのテキスト処理などがあります。

- Oracle Data Minerユーザー・アカウント: リポジトリが提供するサービスに必要な権限をユーザー・アカウントが持っているため、スクリプト・ファイルの実行には必須です。

- マスター・スクリプト・ファイル内の完全なディレクトリ・パス: マスター・スクリプト内の各ノード・スクリプトの起動への完全なディレクトリ・パスを追加します。これは、実行時にマスター・スクリプトが個々のノード・スクリプト・ファイルをコールするために必須です。

- マスター・スクリプトへの完全なディレクトリ・パスの追加
マスター・スクリプト・ファイルを編集して、マスター・スクリプトcodegen_workflow_Run.sqlに完全なディレクトリ・パスを追加できます。

- データベース・ホストとデータベース用の資格証明の作成
資格証明はOracle Schedulerオブジェクトで、専用のデータベース・オブジェクトに格納されるユーザー名とパスワードのペアです。

マスター・スクリプトへの完全なディレクトリ・パスの追加

マスター・スクリプト・ファイルを編集して、マスター・スクリプトcodegen_workflow_Run.sqlに完全なディレクトリ・パスを追加できます。

マスター・スクリプトに完全なディレクトリ・パスを追加する手順:

1. マスター・スクリプトcodegen_workflow_Run.sqlを開いて、次の行を見つけます。

-- Workflow run

@@"INSUR_CUST_LTV_SAMPLE BUILD.sql";

@@"INSUR_CUST_LTV_SAMPLE APPLY.sql";

@@"Class Build.sql"; @@"Coefficients.sql";

@@"MODEL_COEFFCIENTS.sql";

@@"Apply.sql";

@@"SCORED_CUSTOMERS.sql";

2. マスター・スクリプト・ファイルを編集して、スクリプトの格納先となるターゲットまたは本番データベースのホスト・コンピュータの完全なディレクトリ・パスを追加します。この例では、スクリプト・ファイルがhome/workspaceディレクトリにデプロイされると想定されています。次に例を示します。

-- Workflow run

@@"/home/workspace/INSUR_CUST_LTV_SAMPLE BUILD.sql";

@@"/home/workspace/INSUR_CUST_LTV_SAMPLE APPLY.sql";

@@"/home/workspace/Class Build.sql";

@@"/home/workspace/Coefficients.sql";

@@"/home/workspace/MODEL_COEFFCIENTS.sql";

@@"/home/workspace/Apply.sql";

@@"/home/workspace/SCORED_CUSTOMERS.sql";

3. マスター・スクリプト・ファイルを保存して閉じます。

データベース・ホストとデータベース用の資格証明の作成

資格証明はOracle Schedulerオブジェクトで、専用のデータベース・オブジェクトに格納されるユーザー名とパスワードのペアです。

次のように、2つの資格証明を作成する必要があります。

- ホスト資格証明: SQLPlusスクリプト・ジョブは、ホスト資格証明を使用して、SQLPlus実行可能ファイルを実行できるように、データベース・インスタンスまたはオペレーティング・システムに対して自己自身を認証します。

- 接続資格証明: この資格証明には、スクリプトを実行する前にSQLPlusをデータベースに接続するデータベース資格証明が含まれます。

資格証明を作成する手順:

1. 「接続」タブで、ユーザー・アカウントが作成される接続を展開します。

2. その接続の下の「スケジューラ」を展開します。

3. 「スケジューラ」の下で、「資格証明」を右クリックし、「新規資格証明」をクリックします。「資格証明の作成」ダイアログ・ボックスが開きます。

4. まず、ジョブが実行されているホストにログインするためのホスト資格証明を作成します。次の情報を指定します。

a. 名前

b. 「有効」を選択します。

c. 説明

d. ユーザー名

e. パスワード

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

6. 次に、データベース接続のために接続資格証明を作成します。ステップ1からステップ5に記載したのと同じ手順を繰り返します。

これで、データベース・ホストと接続のための資格証明を作成するタスクは完了です。

SQL Developerを使用したSQLスクリプトのスケジューリング

Oracle SQL Developerには、Schedulerジョブを定義するためのグラフィカル・ユーザー・インタフェースがあります。

SQL Developerを使用したStructured Query Language (SQL)スクリプトのスケジューリングには、次が含まれます。

- データベース・ホストとデータベース用の資格証明の作成
資格証明はOracle Schedulerオブジェクトで、専用のデータベース・オブジェクトに格納されるユーザー名とパスワードのペアです。

- ジョブ・ウィザードを使用したSchedulerジョブの定義
ジョブ・ウィザードでジョブ・スケジュールを作成し、それを使用してワークフロー・ジョブを定義できます

データベース・ホストとデータベース用の資格証明の作成

資格証明はOracle Schedulerオブジェクトで、専用のデータベース・オブジェクトに格納されるユーザー名とパスワードのペアです。

次のように、2つの資格証明を作成する必要があります。

- ホスト資格証明: SQLPlusスクリプト・ジョブは、ホスト資格証明を使用して、SQLPlus実行可能ファイルを実行できるように、データベース・インスタンスまたはオペレーティング・システムに対して自己自身を認証します。

- 接続資格証明: この資格証明には、スクリプトを実行する前にSQLPlusをデータベースに接続するデータベース資格証明が含まれます。

資格証明を作成する手順:

1. 「接続」タブで、ユーザー・アカウントが作成される接続を展開します。

2. その接続の下の「スケジューラ」を展開します。

3. 「スケジューラ」の下で、「資格証明」を右クリックし、「新規資格証明」をクリックします。「資格証明の作成」ダイアログ・ボックスが開きます。

4. まず、ジョブが実行されているホストにログインするためのホスト資格証明を作成します。次の情報を指定します。

a. 名前

b. 「有効」を選択します。

c. 説明

d. ユーザー名

e. パスワード

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

6. 次に、データベース接続のために接続資格証明を作成します。ステップ1からステップ5に記載したのと同じ手順を繰り返します。

これで、データベース・ホストと接続のための資格証明を作成するタスクは完了です。

ジョブ・ウィザードを使用したSchedulerジョブの定義

ジョブ・ウィザードでジョブ・スケジュールを作成し、それを使用してワークフロー・ジョブを定義できます

ジョブ・スケジュールを定義する手順:

1. SQL Developerの「接続」タブで、ユーザー・アカウントが作成される接続を展開します。

2. その接続の下の「スケジューラ」を展開します。

3. 「スケジューラ」の下で、「ジョブ」を右クリックし、「新規ジョブ」(ウィザード)をクリックします。「ジョブの作成」ダイアログ・ボックスが開きます。

4. 「ジョブ・ウィザードの作成 — ステップ1/6」ダイアログ・ボックスの「ジョブ詳細」に、次の情報を入力します。

a. ジョブ名

b. 「有効」を選択します。

c. 説明

d. ジョブ・クラス

e. ジョブのタイプ。「スクリプト」を選択します。

f. スクリプト・タイプ: 「SQLPlus」を選択します。

g. ジョブの実行時期: 「繰返し間隔」を選択します。

h. 「繰返し間隔」ダイアログ・ボックスで、繰り返し間隔、開始日、時刻を設定して、「OK」をクリックします。

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

5. 「ジョブ・ウィザードの作成 — ステップ2/6」ダイアログ・ボックスで、次の項目を定義します。

a. ドロップダウン・リストからオプション「ローカル」を選択します。

b. 資格証明の選択: ドロップダウン・リストから作成したホスト資格証明を選択します。

c. 接続の資格証明名: ドロップダウン・リストから作成した接続資格証明を選択します。

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

6. 「ジョブ・ウィザードの作成 — ステップ4/6」ダイアログ・ボックスで、ジョブ・ステータスに基づく電子メール通知を設定できます。

a. 「イベントの選択」セクションで、電子メール通知を送信するジョブ・イベントを選択します。

b. 「受信者」フィールドに、電子メール・アドレスを入力します。各メッセージについて、受信者の電子メール・アドレスと送信者(オプション)を指定できます。

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

7. 「ジョブ・ウィザードの作成 — ステップ5/6」ダイアログ・ボックスで、「次」をクリックします。このユースケースでは、このステップはスキップされます。

8. 「ジョブ・ウィザードの作成 — ステップ6/6」ダイアログ・ボックスで、「終了」をクリックします。これで、ジョブ・スケジュールの作成は完了です。

ジョブを作成したら、SQL Developerでそれを監視できます。

関連項目

- データベース・ホストとデータベース用の資格証明の作成

Oracle Enterprise Managerを使用したSQLスクリプトのスケジューリング

Oracle Enterprise Managerを使用すると、データベース管理者がジョブを定義できます。ジョブの定義は、完全なファイル・パスを使用して、スクリプト・ファイルとしてマスター・スクリプトの起動を定義します。

ジョブをスケジュールに従って実行するか、オンデマンドにするかを決定できます。アプリケーションでジョブの実行を監視することもできます。

Oracle Enterprise Managerでジョブをスケジュールする手順:

1. Oracle Databaseアカウントを使用してOracle Enterprise Managerにログインします。

2. 「ジョブ・アクティビティ」セクションで、「ジョブ」をクリックします。ジョブ作成ページが開きます。

3. 「ジョブの作成」ドロップダウン・リストで「SQLスクリプト」を選択し、「実行」をクリックします。新しいジョブを定義できる「ジョブの作成」ページが開きます。

4. 「一般」タブで、次の詳細を入力します。

a. 名前

b. 説明

c. ターゲット・データベース: ジョブが実行されるターゲット・データベースを入力します。

5. 「パラメータ」タブの「SQLスクリプト」セクションに、クリーンアップ・スクリプトとマスター・スクリプトのフル・パス名を入力します。

6. 「資格証明」タブで、次の資格証明を指定します。

- データベース・ホスト資格証明

- データベース資格証明

7. 「スケジュール」タブで、ジョブのスケジュールを定義します。

8. 「アクセス」タブで、ジョブ・ステータスに基づく電子メール通知を設定できます。

9. 「発行」をクリックしてジョブを作成します。

関連項目

- データベース・ホストとデータベース用の資格証明の作成

ターゲット・データベースへのSQLスクリプトのデプロイ

SQLスクリプトのデプロイには、ベース・ディレクトリからのマスター・スクリプト・ファイルの実行が必要です。

SQLスクリプトをデプロイするには、次のマスター・スクリプト・ファイルを実行します。

> @" C: base directory\workflow name_Run.sql"

> @" C: <base directory>\workflow name_Run.sql"

たとえば、SQLPlusで、ベース・ディレクトリから次のマスター・スクリプトcodegen_workflow_Run.sqlを実行します。

>@" C:\code gen\codegen workflow\codegen_workflow_Run.sql"

引き続きマスター・スクリプト・ファイルを実行する必要がある場合は、先にクリーンアップ・スクリプトcodegen_workflow_Drop.sqlを実行して以前に生成されたオブジェクトを削除し、その後で、次のマスター・スクリプトを実行します。

>@" C:\code gen\codegen workflow\codegen_workflow_Drop.sql"

>@" C:\code gen\codegen workflow\codegen_workflow_Run.sql"

- 制御表の問合せ
SQLスクリプトを実行した後で、生成されたオブジェクトを調べるために、制御表を問い合せることができます。

制御表の問合せ

SQLスクリプトを実行した後で、生成されたオブジェクトを調べるために、制御表を問い合わせることができます。

制御表を問い合せるには、SQLPlusで次のコマンドを実行します。

>select * from workflow_name

たとえば、制御表でcodegen_workflowを問い合わせて、生成されたオブジェクトを次のように調べます。

>select * from "codegen_workflow"

図7-7 出力表- 問合せの結果

この例では、表作成ノードMODEL_COEFFICIENTSにより、生成されたSVMモデルから抽出した係数データを永続化した出力表MODEL_COEFFCIENTSが作成されました。

関連項目

- 制御表

- 制御表の構造

8 PL/SQL APIを使用したワークフローの管理

この章では、PL/SQL APIを使用してワークフローを管理する方法を説明します。

- PL/SQL APIについて
Oracle Data Minerには、アプリケーションがOracle Data Minerプロジェクトとワークフローを直接管理できるようにする、リポジトリPL/SQL API一式が付属しています。

- PL/SQL API
PL/SQL APIを使用してプロジェクトとワークフローを管理できます。

- リポジトリ・ビュー
リポジトリ・ビューでは、ワークフローやプロジェクトに関連する情報の問合せ、およびステータスの監視を行うことができます。

- PL/SQL APIユースケース
PL/SQL APIユースケースでは、PL/SQL APIを実行して構築ワークフローとAPPLYワークフローをスケジュールおよび実行する方法を示します。

PL/SQL APIについて

Oracle Data Miner には、アプリケーションがOracle Data Minerプロジェクトとワークフローを直接管理できるようにする、リポジトリPL/SQL API一式が含まれます。

プロジェクトPL/SQL APIはODMR_PROJECTパッケージにあり、ワークフローPL/SQL APIはODMR_WORKFLOWパッケージにあります。どちらのパッケージも、Oracle Data Minerリポジトリ内のODMRSYSスキーマで定義されます。

PL/SQL APIを使用すると、次のことができます。

- Data Minerプロジェクトとワークフローの管理

- ワークフローのスケジュール

- ワークフローの実行

- プロジェクトおよびワークフロー情報の問合せ

- ワークフロー実行ステータスのモニター

- 生成された結果の問合せ

PL/SQL API

PL/SQL APIを使用してプロジェクトとワークフローを管理できます。

PL/SQL APIを使用して、次のタスクを実行します。

- PROJECT_CREATE
ファンクションPROJECT_CREATEは、入力したプロジェクト名を使用してプロジェクトを作成します。このファンクションは、プロジェクトIDを戻します。プロジェクトがすでに存在すると、例外が発生します。

- PROJECT_RENAME
PROJECT_RENAMEプロシージャは、既存のプロジェクトの名前を変更します。新しい名前を持つプロジェクトがすでに存在する場合は、例外が発生します。

- PROJECT_DELETE
プロシージャPROJECT_DELETEを使用すると、1つ以上のプロジェクトと、それに含まれるワークフローを削除できます。Oracle Data Minerでワークフローが実行中か開かれている場合は、例外が発生します。

- WF_RUN
ワークフローを実行するファンクションWF_RUNには、名前、プロジェクトID、ワークフローおよび実行する特定のノードを受け入れるシグネチャが含まれます。

- WF_STOP
プロシージャWF_STOPを使用すると、実行するようにスケジュールされているワークフローを停止またはキャンセルできます。ワークフローがすでに実行中でないか、スケジュールされていない場合、例外が発生します。

- WF_RENAME
プロシージャWF_RENAMEは、既存のワークフローの名前を変更します。

- WF_DELETE
プロシージャWF_DELETEは、ワークフローを、表、ビュー、モデル、テスト結果などの、生成されたすべてのオブジェクトごと削除します。ワークフローがすでに実行中か、Oracle Data Minerによって開かれている場合は、例外が発生します。

- WF_IMPORT
WF_IMPORTファンクションは、(Oracle Data Minerによってエクスポートされた)ワークフローを、指定したプロジェクトにインポートします。ワークフローは後方互換なので、古いバージョンのワークフローを新しいOracle Data Minerリポジトリにインポートできます。

- WF_EXPORT
WF_EXPORTファンクションは、指定したワークフローをエクスポートします。ワークフローがすでに実行中か、Oracle Data Minerによって開かれている場合は、例外が発生します。別の方法として、ワークフローがエクスポートするODMR_USER_PROJECT_WORKFLOWを問い合わせることができます。

PROJECT_CREATE

ファンクションPROJECT_CREATEは、入力したプロジェクト名を使用してプロジェクトを作成します。このファンクションは、プロジェクトIDを戻します。プロジェクトがすでに存在すると、例外が発生します。

ファンクション:

FUNCTION PROJECT_CREATE(p_project_name IN VARCHAR2,
p_comment IN VARCHAR2 DEFAULT NULL) RETURN NUMBER

表8-1に、PROJECT_CREATEファンクションで使用されるパラメータをリストします。

表8-1 PROJECT_CREATEファンクションのパラメータのリスト

パラメータ:

説明

p_project_name

作成されたプロジェクトに名前を割り当てます。

p_comment

プロジェクトに適用するコメントを指定します。

PROJECT_RENAME

PROJECT_RENAMEプロシージャは、既存のプロジェクトの名前を変更します。新しい名前を持つプロジェクトがすでに存在する場合は、例外が発生します。

プロシージャ:

PROCEDURE PROJECT_RENAME(p_project_id IN NUMBER, p_project_name IN VARCHAR2)

表8-2に、PROJECT_RENAMEプロシージャで使用されるパラメータをリストします。

表8-2 PROJECT_RENAMEプロシージャのパラメータのリスト

パラメータ:

説明

p_project_id

名前を変更するプロジェクトのプロジェクトIDを指定します。

p_project_name

プロジェクトの新しい名前を指定します。

PROJECT_DELETE

プロシージャPROJECT_DELETEを使用すると、1つ以上のプロジェクトと、それに含まれるワークフローを削除できます。Oracle Data Minerでワークフローが実行中か開かれている場合は、例外が発生します。

単一のプロジェクトを削除するプロシージャ:

PROCEDURE PROJECT_DELETE(p_project_id IN NUMBER)

複数のプロジェクトを削除するプロシージャ:

PROCEDURE PROJECT_DELETE(p_project_ids IN ODMR_OBJECT_IDS)

表8-3に、PROJECT_DELETEプロシージャで使用されるパラメータをリストします。

表8-3 PROJECT_DELETEプロシージャのパラメータのリスト

パラメータ:

説明

p_project_id

削除するプロジェクトのプロジェクトIDを指定します。

p_project_ids

削除するプロジェクトのプロジェクトIDを指定します。

WF_RUN

ワークフローを実行するファンクションWF_RUNには、名前、プロジェクトID、ワークフローおよび実行する特定のノードを受け入れるシグネチャが含まれます。

プロジェクトID、ワークフローIDおよびノードIDは、ODMR_USER_WORKFLOW_NODESビューを使用して問い合わせることができます。

- WF_RUNパラメータ
異なるパラメータの組合せを使用してWF_RUNファンクションを実行できます。

- プロジェクト名、ワークフロー名およびノード名を伴うWF_RUN
プロジェクト名、ワークフロー名およびノード名のパラメータを伴うWF_RUN:

- プロジェクト名、ワークフロー名、ノード名および時間間隔を伴うWF_RUN
プロジェクト名、ワークフロー名、ノード名および時間間隔を伴うWF_RUN:

- プロジェクトID、ワークフローID、ノードIDおよび時間間隔を伴うWF_RUN
プロジェクトID、ワークフローID、ノードIDおよび時間間隔を伴うWF_RUN:

- プロジェクトID、ワークフローIDおよびノードIDを伴うWF_RUN
プロジェクトID、ワークフローIDおよびノードIDのパラメータを伴うWF_RUN:

WF_RUNのパラメータ

異なるパラメータの組合せを使用してWF_RUNファンクションを実行できます。

- プロジェクト名、ワークフロー名およびノード名を伴うWF_RUN

- プロジェクトID、ワークフローIDおよびノードIDを伴うWF_RUN

- プロジェクト名、ワークフロー名、ノード名および時間間隔を伴うWF_RUN

- プロジェクトID、ワークフローID、ノードIDおよび時間間隔を伴うWF_RUN

RERUN_WORKFLOW RUNモードは、ノードの接続方法に関係なく、ワークフロー内のすべてのノードを実行します。ワークフローに2系統以上の別々のノードが含まれる場合、すべての系統が実行されますが、系統実行の順序は決まっていません。つまり、ユーザーは系統の実行順序を設定できません。

表8-4に、WF_RUNファンクションで使用されるパラメータをリストします。

表8-4 WF_RUNファンクションのパラメータのリスト

パラメータ:

説明

P_PROJECT_NAME

ワークフローが作成されたプロジェクト名を指定します。

P_PROJECT_ID

ワークフローが作成されたプロジェクトIDを指定します。

P_WORKFLOW_NAME

実行するワークフロー名を指定します。

P_WORKFLOW_ID

実行するワークフローIDを指定します。

P_NODE_NAMES

実行するワークフローのノード名を指定します。

P_NODE_IDS

実行するワークフローのノードIDを指定します。

P_RUN_MODE

- VALIDATE_ONLY: 指定したノードの親ノードを検証します。

- RUN_NODE_ONLY: 指定したノードを実行します。ノードがすでに実行されている場合、再び実行されることはありません。親ノードが実行されなかった場合は実行され、それ以外の場合は無視されます。

- RERUN_NODE_ONLY: 指定したノードのステータスをREADY状態にリセットします。続いてそれらのノードが再び実行されます。

- RERUN_NODE_CHILDREN: 指定したノードと子ノードのステータスをREADY状態にリセットします。続いてそれらのノードが再び実行されます。

- RERUN_NODE_PARENTS: 指定したノードと親ノードのステータスをREADY状態にリセットします。続いてそれらのノードが再び実行されます。

- RERUN_WORKFLOW: すべてのノードのステータスをREADY状態にリセットします。続いてノードが実行されます(ワークフロー実行を完了)。注意: p_node_namesは無視されます。

P_MAX_NUM_THREADS

すべてのワークフロー全体のパラレル・モデル・ビルドの最大数を指定します。決定済システムにはNULLを指定します。システムに豊富なリソースがある場合のみこのパラメータを使用し、それ以外の場合は、この値をNULLに設定してデフォルト値を使用します。

P_SCHEDULE

Schedulerで定義された既存のスケジュール・オブジェクトを指定します。P_SCHEDULEに値が指定されていない場合、ワークフローは可能な限り早く実行するようにスケジュールされます。

P_START_DATE

このワークフローが初めて開始するようにスケジュールされている日付と時刻を指定します。P_START_DATEとP_REPEAT_INTERVALがNULLに設定されている場合、ワークフローは可能な限り早く実行するようにスケジュールされます。

P_REPEAT_INTERVAL

ワークフローが繰返し間隔を指定します。反復間隔は、カレンダ式またはPL/SQL式を使用して指定できます。指定した式を評価して、ワークフローの次回実行時を決定します。P_REPEAT_INTERVALを指定しない場合、ワークフローは、指定した開始日に1回のみ実行されます。

P_END_DATE

ワークフローが期限切れになり、実行できなくなる日付と時刻を指定します。P_END_DATEの値が指定されない場合、ジョブは無期限に繰り返されます。

P_JOB_CLASS

ワークフローを実行する既存のジョブ・クラスを指定します。P_JOB_CLASSの値が指定されていない場合、デフォルトのジョブ・クラスが使用されます。

プロジェクト名、ワークフロー名およびノード名を伴うWF_RUN

プロジェクト名、ワークフロー名およびノード名のパラメータを伴うWF_RUN:

FUNCTION WF_RUN(P_PROJECT_NAME IN VARCHAR2,
P_WORKFLOW_NAME IN VARCHAR2,
P_NODE_NAMES IN ODMR_OBJECT_NAMES,
P_RUN_MODE IN VARCHAR2 DEFAULT 'RUN_NODE_ONLY',
P_MAX_NUM_THREADS IN NUMBER DEFAULT NULL,
P_SCHEDULE IN VARCHAR2 DEFAULT NULL,
P_JOB_CLASS IN VARCHAR2 DEFAULT NULL
RETURN VARCHAR2

プロジェクト名、ワークフロー名、ノード名および時間間隔を伴うWF_RUN

名前のパラメータと開始および終了日付を伴うWF_RUNファンクション:

FUNCTION WF_RUN(P_PROJECT_NAME IN VARCHAR2,
P_WORKFLOW_NAME IN VARCHAR2,
P_NODE_NAMES IN ODMR_OBJECT_NAMES,
P_RUN_MODE IN VARCHAR2 DEFAULT 'RUN_NODE_ONLY',
P_MAX_NUM_THREADS IN NUMBER DEFAULT NULL,
P_START_DATE IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
P_REPEAT_INTERVAL IN VARCHAR2 DEFAULT NULL,
P_END_DATE IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
P_JOB_CLASS IN VARCHAR2 DEFAULT NULL)
RETURN VARCHAR2

プロジェクトID、ワークフローID、ノードIDおよび時間間隔を伴うWF_RUN

IDと開始および終了日付のパラメータを伴うWF_RUNファンクション:

FUNCTION WF_RUN(P_PROJECT_ID IN NUMBER,
P_WORKFLOW_ID IN NUMBER,
P_NODE_IDS IN ODMR_OBJECT_IDS,
P_RUN_MODE IN VARCHAR2 DEFAULT 'RUN_NODE_ONLY',
P_MAX_NUM_THREADS IN NUMBER DEFAULT NULL,
P_START_DATE IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
P_REPEAT_INTERVAL IN VARCHAR2 DEFAULT NULL,
P_END_DATE IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
P_JOB_CLASS IN VARCHAR2 DEFAULT NULL)
RETURN VARCHAR2

プロジェクトID、ワークフローIDおよびノードIDを伴うWF_RUN

プロジェクトID、ワークフローIDおよびノードIDのパラメータを伴うWF_RUNファンクション:

FUNCTION WF_RUN(P_PROJECT_ID IN NUMBER,
P_WORKFLOW_ID IN NUMBER,
P_NODE_IDS IN ODMR_OBJECT_IDS,
P_RUN_MODE IN VARCHAR2 DEFAULT 'RUN_NODE_ONLY',
P_MAX_NUM_THREADS IN NUMBER DEFAULT NULL,
P_SCHEDULE IN VARCHAR2 DEFAULT NULL,
P_JOB_CLASS IN VARCHAR2 DEFAULT NULL)
RETURN VARCHAR

WF_STOP

プロシージャWF_STOPを使用すると、実行するようにスケジュールされているワークフローを停止またはキャンセルできます。ワークフローがすでに実行中でないか、スケジュールされていない場合、例外が発生します。

プロシージャは次のとおりです。

PROCEDURE WF_STOP(p_workflowId IN NUMBER)

表8-5に、WF_STOPプロシージャで使用されるパラメータをリストします。

表8-5 WF_STOPプロシージャのパラメータのリスト

パラメータ:

説明

p_workflow_id

ワークフローを取り消すために、ワークフローIDを指定してください。

WF_RENAME

プロシージャWF_RENAMEは、既存のワークフローの名前を変更します。

このプロシージャでは、次の条件下で例外が発生します。

- 新しい名前を持つワークフローがすでに存在する場合

- ワークフローがすでに実行中か、Oracle Data Minerによって開かれている場合

ワークフローの名前を変更するプロシージャ:

PROCEDURE WF_RENAME(p_workflowId IN NUMBER,
p_workflow_name IN VARCHAR2,
p_mode IN CHAR DEFAULT 'R')

表8-6に、WF_RENAMEプロシージャで使用されるパラメータをリストします。

表8-6 WF_RENAMEプロシージャのパラメータのリスト

パラメータ:

説明

p_workflow_id

名前を変更するワークフローIDを指定します。

p_workflow_name

新しいワークフロー名を指定します。

p_mode

このパラメータは内部で使用します。

WF_DELETE

プロシージャWF_DELETEは、ワークフローを、表、ビュー、モデル、テスト結果などの、生成されたすべてのオブジェクトごと削除します。ワークフローがすでに実行中か、Oracle Data Minerによって開かれている場合は、例外が発生します。

プロシージャ:

PROCEDURE WF_DELETE(p_workflowId IN NUMBER)

表8-7に、WF_DELETEプロシージャで使用されるパラメータをリストします。

表8-7 WF_DELETEプロシージャのパラメータのリスト

パラメータ:

説明

p_workflow_id

削除するワークフローのIDを指定します。

WF_IMPORT

WF_IMPORTファンクションは、(Oracle Data Minerによってエクスポートされた)ワークフローを、指定したプロジェクトにインポートします。ワークフローは後方互換なので、古いバージョンのワークフローを新しいOracle Data Minerリポジトリにインポートできます。

このファンクションは、インポート時に、ワークフローにリポジトリ内の既存のワークフローとのオブジェクト名競合があるかどうかを検出します。p_forceパラメータは、インポートを終了するかどうかを決定します。

例外は、次の条件下で発生します。

- プロジェクトが存在しない場合

- ワークフロー・メタデータが無効か、現在のリポジトリと互換性がない場合

- 同じ名前を持つワークフローがすでに存在する場合

ファンクション:

FUNCTION WF_IMPORT(p_project_id IN NUMBER,
p_workflow_name IN VARCHAR2,
p_workflow_data IN XMLType,
p_comment IN VARCHAR2,
p_force IN BOOLEAN DEFAULT FALSE) RETURN NUMBER;

表8-8に、WF_IMPORTファンクションで使用されるパラメータをリストします。

表8-8 WF_IMPORTプロシージャのファンクションのリスト

パラメータ:

説明

p_project_id

ワークフローをインポートするプロジェクトのIDを指定します。

p_workflow_name

インポートするワークフローを指定します。

p_workflow_data

ワークフロー・メタデータを指定します。このワークフローは、Oracle Data Minerによって事前にエクスポートされている必要があり、ワークフロー・バージョンはリポジトリがサポートするものより新しくない必要があります。

p_comment

ワークフローに適用されるコメントを指定します。

p_force

ワークフローに、リポジトリ内の既存のワークフローとのオブジェクト名競合がある場合に、強制的にインポートするかどうかを決定します。適用できる値は次のとおりです。

- p_force = FALSEの場合、競合するオブジェクト名のリストを持つ例外が発生します。

- p_force = TRUEの場合、ワークフローのインポートが進行します。

WF_EXPORT

WF_EXPORTファンクションは、指定したワークフローをエクスポートします。ワークフローがすでに実行中か、Oracle Data Minerによって開かれている場合は、例外が発生します。別の方法として、ワークフローがエクスポートするODMR_USER_PROJECT_WORKFLOWを問い合わせることができます。

ファンクション:

FUNCTION WF_EXPORT(p_workflow_id IN NUMBER) RETURN XMLType;

表8-9に、WF_EXPORTファンクションで使用されるパラメータをリストします。

表8-9 WF_EXPORTプロシージャのファンクションのリスト

パラメータ:

説明

p_workflow_id

エクスポートするワークフローのIDを指定します。

関連項目

- ODMR_USER_PROJECT_WORKFLOW

リポジトリ・ビュー

リポジトリ・ビューでは、ワークフローやプロジェクトに関連する情報の問合せ、およびステータスの監視を行うことができます。

リポジトリ・ビューを使用すると、次のことが可能です。

- ワークフローとプロジェクトの情報を問い合せます

- ワークフロー実行ステータスのモニター

- 生成された結果の問合せ

次のリポジトリAPIまたはビューが利用できます。

- ODMR_USER_PROJECT_WORKFLOW
特定のプロジェクトまたはすべてのプロジェクトに属するすべてのワークフローを問い合せるには、ODMR_USER_PROJECT_WORKFLOWリポジトリ・ビューを使用します。このビューは、ワークフローに関する情報、たとえばステータス、作成時刻、更新時刻などを提供します。

- ODMR_USER_WORKFLOW_ALL
個々のワークフローの完了後にワークフロー・ノードのステータスを問い合せるには、ODMR_USER_WORKFLOW_ALLリポジトリ・ビューを使用します。

- ODMR_USER_WORKFLOW_LOG
ワークフロー実行のログを問い合せるには、ODMR_USER_WORKFLOW_LOGリポジトリ・ビューを使用します。

- ODMR_USER_WORKFLOW_NODES
ノード名、ノード・ステータス、ノードIDなど、ワークフローの一部である個々のノードに関する情報を問い合せるには、ODMR_USER_WORKFLOW_NODESリポジトリ・ビューを使用します。

- ODMR_USER_WORKFLOW_MODELS
ワークフローの特定の構築またはモデル・ノードに属するマイニング・モデルを問い合せるには、ODMR_USER_WORKFLOW_MODELSリポジトリ・ビューを使用します。

- ODMR_USER_WF_CLAS_TEST_RESULTS
最後のワークフロー実行で特定のマイニング・モデルのために生成された分類結果を問い合せるには、ODMR_USER_WF_CLAS_TEST_RESULTSリポジトリ・ビューを使用します。

- ODMR_USER_WF_REGR_TEST_RESULTS
最後のワークフロー実行で特定のマイニング・モデルのために生成された回帰結果を問い合せるには、ODMR_USER_WF_REGR_TEST_RESULTSリポジトリ・ビューを使用します。

- ODMR_USER_WF_TEST_RESULTS
ODMR_USER_WF_CLAS_TEST_RESULTSとODMR_USER_WF_REGR_TEST_RESULTSの結合結果を問い合せるには、ODMR_USER_WF_TEST_RESULTSリポジトリ・ビューを使用します。

- ODMR_USER_WORKFLOW_ALL_POLL
ODMR_USER_WORKFLOW_ALL_POLLビューを使用してOracle Data Minerワークフローのステータスをポーリングすることで、Oracle Schedulerビューの使用を最小限に抑えることができます。

ODMR_USER_PROJECT_WORKFLOW

特定のプロジェクトまたはすべてのプロジェクトに属するすべてのワークフローを問い合わせるには、ODMR_USER_PROJECT_WORKFLOWリポジトリ・ビューを使用します。このビューは、ワークフローに関する情報、たとえばステータス、作成時刻、更新時刻などを提供します。

8-10に、このビューの詳細を示します。

表8-10 ODMR_USER_PROJECT_WORKFLOWリポジトリ・ビュー

列

データ型

説明

PROJECT_ID

NUMBER

これは、ワークフローが作成されたプロジェクトのIDです。

PROJECT_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローが作成されたプロジェクトの名前です。

PJ_CREATION_TIME

TIMESTAMP (6)

これは、プロジェクト作成時刻です。

PJ_LAST_UPDATED_TIME

TIMESTAMP (6)

プロジェクトの最終更新日タイム・スタンプ。

PJ_COMMENTS

VARCHAR2 (4000 CHAR)

これらは、プロジェクトに関連したコメントです(存在する場合)。

WORKFLOW_ID

NUMBER

これは、ワークフローIDです。

WORKFLOW_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローの名前です。

WORKFLOW_DATA

XMLTYPE

これは、XML形式のワークフロー・メタデータです。

CHAIN_NAME

VARCHAR (128 CHAR)

これは内部使用専用です。

STATUS

VARCHAR (30 CHAR)

- INACTIVE: ワークフローがアイドル状態にあることを示します。

- ACTIVE: ワークフローが実行中であることを示します。

- QUEUED: ワークフローが実行キュー内にあることを示します。

- STOPPING: ワークフローが停止されていることを示します。

- STOPPED: 実行中ワークフローが停止していることを示します。

- SCHEDULED: ワークフローが実行されるようにスケジュールされていることを示します。

WF_CREATION_TIME

TIMESTAMP (6)

これは、ワークフロー作成のタイム・スタンプです。

WF_LAST_UPDATED_TIME

TIMESTAMP (6)

これは、ワークフロー最終更新日のタイム・スタンプです。

WF_COMMENTS

VARCHAR2 (4000 CHAR)

これらは、ワークフローに関連したコメントです(存在する場合)。

ODMR_USER_WORKFLOW_ALL

個々のワークフローの完了後にワークフロー・ノードのステータスを問い合わせるには、ODMR_USER_WORKFLOW_ALLリポジトリ・ビューを使用します。

たとえば、最後のワークフロー実行で失敗したノードと、それに関連するエラー詳細を問い合わせることができます。8-11に、このビューの詳細を示します。

表8-11 ODMR_USER-WORKFLOW_ALLリポジトリ・ビュー

列

データ型

説明

WORKFLOW_ID

NUMBER

これは、ワークフローのIDです。

WF_JOB_NAME

VARCHAR2 (261)

これは、ワークフローを実行するSchedulerジョブです。

LOG_DATE

TIMESTAMP (6)WITH TIME ZONE

これは、ログ・エントリのタイム・スタンプです。

LOG_ID

NUMBER

これは、ログ・エントリIDです。

NODE_ID

VARCHAR2 (261)

これは、ワークフロー・ノードIDです。

SUBNODE_ID

VARCHAR2 (261)

これは、ワークフロー・サブ・ノードです。たとえば、構築ノード内のモデル・ノード。

NODE_STATUS

VARCHAR2 (11)

- RUNNING: ノードが実行中であることを示します。

- SUCCEEDED: ノード実行が正常に完了したことを示します。

- FAILED: ノードが失敗し、未完了であることを示します。

- NOT_STARTED: ノードが実行の待機中であることを示します。

- SCHEDULED: ノードが実行されるようにスケジュールされていることを示します。

- PAUSED: ノードが一時停止されていることを示します。これは、例外です。

- STOPPED: ノード実行が停止していることを示します。

- STALLED: ノードが停止したことを示します。これは、例外です。

SUBNODE_STATUS

VARCHAR2 (30)

NODE_STATUSと同じ

NODE_START_TIME

TIMESTAMP (6)WITH TIME ZONE

これは、ノード開始のタイム・スタンプです。

NODE_RUN_TIME

INTERVAL DAY (9) TO SECOND (6)

これは、ノード実行時刻です。

ERROR_CODE

NUMBER

これは、ノードによって戻されるエラー・コードです。

LOG_MESSAGE

VARCHAR2 (4000 CHAR)

これは、ノードによって生成されるログ・メッセージです。

ODMR_USER_WORKFLOW_LOG

ワークフロー実行のログを問い合わせるには、ODMR_USER_WORKFLOW_LOGリポジトリ・ビューを使用します。

Oracle Data Minerは、このビューを使用してワークフロー・イベント・ログを抽出、表示します。8-12に、このビューの詳細を示します。

表8-12 ODMR_USER_WORKFLOW_LOGリポジトリ・ビュー

列

データ型

説明

LOG_ID

NUMBER

これは、ログ・エントリIDです。

JOB_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローを実行するSchedulerジョブです。

PROJ_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローが作成されたプロジェクトです。

PRO_ID

NUMBER

これは、ワークフローが作成されたプロジェクトIDです。

WF_NAME

VARCHAR2 (128 CHAR)

これは、ワークフロー名です。

WF_ID

NUMBER

これは、ワークフローIDです。

NODE_NAME

VARCHAR2 (128 CHAR)

これは、ワークフロー内のノードの名前です。

NODE_ID

VARCHAR2 (30)

これは、ノードIDです。

SUBNODE_NAME

VARCHAR2 (128 CHAR)

これは、ワークフロー・サブ・ノード名です。たとえば、構築ノードのモデル名。

SUBNODE_ID

VARCHAR2 (30)

これはワークフロー・サブ・ノードのIDです。たとえば、構築ノードのモデルID。

LOG_TIMESTAMP

TIMESTAMP (6)WITH TIME ZONE

これは、ログ・エントリのタイム・スタンプです。

LOG_DURATION

INTERVAL DAY (3) TO SECOND (0)

これは、ログ・エントリ期間です(単位は日数と秒数)。

LOG TYPE

VARCHAR2 (30 CHAR)

- WARN: 警告を示します。

- ERR: エラーを示します。

- INFO: 情報内容を示します。

LOG SUBTYPE

VARCHAR2 (30 CHAR)

- START: タスクの開始を示します。

- END: タスクの終了を示します。

LOG_MESSAGE

NVARCHAR2 (2000)

これは、ノードによって生成されるログ・メッセージです。

LOG_MESSAGE_DETAILS

VARCHAR2 (4000 CHAR)

これは、ノードによって生成されるログ・メッセージの詳細です。

LOG_TASK

VARCHAR2 (30 CHAR)

ノードが実行中のとき、次のタスクのうち1つ以上を実行します。

- PROJECT

- WORKFLOW

- NODE

- SUBNODE

- VALIDATE

- SAMPLE

- CACHE

- STATISTICS

- FEATURES

- DATAPREP

- BUILD

- TEST

- APPLY

- TRANSFORM

- TEXT

- BUILDTEXT

- APPLYTEXT

- OUTPUT

- CLEANUP

- CREATE EXPLORE STATISTICS

- CREATE HISTOGRAM

- CREATE SAMPLE DATA

- CREATE HISTOGRAM SAMPLE

- CREATE DATA GUIDE

- CREATE PROJECT

- DELETE PROJECT

- RENAME PROJECT

- SET COMMENT

- CREATE WORKFLOW

- RUN WORKFLOW

- RENAME WORKFLOW

- DELETE WORKFLOW

- IMPORT WORKFLOW

- EXPORT WORKFLOW

ODMR_USER_WORKFLOW_NODES

ノード名、ノード・ステータス、ノードIDなど、ワークフローの一部である個々のノードに関する情報を問い合わせるには、ODMR_USER_WORKFLOW_NODESリポジトリ・ビューを使用します。

8-13に、このビューの詳細を示します。

表8-13 ODMR_USER_WORKFLOW_NODESリポジトリ・ビュー

列

データ型

説明

PROJECT_ID

NUMBER

これは、ワークフローが作成されたプロジェクトのIDです。

PROJECT_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローが作成されたプロジェクトの名前です。

WORKFLOW_ID

NUMBER

これは、ワークフローのIDです。

WORKFLOW_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローの名前です。

NODE_TYPE

VARCHAR2 (30 CHAR)

これは、ノード・タイプです。

NODE_NAME

VARCHAR2 (128 CHAR)

これは、ノードの名前です。

NODE_ID

NUMBER

これは、ノードのIDです。

NODE_STATUS

VARCHAR2 (10 CHAR)

- INVALID: ノードが有効でなく、実行できないことを示します。

- WARNING: ノードは実行されたが警告があったことを示します。

- READY: ノードがいつでも実行できることを示します。

- FAILURE: ノード実行が失敗したことを示します。

- COMPLETE: ノード実行が正常に完了したことを示します。

ODMR_USER_WORKFLOW_MODELS

ワークフローの特定の構築またはモデル・ノードに属するマイニング・モデルを問い合わせるには、ODMR_USER_WORKFLOW_MODELSリポジトリ・ビューを使用します。

8-14に、このビューの詳細を示します。

表8-14 ODMR_USER_WORKFLOW_MODELSリポジトリ・ビュー

列

データ型

説明

PROJECT_ID

NUMBER

これは、ワークフローが作成されたプロジェクトIDです。

PROJECT_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローが作成されたプロジェクトの名前です。

WORKFLOW_ID

NUMBER

これは、ワークフローのIDです。

WORKFLOW_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローの名前です。

NODE_TYPE

VARCHAR2 (30 CHAR)

これは、ノード・タイプです。

NODE_ID

NUMBER

これは、ワークフロー・ノードIDです。

NODE_NAME

VARCHAR2 (128 CHAR)

これは、ワークフロー・ノードの名前です。

NODE_STATUS

VARCHAR2 (30 CHAR)

- INVALID: ノードが有効でなく、実行できないことを示します。

- WARNING: ノードは実行されたが警告があったことを示します。

- READY: ノードがいつでも実行できることを示します。

- FAILURE: ノード実行が失敗したことを示します。

- COMPLETE: ノード実行が正常に完了したことを示します。

MODEL_TYPE

VARCHAR2 (30 CHAR)

これは、モデル・タイプです。たとえば、Naive Bayesモデル。

MODEL_ID

NUMBER

これは、モデルのIDです。

MODEL_NAME

VARCHAR2 (128 CHAR)

これは、モデルの名前です。

MODEL_STATUS

VARCHAR2 (30 CHAR)

ノード・ステータスと同じ。

MODEL_CREATIONDATE

VARCHAR2 (30 CHAR)

これは、モデルが作成された日付です。

ODMR_USER_WF_CLAS_TEST_RESULTS

最後のワークフロー実行で特定のマイニング・モデルのために生成された分類結果を問い合せるには、ODMR_USER_WF_CLAS_TEST_RESULTSリポジトリ・ビューを使用します。

8-15に、このビューの詳細を示します。

表8-15 ODMR_USER_WF_CLAS_TEST_RESULTS

列

データ型

説明

PROJECT_ID

NUMBER

これは、ワークフローが作成されたプロジェクトのIDです。

PROJECT_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローが作成されたプロジェクトの名前です。

WORKFLOW_ID

NUMBER

これは、ワークフローのIDです。

WORKFLOW_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローの名前です。

NODE_TYPE

VARCHAR2 (30 CHAR)

これは、ノード・タイプです。

NODE_ID

NUMBER

これは、ノードのIDです。

NODE_NAME

VARCHAR2 (128 CHAR)

これは、ノードの名前です。

NODE_STATUS

VARCHAR2 (10 CHAR)

- INVALID: ノードの実行準備ができていないことを示します。

- WARNING: ノードは完全に実行されたが警告があったことを示します。

- READY: ノードがいつでも実行できることを示します。

- FAILURE: ノード実行が失敗したことを示します。

- COMPLETE: ノードが正常に実行されたことを示します。

MODEL_ID

NUMBER

これは、モデルのIDです。

MODEL_NAME

VARCHAR2 (128 CHAR)

これは、モデルの名前です。

MODEL_STATUS

VARCHAR2 (10 CHAR)

- WARNING: モデルは実行されたが警告があったことを示します。

- READY: モデルがいつでも実行できることを示します。

- FAILURE: モデル実行が失敗したことを示します。

- COMPLETE: モデル実行が正常に完了したことを示します。

MODEL_CREATIONDATE

VARCHAR2 (30 CHAR)

これは、モデルの作成時刻です。

TEST_METRICS

VARCHAR2 (128 CHAR)

予測信頼度、精度などを含むテスト・メトリック結果表。

CONFUSION_MATRIX

VARCHAR2 (128 CHAR)

コンフュージョン・マトリックス結果表。

LIFTS

DM_NESTED_CATEGORICALS

DM_NESTED_CATEGORICALの表。ここで、

- ATTRIBUTE_NAMEは、ターゲット・クラスを含みます

- VALUEは、リフト結果表を含みます

ROCS

DM_NESTED_CATEGORICALS

DM_NESTED_CATEGORICALの表。ここで、

- ATTRIBUTE_NAMEは、ターゲット・クラスを含みます

- VALUEは、ROC結果表を含みます

ROC_AREA

DM_NESTED_NUMERICALS

DM_NESTED_NUMERICALの表。ここで、

- ATTRIBUTE_NAMEは、ターゲット・クラスを含みます

- VALUEは、曲線の下のROC領域を含みます

ODMR_USER_WF_REGR_TEST_RESULTS

最後のワークフロー実行で特定のマイニング・モデルのために生成された回帰結果を問い合わせるには、ODMR_USER_WF_REGR_TEST_RESULTSリポジトリ・ビューを使用します。

8-16に、このビューの詳細を示します。

表8-16 ODMR_USER_WF_REGR_TEST_RESULTSリポジトリ・ビュー

列

データ型

説明

PROJECT_ID

NUMBER

これは、ワークフローが作成されるプロジェクトのIDです。

PROJECT_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローが作成されるプロジェクトの名前です。

WORKFLOW_ID

NUMBER

これは、ワークフローIDです。

WORKFLOW_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローの名前です。

NODE_TYPE

VARCHAR2 (30 CHAR)

これは、ノードのタイプです。たとえば、構築ノード、モデル・ノードなど。

NODE_ID

NUMBER

これは、ノードのIDです。

NODE_NAME

VARCHAR2 (128 CHAR)

これは、ノードの名前です。

NODE_STATUS

VARCHAR2 (10 CHAR)

- INVALID: ノードの実行準備ができていないことを示します。

- WARNING: ノードは完全に実行されたが警告があったことを示します。

- READY: ノードがいつでも実行できることを示します。

- FAILURE: ノード実行が失敗したことを示します。

- COMPLETE: ノードが正常に実行されたことを示します。

MODEL_ID

NUMBER

これは、モデルのIDです。

MODEL_NAME

VARCHAR2 (128 CHAR)

これは、モデルの名前です。

MODEL_STATUS

VARCHAR2 (10 CHAR)

- WARNING: モデルは実行されたが警告があったことを示します。

- READY: モデルがいつでも実行できることを示します。

- FAILURE: モデル実行が失敗したことを示します。

- COMPLETE: モデル実行が正常に完了したことを示します。

MODEL_CREATION_DATE

VARCHAR2 (30 CHAR)

これは、モデルの作成日付です。

TEST_METRICS

VARCHAR2 (128 CHAR)

これは、予測信頼度、2乗平均平方根誤差などを含むテスト・メトリック結果表です。

RESIDUAL_PLOT

VARCHAR2 (128 CHAR)

これは、テスト残差プロット表です。

ODMR_USER_WF_TEST_RESULTS

ODMR_USER_WF_CLAS_TEST_RESULTSとODMR_USER_WF_REGR_TEST_RESULTSの結合結果を問い合わせるには、ODMR_USER_WF_TEST_RESULTSリポジトリ・ビューを使用します。

8-17に、このビューの詳細を示します。

表8-17 ODMR_USER_WF_TEST_RESULTSリポジトリ・ビュー

列

データ型

説明

PROJECT_ID

NUMBER

ワークフローが作成されるプロジェクトのプロジェクトID。

PROJECT_NAME

VARCHAR2 (128 CHAR)

ワークフローが作成されるプロジェクトの名前。

WORKFLOW_ID

NUMBER

これは、ワークフローIDです。

WORKFLOW_NAME

VARCHAR2 (128 CHAR)

これは、ワークフローの名前です。

NODE_TYPE

VARCHAR2 (30 CHAR)

これは、ノードのタイプです。たとえば、構築ノード、モデル・ノードなど。

NODE_ID

NUMBER

これは、ノードのIDです。

NODE_NAME

VARCHAR2 (128 CHAR)

これは、ノードの名前です。

NODE_STATUS

VARCHAR2 (10 CHAR)

- INVALID: ノードの実行準備ができていないことを示します。

- WARNING: ノードは完全に実行されたが警告があったことを示します。

- READY: ノードがいつでも実行できることを示します。

- FAILURE: ノード実行が失敗したことを示します。

- COMPLETE: ノードが正常に実行されたことを示します。

MODEL_ID

NUMBER

これは、モデルのIDです。

MODEL_NAME

VARCHAR2 (128 CHAR)

これは、モデルの名前です。

MODEL_STATUS

VARCHAR2 (10 CHAR)

- WARNING: モデルは実行されたが警告があったことを示します。

- READY: モデルがいつでも実行できることを示します。

- FAILURE: モデル実行が失敗したことを示します。

- COMPLETE: モデル実行が正常に完了したことを示します。

MODEL_CREATION_DATE

VARCHAR2 (30 CHAR)

これは、モデルの作成日付です。

TEST_METRICS

VARCHAR2 (128 CHAR)

これは、予測信頼度、2乗平均平方根誤差などを含むテスト・メトリック結果表です。

CONFUSION_MATRIX

VARCHAR2 (128 CHAR)

これは、テスト・コンフュージョン・マトリックス結果表です。

LIFTS

DM_NESTED_CATEGORICALS

DM_NESTED_CATEGORICALの表。ここで、

- ATTRIBUTE_NAMEは、ターゲット・クラスを含みます

- VALUEは、リフト結果表を含みます

ROCS

DM_NESTED_CATEGORICALS

DM_NESTED_CATEGORICALの表。ここで、

- ATTRIBUTE_NAMEは、ターゲット・クラスを含みます

- VALUEは、ROC結果表を含みます

ROC_AREA

DM_NESTED_NUMERICALS

DM_NESTED_NUMERICALの表。ここで、

- ATTRIBUTE_NAMEは、ターゲット・クラスを含みます

- VALUEは、曲線の下のROC領域を含みます

RESIDUAL_PLOT

VARCHAR2 (128 CHAR)

これは、テスト残差プロット表です。

ODMR_USER_WORKFLOW_ALL_POLL

ODMR_USER_WORKFLOW_ALL_POLLビューを使用してOracle Data Minerワークフローのステータスをポーリングすることで、Oracle Schedulerビューの使用を最小限に抑えることができます。

ただし、ワークフロー・ジョブのステータスを特定するにはOracle Schedulerビューを使用する必要があります。ODMR_USER_WORKFLOW_ALL_POLLリポジトリ・ビューでは、失敗したワークフローのステータスに関する完全な情報を提供できます。ワークフロー・ステータスをポーリングするためのリポジトリ・ビューODMR_USER_WORKFLOW_ALL_POLLには、次のリポジトリ・プロパティが含まれます。

- POLLING_IDLE_RATE: 実行中と検出されるワークフローが存在しない場合に、クライアントがデータベースをポーリングする比率を決定します。

- POLLING_ACTIVE_RATE: 実行中と検出されるワークフローが存在する場合に、クライアントがデータベースをポーリングする比率を決定します。

- POLLING_IDLE_ENABLED: スケジュールされたワークフロー・ジョブへの自動更新を決定します。

- POLLING_COMPLETED_WINDOW: 完了したワークフローをポーリング問合せの結果に含めるために必要な時間を指定します。

- PURGE_WORKFLOW_SCHEDULER_JOBS: Data Minerワークフローの実行によって生成された古いOracle Schedulerオブジェクトをパージします。

- PURGE_WORKFLOW_EVENT_LOG: 各ワークフローのワークフロー実行をイベント・ログにいくつ保持するかを制御します。この制限内に収まるように、古いワークフローのイベントはパージされます。

関連項目

- システム管理用のOracle Data Minerリポジトリ・プロパティのサマリー

PL/SQL APIユース・ケース

PL/SQL APIユースケースでは、PL/SQL APIを実行して構築ワークフローとAPPLYワークフローをスケジュールおよび実行する方法を示します。

発生例を次に示します。

- PL/SQLユースケースの前提
PL/SQL APIユースケースは2つの事前定義済ワークフロー上に作成され、SQL Developerのインストール場所から利用できます。

- APPLYワークフローをスケジュールおよび実行するユースケース
このユースケースでは、WF_RUN_APIを実行するようにスケジュールされたAPPLYワークフローの系統を実行する方法を示します。

- 構築ワークフローをスケジュールおよび実行するユースケース
このユースケースでは、ワークフローの系統でWF_RUN_APIを実行し、ステータスをポーリングして、イベント・ログからノード障害を出力する方法を示します。

PL/SQLユースケースの前提

PL/SQL APIユースケースは2つの事前定義済ワークフロー上に作成され、SQL Developerのインストール場所から利用できます。

事前定義済ワークフロー

2つの事前定義済ワークフロー・ファイルは、次のとおりです。

- apply_workflow.xml: build_workflowによって構築されたモデルを参照するモデル・ノードを使用します。続いて、それを使用してスコアリングします。

- build_workflow.xml: サーバー・ベクター・マシン分類モデルを構築し、続いてモデルの詳細または係数を表に格納します。

デモ・ファイルの場所

事前定義済ワークフローを含むワークフロー・ファイルapply_workflow.xmlとbuild_workflow.xmlは、SQL Developerインストールした場所、sqldeveloper home\dataminer\demos\workflowsから利用できます。

APPLYワークフローをスケジュールおよび実行するユースケース

このユースケースでは、WF_RUN_APIを実行するようにスケジュールされたAPPLYワークフローの系統を実行する方法を示します。

系統を実行するには、INSUR_CUST_LTV_SAMPLE APPLYノードを指定して、RERUN_NODE_CHILDREN実行モードを使用します。例に示したように、ユースケースは次のことを行います。

- ESTゾーンの2014/12/31の零時から2015/12/31まで、毎日実行するようにAPPLYワークフローをスケジュールします。

- WF_RUN APIを実行します

- ODMR_USER_PROJECT_WORKFLOWビューからワークフローのステータスをポーリングします

- 失敗したノードを出力します

例8-1 APPLYワークフロー、ポーリング状態および印刷ノードの障害のスケジュールと実行

CONNECT DMUSER/DMUSER
SET SERVEROUTPUT ON
DECLARE
v_jobId VARCHAR2(30) := NULL;
v_status VARCHAR2(30) := NULL;
v_projectName VARCHAR2(30) := 'Project';
v_workflow_name VARCHAR2(30) := 'apply_workflow';
v_node VARCHAR2(30) := 'INSUR_CUST_LTV_SAMPLE APPLY';
v_run_mode VARCHAR2(30) := ODMRSYS.ODMR_WORKFLOW.RERUN_NODE_CHILDREN;
v_failure NUMBER := 0;
v_nodes ODMRSYS.ODMR_OBJECT_NAMES := ODMRSYS.ODMR_OBJECT_NAMES();
BEGIN
v_nodes.extend();
v_nodes(v_nodes.count) := v_node;
v_jobId := ODMRSYS.ODMR_WORKFLOW.WF_RUN(p_project_name => v_projectName,
p_workflow_name => v_workflow_name,
p_node_names => v_nodes,
p_run_mode => v_run_mode,
p_start_date => '31-DEC-14 12.00.00 AM AMERICA/NEW_YORK',
p_repeat_interval => 'FREQ= DAILY',
p_end_date => '31-DEC-15 12.00.00 AM AMERICA/NEW_YORK'));
DBMS_OUTPUT.PUT_LINE('Job: '||v_jobId);
-- wait for workflow to run to completion
LOOP
SELECT STATUS INTO v_status FROM ODMR_USER_PROJECT_WORKFLOW
WHERE WORKFLOW_NAME = v_workflow_name;
IF (v_status IN ('SCHEDULED', 'ACTIVE')) THEN
DBMS_LOCK.SLEEP(10); -- wait for 10 secs
ELSE
EXIT; -- workflow run completes
END IF;
END LOOP;
-- print all failed nodes (see example above)
EXCEPTION WHEN OTHERS THEN
DBMS_OUTPUT.PUT_LINE('Error: '||SUBSTR(DBMS_UTILITY.FORMAT_ERROR_STACK(), 1, 4000));
END;

- スコアリング結果の問合せ
ワークフロー実行が正常に完了したら、スコアリング結果を問い合せることができます。

関連項目

- WF_RUN

- PL/SQLユースケースの前提

スコアリング結果の問合せ

ワークフロー実行が正常に完了したら、スコアリング結果を問い合せることができます。

スコアリング結果を問い合わせる手順:

SELECT * FROM SCORED_CUSTOMERS_TBL

図8-1に示すように、問合せの出力は表形式で表示されます。

図8-1 スコアリング結果の問合せ出力

構築ワークフローをスケジュールおよび実行するユースケース

このユースケースでは、ワークフローの系統でWF_RUN_APIを実行し、ステータスをポーリングして、イベント・ログからノード障害を出力する方法を示します。

実行モードRERUN_NODE_ONLYまたはRERUN_NODE_PARENTSを使用して、ワークフローの系統でWF_RUN_APIを実行できます。

2つの実行モードを使用してWF_RUN_APIを実行する方法では同じ結果が生成され、系統内の4つのノードすべてが実行されます。方法は次のとおりです。

- 系統内のすべてのノードを選択して、RERUN_NODE_ONLY実行モードを使用します。

- MODEL_COEFFICIENTSノードを選択して、RERUN_NODE_PARENTS実行モードを使用します。

例8-2に示したように、ユースケースは次のことを行います。

- ESTゾーンの2014/12/31の零時から2015/12/31まで、毎月、月の最終日(BYMONTHDAY=-1)に実行するワークフローをスケジュールします。

- WF_RUN APIを実行します。このユースケースでは、API WF_RUN with Project Name、Workflow Name Node Name and Time Intervalが、ワークフローの実行をスケジュールします。

- ODMR_USER_PROJECT_WORKFLOWビューからワークフローのステータスをポーリングして、ワークフロー実行が完了したかどうかを判定します。

- イベント・ログから、すべてのノード障害を、エラー・メッセージとともに出力します。

例8-2 ワークフロー、ポーリング状態および印刷ノードの障害のスケジュールと実行

CONNECT DMUSER/DMUSER
SET SERVEROUTPUT ON
DECLARE
v_jobId VARCHAR2(30) := NULL;
v_status VARCHAR2(30) := NULL;
v_projectName VARCHAR2(128) := 'Project';
v_workflow_name VARCHAR2(128) := 'build_workflow';
v_node VARCHAR2(30) := 'MODEL_COEFFCIENTS';
v_run_mode VARCHAR2(30) := ODMRSYS.ODMR_WORKFLOW.RERUN_NODE_PARENTS;
v_failure NUMBER := 0;
v_nodes ODMRSYS.ODMR_OBJECT_NAMES := ODMRSYS.ODMR_OBJECT_NAMES();
BEGIN
v_nodes.extend();
v_nodes(v_nodes.count) := v_node;
v_jobId := ODMRSYS.ODMR_WORKFLOW.WF_RUN(p_project_name => v_projectName,
p_workflow_name => v_workflow_name,
p_node_names => v_nodes,
p_run_mode => v_run_mode,
p_start_date => '31-DEC-14 12.00.00 AM AMERICA/NEW_YORK',
p_repeat_interval => 'FREQ=MONTHLY;BYMONTHDAY=-1',
p_end_date => '31-DEC-15 12.00.00 AM AMERICA/NEW_YORK');
DBMS_OUTPUT.PUT_LINE('Job: '||v_jobId);
-- wait for workflow to run to completion
LOOP
SELECT STATUS INTO v_status FROM ODMR_USER_PROJECT_WORKFLOW
WHERE WORKFLOW_NAME = v_workflow_name;
IF (v_status IN ('SCHEDULED', 'ACTIVE')) THEN
DBMS_LOCK.SLEEP(10); -- wait for 10 secs
ELSE
EXIT; -- workflow run completes
END IF;
END LOOP;
-- print all failed nodes from the event log
FOR wf_log IN (
SELECT node_id, node_name, subnode_id, subnode_name, log_message, log_message_ details
FROM ODMR_USER_WORKFLOW_LOG
WHERE job_name=v_jobId and log_type='ERR' and log_message IS NOT NULL)
LOOP
DBMS_OUTPUT.PUT_LINE('Node Id: '||wf_log.node_id||', '||'Node Name: '||wf_log.node_name);
IF (wf_log.subnode_id IS NOT NULL) THEN
DBMS_OUTPUT.PUT_LINE(
'Subnode Id: '||wf_log.subnode_id||', '||'Subnode Name: '||wf_log.subnode_name);
END IF;
DBMS_OUTPUT.PUT_LINE('Message: '||wf_log.log_message);
v_failure := v_failure + 1;
END LOOP;
IF (v_failure = 0) THEN
DBMS_OUTPUT.PUT_LINE('Workflow Status: SUCCEEDED');
ELSE
DBMS_OUTPUT.PUT_LINE('Workflow Status: FAILURE');
END IF;
EXCEPTION WHEN OTHERS THEN
DBMS_OUTPUT.PUT_LINE('Error: '||SUBSTR(DBMS_UTILITY.FORMAT_ERROR_STACK(), 1, 4000));
END;

- MODEL_COEFFICIENT表の問合せ
問合せを実行して、MODEL_COEFFICIENT表からデータを取得できます。

- 名前付きオブジェクトの問合せ
ワークフロー実行が正常に完了した後、表作成ノード内の表またはビュー、構築ノード内のモデルなど、ワークフローによって生成されたすべての名前付きオブジェクトを問い合せることができます。

- テスト結果の問合せ
ODMR_USER_WF_CLAS_TEST_RESULTSおよびODMR_USER_WF_REGR_TEST_RESULTSリポジトリ・ビューからコンフュージョン・マトリックスとテスト・メトリックのテスト結果を問い合せることができます。

関連項目

- WF_RUN

- WF_RUNファンクション

- ODMR_USER_PROJECT_WORKFLOW

MODEL_COEFFICIENT表の問合せ

問合せを実行して、MODEL_COEFFICIENT表からデータを取得できます。

MODEL_COEFFICIENTS表からのデータを問い合わせるには、次の問合せを実行します。

SELECT * FROM MODEL_COEFFCIENTS

図8-2に示すように、この問合せの出力は表形式で表示されます。

図8-2 MODEL_COEFFICIENT表の問合せ出力

名前付きオブジェクトの問合せ

ワークフロー実行が正常に完了した後、表作成ノード内の表またはビュー、構築ノード内のモデルなど、ワークフローによって生成されたすべての名前付きオブジェクトを問い合わせることができます。

次の問合せは、モデルCLAS_SVM_MODEL_2の情報を戻します。

SELECT * FROM USER_MINING_MODELS WHERE MODEL_NAME = 'CLAS_SVM_MODEL_2

問合せ結果を図8-3に示します。

図8-3 名前付きオブジェクトの問合せ出力

テスト結果の問合せ

ODMR_USER_WF_CLAS_TEST_RESULTSおよびODMR_USER_WF_REGR_TEST_RESULTSリポジトリ・ビューからコンフュージョン・マトリックスとテスト・メトリックのテスト結果を問い合せることができます。

次からテスト結果を問い合わせることができます。

- ODMR_USER_WF_CLAS_TEST_RESULTSリポジトリ・ビュー

- ODMR_USER_WF_REGR_TEST_RESULTSリポジトリ・ビュー

この項には、次を問い合わせる例が記載されています。

- テスト・メトリックとコンフュージョン・マトリックスの結果の問合せ: 例8-3

- テスト・メトリックの問合せ: 例8-4

- コンフュージョン・マトリックスの問合せ: 例8-5

- リフト表結果の問合せ: 例8-6

例8-3 テスト・メトリックとコンフュージョン・マトリックスの結果の問合せ

SELECT TEST_METRICS, CONFUSION_MATRIX FROM ODMR_USER_WF_CLAS_TEST_RESULTS WHERE WORKFLOW_NAME = 'build_workflow' AND NODE_NAME = 'Class Build'

この問合せの出力を次の図に示します。この問合せは、ODMR_USER_WF_CLAS_TEST_RESULTSからテスト・メトリックとコンフュージョン・マトリックスを取得します。

図8-4 テスト・メトリックとコンフュージョン・マトリックスの問合せの出力

例8-4 TEST_METRICSの問合せ

SELECT * FROM ODMR$18_51_18_106346IFHRNMF

この問合せの出力を次のスクリーンショットに示します。テスト・メトリックODMR$18_51_18_106346IFHRNMFを問い合わせます。メトリック名、メトリックVARCHAR値およびメトリックNUM値をフェッチします。

図8-5 TEST METRICSの問合せの出力

例8-5 CONFUSION_MATRIXの問合せ

SELECT * FROM ODMR$18_51_17_954530VMUXPWL

この問合せの出力を次のスクリーンショットに示します。コンフュージョン・マトリックスODMR$18_51_17_954530VMUXPWLを問い合わせます。実際のターゲット名と予測されたターゲット値をフェッチします。

図8-6 CONFUSION_MATRIXの問合せの出力

例8-6 CLAS_SVM_MODEL_2からのリフト表の問合せ

SELECT
MODEL_NAME, a.ATTRIBUTE_NAME "target value", a.VALUE "lift result table"
FROM
ODMR_USER_WF_CLAS_TEST_RESULTS, TABLE(LIFTS) a
WHERE
WORKFLOW_NAME = 'build_workflow' AND NODE_NAME = 'Class Build' AND ATTRIBUTE_NAME='Yes'

この問合せの出力を次のスクリーンショットに示します。CLAS_SVM_MODEL_2からリフト結果表を問い合わせています。

図8-7 CLAS_SVM_MODEL_2からのリフト結果表の問合せの出力

関連項目

- リポジトリ・ビュー

A Oracle Data Minerのリリース

Oracle Data Minerクライアントは、Oracle Database内のOracle Data Minerリポジトリと互換性を持つ必要があります。

バージョンが非互換の場合、Oracle Data Minerは、エラー・メッセージに、クライアントまたはリポジトリをアップグレードする助けとなる情報を表示します。

たとえば、新しいクライアントが古いリポジトリに接続しようとすると、図A-1に示すエラーが表示されます。

図A-1 古いOracle Data Minerのリポジトリ・エラー

古いクライアントが新しいリポジトリに接続しようとすると、図A-2に示すエラーが表示されます。

図A-2 新しいOracle Data Minerのリポジトリ・エラー

図A-1と図A-2に示したエラーの対処法を評価する場合、いくつかのバージョン番号を考慮に入れる必要があります。各リリースでサポートされるバージョン番号の組合せを、表A-1にリストします。表の列に示したバージョン番号の説明は、次のとおりです。

- SQL Developer - これは、SQL Developerで「ヘルプ」メニュー、「バージョン情報」タブを選択したときに表示される情報です。

図A-3 Oracle SQL Developerの概要

- Oracle Data Minerの拡張機能 - これは、SQL Developerで「ヘルプ」メニュー、「拡張」タブを選択したときに表示されるOracle Data Minerのバージョンです。

図A-4 Oracle SQL Developerの概要 —「拡張」タブ

- Oracle Data Minerリポジトリのバージョン - リポジトリ・バージョンを検出するには、5.2項「リポジトリのステータスとバージョンの判定」に示した問合せを実行します。

- Oracle Data Miner XMLスキーマのバージョン - これは、リポジトリ内のOracle Data Minerワークフローによって使用されるXMLスキーマのバージョンです。この番号は、ワークフローをエクスポートまたはインポートするときに表示されます。

注意:

Oracle SQL Developer のバージョンとOracle Data Minerの拡張機能のバージョンにより、クライアントは一意に識別されます。Oracle Data Minerのリポジトリ・バージョンは、リポジトリを一意に識別します。

表A-1 SQL Developer Oracle Data Minerの拡張機能とOracle Data Minerリポジトリの互換性

SQL Developer

Data Minerの拡張機能

Data Minerリポジトリのバージョン

Data Miner XMLスキーマのバージョン

リリースのタイプ(フルまたはパス)

制限事項

SQL Developer 3.0 EA4 3.0.03 Build MAIN-03.97

11.2.0.1.9.96

11.2.0.1.9

11.2.0.1.9

EA4 (Data Minerを含む唯一のEAリリース)

11.2.0.3以降では機能しません

SQL Developer 3.0 RTM 3.0.04 Build MAIN-04.34

11.2.0.1.10.109

11.2.0.1.10

11.2.0.1.9

RTM (11/03/30リリース)

11.2.0.3以降では機能しません

SQL Developer 3.0

11.2.0.2.04.38

11.2.0.1.12

112.0.1.9

パッチ(Dev内部のみ)

11.2.0.3以降では機能しません

SQL Developer 3.0

11.2.0.2.04.39

11.2.0.1.13

11.2.0.1.9

パッチ(内部)

11.2.0.3以降では機能しません

SQL Developer 3.0

11.2.0.2.04.40

11.2.0.1.13

11.2.0.1.9

パッチへのパッチ(外部)リンク

11.2.0.3以降では機能しません

SQL Developer 3.1 EA1

11.2.1.1.xx.xx

11.2.1.1.1

11.2.1.1.1

EA1候補(未リリース)

なし

SQL Developer 3.1 EA1 3.1.05 Build MAIN-05.97

11.2.1.1.05.97

11.2.1.1.2

11.2.1.1.1

EA1 (11/10/10リリース)

なし

SQL Developer 3.1

11.2.1.1.06.44

11.2.1.1.3

11.2.1.1.1

EA2 (11/11/15リリース)

なし

SQL Developer 3.1

11.2.1.06.82

11.2.1.1.4

11.2.1.1.1

EA3 (11/12/21リリース)

なし

SQL Developer 3.1 RTM 3.1.07 Build MAIN-07.42

11.2.1.1.07.42

11.2.1.1.5

11.2.1.1.1

RTM (12/02/07リリース)

なし

SQL Developer 3.2 RTM Version 3.2.09 Build MAIN-09-18

11.2.1.1.09.18

11.2.1.1.6

11.2.1.1.1

RTM (12/08/20リリース)

なし

SQL Developer 3.2.1 RTM Version 3.2.10.09 Build MAIN-09-57

11.2.1.1.09.57

11.2.1.1.6

11.2.1.1.1

RTM (12/09/24リリース)。Data Minerでは、3.2と3.2.1の間に変更はありませんでした。

なし

SQL Developer 3.2.2 RTM Version 3.2.20.09 Build MAIN-09.87

11.2.1.1.09.87

11.2.1.6

11.2.1.1.1

RTM (12/11/01リリース)。Data Minerでは、3.2と3.2.2の間に変更はありませんでした。

なし

SQL Developer 4.0 EA1 (was 3.3) Version 4.0.0.12 Build MAIN-12.27

11.2.2.1.12.27

11.2.2.1.1

11.2.2.1.1

EA1 (13/07/11リリース)

なし

SQL Developer 4.0 EA2 Version 4.0.0.12 Build MAIN-12.84

12.2.0.12.84

12.1.0.1.1

12.1.0.1.1

EA2 (13/09/13リリース)

なし

SQL Developer 4.0 EA3 Version 4.0.0.13 Build MAIN-13.30

12.2.0.13.30

12.1.0.1.2

12.1.0.1.2

EA3 (13/11/05リリース)

以前のバージョンからの移行が分割されます。OTN投稿で文書化された対処方法。

SQL Developer 4.0 RTM Version 4.0.0.13 Build MAIN-13.80

12.2.0.13.80

12.1.0.1.3

12.1.0.1.3

RTM (13/12/12)

なし

SQL Developer 4.0.1 RTM Version 4.0.1.14 Build MAIN14.48

12.2.0.14.48

12.1.0.1.4

12.1.0.1.4

RTM (14/02/25)

Data Minerの修正といくつかの小さな拡張

SQL Developer 4.0.2 Version 4.0.2.15.21 Build 15.21

12.2.0.15.21

12.1.0.1.5

12.1.0.1.4

RTM (14/05/06)

重要なData Miner修正のみがバック・ポートされました。PL/SQLコードに変更があったため、リポジトリ・バージョンが変更されました。XMLschemaは変更されなかったため、XMLワークフローのバージョンは不変です。このため、ユーザーは問題なく4.0.1と4.0.2の間のワークフローをインポートできます。

SQL Developer 4.0.3 Version 4.0.3.16 Build MAIN-16.84

12.2.0.16.84

12.1.0.1.5

12.1.0.1.4

RTM (14/09/16)

Data Minerのリリース4.0.3で変更が行われましたが、サーバー側の変更は不要なので、リポジトリとワークフローのバージョン番号は同じままです。

SQL Developer 4.1 EA1 Version 4.1.0.17 Build MAIN-17.29

12.2.0.17.29

12.1.0.2.1

12.1.0.2.1

EA1 (14/12/09)

なし

SQL Developer 4.1 EA2 Version 4.1.0.18 Build MAIN-18.37

12.2.0.18.37

12.1.0.2.2

12.1.0.2.2

EA2 (15/03/09)

なし

SQL Developer 4.1 RTM Version 4.1.0.19 Build MAIN-19.07

12.2.0.19.07

12.1.0.2.3

12.1.0.2.3

RTM

(05/04/15)

Oracle Database 12.2へのインストールはできません。

SQL Developer 4.1.1 RTM Version 4.1.1.19 Build MAIN-19.59

12.2.0.19.59

12.1.0.2.3

12.1.0.2.3

RTM
(05/29/15)

軽微なData Miner UIバグを含むパッチ・リリース。リポジトリを4.1から4.1.1にアップグレードする必要はありません。

SQL Developer 4.1.2 RTM Version 4.1.2.20 Build MAIN-20.64

12.2.0.20.64

12.1.0.2.4

12.1.0.2.3

RTM
(10/23/15)

Oracle Data Miner 4.1.1拡張パッチ・リリース以降、Oracle Data Minerの変更はありません。

SQL Developer 4.1.3 Version 4.1.3.20 Build MAIN-20.78

12.2.0.20.78

12.1.0.2.5

12.1.0.2.3

RTM
(12/22/15)

Oracle Data Minerパッチ・リリース4.1.2.20以降、Oracle Data Minerの変更はありません。

SQL Developer 4.1.4 Version 4.1.4.21 Build MAIN-21.20

12.2.0.21.20

12.1.0.2.6

12.1.0.2.3

RTM
(8/16)

バグ修正のみ。リポジトリのアップグレードが必要です。Oracle Databaseインストールからのみ入手可能で、Oracle SQL Developer OTNサイトからは入手できません。

SQL Developer 4.1.5 Version 4.1.5.21 Build MAIN-21.78

12.2.0.21.78

12.1.0.2.6

12.1.0.2.3

RTM
(9/16/16)

バグ修正のみ。Oracle Data Miner 4.1.4からのリポジトリのアップグレードは不要です。ただし、Oracle Data Miner 4.1.3からのリポジトリのアップグレードは必要です。

SQL Developer 4.2 EA1 Version 14.2.0.16.260 Build 16.260.1303

12.2.1.16.260.1303

12.2.0.0.0

12.2.0.0.0

リリース

(9/17/16)

今後のOracle Databaseメイン・リリースの機能をサポートします。リポジトリのアップグレードが必要です。

SQL Developer 4.2 EA2 Version 4.2.0.16.356 Build 16.356.1154

12.2.1.16.356.1154

12.2.0.0.1

12.2.0.0.1

リリース
(12/21/16)

改善されたData Miningワークフロー・ステータス・ポーリング・パフォーマンスおよびOracle Data Miner 4.2の機能に関係するバグ修正が含まれます。

SQL Developer 4.2 RTM Version 4.2.0.17.089 Build 17.089.1709

12.2.1.17.089.1709

12.2.0.0.2

12.2.0.0.1

RTM
(4/12/17)

Oracle Database 12.2の機能をサポートします。

SQL Developer 17.2

12.2.1.xx.xx

12.2.0.0.2

12.2.0.0.1

RTM
(6/17)

以前のリリースからの移行は不要です。デモ・データ・インスタンス・スクリプトの修正が含まれます。

索引

A  C  D  F  I  J  L  M  O  P  R  S  T  U  W  X

A

- AL32UTF8キャラクタ・セット 1

- ASM 1

- ASSM 1 , 2 , 3

C

- クラウド・データベース接続 1

D

- データ

- アクセス 1

- マルチバイト 1

- サンプル 1

- Data Miner

- 管理スクリプト 1

- アーキテクチャ 1

- ビッグ・データ 1

- インストール 1

- リソース・プラン 1

- Data Minerリポジトリ

- 「リポジトリ」を参照

- Data Minerユーザー

- 「ユーザー」を参照

- DBMS_DATA_MINING 1

- DBMS_DATA_MINING_TRANSFORM 1

- DBMS_PREDICTIVE_ANALYTICS 1

- DM$表 1

F

- 全体バックアップとリストア 1

I

- インストール

- Data Miner 1

- JSONパーサーとData Guide 1

- Oracle R Enterprise 1

- 要件 1

- SQL Developer 1

- 内部表 1

J

- ジョブ 1

- JSON 1 , 2

L

- Linux 1

- loadjsonschemagen.sql 1

- ロック

- セッション 1 , 2 , 3 , 4

- ワークフロー 1 , 2

M

- システム・リソースの管理

- モデル・ビルド用 1

- パラレル処理用 1

- ワークフロー実行用 1

- ワークロード用 1

- Microsoft Windows 1

- migratebinaryodmr.sql 1 , 2

- migrateodmr.sql 1

O

- オブジェクト 1

- ODMR$表 1

- ODMR$WORKFLOWS_BACKUP表, 1

- ODMRSYS 1

- ODMRUSERロール 1 , 2 , 3 , 4

- Oracle Advanced Analytics 1 , 2

- Oracle Automatic Segment Space Management

- 「ASM」を参照

- Oracle Database Examples 1

- Oracle Database Recovery Manager

- 「RMAN」を参照

- Oracle Database Resource Manager 1

- Oracle Database Scheduler

- 「スケジューラ」を参照

- Oracle Data Mining

- API 1

- データ・ディクショナリ・ビュー 1

- PL/SQLパッケージ 1

- SQLスコアリング関数 1

- Oracle Data Pump 1

- Oracle R Enterprise 1 , 2 , 3

- Oracle RMAN 1

- Oracle Scheduler 1

- Oracle Solaris 1

- Oracle Text 1 , 2 , 3

- Oracle Textのナレッジ・ベース 1

P

- PARALLEL_DEGREE_POLICY=AUTO) 1

- パラレル問合せ 1

- PL/SQL API

- PROJECT_CREATE 1

- PROJECT_DELETE 1

- PROJECT_RENAME 1

- WF_DELETE 1

- WF_EXPORT 1

- WF_IMPORT 1

- WF_RENAME 1

- WF_RUN 1

- WF_STOP 1

- 予測問合せ 1

- PROJECT_DELETE

- PL/SQL API 1

- プロキシ・ユーザー 1

R

- リポジトリ

- 概要 1 , 2

- アクセス権 1

- api 1

- バックアップとリストア 1

- バイナリ記憶域 1 , 2

- ステータスとバージョンの判定 1

- 削除 1

- インストール 1

- GUIを使用したインストール 1

- スクリプトを使用したインストール 1

- オブジェクト・リレーショナル記憶域 1 , 2

- 使用するオブジェクト 1

- ビュー 1

- リポジトリ・ビュー

- ODMR_USER_PROJECT_WORKFLOW 1

- ODMR_USER_WF_CLAS_TEST_RESULTS 1

- ODMR_USER_WF_REGR_TEST_RESULTS 1

- ODMR_USER_WF_TEST_RESULTS 1

- ODMR_USER_WORKFLOW_ALL 1

- ODMR_USER_WORKFLOW_LOG 1

- ODMR_USER_WORKFLOW_MODELS 1

- ODMR_USER_WORKFLOW_NODES 1

- リソース・プラン 1

- RMAN 1

S

- サンプル・データ 1

- サンプル・スキーマ 1

- スケジューラ 1

- スケジューラ 1 , 2

- スコアリング 1

- スニペット 1 , 2

- データ・マイニングSQL関数 1

- SQL Developer

- 概要 1

- インストール 1

- SQLスクリプトの生成

- ユースケース 1

T

- 表とビュー 1

U

- upgradeRepoFromORtoBinary.sql 1

- upgradeRepoWithNewTableSpace.sql 1

- ユーザー

- Data Miner 1

- ユーザー・スキーマ内のオブジェクト 1

- プロキシ 1

- リポジトリへの複数ユーザー・アクセス 1

- ユーザーのスキーマ 1

W

- WF_DELETE

- PL/SQL API 1

- WF_EXPORT

- PL/SQL API 1

- WF_IMPORT

- PL/SQL API 1

- WF_RENAME

- PL/SQL API 1

- WF_STOP

- PL/SQL API 1

- ワークフロー

- バックアップ 1

- バックアップからのリストア 1 , 2

- スケジューリング 1

X

- XML

- バイナリ記憶域 1 , 2 , 3 , 4 , 5

- オブジェクト・リレーショナル記憶域 1 , 2 , 3 , 4 , 5

- XML DB 1 , 2 , 3

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)を参照してください。