R スクリプトの実行

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 スクリプトの間の翻訳プロセスを使用して、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