Inicio rápido: Ejecución de la primera consulta con la extensión MSSQL para Visual Studio Code

En este inicio rápido, usará la extensión MSSQL para Visual Studio Code para ejecutar las primeras instrucciones de Transact-SQL (T-SQL) en una base de datos. Utiliza una base de datos de desarrollo existente o crea una, define una tabla, inserta datos de muestra y consulta los resultados.

Prerequisites

Para completar este inicio rápido necesita instalar:

Si ya tienes una base de datos de desarrollo, reutilízala. De lo contrario, elige una ruta de configuración:

Conectarse a la base de datos

Antes de ejecutar una consulta, conéctese a la base de datos desde el Explorador de objetos. El cuadro de diálogo Conexión le guía por escribir un nombre de servidor, seleccionar un tipo de autenticación y seleccionar una base de datos (opcionalmente). Para ver un tutorial completo de tipos de entrada, métodos de autenticación y administración de conexiones, consulte Conexión a una base de datos con la extensión MSSQL para Visual Studio Code.

Después de conectarse, el servidor aparece en el Explorador de objetos y puede empezar a ejecutar consultas.

Utilizar una base de datos existente

Si ya has provisionado una base de datos gratuita de Azure SQL Database, conéctate directamente a esa base de datos. En el cuadro de diálogo de Conexión, selecciona o introduce el nombre de la conexión en el campo Base de datos en lugar de dejar seleccionada la base de datos predeterminada. También puedes usar esta ruta para otra base de datos de desarrollo existente, incluyendo una base de datos SQL en Fabric.

  1. Abre un nuevo editor de consultas conectado a la base de datos que elijas.

  2. Ejecuta esta consulta para comprobar la base de datos activa del editor:

    SELECT DB_NAME() AS current_database;
    
  3. Confirma que el resultado coincide con la base de datos que pretendes usar. Si no es así, selecciona la conexión correcta a la base de datos y comprueba de nuevo antes de ejecutar cualquier sentencia de ejemplo.

  4. Salta Crear una base de datos y continúa con Crear una tabla. Mantén la misma conexión a la base de datos para los pasos restantes.

Important

La siguiente CREATE DATABASE Library instrucción no provisiona una base de datos bajo el Azure SQL Database free tier. No lo uses para la ruta del nivel gratuito. Crea la tabla del tutorial dentro de la base de datos gratuita que ya has provisionado; no restaures ni importes otra base de datos.

Creación de una base de datos

Si necesitas una nueva base de datos en SQL Server o Azure SQL Managed Instance, crea una base de datos llamada Library. Si ya tienes una base de datos de desarrollo, usa usar una base de datos existente en su lugar.

Important

Este paso crea una base de datos genérica, no una base de datos de nivel gratuito. Añadir otra base de datos en la nube puede conllevar cargos. Revisa los precios del servicio y tus permisos antes de continuar.

  1. Abra un nuevo editor de consultas: presione Ctrl+N para abrir un nuevo editor de consultas o haga clic con el botón derecho en el servidor y seleccione Nueva consulta.

  2. Cree la base de datos. Pegue el siguiente fragmento de código en el editor de consultas y seleccione Ejecutar:

    IF NOT EXISTS (SELECT name
                   FROM sys.databases
                   WHERE name = N'Library')
        CREATE DATABASE Library;
    

    Este script crea una nueva base de datos denominada Library si aún no existe.

La nueva base de datos Library aparece en la lista de bases de datos. Si no lo ve inmediatamente, actualice el Explorador de objetos.

Crear una tabla

Crea la tabla Authors dentro de tu base de datos de desarrollo existente o de la base de datos Library que has creado.

Important

Ejecuta cada paso por separado y para si una sentencia falla. Si dbo.Authors ya existe, no lo uses ni lo borres para este inicio rápido. Elige una base de datos de desarrollo diferente o cambia el nombre de la tabla de forma consistente en todas las sentencias de ejemplo antes de continuar.

  1. Asegúrate de que el editor de consultas esté conectado a la base de datos que elijas. Para la ruta del nivel gratuito, usa el nombre de la base de datos gratuita, no Library o master. Ejecuta SELECT DB_NAME() AS current_database; de nuevo si abres otro editor o cambias las conexiones.

  2. Cree la tabla. Reemplace el texto de la ventana de consulta con el fragmento de código siguiente y seleccione Ejecutar:

    CREATE TABLE dbo.Authors
    (
        id INT IDENTITY (1, 1) NOT NULL PRIMARY KEY,
        first_name NVARCHAR (100) NOT NULL,
        middle_name NVARCHAR (100) NULL,
        last_name NVARCHAR (100) NOT NULL
    );
    

Este script crea la tabla Authors con una columna IDENTITY para id, que genera automáticamente identificadores únicos.

Insertar filas

A continuación, inserte datos en la Authors tabla.

  1. Reemplace el texto de la ventana de consulta con el fragmento de código siguiente y seleccione Ejecutar:

    INSERT INTO dbo.Authors (first_name, middle_name, last_name)
    VALUES ('Isaac', 'Yudovick', 'Asimov'),
           ('Arthur', 'Charles', 'Clarke'),
           ('Herbert', 'George', 'Wells'),
           ('Jules', 'Gabriel', 'Verne'),
           ('Philip', 'Kindred', 'Dick');
    

Los datos de ejemplo se agregan a la Authors tabla.

Visualización de los datos

Para comprobar los datos de la tabla Authors, ejecute la consulta siguiente:

SELECT *
FROM dbo.Authors
ORDER BY id;

Después de una inserción exitosa en la nueva tabla, espera cinco filas en este orden:

id primer nombre segundo nombre apellido
1 Isaac Yudovick Asimov
2 Arthur Charles Clarke
3 Herbert George Wells
4 Jules Gabriel Verne
5 Philip Kindred Dick

Limpieza de recursos

Elimina solo la tabla de ejemplo que creaste en este inicio rápido.

  1. Ejecuta SELECT DB_NAME() AS current_database; y confirma que estás conectado a la base de datos donde creaste la tabla.

  2. Confirma que lo creaste dbo.Authors durante este recorrido guiado y que ya no necesitas sus datos de muestra. No continúes si la creación de la tabla falló o si la tabla pertenece a otro proyecto.

  3. Ejecuta la siguiente instrucción para eliminar esa tabla:

    DROP TABLE dbo.Authors;
    

No descartes una base de datos existente, incluida la base de datos del nivel gratuito que has provisionado, como parte de esta limpieza de ejemplo.

Si usas el nivel gratuito, controla tu cupo restante y revisa el comportamiento de pausa y sobrecostes. Desconecta los editores de consultas y la conexión del Explorador de objetos cuando termines. Las sesiones abiertas pueden evitar la pausa automática en reposo; desconectar no restaura los segundos de vCore ya consumidos. Una consulta exitosa no establece compatibilidad de carga de trabajo ni garantiza que el uso futuro se mantenga dentro de la asignación gratuita.