Skip to main content

Python tool Outil Python

Outil Python mis à jour

À partir de la version 2026.1 de Designer, le mode interactif n'est plus disponible dans l'outil Python.

Le développement Python est désormais pris en charge via un modèle d'exécution en production. Cela signifie que vous pouvez modifier vos scripts Python directement dans l'outil ou dans votre environnement de développement intégré (IDE) préféré avant d'exécuter vos workflows.

Exigences relatives au rôle d'utilisateur

Rôle d'utilisateur*

Accès aux outils/fonctionnalités

Utilisateur complet

✓

Utilisateur de base

X

*S'applique aux clients Alteryx OneÉditions Professional et Enterprise sur les versions 2025.1 et ultérieures de Designer.

L'outil Python est un éditeur de code destiné aux utilisateurs de Python. Vous devez maîtriser le langage Python avant d’utiliser cet outil. Après avoir importé le package Python Alteryx via from ayx import Alteryx, consultez Fonctions Python Alteryx pour en savoir plus sur les fonctions que vous pouvez utiliser via l'outil Python dans Designer.

Important

Bien que Designer accepte le code client Python, Alteryx n'offre pas la prise en charge du code client Python.

Exemple d'outil unique

Cet outil comporte un exemple d'outil unique. Accédez à Exemples de workflows pour savoir comment accéder à cet exemple et à de nombreux autres exemples directement dans Designer.

Pour commencer

Utilisez la fenêtre Configuration de l'outil Python pour saisir ou importer votre script Python. Pour obtenir de l'aide sur le code, consultez les références supplémentaires dans fonctions Python Alteryx.

Installer les packages Data Science dont vous avez besoin

L'outil Python comprend les packages de données science :

  • ayx : API Python Alteryx qui interagit avec les workflows et l'exécution de Designer.

  • ayx_python_sdk : kit de développement logiciel (SDK) pour créer et étendre les outils Alteryx en Python.

  • numpy : package de base pour le calcul numérique et le traitement de tableaux en Python.

  • pandas : structures de données puissantes pour l'analyse de données, les séries temporelles et le traitement de tableaux.

  • scipy : bibliothèque de calcul scientifique pour l'optimisation, les statistiques, le traitement de signaux et les mathématiques avancées.

  • scikit-learn : bibliothèque de machine learning pour la classification, la régression, le clustering et l'évaluation du modèle.

  • statsmodels : bibliothèque de modélisation statistique et d'économétrie pour la régression et le test d'hypothèses.

  • pyarrow : bibliothèque hautes performances pour le traitement des données en colonnes et l'interopérabilité avec Apache Arrow (par exemple, Parquet et IPC).

  • SQLAlchemy : boîte à outils d'abstraction de base de données et de mappage objet-relationnel (ORM) pour les bases de données relationnelles en Python.

  • pyodbc : connecteur ODBC pour les bases de données d'entreprise.

  • requests : bibliothèque HTTP pour appeler des API et des services Web.

  • matplotlib : bibliothèque de traçage pour les graphiques statiques et les visualisations.

  • plotly : bibliothèque de visualisation pour les graphiques et les tableaux de bord interactifs.

  • plotly : bibliothèque de visualisation pour les graphiques et les tableaux de bord interactifs.

  • dash : framework pour créer des applications Web analytiques en Python.

Installation de packages supplémentaires

Selon la version de Designer que vous utilisez, vous pouvez installer des paquets supplémentaires avec la fonction Alteryx.installPackages. Par exemple, pour installer Keras, exécutez la commande suivante :

from ayx import Package

Package.installPackages("keras")

Vous ne pouvez installer des paquets Python supplémentaires que si vous exécutez Designer en tant qu'administrateur. Les utilisateurs non administrateurs ne peuvent pas installer les package Python supplémentaires.

Configuration de l'outil

Vous pouvez utiliser la fenêtre Configuration des outils Python pour sélectionner votre environnement de base et saisir votre script Python.

Environnement

Utilisez la liste déroulante Environnement pour sélectionner votre environnement de base. L'environnement par défaut est DesignerBaseTools_vEnv.

Créer un environnement personnalisé

Vous pouvez également créer un environnement personnalisé à utiliser dans votre outil Python. Vous pouvez spécifier vos dépendances dans votre environnement personnalisé et configurer l'outil Python pour utiliser l'environnement. Cela vous permet d'importer rapidement des packages et offre une approche plus efficace et plus facile à gérer de l'utilisation de l'outil Python dans Designer.

Si vous souhaitez utiliser un environnement personnalisé, suivez ces instructions :

  1. Accédez à ce dossier (version administrateur de Designer) :

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

  2. Copiez le dossier designerbasetools_venv.

  3. Renommez le dossier copié avec le nom que vous souhaitez pour le nouveau noyau.

  4. Dans le dossier renommé, ouvrez kernel.json.

  5. Mettez à jour la valeur display_name.

    • Définissez-la sur le nom de noyau que vous souhaitez afficher dans le menu Environnement de la configuration de l'outil Python.

    • Généralement, cette valeur correspond au nom du dossier, mais pas forcément.

  6. Ne modifiez pas ces valeurs :

    • argv : Jupyter l'utilise pour exécuter Python dans l'environnement. Pour le test, ne le modifiez pas.

    • langage : laissez ce paramètre défini sur python.

    Exemple de fichier kernel.json :

    {
  "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. Enregistrez kernel.json et retournez à Designer.

  8. Actualisez la liste des noyaux :

    • Cliquez en dehors de l'outil Python, puis sélectionnez-le à nouveau.

    • Si le nouveau noyau ne s'affiche pas, fermez Designer et rouvrez-le.

Utiliser un autre interprète Python (facultatif)

Important

Nous recommandons d'utiliser uv pour gérer votre environnement Python personnalisé.

Vous pouvez configurer votre environnement personnalisé pour utiliser un autre interpréteur Python. Cela vous permet d'utiliser un environnement Python entièrement séparé avec vos propres packages installés. Pour utiliser un autre interpréteur Python dans votre environnement personnalisé, procédez comme suit :

  1. Ouvrez kernel.json dans votre dossier de noyau personnalisé.

  2. Mettez à jour la première entrée de la liste argv pour qu'elle pointe vers le chemin du fichier exécutable Python de votre environnement personnalisé.

    Exemple de kernel.json avec l'entrée argv mise à jour :

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

  3. Enregistrez le fichier kernel.json et actualisez la liste des noyaux dans Designer.

    • Cliquez en dehors de l'outil Python, puis sélectionnez-le à nouveau.

    • Si le nouveau noyau ne s'affiche pas, fermez Designer et rouvrez-le.

Ajoutez le package AYX à l'environnement personnalisé

Important

Si vous utilisez un environnement Python personnalisé, vous devez vous assurer que le package ayx est disponible. Le package ayx est indispensable pour que l'outil Python puisse interagir avec votre workflow Designer (par exemple, lire et écrire des données).

Pour ajouter le package ayx à votre environnement personnalisé, procédez comme suit :

  1. Localisez le package ayx dans l'environnement par défaut :

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

  2. Copiez l'intégralité du dossier ayx.

  3. Collez le dossier dans le répertoire site-packages de votre environnement personnalisé :

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

Le package ayx dépend de bibliothèques supplémentaires qui peuvent ne pas être installées dans votre environnement personnalisé (par exemple, pandas). La copie du package dans votre environnement personnalisé n'installe pas automatiquement les dépendances.

Installez les dépendances manquantes dans votre environnement personnalisé. Par exemple :

pip install pandas

Enfin, pour vérifier que vous avez correctement installé le package ayx, activez votre environnement et exécutez la commande suivante :

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

Script Python

Utilisez le champ Script Python de la fenêtre de configuration pour saisir ou coller votre script Python. Vous avez également la possibilité d'importer un script. Pour ce faire, cliquez sur le bouton Écraser le script/bloc-notes et accédez à votre script ou à votre fichier de bloc-notes. Le fichier doit avoir une extension .py (script Python) ou .ipynb (bloc-notes Python).

Fonctions Python Alteryx

Un certain nombre de fonctions sont disponibles dans le package Alteryx lorsque vous exécutez from ayx import Alteryx. Les fonctions vous permettent de transmettre des données entre Alteryx et Jupyter.

Pour connaître les fonctions, descriptions et exemples disponibles, consultez la page Fonctions Python Alteryx.

Important

L'outil Python traite vos données comme une trame de données Pandas. Pour plus d'informations, consultez la page pandas.pydata.org.

Se connecter aux données de workflow

L'outil Python accepte plusieurs entrées. Après avoir connecté les entrées, vous pouvez importer vos données de workflow dans l'outil en tant que dataFrame pandas via la fonction Alteryx.read. Vous pouvez ensuite transformer les données grâce à Python et enfin les extraire de l'outil Python via Alteryx.write.

Consultez Fonctions Python Alteryx pour obtenir la liste complète des fonctions disponibles via la bibliothèque Alteryx.

Notes et limitations

Type de chaîne Pandas

L'outil Python d'Alteryx Designer ne prend pas en charge le dtype « string » Pandas. Nous vous recommandons plutôt le type de données standard « object », qui permet d'écrire correctement la DataFrame.

IPython

Avec les mises à jour de l'outil Python dans la version 2026.1, l'utilisation des fonctionnalités interactives d'IPython n'est plus compatible avec les fonctionnalités prévues de l'outil Python dans Designer.

La fonctionnalité IPython prend principalement en charge l'exploration interactive, ce qui est moins pertinent dans les workflows de production exécutés dans Designer.

Par conséquent :

  • Alteryx ne conservera pas la compatibilité avec les fonctionnalités spécifiques à l'IPython.

  • Les workflows qui reposent sur la fonctionnalité IPython peuvent ne plus se comporter de la même manière qu'avant la version 2026.1.

  • Si vous avez besoin de ces fonctionnalités, vous devez exécuter votre code en dehors de Designer dans un environnement IPython.

L'outil Python ne charge pas le script avec la l'outil Désactiver la configuration automatique.

Si vous activez l'outil Désactiver la configuration automatique dans les Paramètres utilisateur, les outils Python créés avant la version 26.1 ne chargent pas leur script lorsque vous ouvrez un workflow antérieur à la version 26.1 dans Designer 2026.1.

Pour résoudre ce problème, désactivez l'outil Désactiver la configuration automatique dans les Paramètres utilisateur, puis rouvrez le workflow. Cela permet à l'outil de convertir et de charger le contenu du script.

  • Ce problème concerne uniquement les outils Python créés avant la version 2026.1 de Designer.

  • Le problème ne se produit pas lorsque l'outil Désactiver la configuration automatique est désactivé (paramètre par défaut).

Dans cette section​: