Compartir a través de


Creación de un cuaderno parametrizado mediante el URI del cuaderno

Importante

Azure Data Studio se retira el 28 de febrero de 2026. Se recomienda usar Visual Studio Code. Para más información sobre la migración a Visual Studio Code, visite ¿Qué sucede con Azure Data Studio?

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

Parametrización de URI

La parametrización de URI agrega parámetros mediante programación a la consulta del URI de Azure Data Studio para abrir el cuaderno en Azure Data Studio con parámetros nuevos.

El URI de cuaderno de Azure Data Studio admite el esquema HTTPS, HTTP y URI DE ARCHIVO, y usa este formato:

azuredatastudio://microsoft.notebook/open?url=

Para pasar parámetros con un URI de cuaderno de Azure Data Studio, use este formato:

azuredatastudio://microsoft.notebook/open?url=LinkToNotebook?x=1&y=2

En la consulta de URI, use & para indicar un nuevo parámetro que se va a insertar.

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.

Estos son el contenido y la estructura del cuaderno:

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

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. La primera celda de código debe etiquetarse con parámetros. Si usa un archivo de cuaderno nuevo, cree una celda de código. Seleccione Parámetros para etiquetar la celda como una celda de parámetros.

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

  2. Puede usar la barra de búsqueda de cualquier explorador o una celda de Markdown para abrir el vínculo del URI del cuaderno. Con el URI del cuaderno de Azure Data Studio (que se muestra a continuación), puede parametrizar el cuaderno de entrada de ejemplo en GitHub.

    Copie el URI del cuaderno siguiente para parametrizar el cuaderno de entrada de ejemplo en GitHub con los valores nuevos de x e y. Pegue el URI en una barra de búsqueda del explorador:

    azuredatastudio://microsoft.notebook/open?url=https://raw.githubusercontent.com/microsoft/sql-server-samples/master/samples/applications/azure-data-studio/parameterization.ipynb?x=10&y=20

    Captura de pantalla en la que se muestra el vínculo del URI en una barra de búsqueda del explorador

    Cuando abra el vínculo desde el explorador web, se le pedirá que abra el cuaderno en Azure Data Studio. Seleccione Open Azure Data Studio (Abrir Azure Data Studio).

    Captura de pantalla en la que se muestra la solicitud de descarga

  3. Se le pedirá que descargue y abra el cuaderno con los parámetros nuevos.

    Seleccione y consulte el cuaderno parametrizado nuevo. 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: