R 実行 (DB)

R 実行を構成するには、有効なデータ ソースを R 実行オペレーターに接続します。中間オペレーターも R 実行のデータ ソースを構成します。

情報一覧

パラメーター

説明
カテゴリー ツール
データ ソース タイプ DB
出力を他のオペレーターに送信 いいえ
データ処理ツール R エンジン

R 実行 (DB) はデータベース データのみを対象とします。Hadoop データの場合は、R 実行 (HD) オペレーターを使用します。

このオペレーターの設定と使用の詳細については、「R 実行」を参照してください。

入力

スクリプト内の alpine_input という R オブジェクトを参照して、入力データセットが必要であることを指定します。これはデータ フレーム オブジェクトです。

入力データセットを使用しないことを選択することもできます (スクリプトで alpine_input を参照しないことにより)。その場合、データは R に読み込まれません。

  • 入力が先行するオペレーターの場合、先行するオペレーターが実行されますが、スクリプトで alpine_input を使用しないとデータは R に転送されません。
  • 前述のオペレーターがデータ ソース (データベース テーブル) の場合、データベース クエリは実行されないため、実行時間が節約されます。
ノート: R コードで入力データセットを使用しない場合でも、何らかの種類のデータ ソースを指定する必要があります。これは、引き続き出力データ フレームを生成する可能性があり、そのデータ フレームが入力用に選択されたデータ ストア タイプ (つまり、データベース入力に対するデータベース出力) と同じデータ ストア タイプに格納されている必要があるためです。また、同じ特定のデータ ストア (同じデータベース) である必要があります。

制限事項

パッケージ、システム、サーバーの要件については、TIBCO® Data Science - Team Studio システム要件 の「R 実行前提条件」を参照してください。

構成

パラメーター 説明
ノート このオペレーターのパラメーター設定に関するメモまたは役立つ情報。 [ノート] フィールドに内容を入力すると、オペレーターに黄色のアスタリスクが表示されます。
R スクリプト 実行する R スクリプト。 [句の定義] を選択して R スクリプトを指定します。

参照: 「R スクリプトの定義 ダイアログ

出力スキーマ R 実行出力データ フレームのテーブル表現を含むデータベース スキーマを指定します。
出力テーブル 上で定義したスキーマ内で、R 実行出力データ フレームのテーブル表現が保存されるデータベース テーブルの名前を指定します。
存在する場合は削除
  • [はい] (デフォルト) の場合、同じ名前の既存のテーブルを削除し、新しいテーブルを作成します。
  • [いいえ] の場合、フローを停止し、エラーが発生したことをユーザーに警告します。
パス出力テーブル R 実行がターミナル オペレーターではない場合にのみ必須です。

R 実行の出力を次のオペレーターに渡すかどうかを指定します。

このオプションは、オペレーターの出力を次のオペレーターに実行する場合に重要です。

[パス出力テーブル][はい] に設定されている場合、[結果テーブル構造] の詳細を設定する必要があります。

デフォルト値: いいえ

結果テーブルの構造 次のオペレーターに渡すオペレーター出力のテーブル構造を指定します。

このオプションは、R スクリプトの alpine_output 変数から値を動的に取得します。R スクリプトを一度実行するまで、値は設定されません。

[出力ファイルのパス][はい] に設定されている場合にのみ有効になります。

詳細については、「テーブル カラムの編集 ダイアログ」を参照してください。

次のコードは、alpine_output の使用方法の例を示しています。

print("hello")
foo = c("setosa", "virginica", "versicolor")
alpine_output = data.frame(class = foo, 
predicted_class = foo)

出力

ビジュアル出力
このテーブルは、[パス出力テーブル][はい] に設定されているかどうか、および [結果テーブル構造] が提供されているかどうかに関係なく保存されます。 [パス出力テーブル][結果テーブル構造] の組み合わせは、R 実行オペレーターの後に別のオペレーターが続く場合にフローの整合性をチェックするためにのみ使用されます。

alpine_output オブジェクトが R コードに存在しない場合、出力は生成されません。 [パス出力テーブル][はい] に設定し、R スクリプトに alpine_output オブジェクトへの参照が含まれていない場合、フローは次の時点で失敗します。実行時に、この不一致に対してエラー メッセージが表示されます。

データ

R コードで alpine_output オブジェクトを作成すると、R 実行オペレーターの出力により、結果コンソールの データ タブに出力データ フレーム (データベースに保持される) が表示されます。

R コンソール出力

R コードに出力を R コンソールに出力する関数が含まれている場合、出力は結果コンソールの R コンソール出力 タブに表示されます。

ノート: R 実行オペレーターのコンソール表示の動作は、R コンソールや RStudio の動作とは少し異なります。通常、R コードの中に summary(alpine_input) という文があると、R コンソールや RStudio コンソールに表示されます。しかし、R 実行はコンソール出力をオブジェクトに取り込んでいるので(R の capture.output 関数を使って R で実行されます)、このような呼び出しは print() 関数を使ってラップする必要があります。例えば、summary(alpine_input) の代わりに、print(summary(alpine_input))と指定します。これは R の capture.output 関数の動作の制限です。

R スクリプト

R コードは、結果コンソールの R-Script タブに表示されます。

後続のオペレーターへの出力
データベース/クラスターに出力されるデータ、または次のオペレーターに渡されるデータについて説明します。