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

  • Article

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 :

    Capture d’écran qui montre l’option de menu Nouveau notebook, et la définition de la valeur du noyau sur Python 3.

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

    Capture d’écran montrant la boîte de dialogue qui vous invite à mettre à jour les packages Python.

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

    Capture d’écran montrant la valeur du noyau définie sur 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

    Capture d’écran montrant la création d’une cellule de paramètre avec l’option Paramètres sélectionnée.

  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 :

    Capture d’écran montrant la sortie des cellules ajoutées pour tester les nouveaux paramètres.

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

    Capture d’écran montrant du fichier de notebook.

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 :

    Capture d’écran montrant l’icône Exécuter avec des paramètres sélectionnée dans la barre d’outils.

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

    Capture d’écran montrant l’entrée d’un nouveau paramètre pour x.

    Capture d’écran montrant l’entrée d’un nouveau paramètre pour 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 :

    Capture d’écran qui montre la sortie des nouveaux paramètres.

Étapes suivantes

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