Python intégré dans Alteryx
Vue d'ensemble
La plateforme Alteryx est dotée d'une version intégrée de Python pour prendre en charge plusieurs fonctions dans les produits. La version présente dans Alteryx n'affecte pas les autres versions qui peuvent déjà être installées sur votre ordinateur. De temps à autre, Alteryx doit mettre à niveau cette version de Python. Cette mise à jour de version peut se refléter dans l'outil Jupyter Python et d'autres outils qui utilisent le SDK Python pour Alteryx. Les connecteurs de données basés sur Python incluent Salesforce, Google BigQuery, Microsoft Azure Data Lake Store, Microsoft Power BI, Microsoft OneDrive et Microsoft Dynamics CRM.
Compatibilité de Python et Alteryx
Version d'Alteryx | Version de Python intégré | Environnement virtuel |
|---|---|---|
2026.1 | 3.13.11 | L'outil Python dans Designer utilise désormais un environnement virtuel intégré au lieu de la précédente configuration basée sur Miniconda. Cette mise à jour simplifie la gestion des dépendances et réduit la taille des fichiers liés à Python pendant l'installation. Dans la version 2025.2, le répertoire hérité |
2025.1 (Mise à jour stable)–2025.2 | 3.10.18 | L'outil Python dans Designer utilise désormais un environnement virtuel intégré au lieu de la précédente configuration basée sur Miniconda. Cette mise à jour simplifie la gestion des dépendances et réduit la taille des fichiers liés à Python pendant l'installation. Dans la version 2025.2, l'ancien répertoire |
2025.1 | 3.10.15 | Standard (Conda pour SDK v1) Si votre workflow inclut des références au répertoire |
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 |
Avant 2019.3 | 3.6.0 | Standard |
FAQ sur la mise à niveau de Python 3.13 (version 2026.1 d'Alteryx Designer et Server)
Pour plus de détails sur la mise à niveau de Python 3.13, consultez la FAQ sur la mise à niveau de Python 3.13 pour obtenir des informations sur la mise à niveau vers Python 3.13.11 (associée à la version 2026.1 d'Alteryx Designer et Server).
Il s'agit d'une initiative produit qui met à niveau Alteryx Designer et Server de Python 3.8.16 vers Python 3.10.13. Cela est dû au fait que Python ne prend plus en charge la version 3.8. Alteryx doit suivre pour rester en conformité avec les mesures de sécurité. La sécurité est primordiale chez Alteryx, et nous devons mettre à jour Designer vers Python 3.10 d'ici la version 2024.1 (début mai 2024).
Tous les clients qui utilisent des outils de Designer qui sont basés sur Python. Cela inclut les connecteurs de données, les outils SDK conçus par des partenaires, les outils SDK personnalisés, l'outil Python et les outils Intelligence Suite.
Les outils de Designer qui sont basés sur Python doivent être mis à niveau pour fonctionner avec Python 3.10.13. Sinon, ils ne fonctionneront pas dans Designer et Server 24.1.
Si vous disposez d'un outil SDK de Python dans votre workflow dans une version antérieure à la version 24.1 d'Alteryx, cette version de l'outil SDK ne fonctionnera pas avec la version 24.1. Pour aller de l'avant, vous devez…
Installer une nouvelle version de l'outil SDK compatible avec la version 24.1.
Mettez à jour votre workflow pour utiliser la nouvelle version de l'outil.
Republiez le workflow sur Alteryx Server.
Étant donné que les utilisateurs peuvent vouloir tester des workflows avec des outils mis à niveau, les clients de Server préférant tester de nouveaux workflows dans un environnement sandbox unique voudront peut-être créer un environnement sandbox distinct pour tester la version 24.1. Avec un environnement distinct, vous pouvez continuer les tests de votre workflow actuel avec les outils existants (avant de passer en production) et utiliser le nouvel environnement pour tester de nouveaux outils avec la version 24.1. Il s'agit d'une configuration nécessaire car les connecteurs basés sur Python 24.1 ne fonctionnent pas avec les versions antérieures d'Alteryx et vice versa.
Oui, les utilisateurs de votre outil personnalisé devront télécharger et installer la dernière version de votre outil une fois la mise à niveau de Python terminée. Vous pouvez publier la dernière version de votre outil sur Community Gallery ou soumettre une mise à jour sur Alteryx Marketplace, le cas échéant.
Nous allons mettre à niveau la version Python de Designer de 3.8.16 vers 3.10.13 pour la version 2024.1, prévue pour mai 2024. Pour cette raison, nous demandons à nos partenaires et clients de mettre à niveau leurs outils SDK vers Python version 3.10.13 avant d'installer Alteryx Designer 2024.1.
Des instructions de mise à niveau détaillées sur la mise à niveau de vos outils vers Python version 3.10.13 sont disponibles. Consultez la page Instructions pour mettre à jour l'outil personnalisé vers Python 3.10.
Si vous avez d'autres questions, rendez-vous sur le forum des développeurs d'Alteryx IO et publiez-les dans celui-ci. Nous actualiserons également ce document régulièrement à mesure que d'autres documents seront disponibles.
Les FAQ suivantes concernent la mise à niveau vers Python 3.8.5 associée à la version 2020.4 d'Alteryx Designer et Server.
Si vous avez installé des outils personnalisés YXI dans une version précédente de Designer, cet outil ne fonctionne plus correctement car les références de version Python qui se trouvent dans les dépendances du module d'outil sont incompatibles.
Il se peut également que l'outil possède des dépendances de module Python qui ne sont plus compatibles avec la nouvelle version de Python ou qui utilisent des aspects du langage Python qui ne sont plus pris en charge.
Script de mise à niveau :
Nous avons fourni un script de mise à niveau de Python intégré afin que vous puissiez accéder à une liste des outils susceptibles d'être impactés sur votre ordinateur ou votre serveur. Ce script peut aussi bien être utilisé par les utilisateurs d'Alteryx ainsi que les administrateurs de Server qui envisagent une mise à niveau vers la version 2020.4 (et versions ultérieures) ou qui ont déjà effectué la mise à niveau et qui ont besoin d'aide pour résoudre des problèmes dans les workflows contenant des outils basés sur le SDK de Python.
Si vous avez déjà installé des outils personnalisés YXI et réalisé une mise à niveau vers Designer 20.4, un message d'erreur vous avertit du problème et vous ne pouvez pas exécuter de workflow contenant cet outil.
Cela affecte les workflows de tous les produits Alteryx.
Faites l'inventaire de tous les outils et versions dont vous disposez. Il existe deux chemins de fichiers pour trouver ces informations, selon votre installation.
Pour les installations avec privilèges élevés (exécutées en tant qu'administrateur), accédez à Program Data (masqué) > Alteryx > Tools.
Pour les installations sans privilèges élevés, accédez à Users > [Utilisateur] > App Data (masqué) > Roaming > Alteryx > Tools.
Il existe six connecteurs de données basés sur Python : Salesforce, Google BigQuery, Microsoft Azure Data Lake Store, Microsoft Power BI, Microsoft OneDrive et Microsoft Dynamics CRM. Cela vous permet de garder une trace de la version que vous devrez réinstaller. Bien que tous les connecteurs de données ne soient pas défaillants, nous vous recommandons vivement de réinstaller chaque version de chaque connecteur ayant des workflows actifs.
Si un outil ne nécessite aucune mise à jour pour être compatible avec Python 3.8, notez la version et l'emplacement de l'outil. Vérifiez que vous pouvez localiser le package YXI de l'outil avant de supprimer ce dernier, car ce processus nécessite une réinstallation du package d'outils. Nous vous recommandons ensuite de supprimer le répertoire d'outils et ses fichiers, puis de réinstaller YXI pour l'outil. N'ouvrez aucun workflow utilisant l'outil avant de réinstaller YXI, car cela pourrait entraîner un comportement inconnu dans le workflow.
Certains outils peuvent continuer à fonctionner sans cette étape, mais nous vous recommandons fortement de suivre les instructions fournies sur cette page.
Vous devez suivre ces instructions pour chaque outil, sur chaque machine et pour chaque répertoire d'installation. Si vous utilisez des installations non-admin et admin, assurez-vous d'avoir mis à jour tous les emplacements possibles de l'outil.
Si un outil nécessite des mises à jour pour résoudre des différences d'utilisation, des problèmes de dépendance ou des packages avec de nouveaux fichiers WHL, le développeur d'outil doit vous fournir un nouvel outil. La plupart du temps, il s'agit d'un outil conçu par un partenaire, mais il peut également s'agir d'un outil plus ancien conçu par Alteryx, ou même d'un outil disponible dans la Communauté ou dans Gallery.
Non, nous avons mis à niveau ces outils dans le cadre de la procédure de mise à niveau de Python. Ils devraient fonctionner automatiquement.
Vous ne devriez pas remarquer de modifications, ni dans l'outil Python, ni dans l'outil Analyses. Ces derniers utilisent tous deux Python, mais pas le SDK de Python. Cependant, étant donné que les packages sous-jacents sont mis à jour, comme pandas, il se peut que le code ne soit plus compatible avec la version de Python.
Un problème avec votre code Python peut survenir dans l'outil Python s'il utilise une fonctionnalité qui n'est plus prise en charge. Si c'est le cas, vous devez mettre à jour le code pour qu'il soit compatible avec Python 3.8. Des modifications ont pu être appliquées entre les versions 3.7 et 3.8. Liens vers les deux versions :
Vous ne devriez pas rencontrer d'erreur si (1) vous avez téléchargé un workflow avec un outil basé sur le SDK Python depuis la version 20.3 vers Server qui a été mis à niveau vers la version 20.4, (2) le code sous-jacent est le même, et (3) vous avez corrigé votre workflow de l'outil basé sur Python en réinstallant le même fichier YXI sur Server. Tous les outils basés sur Python qui ont des workflows actifs doivent être réinstallés sur Server.
Le workflow fait référence à un nom d'outil et à une version d'outil, pas à la version de Python.
Si l'outil a été reconditionné et qu'une nouvelle version a été créée pour prendre en charge la version 20.4, il y aura des incompatibilités de version entre les outils, et l'outil devra être mis à jour dans Server ou Designer.
Nous avons également mis à niveau Python intégré dans Alteryx Analytics Hub vers la version 3.8.5. Comme avec Server, la version peut être différente entre Designer et Alteryx Analytics Hub. Vous devez réinstaller YXI si vous utilisiez une version avec dépendance incompatible.
Si un utilisateur dispose d'une licence pour Alteryx Analytics Hub et Alteryx Intelligence Suite, il doit installer Alteryx Analytics Hub pour effectuer la mise à niveau à partir de la version stable 20.2, puis installer Alteryx Intelligence Suite à l'aide du téléchargement 20.4, disponible à côté d'AAH sur downloads.alteryx.com. Réinstallez ensuite les YXI.
Oui. La version de Python sera incompatible avec les versions 20.3 et antérieures, et les versions 20.4 et ultérieures. Quelle que soit la date de mise à niveau, vous devez mettre à jour les outils YXI pour que la version de Python compatible.
Oui. Si vous ne réinstallez aucun outil Python, vous devriez pouvoir revenir à un état antérieur sans problème. Après avoir mis à jour les outils Python, vous devez poursuivre ce processus pour changer de version. Par exemple, si vous deviez effectuer une mise à niveau de la version 20.3 vers la version 20.4, puis réinstaller Salesforce avant de revenir à la version 20.3, vous devrez réinstaller Salesforce.
Non, pas si vous utilisez des outils basés sur le SDK Python. Si ce n'est pas le cas, le fait d'avoir plusieurs versions installées ne posera probablement aucun problème.
Vous pouvez continuer à utiliser des installations non-administrateur et administrateur de la même version d'Alteryx.
L'installation va réussir. En revanche, les outils basés sur Python qui ne sont pas installés ne fonctionneront pas sur la version 20.4 tant qu'ils ne seront pas mis à jour. Une fois les outils mis à jour, ils ne fonctionneront plus sur votre installation qui n'est pas basée sur Python 3.8 (versions Alteryx antérieures à 20.4).
Pour plus d'informations sur l'installation de plusieurs versions sur votre ordinateur, rendez-vous sur https://community.alteryx.com/t5/Alteryx-Designer-Knowledge-Base/How-to-install-two-versions-of-Designer-on-the-same-machine/ta-p/454948.
Si vous avez besoin d'aide supplémentaire, faites une demande d'assistance clientèle à l'adresse suivante :https://community.alteryx.com/t5/Support/bd-p/SupportPage.
FAQ des développeurs de Python
Nous recommandons aux partenaires et aux créateurs d'outils de mettre à niveau leurs installations locales et de tester tous les outils qu'ils ont créés. Ils peuvent utiliser des modules avec des versions qui ne sont plus compatibles avec Python 3.8 ou une syntaxe qui n'est plus prise en charge.
Si votre outil utilise des fichiers WHL, vous devez reconditionner l'outil avec ses fichiers WHL dans un environnement Python 3.8, puis republier l'outil pour que les utilisateurs puissent y accéder.
Si un créateur d'outil utilise l'ayx-plugin-sdk de la version bêta qui a été mise à jour pour la version 20.4, il doit mettre à jour ce package vers la dernière version pour qu'elle continue à fonctionner.
Plusieurs modules ont été mis à jour dans Snakeplane pour prendre en charge Python 3.8.5, y compris numpy et pandas. Dans certains cas, vous devrez peut-être mettre à jour Snakeplane pour que vos outils fonctionnent.