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( ).

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.