R スクリプトの実行

Concept Information

Analytics テーブルを外部 R スクリプトで分析して返されたデータを使って、新しいテーブルを Analytics プロジェクト内に作成します。ソースデータはデータフレームとして R スクリプトに渡されます。このデータフレームは同梱の関数を使って参照できます。

R での Analytics データの操作

Analytics 内から実行する R スクリプトを作成する場合は、ACL と R スクリプトの間でデータをやり取りする方法に習熟してください。Analytics に同梱されている R 関数を、作成する R スクリプト内で使用することで、RCOMMAND を正常に実行できます。

詳しく表示

R スクリプトでの Analytics データの参照

Analytics テーブルは R データフレームとしてスクリプトに渡されます。データフレームはタブ形式のデータオブジェクトであり、データの異なるモードまたは型の列を含むことがあります。

R スクリプトで Analytics によって作成されたデータ型を操作するには、acl.readData() 関数を呼び出し、返されたデータフレームを変数に格納します。

# Analytics テーブルをデータ フレーム myTable に格納します。これはスクリプトを使用して参照できます
myTable<-acl.readData()

データフレームのセルからデータを取得するには、次のアプローチのうちの 1 つを使用できます。

行と列の座標の使用：
```
# データ フレームの 1 行 2 列の値を取得します。
myTable[1,2]
```
メモ

座標はコマンドで指定されたフィールドの順序に基づいているのであり、テーブルレイアウトや、現在開いているビューに基づいているのではありません。
行と列の名前の使用：
```
# データ フレームの 1 行 "myColumnTitle" 列の値を取得します。
myTable["1","myColumnTitle"]
```
列の名前を使用するには、コマンドの KEEPTITLE オプションを指定する必要があります。

行は、"1"、"2"、"3" と命名されており、そのように増加します。名前と座標の組み合わせを使用することもできます。

Analytics へのデータの返送

データフレームまたはマトリクスを Analytics に戻し、新しいテーブルを作成するには、次の構文を使用します。

＃ myNewTable データ フレームを Analytics に戻し、新しいテーブルを作成します
acl.output<-myNewTable

メモ

R スクリプトが終了するときに、データフレームまたはマトリクスを Analytics に戻す必要があります。データフレームまたはマトリクスの列には原子値のみが含まれ、リスト、マトリクス、配列、非原子オブジェクトがないことを確認します。値を Analytics データ型に変換できない場合は、コマンドが失敗します。

R データのマッピング

Analytics データ型は、Analytics プロジェクトと R スクリプトの間の翻訳プロセスを使用して、R データ型に変換されます。

Analytics データ型	R データ型
論理	論理
数値	数値
文字	文字
日付時刻	日付、POSIXct、POSIXlt

パフォーマンスとファイルサイズ制限

R スクリプトの実行と返されるデータの処理にかかる時間は、入力データが 1 GB を超える場合には長くなります。R では、2 GB 以上の入力ファイルはサポートされていません。

また、R に送信されるレコード数もパフォーマンスに影響します。ファイルサイズは同じだがレコード数が異なる 2 つのテーブルでは、レコード数が少ないテーブルの方が処理が高速になります。

複数バイト文字データの処理

中国語のような、複数バイトの文字セットでデータを R に送信する場合、R スクリプトにシステムロケールを適切に設定する必要があります。複数バイトのデータのテーブルを R に正常に送信するには、R スクリプトの第 1 行に、次の関数が含まれている必要があります。

# ロケールを中国語に設定する例
Sys.setlocale("LC_ALL","Chinese")

Sys.setlocale( ) の詳細については、R ドキュメントを参照してください。

「Hello world」の例

Analytics コマンド

RCOMMAND FIELDS "Hello", ", world!"TO "r_result" RSCRIPT "C:\scripts\r_scripts\analysis.r"

R スクリプト（analysis.r）

srcTable<-acl.readData()

# ACL に返送するテーブルを作成
output<-data.frame(
  c(srcTable[1,1]),
  c(srcTable[1,2])
)

# 列名を追加して ACL にテーブルを返送
colnames(output) <- c("Greeting","Subject")
acl.output<-output