Executar scripts do R

Referência aos dados do Analytics no script do R

A tabela do Analytics é passada ao script como um quadro de dados do R. Os quadros de dados são objetos de dados tabulares que podem conter colunas com modos ou tipos diferentes de dados.

Para trabalhar com o quadro de dados criado pelo Analytics em um script do R, chame a função acl.readData() e armazene o quadro de dados retornado em uma variável:

# armazena a tabela do Analytics em um quadro de dados denominado minhaTabela que pode ser referenciado em todo o script
minhaTabela<-acl.readData()

Para recuperar dados de uma célula na estrutura de dados, você pode usar uma das seguintes abordagens:

• Uso de coordenadas de linha e coluna:

  # Recupera o valor da primeira linha e segunda coluna do quadro de dados
  minhaTabela[1,2]

  Nota

  As coordenadas são baseadas na ordem de campos especificada no comando e não no layout da tabela ou na exibição aberta no momento.

• Uso de nomes de linha e coluna:

  # Recupera o valor da primeira linha e da coluna "títuloMinhaColuna" do quadro de dados
  minhaTabela["1","títuloMinhaColuna"]

  É necessário especificar a opção KEEPTITLE do comando para usar nomes de colunas.

  As linhas são chamadas de "1", "2", "3" e são incrementadas de acordo. Você também pode usar uma combinação de nomes e coordenadas.

Transferência de dados de volta para o Analytics

Para retornar um quadro de dados ou matriz ao Analytics e criar uma nova tabela, use a sintaxe a seguir:

# Passa o dataframe minhaNovaTabela para o Analytics para criar uma nova tabela
acl.output<-minhaNovaTabela

Mapeamento de dados do R

Os tipos de dados do Analytics são convertidos em tipos de dados do R usando um processo de tradução entre o projeto do Analytics e o script do R:

Tipo de dados do Analytics	Tipo(s) de dados R
Lógico	Lógico
Numérico	Numérico
Caractere	Caractere
Datahora	Data, POSIXct, POSIXlt

Desempenho e limites de tamanho de arquivo

O tempo que leva para executar seu script do R e processar os dados retornados aumenta para dados de entrada que ultrapassem 1 GB. O R não é compatível com arquivos de entrada de 2 GB ou mais.

O número de registros enviado para o R também afeta o desempenho. Para duas tabelas com o mesmo tamanho de arquivo, mas com contagem de registros diferente, o processamento da tabela com menos registros é mais rápido.

Processamento de dados de caracteres multibyte

Se você estiver enviando dados para o R em um conjunto de caracteres multibyte, como chinês, é preciso definir a localidade do sistema em seu script do R. Para enviar com sucesso uma tabela de dados multibyte para o R, a primeira linha do script do R deve conter esta função:

# Exemplo que define a localidade para chinesa
Sys.setlocale("LC_ALL","Chinese")

Para obter mais informações sobre Sys.setlocale( ), consulte a documentação do R.

Exemplo Olá, mundo

Comando do Analytics

RCOMMAND FIELDS "Olá"; ", mundo!" TO "resultado_r" RSCRIPT "C:\scripts\r_scripts\análise.r"

Script do R (análise.r)

srcTable<-acl.readData()

# criar tabela para enviar de volta ao ACL
output<-data.frame(
  c(srcTable[1,1]),
  c(srcTable[1,2])
)

# adicionar nomes de colunas e enviar tabela de volta ao ACL
colnames(output) <- c("Cumprimento","Assunto")
acl.output<-output