Partage via


Créer un notebook paramétrisé avec l’action Exécuter avec des paramètres

Dans Azure Data Studio, la paramétrisation permet d’exécuter un même notebook avec un ensemble différent de paramètres.

Cet article vous montre comment créer et exécuter un notebook paramétrisé dans Azure Data Studio à l’aide du noyau Python.

Notes

Vous pouvez utiliser la paramétrisation avec les noyaux Python, PySpark, PowerShell et .NET interactif.

Prérequis

Action Exécuter avec des paramètres

Lorsque vous utilisez l’action de notebook Exécuter avec des paramètres, vous pouvez entrer de nouveaux paramètres dans l’interface utilisateur afin de définir rapidement de nouveaux paramètres pour votre notebook. L’utilisateur peut ensuite exécuter le notebook avec les nouveaux paramètres.

Notes

Il est important de placer la cellule de chaque nouveau paramètre sur une nouvelle ligne.

Exemple de paramétrisation

Vous pouvez utiliser un exemple de fichier de notebook pour suivre les étapes décrites dans cet article :

  1. Accédez au fichier de notebook dans GitHub. Sélectionnez Raw.
  2. Sélectionnez CTRL + S ou cliquez avec le bouton droit, puis enregistrez le fichier avec l’extension .ipynb.
  3. Ouvrez le fichier dans Azure Data Studio.

Préparer un notebook à la paramétrisation

Vous pouvez commencer par l’exemple de notebook qui est ouvert dans Azure Data Studio ou suivre les étapes ci-dessous pour créer un notebook. Essayez ensuite d’utiliser des paramètres différents. Toutes les étapes s’exécutent à l’intérieur d’un notebook Azure Data Studio.

  1. Créer un nouveau bloc-notes. Remplacez la valeur de Noyau par Python 3 :

    Screenshot that shows the New notebook menu option and setting the Kernel value to Python 3.

  2. Si vous êtes invité à mettre à niveau vos packages Python quand ceux-ci doivent être mis à jour, sélectionnez Oui :

    Screenshot that shows the dialog prompt to update Python packages.

  3. Vérifiez que Python 3 est sélectionné comme Noyau :

    Screenshot that shows the Kernel value to Python 3.

  4. Créez une nouvelle cellule de code. Sélectionnez Paramètres pour étiqueter la cellule en tant que cellule de paramètre.

    x = 2.0
    y = 5.0
    

    Screenshot that shows creating a new parameters cell with Parameters selected.

  5. Ajoutez d’autres cellules pour tester différents paramètres :

    addition = x + y
    multiply = x * y
    
    print("Addition: " + str(addition))
    print("Multiplication: " + str(multiply))
    

    Le résultat ressemble à l’exemple suivant :

    Screenshot that shows the output of cells added to test new parameters.

  6. Enregistrez le notebook dans un fichier Input.ipynb :

    Screenshot that shows saving the notebook file.

Exécuter le notebook avec des paramètres

  1. Dans la barre d’outils du notebook, sélectionnez l’icône Exécuter avec des paramètres :

    Screenshot that shows the Run with Parameters icon selected on the toolbar.

  2. Une suite de nouvelles boîtes de dialogue vous invitent à entrer de nouveaux paramètres pour x et y :

    Screenshot that shows entering a new parameter for x.

    Screenshot that shows entering a new parameter for y.

  3. Une fois que vous avez entré les nouveaux paramètres, affichez le nouveau notebook paramétrisé. Dans la barre d’outils, sélectionnez Tout exécuter pour exécuter toutes les cellules et voir la nouvelle sortie. Une nouvelle cellule étiquetée # Injected-Parameters contient les nouvelles valeurs de paramètre qui ont été passées :

    Screenshot that shows the output for new parameters.

Étapes suivantes

Découvrez-en plus sur les notebooks et le paramétrage :