Creación y ejecución de un cuaderno de PythonCreate and run a Python notebook

Se aplica a:Applies to: síSQL Server 2019 (15.x)SQL Server 2019 (15.x)yesSQL Server 2019 (15.x)SQL Server 2019 (15.x)Se aplica a:Applies to: síSQL Server 2019 (15.x)SQL Server 2019 (15.x)yesSQL Server 2019 (15.x)SQL Server 2019 (15.x)

En este tutorial se muestra cómo crear y ejecutar un cuaderno en Azure Data Studio con Python.This tutorial demonstrates how to create and run a notebook in Azure Data Studio using the Python kernel.

PrerrequisitosPrerequisites

Creación de un cuadernoCreate a notebook

En los pasos siguientes, se muestra cómo crear un archivo de cuaderno en Azure Data Studio:The following steps show how to create a notebook file in Azure Data Studio:

  1. Abra Azure Data Studio.Open Azure Data Studio. Si se le pide que se conecte a un servidor SQL Server, puede conectarse o hacer clic en Cancelar.If you're prompted to connect to a SQL Server, you may connect or click Cancel.

  2. Seleccione Nuevo cuaderno en el menú Archivo.Select New Notebook in the File menu.

  3. Seleccione Python 3 para Kernel.Select Python 3 for the Kernel. Adjuntar a está establecido en "localhost".Attach to is set to "localhost".

    Establecimiento del kernel

Puede guardar el cuaderno mediante los comandos Guardar o Guardar como... del menú Archivo.You can save the notebook using the Save or Save as... command from the File menu.

Para abrir un cuaderno, puede usar el comando Abrir archivo... del menú Archivo, seleccionar Abrir archivo en la página de bienvenida o usar el comando Archivo: Abrir de la paleta de comandos.To open a notebook, you can use the Open file... command in the File menu, select Open file on the Welcome page, or use the File: Open command from the command palette.

Cambio del kernel de PythonChange the Python kernel

La primera vez que se conecta al kernel de Python en un cuaderno, se muestra la página Configurar Python para Notebooks.The first time you connect to the Python kernel in a notebook, the Configure Python for Notebooks page is displayed. Puede seleccionar una de las dos opciones siguientes:You can select either:

  • Nueva instalación de Python, para instalar una nueva copia de Python para Azure Data Studio;New Python installation to install a new copy of Python for Azure Data Studio, or
  • Usar la instalación de Python existente, para especificar la ruta de acceso a una instalación existente de Python para que Azure Data Studio la use.Use existing Python installation to specify the path to an existing Python installation for Azure Data Studio to use

Para ver la ubicación y la versión del kernel de Python activo, cree una celda de código y ejecute los siguientes comandos de Python:To view the location and version of the active Python kernel, create a code cell and run the following Python commands:

import os
import sys
print(sys.version_info)
print(os.path.dirname(sys.executable))

Para conectarse a otra instalación de Python:To connect to a different installation of Python:

  1. En el menú Archivo, seleccione Preferencias y, después, Configuración.From the File menu, select Preferences and then Settings.
  2. Desplácese hasta Configuración de Notebook en Extensiones.Scroll to Notebook configuration under Extensions.
  3. En Usar la instalación de Python existente, desactive la opción "Ruta de acceso local a una instalación de Python preexistente utilizada por Notebooks".Under Use Existing Python, uncheck the option "Local path to a preexisting python installation used by Notebooks."
  4. Reinicie Azure Data Studio.Restart Azure Data Studio.

Cuando se inicia Azure Data Studio y se conecta al kernel de Python, se muestra la página Configurar Python para Notebooks. Ahí podrá crear una instalación de Python o especificar una ruta de acceso a una instalación existente.When Azure Data Studio starts and you connect to the Python kernel, the Configure Python for Notebooks page is displayed, You can choose to create a new Python installation or specify a path to an existing installation.

Ejecución de una celda de códigoRun a code cell

Puede crear celdas que contengan código SQL que puede ejecutar de forma local. Para ello, haga clic en el botón Ejecutar celda (la flecha redonda de color negro) a la izquierda de la celda.You can create cells containing SQL code that you can run in place by clicking the Run cell button (the round black arrow) to the left of the cell. Cuando la celda termine de ejecutarse, los resultados se mostrarán en el cuaderno.The results are shown in the notebook after the cell finishes running.

Por ejemplo:For example:

  1. Puede agregar una nueva celda de código de Python seleccionando el comando +Código de la barra de herramientas.Add a new Python code cell by selecting the +Code command in the toolbar.

    Barra de herramientas del cuaderno

  2. Copie y pegue el ejemplo siguiente en la celda y haga clic en Ejecutar celda.Copy and paste the following example into the cell and click Run cell. En este ejemplo se realizan cálculos simples y el resultado se muestra debajo.This example does simple math and the result appears below.

    a = 1
    b = 2
    c = a/b
    print(c)
    

    Ejecución de la celda del cuaderno

Pasos siguientesNext steps

Obtenga más información sobre los cuadernos:Learn more about notebooks: