Skip to main content

Python tool Outil Python

Outil Python mis à jour

À partir de la version 2026.2 de Designer, l'outil Python est compatible nativement avec AMP Engine.

À 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 Python avant d’utiliser cet outil. Après avoir importé le package Python Alteryx via from ayx import Alteryx, consultez Fonctions Python Alteryx pour obtenir des informations sur les fonctions que vous pouvez utiliser avec 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 pouvez installer des packages Python supplémentaires uniquement si vous exécutez Designer en tant qu’administrateur. Les utilisateurs non administrateurs ne peuvent pas installer de packages 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.

    • Le nom affiché ne doit pas correspondre au nom du dossier contenant l'environnement personnalisé.

  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 répertoire wheels dans l’environnement par défaut :

    C:\Program Files\Alteryx\bin\Python\envs\DesignerBaseTools_vEnv\wheels

  2. Activez votre environnement personnalisé et installez les packages avec :

    pip install ayx --find-links "C:\Program Files\Alteryx\bin\Python\envs\DesignerBaseTools_vEnv\wheels"

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).

  • Find and Replace: Use the find and replace icon to search and replace content in your script.

    • Saisissez du texte dans le champ Rechercher et personnalisez les critères de recherche :

      • Respecter la casse (Alt + C) : rechercher uniquement le texte dont la casse correspond à celle du texte saisi. Rechercher "read", et non "READ".

      • Correspondance du mot entier (Alt + W) : rechercher uniquement des mots entiers (ne pas renvoyer les mots qui contiennent le texte saisi). Par exemple, recherchez "data", et non "DataFrame".

      • Utiliser une expression régulière (Alt + R) : Saisissez une expression régulière pour personnaliser vos critères de recherche.

      • Use the up and down arrows to cycle through the matches.

      • Rechercher dans la sélection (Alt + L) : Sélectionner pour rechercher dans la ligne active.

    • Saisissez du texte dans le champ Remplacer pour remplacer le texte saisi dans le champ Rechercher.

      • Respecter la casse (Alt + P) : conserve la casse du texte trouvé lors du remplacement.

      • Remplacer (Entrée) : remplace une occurrence du texte trouvé par le texte du champ Remplacer.

      • Remplacer tout (Ctrl + Alt + Enter) : remplace toutes les occurrences du texte trouvé par le texte du champ Remplacer.

  • Copier : sélectionnez l’icône de copie pour copier l’intégralité du contenu actuel de l’éditeur, y compris les modifications effectuées depuis le dernier enregistrement du workflow.

  • Comment and Uncomment: Select the # icon to comment or uncomment the current line or selected non-blank lines without changing indentation.

  • Import: Select to import a Python script and browse to your script or notebook file. The file must be a .py (Python script) or .ipynb (Python notebook) extension.

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é des entrées, vous pouvez utiliser la fonction Alteryx.read pour importer les données du workflow dans l’outil sous forme de DataFrame pandas. Vous pouvez ensuite utiliser Python pour transformer les données, puis Alteryx.write pour générer des données en sortie de l’outil Python.

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).