Configuration de Python pour être utilisé avec Analytics

Remarque

Ces instructions de configuration se rapportent à l’instance installée par le client nécessaires pour utiliser la commande ACLScript pour Python (PYCOMMAND) ou les fonctions ACLScript pour Python. Cette instance de Python n'est pas identique à celle qui peut être installée dans le cadre de l'installation d'Analytics pour prendre en charge les commande de machine learning.

Analytics vous fournit différentes options pour intégrer le langage de programmation Python et les scripts Python dans votre automatisation de données et vos flux de travail d’analyse de données.

Domaine fonctionnel Analytics Nombre de bits de Python requis Version Python prise en charge Méthode de configuration de Python

Commande ACLScript pour Python

(PYCOMMAND)

  • 64 bits (méthode recommandée)

  • 32 bits

3.12.4 (testée)

Les autres versions de Python fonctionneront probablement, mais elles n’ont pas été testées.

Le client installe et configure Python séparément d’Analytics.

Voir Configurer Python pour pouvoir utiliser la commande ACLScript pour Python

Fonctions ACLScript pour Python

  • 32 bits

3.7.x ou ultérieure

Le client installe et configure Python séparément d’Analytics.

Voir Configurer Python pour pouvoir utiliser les fonctions ACLScript pour Python

Commandes de machine learning pour ACLScript

  • 32 bits

3.7.9

Le client sélectionne l’installation Python facultative au cours du processus d’installation d’Analytics

Voir Installer ACL pour Windows

Configurer Python pour pouvoir utiliser la commande ACLScript pour Python

Installez et configurez Python pour permettre l’utilisation de la commande ACLScript pour Python (PYCOMMAND). La commande Python vous permet d’intégrer facilement les fonctions de création de scripts Analytics et Python, et de procéder à des allers-retours entre les deux environnements.

Installer Python (64 bits ou 32 bits)

Remarque

La commande ACLScript pour Python peut fonctionner avec Python en version 32 bits ou 64 bits. Nous vous recommandons d’installer Python en 64 bits car cette version vous fournit davantage d’options quant aux packages pris en charge et vous assure de meilleures performances lorsque le volume de données traitées est plus important.

  1. À partir de la page des téléchargements Python, téléchargez une version récente de Python sur votre ordinateur ou sur le serveur.

    La commande ACLScript pour Python a été testée avec Python 3.12.4. Les autres versions de Python devraient fonctionner, mais cela n’est pas garanti.

  2. Double-cliquez sur le programme d’installation de Python sur votre ordinateur ou sur le serveur.

  3. Dans le programme d’installation, sélectionnez Utiliser les privilèges d’Admin lors de l’installation de py.exe.

  4. Cliquez sur Installer maintenant et suivez les instructions à l’écran.

Ajouter des chemins de dossier Python à la variable d’environnement PATH

Ajoutez à la variable d’environnement PATH deux chemins de dossier pour l’installation de Python.

  1. Dans la barre des tâches Windows, effectuez une recherche sur variables d’environnement.

  2. Sélectionnez Modifier les variables d’environnement système.

    La boîte de dialogue Propriétés système s’affiche.

  3. Dans l’onglet Avancé, sélectionnez Variables d’environnement.

    La boîte de dialogue Variables d’environnement s’affiche.

  4. Dans la liste Variables système, sélectionnez Chemin, puis sélectionnez Modifier.

    La boîte de dialogue Modifier la variable d’environnement s’affiche.

  5. Procédez comme suit pour ajouter deux chemins de dossier Python :

    1. Sélectionnez Nouveau et ajoutez ce chemin de dossier (emplacement par défaut de l’installation de Python) :

      C:\Utilisateurs\<USER>\AppData\Local\Programmes\Python\Python<version>\

      Remarque

      Si vous avez installé Python à un emplacement différent, spécifiez le chemin correct vers le dossier contenant le fichier exécutable (python.exe).

    2. Sélectionnez le chemin récemment ajouté et utilisez l’option Déplacer vers le haut pour déplacer le chemin vers le haut de la liste.

    3. Resélectionnez Nouveau et ajoutez ce chemin de dossier modifié en conséquence :

      C:\Utilisateurs\<USER>\AppData\Local\Programmes\Python\Python<version>\Scripts

    4. Sélectionnez le deuxième chemin ajouté et utilisez l’option Déplacer vers le haut pour déplacer le chemin en dessous du premier chemin que vous avez ajouté.

  6. Pour enregistrer vos modifications, sélectionnez OK dans chacune des boîtes de dialogue :

    • Modifier la variable d’environnement

    • Variables d’environnement

    • Propriétés système

  7. Redémarrez votre ordinateur ou le serveur afin de vous assurer que les modifications apportées à la variable d’environnement Chemin soient effectives.

    Remarque

    En fonction de votre système d’exploitation et de votre environnement, un redémarrage peut être nécessaire. Toutefois, si l’ensemble d’actions suivant ne fonctionne pas, redémarrez votre ordinateur ou le serveur avant de procéder à ces étapes.

Créer un environnement virtuel Python

Remarque

Il n’est pas obligatoire de créer un environnement virtuel Python. Vous pouvez utiliser l’environnement Python de base pour vos tâches de développement. Cependant, le fait de travailler dans un environnement virtuel constitue une bonne pratique, car cela vous permet de séparer différentes activités et ensembles de dépendances Python.

  1. Créez un dossier Windows qui contiendra l’environnement virtuel Python.

    Par exemple, C:\Python_ACL_integration.

  2. Ouvrez une invite de commande Windows et choisissez Exécuter en tant qu’administrateur.

  3. Saisissez python.exe --version et appuyez sur Entrée.

    Cela devrait vous renvoyer la version de Python que vous avez installée. Par exemple :
    Python 3.12.4.

    Si cette commande n’est pas reconnue par l’invite de commandes Windows, il est possible que les modifications que vous apportées à la variable d’environnement Chemin ne soient pas effectives. Redémarrez votre ordinateur ou le serveur, puis réessayez.

  4. Basculez vers le dossier que vous avez créé pour l’environnement virtuel Python.

    Par exemple, cd C:\intégration_Python_ACL.

  5. Pour créer un environnement virtuel Python, entrez cette commande : python -m venv venv.

    La première mention de venv indique que le module venv de Python est utilisé. La seconde mention de venv indique le nom de l’environnement virtuel. Vous pouvez donner un nom différent à l’environnement virtuel si vous le souhaitez, mais veillez à ce que le nom soit clairement représentatif de l’environnement virtuel.

    Vous devriez à présent disposer d’un sous-dossier venv dans le dossier que vous avez créé pour l’environnement virtuel Python. Par exemple, C:\Python_ACL_integration\venv.

    Si la création de l’environnement virtuel Python a échoué, il est possible que les modifications apportées à la variable d’environnement chemin ne soient pas effectives. Redémarrez votre ordinateur ou le serveur, puis réessayez.

  6. Pour activer un environnement virtuel Python, entrez cette commande : .\venv\Scripts\activate.

    Cette invite de commande devrait renvoyer le dossier de l’environnement virtuel avec le préfixe (venv). Par exemple, (venv) c:\Python_ACL_integration>

  7. Afin d’installer le module Pandas dans l’environnement virtuel Python, entrez cette commande : pip install pandas.

    En cas de réussite de l’installation de Pandas, la dernière ligne du message de l’invite de commande devrait ressembler à cela :

    Installation réussie de numpy-2.2.2 pandas-2.2.3 python-dateutil-2.9.0.post0 pytz-2024.2 six-1.17.0 tzdata-2025.1

Ajoutez aux Options Analytics le chemin d’accès à l’environnement virtuel

  1. Ouvrez Analytics.

  2. Dans le menu principal Analytics, sélectionnez Outils > Options.

  3. Sélectionnez l’onglet Système.

  4. Dans le champ Chemin Python, entrez le chemin complet et le nom du fichier exécutable Python dans l’environnement virtuel que vous venez de créer.

    Par exemple, C:\Python_ACL_integration\venv\Scripts\python.exe

  5. Cliquez sur OK afin d'enregistrer vos modifications.

Prochaines étapes

En cas de réussite de l’installation et la configuration de Python, de l’environnement virtuel et de Pandas, vous pouvez à présent tester l’intégration de Python à Analytics. Pour plus d'informations, consultez la rubrique Intégrer des scripts Python ou Commande PYCOMMAND.

Configurer Python pour pouvoir utiliser les fonctions ACLScript pour Python

Pour configurer Python afin de l'utiliser avec Analytics, vous devez installer une version compatible de Python et ajouter l'exécutable Python à la variable d'environnement PATH de votre ordinateur. Vous devez également définir les variables d'environnement ACLPYTHONDLL et PYTHONPATH de votre système.

Fonctionnement

Pour exécuter des scripts Python, Analytics doit pouvoir appeler l'exécutable Python et trouver les scripts qu'on lui ordonne d'exécuter. Analytics utilise la variable d'environnement PATH pour localiser Python et la variable d'environnement PYTHONPATH pour localiser les scripts.

Installer Python (32 bits)

  1. À partir de la page des téléchargements Python, téléchargez une des versions suivantes de Python sur votre ordinateur ou sur le serveur :
    • 3.7.x
    • 3.8.x
    • 3.9.x

    Remarque

    Nous avons testé et vérifié le fonctionnement des versions énumérées de Python avec Analytics ou l'agent Robots.

    Toute version de Python à partir de 3.7.x et ultérieure doit fonctionner. Toutefois, le fonctionnement des versions autres que celles énumérées n'est pas garanti.

  2. Sur votre ordinateur ou sur le serveur, double-cliquez sur le programme d'installation.
  3. Dans le programme d'installation, sélectionnez Ajouter Python numéro_de_version à PATH.
  4. Cliquez sur Installer et suivez les instructions à l'écran.
  5. Redémarrez l'ordinateur ou le serveur avant d'exécuter des scripts Python appelés par un script Analytics.

Définir les variables d'environnement ACLPYTHONDLL et PYTHONPATH

  1. Dans le lecteur C:\ du système d'exploitation, créez un ou plusieurs dossiers pour héberger vos scripts Python.

    Exemple C:\python_scripts

  2. Dans le système d'exploitation, ouvrez la boîte de dialogue Propriétés système, puis cliquez sur Variables d'environnement.
  3. Dans la section Variables système, cliquez sur Nouveau puis saisissez les variables suivantes :
    Nom de la variableValeur de la variable
    PYTHONPATH

    Chemin d'accès complet au(x) dossier(s) que vous avez créé(s) pour héberger les scripts Python. Séparez les différents chemins d'accès au dossier avec un point-virgule.

    Exemple :

    C:\python_scripts;C:\dev;C:\tmp
    ACLPYTHONDLL

    Nom du chemin d'accès complet et nom du fichier Python DLL dans le dossier d'installation Python.

    Exemple :

    c:\python_install\python35.dll

    Remarque

    Lors de l'installation, Python ajoute la DLL au dossier système (c:\windows\system32\python35.dll) plutôt qu'au dossier d'installation. Vous devez copier le fichier DLL du dossier système vers le dossier d'installation et utiliser l'emplacement du dossier d'installation comme valeur de variable. Analytics ou l'Agent Robots recherche la DLL dans le dossier d'installation de Python.

    Vous pouvez aussi être amené à supprimer les paramètres en lecture seule du dossier d'installation.

  4. Pour enregistrer la variable, cliquez sur OK, puis, dans la boîte de dialogue Propriétés système, cliquez à nouveau sur OK.

Utiliser Python dans les fonctions Analytics Python

Dans Analytics, utilisez les fonctions Analytics Python pour appeler des fonctions dans les scripts existant dans PYTHONPATH.AnalyticsAnalytics

Pour plus d'informations, consultez la section Python.

Note

If you make any edits to a Python script, you must refresh the view in your Analytics project to use the latest version of the Python script. The simplest way to refresh the view is to close the table you are working with and then re-open it.