Tutorial: Crear y ejecutar un script Transact-SQL simple

Artículo
10/07/2008

Actualización: noviembre 2007

En este tutorial, va crear y a ejecutar un script sencillo de T-SQL (Transact-SQL) para la base de datos de ejemplo Northwind desde el editor de T-SQL en Visual Studio Team System Database. En el tutorial se explican las siguientes tareas:

Abrir una sesión del editor de Transact-SQL.
Conectar con la base de datos de ejemplo Northwind.
Ejecutar una consulta individual para comprobar que la conexión funciona correctamente.
Desconectar de la base de datos y trabajar sin conexión.
Actualizar la secuencia de comandos para agregar varias instrucciones T-SQL.
Validar la sintaxis T-SQL de la secuencia de comandos para identificar y corregir los errores.
Ejecutar la secuencia de comandos y examinar los resultados devueltos.
Guardar la secuencia de comandos.

Requisitos previos

Debe tener instalada la base de datos de ejemplo Northwind en la instancia de Microsoft SQL Server 2000 o Microsoft SQL Server 2005 del equipo local.

Para abrir una sesión del editor de Transact-SQL.

En el menú Datos, elija Editor de T-SQL y haga clic en Nueva conexión de consulta.

Se abre el editor de Transact-SQL y aparece el cuadro de diálogo Conectar con base de datos sobre el editor.

A continuación, debe proporcionar la información de conexión con la base de datos Northwind.

Para conectar con la base de datos Northwind

Si definió previamente una conexión con la base de datos Northwind, haga clic en la conexión en la lista Cadena de conexión y vaya al paso 6.
Si no definió previamente una cadena de conexión para la base de datos Northwind, haga clic en Nueva conexión.

Aparece el cuadro de diálogo Propiedades de la conexión.
Escriba o haga clic en (local) como servidor de base de datos.
Haga clic en Utilizar autenticación de Windows para seleccionarlo como método de autenticación para conectar con el servidor.
En Seleccione o escriba el nombre de la base de datos, escriba o haga clic en Northwind y, a continuación, haga clic en Aceptar.

Se cierra el cuadro de diálogo Propiedades de conexión y vuelve al cuadro de diálogo Conectar a base de datos.
Haga clic en Aceptar para confirmar su opción de conexión de base de datos.

Se cierra el cuadro de diálogo Conectar a base de datos y el editor de Transact-SQL vuelve a estar disponible con la conexión a la base de datos Northwind.

A continuación, compruebe la conexión ejecutando la simple instrucción SELECT.

Para comprobar la conexión

Escriba SELECT * FROM [dbo].[Suppliers] en el editor de Transact-SQL.
En el menú Datos, elija Editor de T-SQL y haga clic en Ejecutar SQL.

Aparecerá el panel de resultados, que mostrará los resultados de la consulta en una cuadrícula.

A continuación, se desconectará del servidor de la base de datos y trabajará sin conexión.

Para desconectarse del servidor y trabajar sin conexión

En el menú Datos, elija Editor de T-SQL, Conexión y, a continuación, haga clic en Desconectar.

La sesión del editor se desconecta del servidor. El título de la ventana cambia a SQLQuery_N.sql - Desconectado, donde N es un número asignado de manera secuencial. El explorador de propiedades refleja que está trabajando en un estado desconectado.

A continuación va a modificar la secuencia de comandos T-SQL para incluir varias instrucciones.

Para agregar instrucciones a la secuencia de comandos T-SQL

En el editor de T-SQL, elimine la instrucción SELECT que agregó en un paso anterior.
Escriba lo siguiente en el editor:
```
EXECUTE [dbo].[SalesByCategory] 'Beverages', '1997'
GO
EXE [dbo].[Ten Most Expensive Products]
GO 
```
Nota importante:

Estas instrucciones contienen un error de sintaxis intencionado para ilustrar la validación en el procedimiento siguiente.

A continuación, validará la sintaxis del script.

Nota importante:
Estas instrucciones contienen un error de sintaxis intencionado para ilustrar la validación en el procedimiento siguiente.

Para validar la sintaxis de la secuencia de comandos

Para volver a conectarse a la base de datos, en el menú Datos, elija Editor de T-SQL, Conexión y, a continuación, haga clic en Conectar.

Aparece el cuadro de diálogo Propiedades de conexión, con la información de servidor, autenticación y base de datos. El cuadro de diálogo muestra los valores usados para conectarse en el paso anterior.
Haga clic en Aceptar para volver a conectarse a la misma base de datos y al mismo servidor.
En el menú Datos, elija Editor de T-SQL y haga clic en Validar sintaxis SQL.

Aparece el panel Resultados y muestra la ficha Mensajes. Como la secuencia de comandos que escribió contiene un error (EXE en lugar de EXEC o EXECUTE), aparecerá el error siguiente en la ficha Mensajes:Msg 170, Level 15, State 1, Line 1

Line 1: Incorrect syntax near '.'."
Corrija la segunda instrucción de forma que coincida con la siguiente:
```
EXECUTE [dbo].[Ten Most Expensive Products]
```
En el menú Datos, elija Editor de T-SQL y haga clic en Validar sintaxis SQL para volver a validar la secuencia de comandos.

Aparece Los comandos se completaron correctamente en la ficha Mensajes.

A continuación, vuelva a conectarse a la base de datos, ejecute la secuencia de comandos y examine los resultados.

Para ejecutar la secuencia de comandos y examinar los resultados

Para habilitar las estadísticas de cliente, en el menú Consulta, haga clic en Incluir estadísticas de cliente.
En el menú Datos, elija Editor de T-SQLy haga clic en Ejecutar SQL para ejecutar la secuencia de comandos.

Se muestran los resultados de las dos instrucciones en el panel Resultados. De manera predeterminada, los resultados se muestran en la cuadrícula. Si no ve ambos conjuntos de resultados, puede usar la barra de desplazamiento vertical del extremo derecho del panel Resultados o ajustar el tamaño del panel Resultados con la barra de división.

El procedimiento almacenado SalesByCategory devuelve 12 filas y el procedimiento almacenado Ten Most Expensive Products devuelve 10 filas.
Haga clic en la ficha Mensajes, que muestra los mensajes devueltos por el servidor para cada instrucción ejecutada. En este caso, aparecen los siguientes mensajes:

(12 row(s) affected)

(10 row(s) affected)
Haga clic en la ficha Estadísticas de cliente para mostrar información sobre cada ejecución del script. Aparece una columna cada vez que se ejecuta la secuencia de comandos.
En el menú Datos, elija Editor de T-SQLy haga clic en Ejecutar SQL para ejecutar de nuevo la secuencia de comandos.
Haga clic de nuevo en la ficha Estadísticas de cliente para volver a mostrarla.

Se muestra otra columna para la segunda ejecución y la columna de medias aparece actualizada.

En el paso final, debe guardar la secuencia de comandos.

Para guardar la secuencia de comandos en el disco

En el menú Archivo, haga clic en Guardar SQLQuery_N.sql (N es un número asignado secuencialmente).

Aparece el cuadro de diálogo Guardar archivo como, en el que puede especificar una ruta de acceso y un nombre de archivo para la secuencia de comandos.
En Nombre de archivo, escriba Northwind_Sales.sql.
Haga clic en Guardar para guardar la secuencia de comandos en el disco.

La secuencia de comandos se guarda en el disco. El título de la ventana se actualiza para mostrar el nuevo nombre, que aparece en la información sobre herramientas de la ficha de la ventana.