Partager via


Utiliser Python avec revoscalepy pour créer un modèle qui s’exécute à distance sur SQL Server

S’applique à : SQL Server 2017 (14.x) et versions ultérieures

La bibliothèque Python revoscalepy de Microsoft fournit des algorithmes de science des données pour l’exploration, la visualisation, les transformations et l’analyse des données. Cette bibliothèque a une importance stratégique dans les scénarios d’intégration Python dans SQL Server. Sur un serveur à plusieurs cœurs, les fonctions revoscalepy peuvent s’exécuter en parallèle. Dans une architecture distribuée avec un serveur central et des stations de travail clientes (des ordinateurs physiques distincts, qui ont tous la même bibliothèque revoscalepy), vous pouvez écrire du code Python qui démarre localement, puis déplace l’exécution vers une instance SQL Server distante où les données résident.

Vous pouvez trouver revoscalepy dans les produits et distributions Microsoft suivants :

Cet exercice montre comment créer un modèle de régression linéaire basé sur rx_lin_mod, l’un des algorithmes de revoscalepy qui accepte le contexte de calcul comme entrée. Le code que vous allez exécuter dans cet exercice bascule l’exécution du code d’un environnement de calcul local vers un environnement distant, activé par les fonctions revoscalepy qui permettent de bénéficier d’un contexte de calcul distant.

En suivant ce didacticiel, vous allez apprendre à :

  • Utiliser revoscalepy pour créer un modèle linéaire
  • Basculer des opérations d’un contexte de calcul local à un contexte de calcul distant

Prérequis

L’échantillon de données utilisé dans cet exercice est la base de données flightdata.

Vous avez besoin d’un IDE pour exécuter l’exemple de code de cet article, et l’IDE doit être lié à l’exécutable Python.

Pour effectuer un basculement de contexte de calcul, vous avez besoin d’une station de travail locale et d’une instance de moteur de base de données SQL Server avec Machine Learning Services et Python activés.

Conseil

Si vous n’avez pas deux ordinateurs, vous pouvez simuler un contexte de calcul distant sur un ordinateur physique en installant les applications appropriées. Tout d’abord, une installation de SQL Server Machine Learning Services fonctionne comme l’instance « distante ». Ensuite, une installation des bibliothèques clientes Python fonctionne en tant que client. Vous aurez deux copies de la même distribution Python et des bibliothèques Python Microsoft sur le même ordinateur. Vous devez noter les chemins d’accès aux fichiers et quelle copie de Python.exe vous utilisez pour terminer l’exercice.

Contextes de calcul distants et revoscalepy

Cet exemple illustre le processus de création d’un modèle Python dans un contexte de calcul distant, qui vous permet de travailler à partir d’un client, mais de choisir un environnement distant, tel que SQL Server ou Spark, où les opérations sont réellement effectuées. L’objectif du contexte de calcul distant est d’amener le calcul à l’emplacement où résident les données.

Pour exécuter du code Python dans SQL Server, le package revoscalepy est nécessaire. Il s’agit d’un package Python spécial fourni par Microsoft, similaire au package RevoScaleR pour le langage R. Le package revoscalepy prend en charge la création de contextes de calcul et fournit l’infrastructure pour transmettre des données et des modèles entre une station de travail locale et un serveur distant. La fonction revoscalepy qui prend en charge l’exécution de code dans la base de données est RxInSqlServer.

Dans cette leçon, vous utilisez les données de SQL Server pour former un modèle linéaire basé sur rx_lin_mod, une fonction dans revoscalepy qui prend en charge la régression sur les jeux de données très volumineux.

Cette leçon présente également les bases de la configuration et de l’utilisation d’un contexte de calcul SQL Server dans Python.

Exécuter l’exemple de code

Une fois que vous avez préparé la base de données et que vous disposez des données de formation stockées dans une table, ouvrez un environnement de développement Python et exécutez l’exemple de code.

Le code effectue les actions suivantes :

  1. Importe les bibliothèques et les fonctions requises.
  2. Crée une connexion à SQL Server. Crée des objets de source de données pour l’utilisation des données.
  3. Modifie les données à l’aide de transformations afin qu’elles puissent être utilisées par l’algorithme de régression logistique.
  4. Appelle rx_lin_mod et définit la formule utilisée pour s’adapter au modèle.
  5. Génère un ensemble de prédictions basées sur les données d’origine.
  6. Crée un résumé basé sur les valeurs prédites.

Toutes les opérations sont effectuées à l’aide d’une instance de SQL Server comme contexte de calcul.

Notes

Pour obtenir une démonstration de l’exécution de cet exemple à partir de la ligne de commande, consultez cette vidéo : SQL Server 2017 Advanced Analytics with Python

Exemple de code

from revoscalepy import RxComputeContext, RxInSqlServer, RxSqlServerData
from revoscalepy import rx_lin_mod, rx_predict, rx_summary
from revoscalepy import RxOptions, rx_import

import os

def test_linmod_sql():
    sql_server = os.getenv('PYTEST_SQL_SERVER', '.')
    
    sql_connection_string = 'Driver=SQL Server;Server=' + sqlServer + ';Database=sqlpy;Trusted_Connection=True;'
    print("connectionString={0!s}".format(sql_connection_string))

    data_source = RxSqlServerData(
        sql_query = "select top 10 * from airlinedemosmall",
        connection_string = sql_connection_string,

        column_info = {
            "ArrDelay" : { "type" : "integer" },
            "DayOfWeek" : {
                "type" : "factor",
                "levels" : [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ]
            }
        })

    sql_compute_context = RxInSqlServer(
        connection_string = sql_connection_string,
        num_tasks = 4,
        auto_cleanup = False
        )

    #
    # Run linmod locally
    #
    linmod_local = rx_lin_mod("ArrDelay ~ DayOfWeek", data = data_source)
    #
    # Run linmod remotely
    #
    linmod = rx_lin_mod("ArrDelay ~ DayOfWeek", data = data_source, compute_context = sql_compute_context)

    # Predict results
    # 
    predict = rx_predict(linmod, data = rx_import(input_data = data_source))
    summary = rx_summary("ArrDelay ~ DayOfWeek", data = data_source, compute_context = sql_compute_context)

Comparaison entre la définition d’une source de données et la définition d’un contexte de calcul

Une source de données est différente d’un contexte de calcul. La source de données définit les données utilisées dans votre code. Le contexte de calcul définit l’emplacement d’exécution du code. Toutefois, ils utilisent certaines informations communes :

  • Les variables Python, telles que sql_query et sql_connection_string, définissent la source des données.

    Transmettez ces variables au constructeur RxSqlServerData pour implémenter l’objet de source de données nommé data_source.

  • Vous créez un objet de contexte de calcul à l’aide du constructeur RxInSqlServer. L’objet de contexte de calcul obtenu est nommé sql_cc.

    Cet exemple réutilise la même chaîne de connexion que celle que vous avez utilisée dans la source de données, en supposant que les données se trouvent sur la même instance SQL Server que celle que vous allez utiliser comme contexte de calcul.

    Toutefois, la source de données et le contexte de calcul peuvent se trouver sur des serveurs différents.

Modification des contextes de calcul

Une fois que vous avez défini un contexte de calcul, vous devez définir le contexte de calcul actif.

Par défaut, la plupart des opérations sont exécutées localement, ce qui signifie que si vous ne spécifiez pas un autre contexte de calcul, les données seront extraites de la source de données et le code s’exécutera dans votre environnement Python actuel.

Vous pouvez définir le contexte de calcul actif de deux façons :

  • En tant qu’argument d’une méthode ou d’une fonction
  • En appelant rx_set_computecontext

Définir le contexte de calcul en tant qu’argument d’une méthode ou d’une fonction

Dans cet exemple, vous définissez le contexte de calcul à l’aide d’un argument de la fonction individuelle rx.

linmod = rx_lin_mod_ex("ArrDelay ~ DayOfWeek", data = data, compute_context = sql_compute_context)

Ce contexte de calcul est réutilisé dans l’appel à rxsummary :

summary = rx_summary("ArrDelay ~ DayOfWeek", data = data_source, compute_context = sql_compute_context)

Définir explicitement un contexte de calcul à l’aide de rx_set_compute_context

La fonction rx_set_compute_context vous permet de basculer entre les contextes de calcul qui ont déjà été définis.

Une fois que vous avez défini le contexte de calcul actif, il reste actif jusqu’à ce que vous le changiez.

Utilisation du traitement parallèle et de la diffusion en continu

Lorsque vous définissez le contexte de calcul, vous pouvez également définir des paramètres qui contrôlent la façon dont les données sont gérées par le contexte de calcul. Ces paramètres diffèrent en fonction du type de source de données.

Pour les contextes de calcul SQL Server, vous pouvez définir la taille du lot ou fournir des indications sur le degré de parallélisme à utiliser dans les tâches en cours d’exécution.

  • L’exemple a été exécuté sur un ordinateur doté de quatre processeurs. Par conséquent, le paramètre num_tasks est défini sur la valeur 4 pour permettre une utilisation maximale des ressources.
  • Si vous définissez cette valeur sur 0, SQL Server utilise la valeur par défaut, qui consiste à exécuter autant de tâches en parallèle que possible, sous les paramètres MAXDOP actuels du serveur. Toutefois, le nombre exact de tâches qui peuvent être allouées dépend de nombreux autres facteurs, tels que les paramètres du serveur, et d’autres travaux en cours d’exécution.

Étapes suivantes

Les didacticiels et exemples Python supplémentaires ci-dessous présentent des scénarios de bout en bout utilisant des sources de données plus complexes, ainsi que l’utilisation de contextes de calcul distants.