运行 R 脚本

在 R 脚本中引用 Analytics 数据

Analytics 表被作为 R 数据框架传递给脚本。数据框架是可能包含数据的不同模式或类型的表格式数据对象。

要在 R 脚本中使用由 Analytics 创建的数据框架，请调用 acl.readData() 函数并且在变量中存储所返回的数据框架：

# 在可以在整个脚本中引用的名为 myTable 的数据帧中存储该 Analytics 表
myTable<-acl.readData()

如需从数据框架中的单元格检索数据，请使用如下方法之一：

• 使用行和列坐标：

  # 检索数据帧的第一行、第二列中的值
  myTable[1,2]

  说明

  坐标基于在命令中指定的域的顺序，而非当前打开的表布局或视图。

• 使用行和列名称：

  # 检索该数据帧的第一行和“myColumnTitle”列中的值
  myTable["1","myColumnTitle"]

  您必须指定该命令的 KEEPTITLE 选项才能使用列名称。

  行被命名为“1”、“2”、“3”，并相应递增。您也可以使用名称和坐标的组合。

将数据传回 Analytics

要将一个数据帧或数据矩阵返回至 Analytics 并创建一个新表，请使用以下语法：

# 将 myNewTable 数据帧返回至 Analytics 以创建一个新表
acl.output<-myNewTable

R 数据映射

Analytics 数据类型被使用 Analytics 项目和 R 脚本之间的转换流程转换为 R 数据类型：

Analytics 数据类型	R 数据类型
逻辑	逻辑
数值	数值
字符	字符
日期时间	日期，POSIXct，POSIXlt

性能和文件大小限制

对于大小超过 1 GB 的输入数据，运行您的 R 脚本以及处理返回数据所花费的时间会增加。R 不支持大小不低于 2 GB 的输入文件。

被发送到 R 的记录数也会影响性能。对于两个具有相同文件大小和不同记录数的表而言，处理包含较少记录的表时更快一些。

处理多字节字符数据

如果要在多字节字符集（例如，中文）中向 R 发送数据，则必须在 R 脚本中适当地设定系统区域设置。要成功向 R 发送多字节数据表，则 R 脚本的第一行必须包含以下函数：

# 将区域设置设定为中文的示例
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