Ferramenta R
A ferramenta r é um editor de código para usuários de r, uma base de código Open-Source usada para análise estatística e preditiva. A proficiência em R scripting é recomendada antes de usar esta ferramenta.
Compatibilidade da Galeria pública do alteryx
Planejando publicar seu fluxo de trabalho para Gallery.alteryx.com? Você deve primeiro solicitar uma isenção. Essa restrição não se aplica a instâncias privadas do Alteryx Server e da galeria do Alteryx.
R em Designer
Designer lê no script R válido e passa o script através da ferramenta. A saída da ferramenta r corresponde a saídas r.
R suporte
Enquanto designer aceita código R personalizado, Alteryx não fornece suporte para ele.
Alteryx usa [AlteryxFullUpdate], uma variável global para o script R, para atualizações de metainfo. As atualizações completas de metainfo ocorrem quando AlteryxFullUpdate = true. Isso acontece quando o fluxo de trabalho é aberto pela primeira vez e quando o fluxo de trabalho é atualizado usando F5.
AlteryxFullUpdate = false durante todas as outras atualizações, como um fluxo de trabalho sendo executado ou reconfiguração de ferramenta. Para forçar atualizações completas depois de modificar um fluxo de trabalho, selecione Executar script quando atualizado (F5). Operações de atualização não podem ser canceladas uma vez iniciado.
Funções de leitura e gravação padrão não podem ser usadas quando AlteryxFullUpdate = true. Se funções, como Read. Alteryx ou escreva. Alteryx estão no script quando AlteryxFullUpdate = true, ocorre um erro.
Metainfo passado para saídas quando AlteryxFullUpdate = false pode diferir de metainfo gerada quando o fluxo de trabalho é executado. Isso pode causar erros ocorra.
Configure a ferramenta
A ferramenta R aceita várias entradas e rotula-as em ordem de conexão como #1, #2e assim por diante. A ferramenta produz até 5 fluxos de dados de suas âncoras, rotuladas de 1 a 5. As referências no código devem seguir as mesmas diferenças de formato entre entradas e saídas.
Para as seguintes descrições, #1 refere-se a qualquer rótulo de conexão de entrada e 5 refere-se a qualquer âncora de saída.
As saídas da ferramenta R usando a função Write. Alteryx (dataVariableToWrite, 5).
Inserir código: uma lista de comandos específicos que podem ser injetados no editor de código R. Os comandos são destinados a ser usados com comandos típicos R. Esta lista não é abrangente.Designer
R e ferramentas de interface
Para acessar as ferramentas de interface com a ferramenta R, insira % question. tool_name% onde tool_name é o nome da ferramenta de interface, que pode ser encontrada na guia anotação na janela de configuração
Ler entrada
Leitura de entrada: uma função que lê em uma entrada de dados conectados. Cada entrada conectada cria uma opção separada listada em ordem de conexão. Selecione uma entrada listada para inserir a conexão no editor de código. Essa função pode ser usada independentemente se AlteryxFullUpdate é true ou false.
A leitura. A função Alteryx () transmite dados de entrada para o ambiente R.
Parâmetro opcional
Nomes de linha: um parâmetro opcional para incluir uma nova coluna denominada nomes de linhas, preenchidas com a primeira coluna de dados a serem tratadas como cabeçalhos de linha. Por padrão, esse parâmetro é definido como false.
Escrever. Alteryx (dataVariableToWrite, 5, true)
como quadro de dados: opção usada para ler em uma tabela de dados.
Sem parâmetros adicionais.
Ler. Alteryx ("#1", Mode = "Data. frame")
como quadro de dados: fatiado: opção usada para ler em uma tabela de dados grande. Especifique o número de registros processados por vez.
Ler. Alteryx ("#1", 50000, Mode = "Data. frame")
como lista: opção usada para ler em objetos espaciais.
Ler. Alteryx ("#1", Mode = "lista")
como lista: fatiado: opção usada para ler em um grande número de registros espaciais. Especifique o número de registros processados por vez.
Ler. Alteryx ("#1", 50000, Mode = "lista")
Metainfo de entrada: opção usada para ler a metainfo da entrada em vez dos dados. A função retorna um data. frame que contém o metainfo. As linhas do Data. frame representam cada coluna dos dados de entrada, enquanto a metainfo aplicável é exibida em 6 colunas:
- Nome: String. O nome da coluna.
- Tipo: String. O tipo de dados.
- Tamanho: Integer. O dimensionar do tipo de dados em bytes.
- Escala: inteiro. O número de casas decimais em um FixedDecimal.
- Fonte: String. Os metadados sobre o tipo de coluna, seguido pelo valor inicial.
- Descrição: String. Uma coluna opcional que pode ser preenchida com uma seqüência de caracteres de descrição.
Ler. AlteryxMetaInfo ("#1")
Definir progresso
Definir Progresso: uma função que relata o progresso no ícone da ferramenta em um fluxo de trabalho em execução. Selecione uma das opções de incremento:
AlteryxProgress (0.25)
Mensagem de saída
Mensagem de saída: uma função que exibe uma mensagem na janela de resultados. A prioridade da mensagem determina quando a mensagem é relatada. Veja Configuração de fluxo de trabalho para alterar o comportamento de exibição de mensagem.
- Mensagem de prioridade normal: a mensagem só é exibida quando a ferramenta R é visível na tela do fluxo de trabalho em execução. Se a ferramenta R estiver contida em uma macro, a mensagem não será exibida.
AlteryxMessage ("mensagem", msg. CONSTS $ info, prioridade. CONSTS $ baixo)
Mensagem transitória de prioridade normal: a mensagem é exibida no lugar de uma mensagem existente emitida pela mesma ferramenta.
AlteryxMessage ("mensagem", msg. CONSTS $ info, prioridade. CONSTS $ baixo, 5)
Aviso de prioridade média: a mensagem é exibida quando a ferramenta R é visível na tela do fluxo de trabalho em execução ou está contida em uma macro no fluxo de trabalho em execução.
AlteryxMessage ("mensagem", msg. CONSTS $ aviso, Priority. CONSTS $ médio)
Erro de conversão de campo: a mensagem é exibida quando os dados não podem ser convertidos de um tipo de campo para outro ou quando os dados não puderam caber na especificação de campo.
AlteryxMessage ("mensagem", msg. CONSTS $ FIELD_CONVERSION_ERROR)
Erro de alta prioridade: a mensagem é exibida independentemente da relação da ferramenta R para o fluxo de trabalho em execução. Erros de conversão de campo são tratados como prioridade alta.
AlteryxMessage ("mensagem", msg. CONSTS $ erro, Priority. CONSTS $ alta)
Saída de gravação
Gravação de saída: uma opção para a saída de um fluxo de dados de uma âncora de saída. Todas as âncoras podem produzir dados ou um único gráfico.
Parâmetros opcionais
Fonte: um parâmetro opcional para adicionar uma cadeia de caracteres à coluna de origem na saída de metadados.
Escrever. Alteryx (dataVariableToWrite, 5, Source = "dados do cliente de 2012 repo")
Nomesde linha: um parâmetro opcional para incluir uma nova coluna denominada nomes de linhas, preenchidas com a primeira coluna de dados como cabeçalhos de linha. Por padrão, esse parâmetro é definido como false.
Escrever. Alteryx (dataVariableToWrite, 5, true)
Dependências de embalagem
Arquivos extras que acompanham o código R não serão detectados automaticamente como dependências de fluxo de trabalho. Portanto, se você precisar empacotar seu fluxo de trabalho e seu código R tem suas próprias dependências, certifique-se de incluir quaisquer arquivos adicionais usando Configuração da ferramenta na janela de configuração.
Criar gráfico
Criar gráfico: uma opção para a saída de um gráfico da análise. A saída é tratada como um trecho de relatórios que pode ser lido por ferramentas de relatório. Selecione uma das opções de tamanho do gráfico:
- 6x6 polegadas - 96 dpi
- 8x10 polegadas - 300 dpi
AlteryxGraph (5, Width = 576, altura = 576)xPoints </->Plot (xPoints, yPoints)<x 4="">invisível (dev. off ())</x> </x>
Atualizar/Metainformações
If (AlteryxFullUpdate)... : Uma função que funciona com a variável global [AlteryxFullUpdate].
Escrever. AlteryxAddFieldMetaInfo: uma função que adiciona o metainfo de uma única coluna para a saída nomeada. Esta função não pode ser usada quando AlteryxFullUpdate = false.
Parâmetros opcionais
Pode ser utilizada qualquer combinação dos seguintes parâmetros.
nOutput: a saída à qual os metadados da coluna são adicionados.
nome: o nome da coluna cuja metainfo é saída. Esta opção verifica se o nome fornecido é válido ou ocorre um erro.
FieldType: uma cadeia de caracteres que representa o DataType da coluna. Esta opção verifica se o FieldType fornecido é válido ou ocorre um erro. Tamanho e escala pode precisar ser atualizado manualmente, dependendo do FieldType. Vários FieldTypes são aceitos entradas que são convertidas em tipos de campo válidos.
tamanho: o tamanho da coluna.
Muitos FieldTypes são atribuídos um valor automaticamente.
escala: o número de casas decimais para valores de coluna.
Esta opção é necessária para FixedDecimal FieldTypes, mas é ignorado por todos os outros FieldTypes.
fonte: uma coluna opcional que pode ser preenchida com uma seqüência de caracteres que descreve as origens da coluna.
Descrição: uma coluna opcional que pode ser preenchida com uma seqüência de caracteres de descrição.
Escrever. AlteryxGraphMetaInfo: uma função que define a metainfo da saída nomeada para um gráfico de script R, chamando a função AlteryxGraph (). Esta função não pode ser usada quando AlteryxFullUpdate = false.