Compartir a través de

Creación de un cuaderno parametrizado mediante la acción Ejecutar con parámetros

  • Artículo

La parametrización en Azure Data Studio ejecuta el mismo cuaderno con un conjunto de parámetros diferente.

En este artículo se explica cómo crear y ejecutar un cuaderno parametrizado en Azure Data Studio con el kernel de Python.

Nota

Actualmente, puede usar la parametrización con Python, PySpark, PowerShell y kernels interactivos de .NET.

Requisitos previos

Acción Ejecutar con parámetros

Cuando usa la acción de cuaderno Ejecutar con parámetros, el usuario puede indicar parámetros nuevos en la UI a fin de establecerlos rápidamente para el cuaderno. A continuación, el usuario puede ejecutar el cuaderno con los parámetros nuevos.

Nota

Es importante dar formato a la celda del parámetro con cada parámetro nuevo en una línea nueva.

Ejemplo de parametrización

Puede usar un archivo de cuaderno de ejemplo para seguir los pasos de este artículo:

  1. Vaya al archivo de cuaderno en GitHub. Seleccione Raw.
  2. Seleccione Ctrl+S o haga clic con el botón derecho y guarde el archivo con la extensión .ipynb.
  3. Abra el archivo en Azure Data Studio.

Configuración de un cuaderno para su parametrización

Puede comenzar con el cuaderno de ejemplo abierto en Azure Data Studio o seguir los pasos a continuación para crear otro. Luego, pruebe a usar parámetros diferentes. Todos los pasos se ejecutan dentro de un cuaderno de Azure Data Studio.

  1. Cree un nuevo notebook. Establezca el valor Kernel en Python 3:

    Captura de pantalla en la que se muestran la opción de menú Nuevo cuaderno y el establecimiento del valor Kernel en Python 3

  2. Si se le solicita que actualice los paquetes de Python cuando los paquetes deban actualizarse, seleccione Sí:

    Captura de pantalla en la que se muestra la solicitud del cuadro de diálogo para actualizar los paquetes de Python

  3. Compruebe que el valor Kernel esté establecido en Python 3:

    Captura de pantalla en la que se muestra el valor Kernel establecido en Python 3

  4. Cree una celda de código. Seleccione Parámetros para etiquetar la celda como una celda de parámetros.

    x = 2.0
y = 5.0

    Captura de pantalla en la que se muestra la creación de una celda de parámetros con la opción Parámetros seleccionada

  5. Agregue otras celdas para probar diferentes parámetros:

    addition = x + y
multiply = x * y

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

    El resultado será similar al siguiente ejemplo:

    Captura de pantalla en la que se muestra el resultado de las celdas agregadas para probar parámetros nuevos

  6. Guarde el cuaderno como Input.ipynb:

    Captura de pantalla en la que se muestra cómo guardar el archivo de cuaderno

Ejecución del cuaderno con parámetros

  1. En la barra de herramientas del cuaderno, seleccione el icono Ejecutar con parámetros:

    Captura de pantalla en la que se muestra el icono Ejecutar con parámetros seleccionado en la barra de herramientas

  2. Mediante una serie de cuadros de diálogo nuevos se le solicitará que especifique parámetros nuevos para x e y:

    Captura de pantalla en la que se muestra cómo especificar un parámetro nuevo para x

    Captura de pantalla en la que se muestra cómo especificar un parámetro nuevo para y

  3. Después de especificar los parámetros nuevos, consulte el nuevo cuaderno parametrizado. En la barra de herramientas, seleccione Ejecutar todas para ejecutar todas las celdas y ver el resultado nuevo. En una celda nueva con la etiqueta # Injected-Parameters se incluyen los valores de parámetro nuevos que se han pasado:

    Captura de pantalla en la que se muestra el resultado de los parámetros nuevos

Pasos siguientes

Obtenga más información sobre los cuadernos y la parametrización: