Outil Python
Version:
2023.1
Last modified: May 30, 2023
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 Alteryx Python, exécutez Alteryx.help pour plus d'informations sur les fonctions utiles :
from ayx import AlteryxAlteryx.help()
Bien que Designer accepte le code Python personnalisé, Alteryx n'offre pas la prise en charge du code Python personnalisé.
Compatibilité de la galerie publique alteryx
Planification de la publication de votre flux de travail sur gallery.alteryx.com? Pour demander une exemption : Cette restriction ne s'applique pas aux instances privées d'Alteryx Server et alteryx Gallery.
Mise en route
La fenêtre de configuration de l'outil Python ressemble à un bloc-notes Jupyter. Si vous n'êtes pas familiarisé avec les Bloc-notes Jupyter, accédez à Aide > Visite de l'interface utilisateur ou Aide > Aide du Bloc-notes. Pour obtenir une assistance avec le code, voir les références supplémentaires disponibles dans Aide.
Bien que l'outil reproduit l'interface du Bloc-notes Jupyter, certaines options peuvent se comporter différemment de ce que vous attendez.
Installez les packages de données science dont vous avez besoin
L'outil Python comprend les packages de données science :
- ayx : API Alteryx
- jupyter : métapaquet Jupyter
- matplotlib : Paquet de traçage Python
- numpy : NumPy, traitement de matrices pour les nombres, les chaînes, les enregistrements et les objets.
- pandas : puissantes structures de données pour l'analyse des données, les séries chronologiques et les statistiques
- demandes : HTTP pour les humains
- scikit-learn : un ensemble de modules Python pour machine learning et l'exploration de données
- scipy : SciPy, Bibliothèque Scientifique pour Python
- six : utilitaires compatibles avec Python 2 et 3
- SQLAlchemy : Bibliothèque d'abstraction de base de données
- statsmodels : calculs et modèles statistiques pour Python
Installation de paquets supplémentaires
Selon la version de Designer que vous utilisez, vous pouvez installer des paquets supplémentaires avec la fonction Alteryx.installPackages. Par exemple, installer keras :
Python
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-administrateur ne peuvent pas installer les paquets Python supplémentaires.
Connecter les entrées
L'outil Python accepte plusieurs entrées. Une fois que vous avez connecté les entrées, vous devez exécuter le workflow pour mettre en cache les flux de données entrants. Suivez ces étapes pour accéder à une connexion de données entrante :
Importez la bibliothèque Alteryx :
Python
from ayx import Alteryx
Accédez à la connexion et fournissez une variable à utiliser comme référence de données :
Python
# Use the method this method to read data from the reference. Replace "CONNECTION_NAME" with the name of your connection.
data1 = Alteryx.read("CONNECTION_NAME")
# Read in all connections and reference the returned zero-index array. Replace "INDEX_NUMBER" with the appropriate index number from the array.
Alteryx.read(Alteryx.getIncomingConnectionNames()[INDEX_NUMBER])
Exécutez votre workflow avant de commencer à travailler avec l'outil Python. Cela cache vos données et les rend accessibles à l'outil.
L'outil Python traite vos données comme une trame de données Pandas. Pour plus d'informations, visitez pandas.pydata.org.
Configurer l'outil
Définir le mode d'exécution du workflow
Vous avez la possibilité d'utiliser deux modes pour travailler avec l'outil Python :
- Utilisez le mode Interactif pour commencer le développement.
- Utilisez le mode Production pour améliorer la vitesse lorsque vous avez terminé le développement et que vous souhaitez exécuter votre code via un interprète Python standard.
Mode interactif
Cliquez sur le bouton Interactif. Utilisez ce mode pour le développement. Ce mode vous permet d'interagir avec les données entrantes via un Bloc-notes Jupyter sans avoir besoin de réexécuter le workflow pour voir les résultats de votre code.
Lorsque vous exécutez le workflow, Designer exécute ces tâches :
- Designer met en cache une copie des données entrantes et la met à disposition de l'outil Python.
- L'interpréteur de commandes Jupyter exécute le code dans le bloc-notes.
- Si votre code appelle la méthode , L'interpréteur de commandes Jupyter envoie des résultats à travers les ancrages de sortie.
- Le bloc-notes Jupyter affiche tous les erreurs, avertissements et déclarations d'impression, juste comme quand vous sélectionnez Éxécuter tous.
Mode Production
Cliquez sur le bouton Production. Utilisez ce mode pour les modèles en production. Dans ce mode, Designer consolide toutes les cellules Python à partir du bloc-notes Jupyter au sein d'un script unique en lecture seule. Designer transmet ce script à votre interprète Python.
Lorsque vous exécutez le workflow, Designer exécute ces tâches :
- Il contourne l'interpréteur de commandes Jupyter, puis exécute le script en lecture seule via un interprète Python standard.
- Il n'affiche pas les erreurs, les avertissements et les déclarations d'impression.
Pour modifier le script en mode production, cliquez sur le mode Interactif, puis modifiez les cellules dans le bloc-notes Jupyter. Une fois vos modifications terminées, cliquez sur le mode Production.
Définir le format de stockage des données
L'outil Python dispose de deux options de format : SQLite et YXDB.
SQLite
- Cliquez sur le menu Alteryx dans la fenêtre de configuration de l'outil Python.
- Sélectionnez Remplacement de Sqlite.
YXDB
Suivez ces étapes pour utiliser le format de stockage de données YXDB.
- Cliquez sur le menu Alteryx dans la fenêtre de configuration de l'outil Python.
- Désélectionnez Remplacement de Sqlite pour supprimer le signe de vérification.
| SQLite | YXDB | |
|---|---|---|
| Blob | Pas de support | Assistance |
| Objets géographiques | Pas de support | Transmettre les objets géographiques entre l'outil Python et d'autres outils. Utilisez des balises de métadonnées lorsque vous créez des sorties d'objets géographiques à partir de l'outil Python. |
| Limitation de colonne | La limite est de 2000 | Pas de limite |
| Note relative aux valeurs nulles | Pas de support | Designer convertit les colonnes numériques ou octets en type de données float64 (c.-à-d. flottant à double précision). |
Si vous ne modifiez pas la disposition des lignes ou si vous utilisez Python GeoSpatial, Alteryx vous recommande de couper les données GeoSpatial du jeu de données et de les rejoindre à nouveau après l'outil Python. Cela est dû au fait que la conversion depuis et vers les données Alteryx Binary et le texte GeoSpatial est lente.
Importer un fichier ou un répertoire
Vous pouvez importer un fichier ou un répertoire de deux façons :
- Utilisez la fonction d'importation dans le menu Alteryx pour importer des scripts Python individuels ou des bloc-notes Jupyter.
- Utilisez la commande d'importation pour importer un répertoire.
Suivez ces étapes pour importer un script Python ou un bloc-notes Jupyter avec la fonction d'importation :
- Cliquez sur le menu Alteryx.
- Sélectionnez Importer le script.
- Cliquez sur Choisir fichier.
- Accédez à unfichier .py ou .ipynb et sélectionnezImporter.
Utilisez le menu Kernel
Émettre l'une de ces commandes à partir du menu Kernel :
- Pour arrêter le traitement, sélectionnez Interrompre.
- Pour redémarrer le traitement, sélectionnez Redémarrer.
- Pour effacer le classeur des résultats immédiats, sélectionnez Reconnecter.
- La modification Kernel ne fournit pas cette fonctionnalité.
- Alteryx recommande de ne pas sélectionner Arrêter.
Respecter les meilleures pratiques
Ces meilleures pratiques vous aident à utiliser l'outil Python avec succès :
Utilisez la méthode Alteryx.getWorkflowConstant pour faire référence à une constante du workflow comme Engine.WorkflowDirectory. Dans le cas contraire, le résultat ou la sortie de la commande remplace définitivement la commande dans votre bloc-notes Jupyter lorsque vous exécutez votre code.
Évitez d'utiliser des wrappers % dans les constantes du workflow. Utilisez plutôt ceci, par exemple, pour appeler Engine.WorkflowDirectory :
from ayx import Alteryx
Alteryx.getWorkflowConstant("Engine.WorkflowDirectory")
Sortie de données depuis l'outil
Utilisez la méthode Alteryx.write pour extraire les données de l'outil.
Pour envoyer des données à d'autres outils du canevas, utilisez une méthode comme ceci :
Python
# Replace "PANDAS_DF" with your data, in DataFrame form.
# Replace "OUTPUT_ANCHOR_NUM" with the number of your output anchor.
Alteryx.write(PANDAS_DATAFRAME, OUTPUT_ANCHOR_NUM)
La méthode Alteryx.write accepte uniquement les trame de données pandas. Si vous avez des données dans un autre format, utilisez la bibliothèque Pandas pour les convertir en trame de données. La bibliothèque Pandas est déjà installée dans avec Designer. Accédez-y dans le bloc-notes Jupyter avec importer pandas.
Vous pouvez envoyer jusqu'à cinq trames de données vers les ancrages de sortie.