Herramienta R

La herramienta r es un editor de código para los usuarios de r, una base de código abierto utilizada para el análisis estadístico y predictivo. Se recomienda el dominio del scripting R antes de utilizar esta herramienta.

Alteryx compatibilidad con galerías públicas

¿Planea publicar su flujo de trabajo en Gallery.alteryx.com? Primero debe solicitar una exención. Esta restricción no se aplica a las instancias privadas de Alteryx Server y Alteryx Gallery.

R en Designer

El diseñador lee en el script R válido y pasa el script a través de la herramienta. La salida de la herramienta r coincide con las salidas r.

Soporte de R

Mientras el diseñador acepta el código R personalizado, Alteryx no proporciona soporte para él.

Alteryx utiliza [AlteryxFullUpdate], una variable global para el script R, para las actualizaciones de metainfo. Las actualizaciones de metainformación completas se producen cuando AlteryxFullUpdate = true. Esto sucede cuando el flujo de trabajo se abre por primera vez y cuando el flujo de trabajo se actualiza mediante F5.

AlteryxFullUpdate = false durante todas las demás actualizaciones, como un flujo de trabajo que se está ejecutando o la reconfiguración de la herramienta. Para forzar las actualizaciones completas después de modificar un flujo de trabajo, seleccione Ejecutar secuencia de comandos cuando se actualice (F5). Las operaciones de actualización no se pueden cancelar una vez iniciado.

Las funciones de lectura y escritura estándar no se pueden utilizar cuando AlteryxFullUpdate = true. Si funciona como Read. Alteryx o Escriba. Alteryx se encuentran en el script cuando AlteryxFullUpdate = true, se produce un error.

Metainfo se pasa a las salidas cuando AlteryxFullUpdate = false puede diferir de la metainformación generada cuando se ejecuta el flujo de trabajo. Esto puede producir errores.

Configurar la herramienta

La herramienta R acepta varias entradas y las etiqueta en orden de conexión como #1, #2, etc. La herramienta emite hasta 5 flujos de datos desde sus anclajes, rotulados del 1 al 5. Las referencias en el código deben seguir las mismas diferencias de formato entre las entradas y las salidas.

Para las siguientes descripciones, #1 se refiere a cualquier etiqueta de conexión de entrada y 5 se refiere a cualquier ancla de salida.

Las salidas de la herramienta R usando la función Write. Alteryx (dataVariableToWrite, 5).

Insertar código: una lista de comandos específicos que se pueden inyectar en el editor de código R. Los comandos están diseñados para ser utilizados con los comandos R típicos. Esta lista no es exhaustiva.Designer

R y herramientas de interfaz

Para acceder a las herramientas de interfaz con la herramienta R, escriba % Question. tool_name% donde tool_name es el nombre de la herramienta de interfaz, que se puede encontrar en la ficha anotación de la ventana de configuración

Leer entrada

Entrada de lectura: función que lee en una entrada de datos conectada. Cada entrada conectada crea una opción separada listada en orden de conexión. Seleccione una entrada lista para insertar la conexión en el editor de código. Esta función se puede utilizar independientemente de si AlteryxFullUpdate es true o false.

La lectura. La función Alteryx () transmite los datos de entrada al entorno R.

Parámetro opcional

Nombres de fila: un parámetro opcional para incluir una nueva columna titulada RowNames, rellenada con la primera columna de datos que se tratará como cabeceras de fila. De forma predeterminada, este parámetro se establece en false.

Escribir. Alteryx (dataVariableToWrite, 5, true)

como Frame de datos: opción utilizada para leer en una tabla de datos. No hay parámetros adicionales.

Leer. Alteryx ("#1", Mode = "datos. Frame")

como marco de datos: fragmentado: opción utilizada para leer en una tabla de datos grande. Especifique el número de registros procesados a la vez.

Leer. Alteryx ("#1", 50000, modo = "Data. Frame")

como lista: opción utilizada para leer en objetos espaciales.

Leer. Alteryx ("#1", modo = "lista")

como lista: fragmentado: opción utilizada para leer en un gran número de registros espaciales. Especifique el número de registros procesados a la vez.

Leer. Alteryx ("#1", 50000, modo = "lista")

Metainfode entrada: opción utilizada para leer en la metainformación de la entrada en lugar de los datos. La función devuelve un dato. Frame que contiene el metainfo. Las filas de los datos. Frame representan cada columna de los datos de entrada, mientras que la metainformación aplicable se muestra en 6 columnas:

Nombre: String. El nombre de la columna.
Tipo: String. El tipo de datos.
Tamaño: Integer. Tamaño del tipo de datos en bytes.
Escala: Integer. El número de posiciones decimales en un FixedDecimal.
Fuente: String. Los metadatos sobre el tipo de columna, seguido del valor inicial.
Descripción: String. Una columna opcional que se puede rellenar con una cadena de descripción.

Leer. AlteryxMetaInfo ("#1")

Definir el progreso

Configurado Progreso: función que reporta el progreso en el icono de la herramienta en un flujo de trabajo en ejecución. Seleccione una de las opciones de incremento:

25 %
50 %
75 %
100 %

AlteryxProgress (0.25)

Mensaje de salida

Mensajede salida: función que muestra un mensaje en la ventana resultados. La prioridad del mensaje determina cuándo se informa el mensaje. Consulta Configuración de flujo de trabajo para cambiar el comportamiento de la visualización de mensajes.

Mensaje de prioridad normal: el mensaje sólo se muestra cuando la herramienta R está visible en el lienzo del flujo de trabajo en ejecución. Si la herramienta R está contenida dentro de una macro, el mensaje no aparece.

AlteryxMessage ("message", MSG. conss $ info, Priority. conss $ Low)

Mensaje transitorio de prioridad normal: el mensaje se muestra en lugar de un mensaje existente emitido por la misma herramienta.

AlteryxMessage ("message", MSG. conss $ info, Priority. conses $ Low, 5)

Prioridad media ADVERTENCIA: el mensaje se muestra cuando la herramienta R está visible en el lienzo del flujo de trabajo en ejecución o está contenida dentro de una macro en el flujo de trabajo en ejecución.

AlteryxMessage ("message", MSG. conses $ ADVERTENCIA, Priority. conss $ Medium)

Error de conversiónde campo: el mensaje se muestra cuando los datos no se pueden convertir de un tipo de campo a otro o cuando los datos no pueden encajar en la especificación de campo.

AlteryxMessage ("message", MSG. conses $ FIELD_CONVERSION_ERROR)

Error de alta prioridad: el mensaje se muestra independientemente de la relación de la herramienta R con el flujo de trabajo en ejecución. Los errores de conversión de campo se tratan como alta prioridad.

AlteryxMessage ("message", MSG. conss $ error, Priority. conss $ High)

Escribir salida

Salida de escritura: opción para emitir una secuencia de datos desde un anclaje de salida. Todos los anclajes pueden producir datos o una sola gráfica.

Parámetros opcionales

Fuente: parámetro opcional para agregar una cadena a la columna de origen en la salida de metadatos.

Escribir. Alteryx (dataVariableToWrite, 5, source = "datos del cliente desde el repo 2012")

Nombresde fila: un parámetro opcional para incluir una nueva columna titulada RowNames, rellenada con la primera columna de datos como cabeceras de fila. De forma predeterminada, este parámetro se establece en false.

Escribir. Alteryx (dataVariableToWrite, 5, true)

Crear gráfico

Crear gráfico: una opción para emitir un gráfico del análisis. La salida se trata como un fragmento de informe que puede ser leído por las herramientas de reporting. Seleccione una de las opciones de tamaño del gráfico:

6 x 6 pulgadas - 96 dpi
8 x 10 pulgadas - 300 dpi

AlteryxGraph (5, width = 576, height = 576)xPoints   </->parcela (xPoints, yPoints)<x 4="">invisible (dev. OFF ())</x> </x>

Actualizar/Metainformación

if (AlteryxFullUpdate)... : Función que funciona con la variable global [AlteryxFullUpdate].

Escribir. AlteryxAddFieldMetaInfo: función que agrega la metainformación de una sola columna a la salida denominada. Esta función no se puede utilizar cuando AlteryxFullUpdate = false.

Parámetros opcionales

Se puede utilizar cualquier combinación de los siguientes parámetros.

nOutput: la salida a la que se agregan los metadatos de la columna.

nombre: nombre de columna cuyo metainfo es output. Esta opción comprueba que el nombre proporcionado es válido o que se produce un error.

fieldType: cadena que representa el tipo de la columna. Esta opción comprueba que el fieldType proporcionado es válido o que se produce un error. El tamaño y la escala pueden necesitar ser actualizados manualmente dependiendo del fieldType. Varios fieldTypes son entradas aceptadas que se convierten en tipos de campos válidos.

tamaño: el tamaño de la columna.

Muchos fieldTypes se asignan un valor automáticamente.

escala: número de posiciones decimales para los valores de columna.

Esta opción es necesaria para FixedDecimal fieldTypes, pero es ignorada por el resto de fieldTypes.

Cadenas de FieldType válidas	Tamaño anulado	Escala anulada	Convierte a FieldType válido
Booleano	automático		Lógica
Byte	automático
Int16	automático
Int32	automático		Entero
Int 64	automático
FixedDecimal	Manual	Manual
Flotante	automático
Doble	automático		numérico
Cadena	Manual
WString	Manual
V_String
V_WString			factor Carácter
Fecha	automático
Tiempo	automático
Fecha y hora	automático
Blob
Objeto espacial

fuente: columna opcional que se puede rellenar con una cadena que describe los orígenes de la columna.

Descripción: columna opcional que se puede rellenar con una cadena de descripción.

Escribir. AlteryxGraphMetaInfo: función que establece la metainformación de la salida denominada en un gráfico de secuencias de comandos R llamando a la función AlteryxGraph (). Esta función no se puede utilizar cuando AlteryxFullUpdate = false.