Oracle Machine Learning for Rの概要

1.1 Oracle Machine Learning for Rについて

Oracle Machine Learning for R (OML4R)は、本番環境への迅速なデプロイが可能な、Rでのエンドツーエンド分析プロセス用の包括的なデータベース集中型の環境です。

OML4Rは、RパッケージおよびOracle Database機能のセットで、Rユーザーは、SQLを使用せずにデータベース常駐データを操作でき、そのデータベース・サーバーで稼働する1つ以上の埋込みRエンジンでRスクリプトを実行できます。

OML4RをローカルのRセッションから使用すると、Oracle Databaseインスタンスのデータに簡単にアクセスできます。データベース表のデータを指定するRオブジェクトを作成および使用できます。OML4Rには、R操作をデータベース内で実行するSQLに変換するオーバーロードされた関数があります。データベースはSQLを統合し、SQL文の実行時に、問合せの最適化、パラレル処理およびデータベースのスケーラビリティ機能を使用できます。データベースは結果をRオブジェクトとして返します。

埋込みRの実行は、OML4Rの使用による最も重要な利点のいくつかを提供します。埋込みRの実行を使用すると、RインタフェースまたはSQLインタフェース、あるいは両方を介してデータベース内のRスクリプトを格納および実行できます。Rスクリプトの結果を、構造化データ、Rオブジェクトおよびイメージに対するSQL対応のツールで使用できます。

親トピック: Oracle Machine Learning for Rの概要

1.2 Oracle Machine Learning for Rの利点

OML4Rを使用したOracle Databaseインスタンスのデータの準備および分析では、Rユーザーにとって多くの利点があります。

OML4Rを使用して、次のことを実行できます。

SQLを使用せずにデータベース常駐データを操作。OML4Rには、標準のR構文をSQLに透過的に変換するオーバーロードされたオープン・ソースRのメソッドおよび関数があります。これらのメソッドおよび関数は、OML4Rの透過層を実装するパッケージに含まれています。これらの関数およびメソッドを使用することで、データベースに常駐するデータに対するアクセス、分析および操作を行うRオブジェクトを作成できます。データベースは、SQLを自動的に最適化して問合せの効率を向上できます。
データの移動を排除。データベースにデータを保持することによって、デスクトップ・コンピュータへのデータの転送にかかる時間およびデータをローカルに格納する必要性をなくします。また、ローカルに格納したデータの管理(データ・ファイルの適切な場所への配布、本番データベースで行われた変更とのデータの同期などのタスクが含まれます)を必要なくします。
データをセキュアに保持。データをデータベースに保持することによって、データ管理用のOracle Databaseのセキュリティ、スケーラビリティ、信頼性およびバックアップの各機能を利用できます。
データベースの能力を使用。データベース常駐データを直接操作することによって、データベースのメモリーおよび処理能力を使用でき、クライアントのRセッションのメモリーの制約を回避できます。
最新のデータを使用。データはデータベースでリフレッシュされるため、最新のデータにただちにアクセスできます。
データベースでデータを準備。透過層関数を使用して、順序付け、集計、フィルタ処理、記録などの操作を介した予測分析用、およびSQLコードを記述することなく総括的サンプリング手法を使用するための、大規模なデータベース常駐データ・セットを準備します。
データベースにRオブジェクトを保存。Rオブジェクトを他の場所から使用可能な永続データベース・オブジェクトとしてOracle Databaseインスタンスに保存できます。RオブジェクトおよびOML4RオブジェクトをOracle Databaseインスタンスが管理するOML4Rデータストアに格納できます。
データベースにモデルを構築。データベースにモデルを構築して、OML4Rデータストアにそれらを格納して管理できます。CRAN (Comprehensive R Archive Network)からダウンロードしたパッケージ内の関数を使用して、大量のメモリーを必要とし、アンサンブル・モデリングなどの手法を使用するモデルを構築できます。
データベースのデータをスコアリング。スクリプトにRモデルを含めてデータベース常駐データをスコアリングできます。次のようなタスクを実行できます。
- スコアリングに同じRコードを使用できるため、モデル構築からスコアリングに1つのステップで移動します。一部のスタンドアロン分析サーバーで必要なスコアリング・ロジックの変換は必要ありません。
- バルク・スコアリングなどのタスクを実行するためにスクリプトが自動的に実行されるようにスケジュールします。
- トランザクションのコンテキストでデータをスコアリングします。
- オンラインのwhat-ifスコアリングを実行します。
- オプションでモデルをSQLに変換しますが、これはOracle Databaseによって自動的に実行されます。その後、生成されたSQLを低遅延スコアリング・タスクにデプロイできます。
データベースでRスクリプトを実行。 OML4Rの埋込みRの実行機能を使用して、データベースでRスクリプトを作成、格納および実行できます。このスクリプトの実行時に、Oracle Databaseは、データベース・サーバーでパラレルに実行可能な1つ以上のRエンジンを開始、制御および管理します。データベース・サーバーでスクリプトを実行することによって、サーバーのスケーラビリティおよびパフォーマンスを活用できます。

埋込みRの実行機能を使用すると、次のことを実行できます。
- Rスクリプトを対話式に開発およびテストし、SQLアプリケーションでスクリプトを使用できるようにします。
- データベース・サーバー上のRスクリプトでCRANおよび他のパッケージを使用します。
- Rスクリプト全体を本番アプリケーションで操作できるようにし、Rコードの移植を排除することで、Rの結果を既存のアプリケーションに統合するためのコードの作り直しを回避します。
- Oracle DatabaseをRスクリプトの高パフォーマンス・コンピューティング(HPC)環境としてシームレスに使用することで、データのパラレル化およびリソース管理を提供します。
- Oracle Databaseの処理リソースおよびメモリー・リソース、およびデータベースと埋込みRの実行のRエンジン間の読取り/書込み操作の高い効率性を使用します。
- データ・パラレル操作およびタスク・パラレル操作でのデータベースのパラレル処理機能を使用します。
- パラレル・シミュレーションを実行します
- RアプリケーションまたはSQLアプリケーションで使用可能なXMLイメージおよびPNGイメージを生成します。
Oracleテクノロジ・スタックと統合。Oracleテクノロジ・スタックのあらゆる側面を利用して、ビジネス・インテリジェンスや科学調査といった、より大規模なフレームワーク内に、独自のデータ分析を統合できます。たとえば、OML4Rの分析結果をOracle Business Intelligence Enterprise Edition (OBIEE)に統合できます。

親トピック: Oracle Machine Learning for Rの概要

1.3 Oracle Machine Learning for Rのクラス、関数およびメソッドのオンライン・ヘルプの取得

OML4Rのクライアント・パッケージには、Oracle Databaseのデータとの相互作用に使用するRコンポーネントが含まれています。

クライアント・パッケージのリストと簡単な説明、およびそれらのインストールの詳細は、『Oracle Machine Learning for Rインストレーションおよび管理ガイド』を参照してください。

OML4Rのクラス、関数およびメソッドに関するヘルプを取得するには、help、showMethodsなどのR関数を使用します。クラスまたは関数の名前にore接頭辞が付いている場合は、help関数にその名前を指定できます。オープン・ソースR関数のオーバーロードされたメソッドに関するヘルプを取得するには、メソッドの名前およびoreクラスの名前を指定します。

例1-1 OML4Rのクラス、関数およびメソッドに関するヘルプの取得

この例では、OML4Rのクラス、関数およびメソッドに関する情報を取得するための様々な方法を示します。例の後にあるリストでは、一部のコードは結果の一部のみを表示するために変更されていて、一部の関数の出力は表示されていません。

# List the contents of the OREbase package.
ls("package:OREbase")

# Get help for the OREbase package.
help("OREbase")

# Get help for the ore virtual class.
help("ore-class")

# Show the subclasses of the ore virtual class.
showClass("ore")

# Get help on the ore.frame class.
help("ore.frame")

# Get help on the ore.vector class.
help("ore.vector")

# Show the arguments for the aggregate method.
showMethods("aggregate")

# Get help on the aggregate method for an ore.vector object.
help("aggregate,ore.vector-method")

# Show the signatures for the merge method.
showMethods("merge")

# Get help on the merge method for an ore.frame object.
help("merge,ore.frame,ore.frame-method")

showMethods("scale")

# Get help on the scale method for an ore.number object.
help("scale,ore.number-method")

# Get help on the ore.connect function.
help("ore.connect")

例1-1のリスト

R> options(width = 80)
# List the contents of the OREbase package.
R> head(ls("package:OREbase"), 12)
 [1] "%in%"          "Arith"         "Compare"       "I"            
 [5] "Logic"         "Math"          "NCOL"          "NROW"         
 [9] "Summary"       "as.data.frame" "as.env"        "as.factor"
R>
R># Get help for the OREbase package.
R> help("OREbase")      # Output not shown.
R>
R> # Get help for the ore virtual class.
R> help("ore-class")    # Output not shown.
R>
R># Show the subclasses of the ore virtual class.
R> showClass("ore")
Virtual Class "ore" [package "OREbase"]
 
No Slots, prototype of class "ore.vector"
 
Known Subclasses: 
Class "ore.vector", directly
Class "ore.frame", directly
Class "ore.matrix", directly
Class "ore.number", by class "ore.vector", distance 2
Class "ore.character", by class "ore.vector", distance 2
Class "ore.factor", by class "ore.vector", distance 2
Class "ore.date", by class "ore.vector", distance 2
Class "ore.datetime", by class "ore.vector", distance 2
Class "ore.difftime", by class "ore.vector", distance 2
Class "ore.logical", by class "ore.vector", distance 3
Class "ore.integer", by class "ore.vector", distance 3
Class "ore.numeric", by class "ore.vector", distance 3
Class "ore.tblmatrix", by class "ore.matrix", distance 2
Class "ore.vecmatrix", by class "ore.matrix", distance 2
R>
# Get help on the ore.frame class.
R> help("ore.frame")       # Output not shown.

R># Get help on the ore.vector class.
R> help("ore.vector")    # Output not shown.
R>
R># Show the arguments for the aggregate method.
R> showMethods("aggregate")
Function: aggregate (package stats)
x="ANY"
x="ore.vector"

# Get help on the aggregate method for an ore.vector object.
R> help("aggregate,ore.vector-method")      # Output not shown.

# Show the signatures for the merge method.
R> showMethods("merge")
Function: merge (package base)
x="ANY", y="ANY"
x="data.frame", y="ore.frame"
x="ore.frame", y="data.frame"
x="ore.frame", y="ore.frame

# Get help on the merge method for an ore.frame object.
R> help("merge,ore.frame,ore.frame-method")  # Output not shown.

R> showMethods("scale")
Function: scale (package base)
x="ANY"
x="ore.frame"
x="ore.number"
x="ore.tblmatrix"
x="ore.vecmatrix"

# Get help on the scale method for an ore.number object.
R> help("scale,ore.number-method")    # Output not shown.

# Get help on the ore.connect function.
R> help("ore.connect")                # Output not shown.

親トピック: Oracle Machine Learning for Rの概要

1.4 Oracle DatabaseのデータでのRの透過的な使用について

OML4Rには、Oracle Databaseインスタンスのデータを直接操作するために使用できるオーバーロードされたオープン・ソースRのメソッドおよび関数があります。

このメソッドおよび関数は、R関数をSQLに変換する透過層を実装するパッケージに含まれています。

OML4Rの透過層パッケージおよびRをSQLに変換する際の制限について、次の各項で説明します。

透過層について
Oracle Machine Learning for Rの透過層は、OREbase、OREgraphicsおよびOREstatsのパッケージで実装されます。
Rのデータ型およびクラスの透過層サポート
Oracle Machine Learning for Rの透過層には、Rデータ型をOracle Databaseデータ型にマップするクラスおよびデータ型があります。

親トピック: Oracle Machine Learning for Rの概要

1.4.1 透過層について

Oracle Machine Learning for Rの透過層は、OREbase、OREgraphicsおよびOREstatsのパッケージで実装されます。

これらのOML4Rパッケージには、オープン・ソースRのbase、graphicsおよびstatsのパッケージの関数のオーバーロードされたメソッドがそれぞれ含まれています。また、OML4Rパッケージには、一部のオープン・ソースR関数のOML4R版も含まれています。

これらのパッケージのメソッドおよび関数を使用することで、Oracle Databaseインスタンスのデータを指定するRオブジェクトを作成できます。そのようなオブジェクトを使用するR式を実行すると、メソッドおよび関数はSQL問合せを透過的に生成してデータベースに送信します。その後、データベースはその問合せを実行して、操作の結果をRオブジェクトとして返します。

データベース表またはビューは、data.frameのサブクラスであるore.frameオブジェクトで表されます。その他のOML4Rクラスは、ore.vector、vectorなどの対応するRクラスから継承されます。OML4Rは、Oracle Databaseのデータ型をOML4Rのクラスに(たとえば、NUMBERをore.integerに)マップします。

透過層メソッドおよび関数を使用して、分析用のデータベース常駐データを準備できます。次に、他のOML4Rパッケージの関数を使用して、モデルを構築および適合し、それを使用してデータをスコアリングできます。大規模なデータセットでは、Oracle Databaseに埋め込まれたRエンジンを使用してモデリングおよびスコアリングを実行できます。

1.4.2 Rのデータ型およびクラスの透過層サポート

Oracle Machine Learning for Rの透過層には、Rデータ型をOracle Databaseデータ型にマップするクラスおよびデータ型があります。

これらのクラスおよびデータ型について、次の各項で説明します。

Oracle Machine Learning for Rのデータ型およびクラスについて
OML4Rには、Rデータ型をSQLデータ型にマップするデータ型があります。
ore.frameクラスについて
ore.frameオブジェクトは、Oracle Databaseインスタンスに対するリレーショナル問合せを表します。
Rのネーミング規則のサポート
OML4Rは、ore.frame列に対して、より制限的なOracle Databaseのネーミング規則ではなくRのネーミング規則を使用します。
RおよびOracle Machine Learning for Rのクラス・タイプの強制変換について
OML4R関数の一部は、Rオブジェクトおよびクラス・タイプをOML4Rのoreオブジェクトおよびタイプに強制変換します。

親トピック: Oracle DatabaseのデータでのRの透過的な使用について

1.4.2.1 Oracle Machine Learning for Rのデータ型およびクラスについて

OML4Rには、Rデータ型をSQLデータ型にマップするデータ型があります。

Rセッションでは、Rオブジェクトからデータベース・オブジェクトを作成するか、データベース・データからRオブジェクトを作成すると、OML4RはRデータ型をSQLデータ型に変換し、可能な場合はその逆を実行します。

OML4Rは、OML4Rのクラスのインスタンスであるオブジェクトを作成します。OML4Rは、多くの標準のR関数をオーバーロードし、それらでOML4Rのクラスおよびデータ型を使用できるようにします。R言語の構造および構文は、Oracle Databaseオブジェクトにマップされているオブジェクトでサポートされます。

表1-1 R、OML4RおよびSQLのデータ型のマッピング

Rデータ型	OML4Rデータ型	SQLデータ型
キャラクタ・モードの`vector`	`ore.character`	`VARCHAR2` `INTERVALYEARTOMONTH`
整数モードの`vector`	`ore.integer`	`NUMBER`
論理モードの`vector`	`ore.logical`	`NUMBER`は`FALSE`の場合は0、`TRUE`の場合は1
数値モードの`vector`	`ore.number`	`BINARY_DOUBLE` `BINARY_FLOAT` `FLOAT` `NUMBER`
`Date`	`ore.date`	`DATE`
`POSIXct` `POSIXlt`	`ore.datetime`	`TIMESTAMP` `TIMESTAMPWITHTIMEZONE` `TIMESTAMPWITHLOCALTIMEZONE`
`difftime`	`ore.difftime`	`INTERVALDAYTOSECOND`
なし	サポートなし	`LONG` `LONG RAW` `RAW` ユーザー定義のデータ型参照データ型

ノート:

タイプore.datetimeのオブジェクトはタイム・ゾーン設定をサポートしていないため、かわりに、システム・タイム・ゾーンSys.timezoneが使用可能な場合はそれを使用し、Sys.timezoneを使用できない場合はGMTを使用します。
SQL VARCHAR2データ型は、埋込みRの入力データ引数を介してR文字データ型にマップされます。ユーザーは、as.factor()を使用して、必要に応じて文字変数をRファクタに変換できます。

関連トピック

Oracle Machine Learning for RでサポートされるR演算子およびR関数

親トピック: Rのデータ型およびクラスの透過層サポート

1.4.2.2 ore.frameクラスについて

ore.frameオブジェクトは、Oracle Databaseインスタンスに対するリレーショナル問合せを表します。

これはdata.frameに相当するOML4Rのオブジェクトです。通常は、データベース表のプロキシであるore.frameオブジェクトを取得します。次に、ore.frameプロキシ・オブジェクトに新しい列を追加するか、他の変更を行います。そのような変更は、基礎となる表には影響しません。その後でore.frameオブジェクトのソース表からデータをリクエストした場合は、透過層関数が選択リストに追加の列があるSQL問合せを生成しますが、その表は変更されません。

Rでは、data.frameの要素に明示的な順序付けがあります。整数索引付けを使用して要素を指定できます。一方、リレーショナル・データベース表では行の順序が定義されないため、Rデータ構造に直接マップできません。

OML4Rには、ore.frameオブジェクトの順序付けられたものと順序付けられていないものの両方があります。表に主キー(行内で個別のタプルを形成する1つ以上の列のセット)がある場合は、SELECT文でORDER BY句を使用することで順序付けられた結果を生成できます。ただし、リレーショナル・データの順序付けは負荷が高く、多くの場合、透過層操作では不要です。たとえば、ore.frameでsummary関数を呼び出す場合、サマリー統計の計算に順序付けは必要ありません。

1.4.2.3 Rのネーミング規則のサポート

OML4Rは、ore.frame列に対して、より制限的なOracle Databaseのネーミング規則ではなくRのネーミング規則を使用します。

ore.frameの列には、30バイトより長く、二重引用符を含む、一意でない名前を付けることができます。

親トピック: Rのデータ型およびクラスの透過層サポート

1.4.2.4 RおよびOracle Machine Learning for Rのクラス・タイプの強制変換について

OML4R関数の一部は、Rオブジェクトおよびクラス・タイプをOML4Rのoreオブジェクトおよびタイプに強制変換します。

汎用のas.ore関数は、インメモリーRオブジェクトをoreオブジェクトに強制変換します。より厳密なas.ore.characterなどの関数は、オブジェクトを特定の型に強制変換します。ore.push関数は、Rクラス・タイプをoreクラス・タイプに暗黙的に強制変換し、ore.pull関数は、oreクラス・タイプをRクラス・タイプに強制変換します。これらの関数の詳細は、「データベースに対するデータの移動」を参照してください。

例1-5 RおよびOML4Rのクラス・タイプの強制変換

この例では、oreオブジェクトへのRオブジェクトの強制変換を示します。Rのintegerオブジェクトを作成した後、汎用メソッドas.oreを使用してore.integerであるoreオブジェクトに強制変換します。この例では、Rオブジェクトを他の様々なoreクラス・タイプに強制変換します。埋込みRの実行関数でのas.factorの使用例は、例6-13を参照してください。

x <- 1:10
class(x)
X <- as.ore(x)
class(X)
Xn <- as.ore.numeric(x)
class(Xn)
Xc <- as.ore.character(x)
class(Xc)
Xc
Xf <- as.ore.factor(x)
Xf

例1-5のリスト

R> x <- 1:10
R> class(x)
[1] "integer"
R> X <- as.ore(x)
R> class(X)
[1] "ore.integer"
attr(,"package")
[1] "OREbase"
R> Xn <- as.ore.numeric(x)
R> class(Xn)
[1] "ore.numeric"
attr(,"package")
[1] "OREbase"
R> Xc <- as.ore.character(x)
R> class(Xc)
[1] "ore.character"
attr(,"package")
[1] "OREbase"
R> Xc
 [1] "1"  "2"  "3"  "4"  "5"  "6"  "7"  "8"  "9"  "10"
R> Xf <- as.ore.factor(x)
R> Xf
 [1] 1  2  3  4  5  6  7  8  9  10
Levels: 1 10 2 3 4 5 6 7 8 9

親トピック: Rのデータ型およびクラスの透過層サポート

1.5 Oracle Machine Learning for R使用時の通常の操作

OML4Rを使用する際の一般的な操作の進め方を次に示します。

Rセッションで、Oracle Databaseインスタンスのスキーマに接続します。
スキーマをアタッチして、データベース表に対するOML4Rプロキシ・オブジェクトを生成するスキーマ・オブジェクトと同期化します。
分析用のデータを準備し、探索的データ分析およびデータの視覚化を実行する場合があります。
OREmodelsパッケージまたはOREdmパッケージの関数を使用してモデルを構築します。
ローカルのRセッションで、または埋込みRの実行を使用して、モデルを使用してデータをスコアリングします。
分析結果をエンド・ユーザーにデプロイします。

図1-1 一般的なOML4Rのワークフロー

この図は、これらのステップおよびステップの一般的な繰返しを示しています。

「図1-1 一般的なOML4Rのワークフロー」の説明

親トピック: Oracle Machine Learning for Rの概要

1.6 Oracle Machine Learning for Rのグローバル・オプション

OML4Rには、様々な関数に適用されるグローバル・オプションがあります。

表1-2に、OML4Rのグローバル・オプションおよび説明を示します。

表1-2 OML4Rのグローバル・オプション

グローバル	説明
`ore.envAsEmptyenv`	Oracle Databaseへのシリアライズ中にオブジェクト内の参照される環境を空の環境で置き換えるかどうかを指定する論理値。`TRUE`の場合、オブジェクト内の参照される環境は親が`.GlobalEnv`である空の環境で置き換えられ、参照される元の環境内のオブジェクトはシリアライズされません。これにより、シリアライズされるオブジェクトのサイズを大幅に削減できる場合があります。`FALSE`の場合、参照される環境内のすべてのオブジェクトがシリアライズされますが、シリアライズを解除したりメモリーにロードすることもできます。このオプションのデフォルト値は`FALSE`です。このグローバル・オプションは次のOML4R関数で使用されます。シリアライズされた`list`オブジェクトをデータベースに保存するための`ore.push` オブジェクトをOML4Rデータストアに保存するための`ore.save` `ore.doEval`、および`list`タイプのパラメータをシリアライズし、埋込みRの実行時にR関数により返されたオブジェクトをシリアライズするためのその他の埋込みR実行関数
`ore.na.extract`	`ore.frame`オブジェクトまたは`ore.vector`オブジェクトの論理サブスクリプト中に使用される論理値。`TRUE`が指定されると、`NA`論理サブスクリプトを含む行または要素は、`NA`値を含む行または要素を生成しますが、これは、Rによる`data.frame`値および`vector`値の欠損値の論理サブスクリプトの処理方法を模倣します。 `FALSE`が指定されると、`NA`論理サブスクリプトは`FALSE`値として解釈されるため、対応する行または要素が削除されます。デフォルト値は`FALSE`です。
`ore.parallel`	埋込みRの実行で使用する優先並列度。次のうちの1つ。特定の並列度では、`2`以上の正の整数パラレル化しない場合は、`FALSE`または`1` `data`引数のデフォルトのパラレル化の場合は`TRUE` 操作に対するデータベースのデフォルトは`NULL` デフォルト値は`NULL`です。
`ore.sep`	`ore.frame`の複数列の行名間で使用するセパレータを指定する文字列。デフォルト値は`\|`です。
`ore.trace`	OML4Rの反復関数が反復ごとに出力を印刷するかどうかを指定する論理値。デフォルト値は`FALSE`です。
`ore.warn.order`	順序付けが必要な関数で行名がない`ore.frame`または要素名がない`ore.vector`を使用したときにOML4Rが警告メッセージを表示するかどうかを指定する論理値。デフォルト値は`TRUE`です。