Ventana del Editor de consultas del motor de base de datos de SQL Server Management Studio

Use el Editor de consultas del Motor de base de datos para crear y ejecutar scripts de Transact-SQL y sqlcmd.

Obtener ayuda de Transact-SQL

Este tema es la ubicación predeterminada de la Ayuda de F1 cuyo origen es la ventana Editor de consultas de motor de base de datos. Si selecciona F1 después de resaltar texto en el editor que no coincida con ninguna palabra clave de la Ayuda de F aplicada a cualquier tema de referencia de Transact-SQL, la Ayuda de F1 muestra este tema. En ese caso, hay dos métodos para obtener ayuda adicional:

  • Copiar y pegar la cadena del editor que resaltó en la pestaña de búsqueda de los Libros en pantalla de SQL Server y realizar una búsqueda.

  • Resaltar solo la parte de la instrucción Transact-SQL que sea más probable que coincida con una palabra clave F aplicada a un tema y vuelva a seleccionar F1. Entre los ejemplos de cadenas que se van a resaltar se incluyen los siguientes:

    • El nombre de una instrucción Transact-SQL, como CREATE DATABASE o BEGIN TRANSACTION.

    • El nombre de una función integrada, como SERVERPROPERTY o @@VERSION.

    • El nombre de una tabla de procedimiento almacenado del sistema o de una vista, como sys.data_spaces o sp_tableoption.

Características

  • Escriba scripts en la ventana del Editor de consultas.

  • Para ejecutar scripts, presione F5 o haga clic en Ejecutar en la barra de herramientas, o haga clic en Ejecutar en el menú Consulta. Si se selecciona una parte del código, solo se ejecutará dicha parte. Si no se selecciona ningún código, se ejecutará todo el código del Editor de consultas.

  • Para obtener ayuda sobre la sintaxis de Transact-SQL, seleccione una palabra clave en el Editor de consultas y, a continuación, haga clic en F1.

  • Para obtener ayuda dinámica sobre la sintaxis de Transact-SQL, en el menú Ayuda haga clic en Ayuda dinámica. Se abre el componente Ayuda dinámica. Con la Ayuda dinámica, los temas de Ayuda aparecen en la ventana Ayuda dinámica al escribir palabras clave en el Editor de consultas.

  • El Editor de consultas admite la funcionalidad de IntelliSense, como la finalización automática de palabras y de parámetros. Para obtener más información, vea Usar IntelliSense.

    Nota

    Si se habilita IntelliSense para los scripts de gran tamaño de Transact-SQL, se puede disminuir el rendimiento en equipos lentos. Para obtener más información acerca de cómo limitar el tamaño de los scripts de Transact-SQL para los que está habilitado IntelliSense, vea Opciones (Editor de texto/Transact-SQL/IntelliSense).

  • El Editor de consultas proporciona el depurador de Transact-SQL que puede utilizar para ayudar a depurar los scripts e instrucciones de Transact-SQL. Para obtener más información, vea Utilizar el depurador de Transact-SQL.

  • Se muestran mensajes de errores en las áreas siguientes:

    • En una pestaña Mensajes en la parte inferior de la ventana, los errores que devuelve SQL Server Database Engine (Motor de base de datos de SQL Server).

    • En la ventana Lista de errores, los errores que se generan a través de IntelliSense. Para obtener más información, vea Ventana Lista de errores (Management Studio).

    • En las ventanas Salida o Inmediato, los errores que genera el depurador de Transact-SQL.

Barra de herramientas del Editor SQL

Cuando el Editor de consultas de Motor de base de datos está abierto, la barra de herramientas del Editor SQL aparece con los botones siguientes.

  • Conectar
    Se abre el cuadro de diálogo Conectar al servidor. Utilice este cuadro de diálogo para establecer una conexión a un servidor.

  • Desconectar
    Desconecta el Editor de consultas actual del servidor.

  • Cambiar conexión
    Se abre el cuadro de diálogo Conectar al servidor. Utilice este cuadro de diálogo para establecer una conexión a un servidor diferente.

  • Consulta con conexión actual
    Abre una nueva ventana del Editor de consultas y usa la información de conexión de la ventana actual del Editor de consultas.

  • Bases de datos disponibles
    Cambia la conexión a una base de datos distinta del mismo servidor.

  • Ejecutar
    Ejecuta el código seleccionado o, si no se ha seleccionado ningún código, ejecuta todo el código del Editor de consultas.

  • Depuración
    Habilita el depurador de Transact-SQL. Este depurador admite acciones de depuración como establecer puntos de interrupción, inspeccionar variables y recorrer el código.

  • Cancelar ejecución de la consulta
    Envía una solicitud de cancelación al servidor. Algunas consultas no pueden cancelarse inmediatamente, sino que deben esperar a una condición de cancelación adecuada. Cuando se cancelan las transacciones, podrían producirse retrasos mientras se revierten.

  • Analizar
    Comprueba la sintaxis del código seleccionado. Si no se ha seleccionado ningún código, comprueba la sintaxis de todo el código en la ventana del Editor de consultas.

  • Mostrar plan de ejecución estimado
    Solicita un plan de ejecución de consulta desde el procesador de consultas sin ejecutar realmente la consulta y muestra el plan en la ventana Plan de ejecución. Este plan utiliza estadísticas de índice para calcular el número de filas que se prevé que van a devolverse en cada parte de la ejecución de la consulta. El plan de consultas real que se utiliza puede ser diferente del plan de ejecución calculado. Esto puede ocurrir si el número de filas que se devuelven es significativamente diferente del calculado y el procesador de consultas cambia el plan para obtener una mayor eficacia.

  • Opciones de consulta
    Abre el cuadro de diálogo Opciones de consulta. Use este cuadro de diálogo para configurar las opciones predeterminadas de la ejecución de consultas y los resultados de las mismas.

  • IntelliSense habilitado
    Especifica si la funcionalidad de IntelliSense está disponible en el Editor de consultas de Motor de base de datos.

  • Incluir plan de ejecución real
    Ejecuta la consulta, devuelve los resultados de la consulta y el plan de ejecución que se usó para la consulta. Se muestran como un plan de consultas gráfico en la ventana Plan de ejecución.

  • Incluir estadísticas de cliente
    Incluye una ventana Estadísticas de clientes que contiene estadísticas sobre la consulta y los paquetes de red, así como el tiempo transcurrido de la consulta.

  • Resultados a texto
    Devuelve los resultados de la consulta como texto en la ventana Resultados.

  • Resultados a cuadrícula
    Devuelve los resultados de la consulta como una o varias cuadrículas en la ventana Resultados.

  • Resultados a archivo
    Cuando se ejecuta la consulta, se abre el cuadro de diálogo Guardar resultados. En Guardar en, seleccione la carpeta en la que desea guardar el archivo. En Nombre de archivo, escriba el nombre del archivo y, a continuación, haga clic en Guardar para guardar los resultados de la consulta como un archivo Informe que tenga la extensión .rpt. Para obtener acceso a las opciones avanzadas, haga clic en la flecha abajo del botón Guardar y, a continuación, haga clic en Guardar con codificación.

  • Selección con comentarios
    Convierte la línea actual en comentario agregando al principio de la línea un operador de comentario (--).

  • Selección sin comentarios
    Convierte la línea actual en una instrucción de código activo quitando los operadores de comentario (--) del principio de la línea.

  • Reducir sangría de línea
    Mueve el texto de la línea a la izquierda quitando los espacios en blanco al principio de la línea.

  • Aumentar sangría de línea
    Mueve el texto de la línea a la derecha agregando espacios en blanco al principio de la línea.

  • Especificar valores para parámetros de plantilla
    Abre un cuadro de diálogo que puede utilizar para especificar los valores de los parámetros en los procedimientos almacenados y funciones.

También puede agregar la barra de herramientas del Editor SQL seleccionando el menú Ver y, a continuación, las opciones Barras de herramientas y Editor SQL. Si agrega la barra de herramientas del Editor SQL cuando no hay ninguna ventana del Editor de consultas de Motor de base de datos abierta, no habrá ningún botón disponible.

Barra de herramientas del Editor SQL

Cuando se abre una ventana del Editor de consultas de Motor de base de datos, puede agregar la barra de herramientas Depurar seleccionando el menú Ver, seleccionando Barras de herramientas y seleccionando a continuación Depurar. Si agrega la barra de herramientas Depurar cuando no hay ninguna ventana del Editor de consultas de Motor de base de datos abierta, no habrá ningún botón disponible.

  • Continuar
    Ejecuta el código en la ventana del Editor de consultas de Motor de base de datos hasta que se encuentre un punto de interrupción. 

  • Interrumpir todos
    Establece el depurador para interrumpir todos los procesos a los que está asociado cuando se produce una interrupción.

  • Detener depuración
    Saca la ventana del Editor de consultas de Motor de base de datos seleccionada del modo de depuración y restaura el modo de ejecución estándar.

  • Mostrar la instrucción siguiente
    Mueve el cursor a la siguiente instrucción que se va a ejecutar.

  • Depurar paso a paso por instrucciones
    Ejecuta la instrucción siguiente a la actual. Si la siguiente instrucción invoca un procedimiento almacenado, función o desencadenador de Transact-SQL, el depurador muestra una nueva ventana del Editor de consultas que contiene el código del módulo. La ventana está en el modo de depuración y la ejecución se pausa en la primera instrucción del mismo. Después puede desplazarse por el código del módulo, por ejemplo, estableciendo puntos de interrupción o recorriendo el código.

  • Paso a paso por procedimientos
    Ejecuta la instrucción siguiente a la actual. Si la instrucción invoca un procedimiento almacenado, una función o un desencadenador de Transact-SQL, el módulo se ejecuta hasta que se completa y los resultados se devuelven al código de llamada. Si está seguro de que no hay errores en el módulo, puede omitirlo. La ejecución se detiene en la instrucción que sigue a la llamada al módulo.

  • Paso a paso para salir
    Vuelve al nivel de la siguiente llamada superior (función, procedimiento almacenado o desencadenador). La ejecución se pausa en la instrucción que sigue a la llamada al módulo.

  • Windows
    Abre la ventana Punto de interrupción o la ventana Inmediato.

Historial de cambios

Contenido actualizado

Se han corregido las descripciones de Depurar paso a paso por instrucciones y paso a paso por procedimientos.