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

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

  • Статья

Параметризация в 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:

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

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

    Screenshot that shows the dialog prompt to update Python packages.

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

    Screenshot that shows the Kernel value to Python 3.

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

    x = 2.0
y = 5.0

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

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

    addition = x + y
multiply = x * y

    print("Addition: " + str(addition))
print("Multiplication: " + str(multiply))

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

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

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

    Screenshot that shows saving the notebook file.

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

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

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

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

    Screenshot that shows entering a new parameter for x.

    Screenshot that shows entering a new parameter for y.

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

    Screenshot that shows the output for new parameters.

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

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