Skip to main content

Python tool Herramienta Python

Herramienta Python actualizada

A partir del lanzamiento de la versión 2026.1 de Designer, el modo interactivo ya no está disponible en la herramienta Python.

Ahora se admite el desarrollo de Python mediante un modelo de ejecución que prioriza la producción. Esto significa que puedes editar tus scripts de Python directamente en la herramienta o en tu entorno de desarrollo integrado (IDE) externo preferido antes de ejecutar tus flujos de trabajo.

Requisitos del rol de usuario

Rol de usuario*

Acceso a herramientas/características

Usuario completo

✓

Usuario básico

X

* Se aplica a los clientes de las ediciones profesional y empresarial de Alteryx One en las versiones 2025.1 o posteriores de Designer.

La herramienta Python es un editor de código para usuarios de Python. Usted debe ser competente en Python antes de utilizar esta herramienta. Después de importar el paquete de Python de Alteryx a través de from ayx import Alteryx, consulta las Funciones de Python de Alteryx para obtener información sobre las funciones que puedes utilizar a través de la herramienta Python en Designer.

Importante

Aunque Designer acepta código Python de cliente, Alteryx no proporciona soporte para el código Python de cliente.

Ejemplo de uso de herramienta

Esta herramienta tiene un ejemplo de uso. Ve a Flujos de trabajo de muestra para aprender cómo acceder a este y muchos otros ejemplos directamente en Designer.

Introducción

Utiliza la ventana Configuración de la herramienta Python para ingresar o importar el script de Python. Para obtener ayuda con el código, consulta las referencias adicionales en Funciones de Python de Alteryx.

Instalar los paquetes de ciencia de datos que necesitas

La herramienta Python incluye estos paquetes de ciencia de datos:

  • ayx: API de Python de Alteryx que interactúa con flujos de trabajo y el tiempo de ejecución de Alteryx Designer.

  • ayx_python_sdk: kit de desarrollo de software (SDK) para crear y ampliar herramientas de Alteryx en Python.

  • numpy: paquete principal para informática numérica y procesamiento de conjuntos en Python.

  • pandas: estructuras de datos para análisis de datos, series de tiempo y procesamiento tabular.

  • scipy: biblioteca de informática científica para optimización, estadísticas, procesamiento de señales y matemáticas avanzadas.

  • scikit-learn: biblioteca de aprendizaje automático para clasificación, regresión, agrupamiento de clústeres y evaluación de modelos.

  • statsmodels: biblioteca de modelado estadístico y econometría para regresión y evaluación de hipótesis.

  • pyarrow: biblioteca de alto rendimiento para el procesamiento de datos columnares y la interoperabilidad de Apache Arrow (por ejemplo, Parquet e IPC).

  • SQLAlchemy: conjunto de herramientas de abstracción de bases de datos y mapeo objeto-relacional (ORM) para bases de datos relacionales en Python.

  • pyodbc: conector ODBC para bases de datos empresariales.

  • requests: biblioteca HTTP para llamar a las API y servicios web.

  • matplotlib: biblioteca de trazado para gráficos estáticos y visualizaciones.

  • plotly: biblioteca de visualización para gráficos y paneles de control interactivos.

  • plotly: biblioteca de visualización para gráficos y paneles de control interactivos.

  • dash: marco para crear aplicaciones web analíticas en Python.

Instalación de paquete adicional

Dependiendo de la versión de Designer que utilices, puedes instalar paquetes adicionales con la función Alteryx.installPackages. Por ejemplo, para instalar keras, ejecuta este comando:

from ayx import Package

Package.installPackages("keras")

Puedes instalar paquetes de Python adicionales solo cuando ejecutas Designer como administrador. Los usuarios que no son administradores no pueden instalar paquetes de Python adicionales.

Configurar la herramienta

Puedes utilizar la ventana Configuración de la herramienta Python para seleccionar tu entorno base e ingresar tu script de Python.

Entorno

Utiliza el menú desplegable Entorno para seleccionar tu entorno base. El entorno predeterminado es DesignerBaseTools_vEnv.

Crea un entorno sin fisuras

También puedes crear un entorno personalizado para utilizar en tu herramienta Python. Puedes especificar tus dependencias en tu entorno personalizado y configurar la herramienta Python para que utilice el entorno. Esto te permite importar paquetes rápidamente y proporciona un enfoque más eficiente y fácil de administrar a la hora de utilizar la herramienta Python en Designer.

Si deseas utilizar un entorno personalizado, sigue estas instrucciones:

  1. Ve a esta carpeta (versión de administrador de Designer):

    C:\Program Files\Alteryx\bin\Python\envs\DesignerBaseTools_vEnv\share\jupyter\kernels

  2. Copia la carpeta designerbasetools_venv.

  3. Cambia el nombre de la carpeta copiada al nombre que deseas para el nuevo kernel.

  4. En la carpeta renombrada, abre kernel.json.

  5. Actualiza el valor display_name.

    • Cámbialo al nombre de kernel que deseas mostrar en el menú Entorno en la configuración de la herramienta Python.

    • Este valor generalmente coincide con el nombre de la carpeta, pero no es necesario que así sea.

  6. Deja estos valores sin cambios:

    • argv: Jupyter lo utiliza para ejecutar Python para el entorno. Para las pruebas, no lo cambies.

    • language: déjalo establecido como python.

    Archivo kernel.json de ejemplo:

    {
  "argv": [
    "C:\\Program Files\\Alteryx\\bin\\Python\\envs\\DesignerBaseTools_vEnv\\Scripts\\python.exe",
    "-m",
    "ipykernel_launcher",
    "-f",
    "{connection_file}"
  ],
  "display_name": "MyCustomEnv",
  "language": "python"
}

  7. Guarda kernel.json y vuelve a Designer.

  8. Actualiza la lista de kernel:

    • Cierra la herramienta Python y, luego, vuelve a seleccionar la herramienta.

    • Si no ves el nuevo kernel, cierra Designer y vuelve a abrirlo.

Utiliza un intérprete de Python diferente (opcional)

Importante

Recomendamos uv para administrar tu entorno personalizado de Python.

Puedes configurar tu entorno personalizado para utilizar un intérprete de Python diferente. Hacer esto te permite utilizar un entorno de Python completamente separado con tus propios paquetes instalados. Para utilizar un intérprete de Python diferente en tu entorno personalizado, sigue estos pasos:

  1. Abre kernel.json en tu carpeta personalizada del kernel.

  2. Actualiza la primera entrada de la lista argv para apuntar a la ruta del archivo del ejecutable de Python de tu entorno personalizado.

    Ejemplo de kenrel.json con entrada argv actualizada:

    {
  "argv": [
    "C:\\Users\\<username>\\alteryx_envs\\myenv\\Scripts\\python.exe",
    "-m",
    "ipykernel_launcher",
    "-f",
    "{connection_file}"
  ],
  "display_name": "MyCustomEnv",
  "language": "python"
}

  3. Guarda el archivo kernel.json y actualiza la lista del kernel en Designer.

    • Cierra la herramienta Python y, luego, vuelve a seleccionar la herramienta.

    • Si no ves el nuevo kernel, cierra Designer y vuelve a abrirlo.

Agrega el paquete AYX al entorno personalizado

Importante

Si utilizas un entorno de Python personalizado, debes asegurarte de que el paquete ayx esté disponible. El paquete ayx es necesario para que la herramienta Python interactúe con el flujo de trabajo de Designer (por ejemplo, leer y escribir datos).

Para agregar el paquete ayx a tu entorno personalizado, sigue estos pasos:

  1. Localiza el paquete ayx en el entorno predeterminado:

    C:\Program Files\Alteryx\bin\Python\envs\DesignerBaseTools_vEnv\Lib\site-packages\ayx

  2. Copia toda la carpeta ayx.

  3. Pega la carpeta en el directorio site-packages de tu entorno personalizado:

    <your-env>\Lib\site-packages\

El paquete ayx depende de bibliotecas adicionales que podrían no estar instaladas en tu entorno personalizado (por ejemplo, pandas). Copiar el paquete en tu entorno personalizado no instala las dependencias automáticamente.

Instala cualquier dependencia ausente en tu entorno personalizado. Por ejemplo:

pip install pandas

Por último, para verificar que instalaste correctamente el paquete ayx, activa tu entorno y ejecuta este comando:

python -c "import ayx; print('ayx installed successfully')"

Script de Python

Utiliza el campo Script de Python de la ventana Configuración para ingresar o pegar tu script de Python. También tienes la opción de importar un script. Para ello, selecciona Sobrescribir script/Notebook y examina tu archivo de script o notebook. El archivo debe ser una extensión .py (script de Python) o .ipynb (notebook de Python).

Funciones de Python de Alteryx

Hay varias funciones disponibles como parte del paquete Alteryx cuando se ejecuta from ayx import Alteryx. Las funciones te permiten transferir datos entre Alteryx y Jupyter.

Para obtener funciones, descripciones y ejemplos disponibles, ve a Funciones de Python de Alteryx.

Importante

La herramienta Python trata los datos como un DataFrame de Pandas. Para obtener más información, consulta pandas.pydata.org.

Conectarse a datos del flujo de trabajo

La herramienta Python acepta múltiples entradas. Después de conectar las entradas, puedes utilizar la función Alteryx.read para ingresar los datos de tu flujo de trabajo en la herramienta como un DataFrame de pandas. Luego, puedes utilizar Python para transformar los datos y, finalmente, utilizar Alteryx.write para generar datos desde la herramienta Python.

Consulta las Funciones de Python de Alteryx para obtener una lista completa de funciones disponibles a través de la biblioteca de Alteryx.

Notas y limitaciones

Dtype string pandas

La herramienta Python de Alteryx Designer no admite el dtype “string” pandas. En su lugar, te recomendamos el dtype “object” estándar, que permite que el DataFrame se escriba correctamente.

IPython

Con las actualizaciones de la herramienta Python en la versión 2026.1, ya no es posible recurrir a las características interactivas de IPython con la funcionalidad prevista de la herramienta Python en Designer.

La funcionalidad de IPython admite principalmente la exploración interactiva, que es menos relevante en flujos de trabajo de producción ejecutados dentro de Designer.

Por lo tanto:

  • Alteryx no mantendrá la compatibilidad con las características específicas de IPython.

  • Es posible que los flujos de trabajo que dependen de la funcionalidad de IPython ya no se comporten de la misma manera que antes de la versión 2026.1.

  • Si necesitas estas capacidades, debes ejecutar el código fuera de Designer en un entorno de IPython.

La herramienta Python no carga el script con Deshabilitar configuración automática

Si activas Deshabilitar la configuración automática en Configuración de usuario, las herramientas Python creadas antes de la versión 26.1 no cargarán el contenido de sus script cuando abras un flujo de trabajo anterior a 26.1 en la versión 2026.1 de Designer.

Para solucionar este problema, desactiva Deshabilitar la configuración automática en Configuración del usuario y vuelve a abrir el flujo de trabajo. Esto permite a la herramienta convertir y cargar el contenido del script.

  • Este problema afecta solo a las herramientas Python creadas antes de la versión 2026.1 de Designer.

  • El problema no se produce cuando la opción Deshabilitar configuración automática está desactivada (configuración predeterminada).

En esta sección: