Extensión SQL Server para Visual Studio Code

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

En este artículo se explica cómo usar la extensión mssql de Visual Studio Code (Visual Studio Code) para trabajar con bases de datos de SQL Server en Windows, macOS y Linux, así como Azure SQL Database, Azure SQL Managed Instance y Azure Synapse Analytics. La extensión mssql de Visual Studio Code permite conectarse a SQL Server, consultar con Transact-SQL (T-SQL) y ver los resultados.

Creación o apertura de un archivo SQL

La extensión mssql habilita los comandos de mssql y T-SQL IntelliSense en el editor de código cuando el modo de lenguaje está establecido en SQL.

1. Seleccione Archivo>Nuevo archivo o presione Ctrl+N. Visual Studio Code abre de forma predeterminada un nuevo archivo de texto sin formato.

2. Seleccione Texto sin formato en la barra de estado inferior o presione Ctrl+K>M y seleccione SQL en la lista desplegable de lenguajes.

   

   Nota

   Si es la primera vez que usa la extensión, esta instala el servicio de herramientas de SQL en segundo plano.

Si abre un archivo existente con una extensión de archivo .sql, el modo de lenguaje se establece automáticamente en SQL.

Conectar a SQL Server

Siga estos pasos para crear un perfil de conexión y conectarse a SQL Server.

1. Presione Ctrl+Mayús+P o F1 para abrir la Paleta de comandos.

2. Escriba sql para mostrar los comandos de mssql o escriba sqlcon y, luego, seleccione MS SQL: Connect (Conectar) en la lista desplegable.

   

   Nota

   Un archivo SQL, como el archivo SQL vacío creado, debe tener el foco en el editor de código para poder ejecutar los comandos de mssql.

3. Seleccione el comando MS SQL: Manage Connection Profiles (Administrar perfiles de conexión).

4. Luego seleccione Crear para crear un nuevo perfil de conexión para SQL Server.

5. Siga los mensajes para especificar las propiedades del nuevo perfil de conexión. Después de especificar cada valor, presione Entrar para continuar.

   Propiedad Conexión	Descripción
   Nombre del servidor o cadena de conexión ADO	Especifique el nombre de la instancia de SQL Server. Use localhost para conectarse a una instancia de SQL Server en el equipo local. Para conectarse a una instancia remota de SQL Server, escriba el nombre del servidor SQL Server de destino o su dirección IP. Para conectarse a un contenedor de SQL Server, especifique la dirección IP del equipo host del contenedor. Si necesita especificar un puerto, use una coma para separarlo del nombre. Por ejemplo, en el caso de un servidor que escucha en el puerto 1401, escriba <servername or IP>,1401. La cadena de conexión usa el puerto 1433 de forma predeterminada. Una instancia predeterminada de SQL Server usa el puerto 1433 a menos que se modifique. Si la instancia escucha en el puerto 1433, no es necesario especificar el puerto. Como alternativa, puede escribir la cadena de conexión ADO de la base de datos aquí.
   Nombre de la base de datos (opcional)	Base de datos que se quiere usar. Para conectarse a la base de datos predeterminada, no especifique aquí ningún nombre de base de datos.
   Tipo de autenticación	Seleccione Integrado o Inicio de sesión de SQL.
   Nombre de usuario	Si ha seleccionado Inicio de sesión de SQL, escriba el nombre de un usuario con acceso a una base de datos en el servidor.
   Contraseña	Escriba la contraseña del usuario especificado.
   Guardar contraseña	Presione Entrar para seleccionar Sí y guardar la contraseña. Seleccione No para que se le pida la contraseña cada vez que se use el perfil de conexión.
   Nombre de perfil (opcional)	Escriba un nombre para el perfil de conexión, como localhost profile.

   Después de escribir todos los valores y seleccionar Entrar, Visual Studio Code crea el perfil de conexión y se conecta a SQL Server.

   Sugerencia

   Si se produce un error en la conexión, intente diagnosticar el problema a partir del mensaje de error del panel Salida de Visual Studio Code. Para abrir el panel Salida, seleccione Ver>Salida. Además, revise las recomendaciones para solucionar problemas de conexión.

6. Compruebe la conexión en la barra de estado inferior.

   

Como alternativa a los pasos anteriores, también puede crear y editar perfiles de conexión en el archivo de configuración de usuario (settings.json). Para abrir el archivo de configuración, seleccione Archivo>Preferencias>Configuración. Para obtener más información, vea Administración de perfiles de conexión.

Cifrado y certificado de servidor de confianza

La extensión mssql para VS Code v1.17.0 y versiones posteriores incluyen un cambio importante en la propiedad Encrypt, que ahora está habilitada (establecida en True) de forma predeterminada para las conexiones del proveedor MSSQL. Además, SQL Server debe configurarse con certificados TLS firmados por una entidad de certificados raíz de confianza. Además, si se produce un error en un intento de conexión inicial con el cifrado habilitado (valor predeterminado), la extensión mssql proporcionará una solicitud de notificación con la opción para intentar la conexión con el certificado de servidor de confianza habilitado. Las propiedades de certificado de servidor Encrypt y Trust también están disponibles para su edición manual en el archivo de configuración de usuario (settings.json). El procedimiento recomendado consiste en facilitar la conexión cifrada de confianza con el servidor.

Los usuarios que se conectan a Azure SQL Database no necesitan cambios en las conexiones guardadas existentes. Azure SQL Database admite conexiones cifradas y está configurada con certificados de confianza.

Si la propiedad Encrypt está establecida en True, los usuarios que se conectan en el entorno local de SQL Server o que conectan SQL Server en una máquina virtual, deben asegurarse de que tienen un certificado de una entidad de certificación de confianza (no un certificado autofirmado, por ejemplo). Como alternativa, puede optar por conectarse sin cifrado (Encrypt establecido en False) o confiar en el certificado del servidor (Encrypt establecido en True y Trust server certificate establecido en True).

Crear una base de datos

1. En el nuevo archivo SQL que ha iniciado anteriormente, escriba sql para mostrar una lista de fragmentos de código modificables.

   

2. Seleccione sqlCreateDatabase.

3. En el fragmento de código, escriba TutorialDB para reemplazar "DatabaseName":

   -- Create a new database called 'TutorialDB'
   -- Connect to the 'master' database to run this snippet
   USE master
   GO
   IF NOT EXISTS (
      SELECT name
      FROM sys.databases
      WHERE name = N'TutorialDB'
   )
   CREATE DATABASE [TutorialDB]
   GO
   

4. Presione Ctrl+Mayús+E para ejecutar los comandos de Transact-SQL. Vea los resultados en la ventana de consulta.

   

   Sugerencia

   Puede personalizar las teclas de método abreviado de los comandos de mssql. Vea Personalización de accesos directos.

Creación de una tabla

1. Elimine el contenido de la ventana del editor de código.

2. Presione Ctrl+Mayús+P o F1 para abrir la Paleta de comandos.

3. Escriba sql para mostrar los comandos de mssql o escriba sqluse y, luego, seleccione el comando MS SQL: Use Database (Usar base de datos).

4. Seleccione la nueva base de datos TutorialDB.

   

5. En el editor de código, escriba sql para mostrar los fragmentos de código, seleccione sqlCreateTable y presione Entrar.

6. En el fragmento de código, escriba Employees como nombre de la tabla.

7. Presione Tab para ir al siguiente campo y luego escriba dbo como nombre del esquema.

8. Reemplace las definiciones de columna por las columnas siguientes:

   EmployeesId INT NOT NULL PRIMARY KEY,
   Name [NVARCHAR](50)  NOT NULL,
   Location [NVARCHAR](50)  NOT NULL
   

9. Presione Ctrl+Mayús+E para crear la tabla.

Inserción y consulta

1. Agregue las siguientes instrucciones para insertar cuatro filas en la tabla Employees.

   -- Insert rows into table 'Employees'
   INSERT INTO Employees
      ([EmployeesId],[Name],[Location])
   VALUES
      ( 1, N'Jared', N'Australia'),
      ( 2, N'Nikita', N'India'),
      ( 3, N'Tom', N'Germany'),
      ( 4, N'Jake', N'United States')
   GO
   -- Query the total count of employees
   SELECT COUNT(*) as EmployeeCount FROM dbo.Employees;
   -- Query all employee information
   SELECT e.EmployeesId, e.Name, e.Location
   FROM dbo.Employees as e
   GO
   

   A medida que escribe, T-SQL IntelliSense le ayuda a completar las instrucciones:

   

   Sugerencia

   La extensión mssql también tiene comandos que ayudan a crear instrucciones INSERT y SELECT. No se han usado en el ejemplo anterior.

2. Presione Ctrl+Mayús+E para ejecutar los comandos. Los dos conjuntos de resultados se muestran en la ventana Resultados.

   

Consulta y guardado del resultado

1. Seleccione Ver>Editor de diseño>Voltear diseño para cambiar entre un diseño dividido vertical u horizontal.

2. Seleccione los encabezados de panel Resultados y Mensajes para contraer y expandir los paneles.

   

   Sugerencia

   Puede personalizar el comportamiento predeterminado de la extensión mssql. Vea Personalización de las opciones de extensión.

3. Seleccione el icono de maximizar cuadrícula en la segunda cuadrícula de resultados para acercar los resultados.

   

   Nota

   El icono de maximizar aparece cuando el script de T-SQL genera dos o más cuadrículas de resultados.

4. Abra el menú contextual de la cuadrícula al hacer clic con el botón derecho en la cuadrícula.

   

5. Seleccione Seleccionar todo.

6. Vuelva a abrir el menú contextual de la cuadrícula y seleccione Guardar como JSON para guardar el resultado en un archivo .json.

7. Especifique un nombre de archivo para el archivo JSON.

8. Compruebe que el archivo JSON se guarda y se abre en Visual Studio Code.

   

Si necesita guardar y ejecutar scripts de SQL más adelante, para la administración o un proyecto de desarrollo de mayor tamaño, guarde los scripts con una extensión .sql.

Pasos siguientes

• Si no está familiarizado con T-SQL, consulte los artículos Tutorial: Escritura de instrucciones Transact-SQL y Referencia de Transact-SQL (motor de base de datos).
• Desarrollo de bases de datos SQL en Visual Studio Code con la extensión Proyectos de SQL Database
• Para obtener más información sobre el uso o la contribución a la extensión mssql, vea la wiki del proyecto de extensión mssql.
• Para obtener más información sobre el uso de Visual Studio Code, vea la documentación de Visual Studio Code.