Поделиться через


Создание параметризованной записной книжки с помощью действия "Запуск с параметрами"

Параметризация в Azure Data Studio представляет собой запуск той же записной книжки с другим набором параметров.

В этой статье показано, как создать и запустить параметризованную записную книжку в Azure Data Studio с помощью ядра Python.

Примечание.

Сейчас параметризацию можно использовать с ядрами Python, PySpark, PowerShell и .NET Interactive.

Необходимые компоненты

Действие "Запуск с параметрами"

При использовании действия "Запуск с параметрами" пользователь может быстро задать новые параметры записной книжки в пользовательском интерфейсе. Затем пользователь может запустить записную книжку с новыми параметрами.

Примечание.

Важно отформатировать ячейку параметра таким образом, чтобы каждый параметр находился на новой строке.

Пример параметризации

Для выполнения действий, описанных в этой статье, можно использовать пример файла записной книжки:

  1. Перейдите к файлу записной книжки в GitHub. Выберите Raw (Необработанный формат).
  2. Нажмите CTRL+S или щелкните правой кнопкой мыши и сохраните файл с расширением .ipynb.
  3. Откройте файл в Azure Data Studio.

Настройка записной книжки для параметризации

Вы можете начать с примера записной книжки, открытой в Azure Data Studio, или выполнить следующие действия, чтобы создать записную книжку. Затем попробуйте использовать различные параметры. Все действия выполняются в записной книжке Azure Data Studio.

  1. Создайте новую записную книжку. Для параметра Ядро установите значение Python 3:

    Снимок экрана, на котором показан пункт меню

  2. Если вам будет предложено обновить пакеты Python, требующие обновления, выберите Да:

    Снимок экрана, на котором показан запрос на обновление пакетов Python.

  3. Убедитесь, что для параметра Ядро установлено значение Python 3:

    Снимок экрана, на котором показано значение

  4. Создайте новую ячейку кода. Выберите Параметры, чтобы пометить ячейку как ячейку параметров.

    x = 2.0
    y = 5.0
    

    Снимок экрана, на котором показано создание ячейки параметров с выбранным элементом

  5. Добавьте другие ячейки для тестирования различных параметров:

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

    Выходные данные будут выглядеть приблизительно так:

    Снимок экрана, на котором показаны выходные данные ячеек, добавленных для проверки новых параметров.

  6. Сохраните записную книжку в файле Input.ipynb.

    Снимок экрана, на котором показано сохранение файла записной книжки.

Запуск записной книжки с параметрами

  1. На панели инструментов записной книжки нажмите на значок Запуск с параметрами:

    Снимок экрана, на котором показан значок

  2. Откроется несколько диалоговых окон с предложением ввести новые параметры для x и y:

    Снимок экрана, на котором показан ввод нового параметра для x.

    Снимок экрана, на котором показан ввод нового параметра для y.

  3. После ввода новых параметров просмотрите новую параметризованную записную книжку. На панели инструментов выберите команду Запустить все, чтобы выполнить все ячейки и просмотреть новые выходные данные. Новая ячейка с меткой # Injected-Parameters содержит новые значения параметров, которые были переданы:

    Снимок экрана, на котором показаны выходные данные для новых параметров.

Следующие шаги

Дополнительные сведения о записных книжках и параметризации: