Creación y ejecución de un cuaderno de SQL Server

Se aplica a: SQL Server 2019 (15.x)

En este tutorial se muestra cómo crear y ejecutar un cuaderno en Azure Data Studio con SQL Server.

Prerrequisitos

• Azure Data Studio instalado
• SQL Server instalado
  • Windows
  • Linux

Creación de un cuaderno

En los pasos siguientes, se muestra cómo crear un archivo de cuaderno en Azure Data Studio:

1. En Azure Data Studio, conéctese a su instancia de SQL Server.

2. Seleccione las Conexiones en la ventana Servidores. Después, seleccione Nuevo cuaderno.

3. Espere hasta que se rellenen el Kernel y el contexto del destino (Conectar a). Confirme que Kernel está establecido en SQL y establezca Adjuntar a en la instancia de SQL Server (en este ejemplo, su localhost).

   

Puede guardar el cuaderno mediante los comandos Guardar o Guardar como... del menú Archivo.

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.

Cambio de la conexión SQL

Para cambiar la conexión SQL de un cuaderno:

1. Seleccione el menú Adjuntar a en la barra de herramientas del cuaderno y elija Cambiar conexión.

   

2. Ahora puede seleccionar un servidor de conexión reciente o especificar nuevos detalles de conexión para conectarse.

Ejecución de una celda de código

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. Cuando la celda termine de ejecutarse, los resultados se mostrarán en el cuaderno.

Por ejemplo:

1. Para agregar una nueva celda de código, seleccione el comando +Código de la barra de herramientas.

   

2. Copie y pegue el ejemplo siguiente en la celda y haga clic en Ejecutar celda. En este ejemplo se crea una base de datos.

   USE master
   GO
   
   -- Drop the database if it already exists
   IF  EXISTS (
           SELECT name
           FROM sys.databases
           WHERE name = N'TestNotebookDB'
      )
   DROP DATABASE TestNotebookDB
   GO
   
   -- Create the database
   CREATE DATABASE TestNotebookDB
   GO
   

   

Guardado de un resultado

Si ejecuta un script que devuelve un resultado, puede guardarlo en distintos formatos mediante la barra de herramientas que se muestra sobre el resultado.

• Guardar como CSV
• Guardar como Excel
• Guardar como JSON
• Guardar como XML

Por ejemplo, el código siguiente devuelve el resultado de PI.

SELECT PI() AS PI;
GO

Pasos siguientes

Obtenga más información sobre los cuadernos:

• Uso de cuadernos en Azure Data Studio
• Creación y ejecución de un cuaderno de Python
• Ejecución de un cuaderno de ejemplo con Spark