Python incrustado en Alteryx
Descripción general
La plataforma Alteryx incluye una versión integrada de Python que admite diversas funciones en todos sus productos. La versión en Alteryx no afecta a otras versiones que puedas haber instalado en el equipo. De vez en cuando, Alteryx necesita actualizar esa versión de Python. Puedes ver que la actualización de la versión se refleja en la herramienta Python (Jupyter Notebook) y otras herramientas que utilicen el SDK de Python de Alteryx. Los conectores de datos basados en Python incluyen Salesforce, Google BigQuery, Microsoft Azure Data Lake, Microsoft Power BI, Microsoft OneDrive y Microsoft Dynamics CRM.
Compatibilidad de Python de Alteryx
Versión de Alteryx | Versión incrustada de Python | Entorno virtual |
|---|---|---|
2026.1 | 3.13.11 | La herramienta Python en Designer ahora utiliza un entorno virtual integrado en lugar de la configuración anterior basada en Miniconda. Esta actualización simplifica la administración de dependencias y reduce el tamaño de los archivos relacionados con Python durante la instalación. En la versión 2025.2, el directorio |
2025.1 (actualización estable)–2025.2 | 3.10.18 | La herramienta Python en Designer ahora utiliza un entorno virtual integrado en lugar de la configuración anterior basada en Miniconda. Esta actualización simplifica la administración de dependencias y reduce el tamaño de los archivos relacionados con Python durante la instalación. En la versión 2025.2, se eliminará el directorio |
2025.1 | 3.10.15 | Estándar (Conda para SDK v1) Si tu flujo de trabajo incluye referencias al directorio |
2024.1–2024.2 | 3.10.13 | Conda |
2023.2 | 3.8.16 | Conda |
2020.4–2023.1 | 3.8.5 | Conda |
2019.3–2020.3 | 3.6.8 | Conda |
Antes de 2019.3 | 3.6.0 | Estándar |
Preguntas frecuentes sobre la actualización de Python 3.13 (lanzamiento 2026.1 de Alteryx Designer y Server)
Para obtener más información sobre la actualización de Python 3.13, ve a Preguntas frecuentes sobre la actualización de Python 3.13 y consulta la información relacionada con la actualización a Python 3.13.11 (asociada al lanzamiento 2026.1 de Alteryx Designer y Server).
Es una iniciativa de producto que actualiza Alteryx Designer y Server de Python v3.8.16 a Python v3.10.13. Esto se debe a que Python ya no ofrece soporte para v3.8. Alteryx debe cumplir con las medidas de seguridad. La seguridad es primordial en Alteryx, y debemos actualizar Designer a Python 3.10 para el lanzamiento 2024.1 (principios de mayo de 2024).
Todos los clientes que usen herramientas de Designer que dependan de Python. Esto incluye conectores de datos, herramientas SDK creadas por socios, herramientas SDK personalizadas, la herramienta Python y las herramientas de Intelligence Suite.
Las herramientas de Designer que usan Python deben actualizarse para funcionar con Python 3.10.13; de lo contrario, no funcionarán en Designer y Server 24.1.
Si tienes una herramienta SDK de Python en tu flujo de trabajo en una versión anterior al lanzamiento de Alteryx 24.1, esa versión de la herramienta SDK no funcionará con la 24.1. Para seguir adelante, debes…
Instalar una nueva versión de la herramienta SDK que sea compatible con la 24.1.
Actualizar tu flujo de trabajo para usar la nueva versión de la herramienta.
Volver a publicar el flujo de trabajo en Alteryx Server.
Dado que es posible que los usuarios deseen probar los flujos de trabajo con las herramientas actualizadas, se recomienda que los clientes de Server que prefieran probar los nuevos flujos de trabajo en un único entorno creen un entorno de prueba independiente para probar la versión 24.1. Con un entorno independiente, puedes continuar probando los flujos de trabajo actuales con herramientas existentes (antes de migrar a Producción) y usar el nuevo entorno para probar nuevas herramientas con 24.1. Esta configuración es necesaria porque los conectores de la versión 24.1 basados en Python no funcionan con versiones anteriores de Alteryx y viceversa.
Sí, los usuarios de tu herramienta personalizada deberán descargar e instalar la versión más reciente después de que completes la actualización de Python. Puedes publicar la versión más reciente de tu herramienta en la Galería de la Comunidad o enviar una actualización a Alteryx Marketplace, si corresponde.
Actualizaremos la versión de Python de Designer de la 3.8.16 a la 3.10.13 para la versión 2024.1, cuyo lanzamiento está previsto para mayo de 2024. Por este motivo, solicitamos a los socios y clientes que actualicen sus herramientas SDK a la versión 3.10.13 de Python antes de instalar la versión 2024.1 de Alteryx Designer.
Se encuentran disponibles instrucciones de actualización paso a paso para actualizar tus herramientas a la versión 3.10.13 de Python. Ve a Instrucciones para actualizar herramientas personalizadas a Python 3.10.
Si tienes más preguntas, ve al foro de desarrolladores de Alteryx IO y publícalas allí. También actualizaremos este documento periódicamente a medida que haya más material disponible.
Las siguientes preguntas frecuentes hacen referencia a la actualización de Python 3.8.5 incluida en el lanzamiento 2020.4 de Alteryx Designer y Server.
Si instalaste herramientas personalizadas YXI en una versión anterior de Alteryx Designer, esas herramientas ya no funcionarán correctamente debido a referencias a la versión de Python incompatible dentro de las dependencias del módulo de las herramientas.
También es posible que una herramienta tenga dependencias del módulo de Python que ya no son compatibles, o que usen aspectos del lenguaje Python que ya no son compatibles, con la nueva versión de Python.
Script de actualización:
Hemos proporcionado un script de actualización de Python incrustado para que puedas ver una lista de herramientas que podrían verse afectadas en tu máquina o servidor. Los usuarios de Alteryx y los administradores de Alteryx Server pueden utilizar este script si están considerando actualizar a la versión 2020.4 (y versiones posteriores) o si ya han actualizado y necesitan ayuda para solucionar problemas con los flujos de trabajo que contienen herramientas basadas en el SDK de Python.
Si instalaste anteriormente herramientas personalizadas YXI y actualizaste a Alteryx Designer 20.4, un mensaje de error te avisará del problema y no podrás ejecutar un flujo de trabajo que contenga esa herramienta.
Esto afecta a los flujos de trabajo de todos los productos Alteryx.
Haz un inventario de todas las herramientas y versiones que tengas. Según la instalación, hay dos rutas de archivo para encontrar esta información.
En el caso de instalaciones elevadas (que se ejecutan como administrador), dirígete a Program Data (ocultado) > Alteryx > Tools.
En el caso de instalaciones no elevadas, dirígete a Usuarios > [Usuario] > App Data (ocultado) > Roaming > Alteryx > Tools.
Existen seis conectores de datos basados en Python: Salesforce, Google BigQuery, Microsoft Azure Data Lake Store, Microsoft Power BI, Microsoft OneDrive y Microsoft Dynamics CRM. Esto garantiza que realices un seguimiento de la versión que tendrás que volver a instalar. Si bien es posible que todos los conectores de datos no fallen, te recomendamos que vuelvas a instalar todas las versiones de cada conector que tenga flujos de trabajo activos.
Si una herramienta no requiere ninguna actualización para ser compatible con Python 3.8, toma nota de la versión y ubicación de la herramienta específica. Asegúrate de que puedas localizar el paquete YXI de la herramienta antes de eliminarla, ya que este proceso requiere volver a instalar el paquete de la herramienta. Además, recomendamos que elimines el directorio de la herramienta y sus archivos y, luego, vuelvas a instalar el paquete YXI de la herramienta. Antes de volver a instalar el paquete YXI, no abras ningún flujo de trabajo que utilice la herramienta porque podría provocar un comportamiento desconocido en el flujo de trabajo.
Es posible que algunas herramientas sigan funcionando sin completar este paso, pero recomendamos que sigas las instrucciones que proporcionamos aquí.
Debes seguir las instrucciones para cada herramienta en cada equipo para cada directorio de instalación. Si utilizas instalaciones de administrador y no administrador, asegúrate de haber actualizado todas las ubicaciones posibles en las que se encuentre la herramienta.
Si una herramienta requiere actualizaciones para resolver diferencias de uso, problemas de dependencia o paquetes con nuevos archivos WHL, debes recibir una nueva herramienta del desarrollador de herramientas. En la mayoría de los casos, es una herramienta creada por un socio, pero también podría ser una herramienta anterior desarrollada por Alteryx o incluso una herramienta encontrada en la Comunidad o la Galería.
No. Actualizamos estas herramientas como parte de la iniciativa de actualización de Python. Deberían funcionar automáticamente.
No deberías notar ningún cambio en la herramienta Python ni en la herramienta Insights, las cuales usan Python, pero no el SDK de Python. Sin embargo, debido a que los paquetes subyacentes se están actualizando, como pandas, puede haber algunos casos en los que el código ya no es compatible con la versión de Python.
Es posible que veas un problema con el código de Python en la herramienta Python si utiliza una funcionalidad que ya no es compatible. Si ese es el caso, debes actualizar el código para que sea compatible con Python 3.8. Es posible que haya cambios entre las versiones 3.7 y 3.8. Aquí se encuentran ambos vínculos:
No deberías encontrar un error si (1) cargaste un flujo de trabajo con una herramienta basada en el SDK de Python de versión 20.3 a Alteryx Server que se actualizó a 20.4, (2) el código subyacente es el mismo y (3) corregiste el flujo de trabajo de la herramienta basada en Python volviendo a instalar el mismo archivo YXI en Alteryx Server. Todas las herramientas basadas en Python que tienen flujos de trabajo activos deben volver a instalarse en Alteryx Server.
El flujo de trabajo hace referencia al nombre y la versión de una herramienta, no a la versión de Python.
Si la herramienta se volvió a empaquetar y se creó una nueva versión para admitir 20.4, habrá incompatibilidades de versión entre las herramientas, y la herramienta tendrá que actualizarse en Alteryx Designer o Alteryx Server.
También actualizamos la versión incrustada de Python en Alteryx Analytics Hub a la 3.8.5. Al igual que con Alteryx Server, la versión puede ser diferente entre Alteryx Designer y Alteryx Analytics Hub. Debes volver a instalar el YXI si estabas utilizando uno con versiones de dependencia incompatibles.
Si un usuario tiene licencia tanto para Alteryx Analytics Hub como para Alteryx Intelligence Suite, debe instalar Alteryx Analytics Hub para actualizar desde la versión estable 20.2 y, luego, instalar Alteryx Intelligence Suite usando la descarga 20.4, que está disponible junto a AAH en downloads.alteryx.com. Después de eso, reinstala las YXI.
Sí. La versión de Python será incompatible con las versiones 20.3 y anteriores, y 20.4 y posteriores. Independientemente de cuándo realices la actualización, debes actualizar las herramientas YXI para que sean compatibles.
Sí. Si no reinstalas ninguna herramienta de Python, deberías poder volver a un estado anterior sin problemas. Después de actualizar las herramientas de Python, debes continuar ese proceso para cambiar de versión. Por ejemplo, si actualizas de la versión 20.3 a la 20.4 y reinstalas Salesforce, pero luego regresas a la versión 20.3, tendrías que volver a instalar Salesforce.
No, no si utilizas herramientas basadas en el SDK de Python. Si no lo haces, lo más probable es que no tengas ningún problema al tener varias versiones instaladas.
Puedes seguir usando instalaciones de administrador y de no administrador de la misma versión de Alteryx.
La instalación se realizará correctamente. El problema es que las herramientas basadas en Python no instaladas no funcionarán en la versión 20.4 hasta que se actualicen. Una vez actualizadas las herramientas, ya no funcionarán en la instalación que no esté basada en Python 3.8 (versiones de Alteryx anteriores a la 20.4).
Para obtener más información sobre cómo instalar varias versiones en una máquina, visita https://community.alteryx.com/t5/Alteryx-Designer-Knowledge-Base/How-to-install-two-versions-of-Designer-on-the-same-machine/ta-p/454948.
Crea un ticket de servicio de asistencia al cliente en la siguiente URL si necesitas ayuda adicional: https://community.alteryx.com/t5/Soporte-Espanol/bd-p/SupportPage-es.
Preguntas frecuentes sobre el desarrollador de Python
Recomendamos que los socios y los creadores de herramientas actualicen sus instalaciones locales y prueben todas las herramientas que hayan creado. Pueden usar módulos con versiones que ya no son compatibles con Python 3.8 o la sintaxis que ya no es compatible.
Si la herramienta usa archivos WHL, debes volver a empaquetar la herramienta con sus archivos WHL en un entorno Python 3.8 y volver a publicar la herramienta para que los usuarios puedan acceder a ella.
Si un creador de herramientas usa el lanzamiento Beta de ayx-plugin-sdk, que se actualizó para la versión 20.4, deberá actualizar este paquete a la versión más reciente para que siga funcionando.
Se actualizaron varios módulos en Snakeplane para admitir Python 3.8.5, como numpy y pandas. En algunos casos, es posible que se deba actualizar Snakeplane para que las herramientas funcionen.