Função RSTRING( )

Retorna um valor de cadeia calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

Sintaxe

RSTRING(scriptR|códigoR; comprimento <;campo|valor <;...n>>)

Parâmetros

Nome Tipo Descrição
rScript | rCode

caractere

O caminho completo ou relativo para o script do R ou um snippet de código R a ser executado.

Se você inserir o código R diretamente em vez de usar um arquivo externo, não será possível usar texto entre aspas no código, mesmo que você use o caractere de escape para as aspas:

  • válido 'var <- "\"teste\"" '
  • inválido 'var <- "\'teste\'" '
comprimento numérico O comprimento a ser alocado para a cadeia de retorno.
campo | valor <,...n>

opcional

caractere

numérico

datahora

lógico

A lista de campos, expressões ou valores literais para usar como argumentos para o script ou snippet de código do R.

Os valores são passados para a função chamada na ordem em que são especificados e são referenciados usando valor1, valor2 ... valorN no código do R.

Você pode incluir o número de argumentos necessário para atender à definição da função no script do R.

Nota

Use a função ALLTRIM( ) para remover todos os espaços à esquerda ou à direita de entradas de caracteres: ALLTRIM(cadeia). Para obter mais informações, consulte Função ALLTRIM( ).

Saída

Caractere.

Exemplos

Exemplos básicos

Retorna "abc123":

RSTRING("print(paste(value1,value2,sep=""))",6,"abc","123")

Exemplos avançados

Uso de um script do R externo

Concatena x e y em uma única cadeia delimitada por um caractere espaço:

RSTRING(“a<-source(‘./amostra.r');a[[1]]",50, Nome, Sobrenome)

Script do R externo (amostra.r):

conc <- function(x, y) {
    paste(x, y, sep=" ")
}
print(conc(valor1, valor2))

Uso do código do R armazenado em uma variável

Concatena x e y em uma única cadeia delimitada por um caractere espaço:

ASSIGN v_script = "conc <- function(x, y){paste(x, y, sep=' ')};conc(valor1, valor2)"
RSTRING(v_script; 50; Nome, Sobrenome)

Uso do R para gerar um UUID para uma tabela

Você está preparando uma tabela de exceções para carregar no Resultados e precisa de um identificador comprovadamente único para cada registro. Para gerar esse campo, use o pacote uuid no R para criar um valor de chave primária único para cada registro:

EXTRACT RSTRING("uuid::UUIDgenerate()"; 36) AS "id", nome, sobrenome, data_nascimento TO tabela_exportação

Dica

Para instalar o pacote uuid, abra o R.exe e execute o seguinte comando:

install.packages("uuid")

Observações

Retorno de uma data do R

Ao chamar scripts do R, use a função origem e atribua o objeto retornado a uma variável. Desse modo, você pode acessar o valor retornado da função do R no objeto retornado:

# 'a' contém o objeto da resposta e a[[1]] acessa o valor dos dados
"a<-source('c:\\scripts\\r_scripts\\sample.r');a[[1]]"

Arquivo de log R

O Analytics registra em log as mensagens da linguagem R no arquivo aclrlan.log na pasta do projeto. Use esse arquivo de log para depurar erros do R.

Dica

O arquivo de log está disponível na pasta Resultados das tarefas de análise do Analytics Exchange.

Execução de scripts do R externos no Servidor AX

Se você estiver criando um aplicativo de análise para executar no Servidor AX e quiser trabalhar com scripts do R externos:

  1. Carregue o arquivo como arquivo relacionado ao aplicativo de análise.
  2. Use a tag de análise FILE para identificar o(s) arquivo(s).
  3. Faça referência aos arquivos usando o caminho relativo ./nomedoarquivo.r.

Nota

Usar um arquivo relacionado garante que a conta do servidor do aplicativo TomEE tenha permissões suficientes para acessar o arquivo ao executar o R com o Analytics Exchange.

[ Voltar ao início ]

Guia de scripting do ACL 14.1