Compartir vía


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

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).

    Establecer el Kernel y Conectar a

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.

    Selección del menú

  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.

    Barra de herramientas Cuaderno

  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
    

    Ejecución de una celda

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

Guardado de un resultado

Pasos siguientes

Obtenga más información sobre los cuadernos: