Compartir a través de

Cuadernos de SQL (versión preliminar)

Los cuadernos SQL de la extensión MSSQL para Visual Studio Code proporcionan desarrollo de SQL basado en cuadernos mediante los cuadernos nativos Jupyter de Visual Studio Code. Puede combinar la ejecución interactiva de consultas SQL con celdas de documentación de Markdown para crear colecciones de consultas ejecutables, operaciones de base de datos de documentos y compartir análisis reproducibles.

Sugerencia

Los cuadernos de SQL se encuentran actualmente en versión preliminar y pueden cambiar en función de los comentarios. Únase a la comunidad en GitHub Discussions para compartir ideas o notificar problemas.

Características

Los cuadernos de SQL ofrecen estas funcionalidades:

  • Ejecute consultas T-SQL de forma interactiva en celdas de código de cuaderno con resultados en línea mostrados debajo de cada celda.

  • Usa el formato nativo de Jupyter Notebook en Visual Studio Code (archivos .ipynb) para lograr una compatibilidad completa con las herramientas de cuaderno existentes.

  • Ver los resultados de las consultas en un grid de datos enriquecido con opciones de ordenación, filtrado, selección de celdas, resaltado de valores nulos y copia (incluida la copia con encabezados).

  • Escriba SQL con IntelliSense, incluidas sugerencias de nombre de tabla y columna en función de la conexión de base de datos activa.

  • Agregue celdas de texto markdown junto con celdas de código SQL para documentar consultas, anotar resultados y crear flujos de trabajo narrativos.

  • Conecte cada cuaderno a una instancia de SQL Server y cambie entre bases de datos en el mismo servidor.

  • Ejecute celdas individualmente o ejecute todas las celdas secuencialmente.

  • Use GitHub Copilot para obtener sugerencias de consulta insertadas en celdas de código y creación de cuadernos controlados por chat para generar cuadernos completos a partir de descripciones de lenguaje natural.

  • Combine las celdas de SQL con otros kernels de lenguaje (como Python) en el mismo notebook instalando la extensión de Jupyter.

  • Exporte y comparta cuadernos como .ipynb archivos que otros usuarios pueden abrir en Visual Studio Code o en cualquier entorno compatible con Jupyter.

Prerrequisitos

Antes de usar cuadernos de SQL, asegúrese de que se cumplen los siguientes requisitos:

Creación de un cuaderno de SQL

Puede crear un cuaderno de SQL de varias maneras:

  • Abra la paleta de comandos (Ctrl+Mayús+P en Windows y Linux o Cmd+Mayús+P en macOS), escriba New Notebooky seleccione el comando .

  • Vaya al menú Archivo y seleccione Nuevo archivo y, a continuación, elija el tipo de Jupyter Notebook.

  • Haga clic con el botón derecho en una base de datos en el Explorador de objetos de la extensión MSSQL y seleccione Nuevo cuaderno en el menú contextual.

Al crear un cuaderno, seleccione el kernel de MSSQL para habilitar la ejecución de T-SQL en celdas de código.

Conectar con una base de datos

Cada cuaderno de SQL necesita una conexión de base de datos activa para ejecutar consultas. Al abrir un cuaderno con el kernel de MSSQL, la extensión le pedirá que seleccione un perfil de conexión o cree uno nuevo.

Importante

Cada cuaderno admite una única conexión de servidor por kernel. Puede conectarse a una instancia de SQL Server y cambiar entre bases de datos de ese servidor, pero no puede conectarse a varios servidores dentro del mismo cuaderno. Para trabajar con otro servidor, cree un cuaderno independiente o cambie la conexión del cuaderno.

Escritura y ejecución de celdas SQL

Las celdas de código SQL permiten escribir y ejecutar consultas T-SQL de forma interactiva en el cuaderno.

  1. Seleccione + Código en la barra de herramientas del cuaderno para agregar una nueva celda de código.

  2. Escriba la consulta de T-SQL en la celda. La celda proporciona la misma experiencia de edición de SQL que un editor de consultas estándar, incluido IntelliSense con sugerencias de nombre de tabla y columna de la base de datos conectada.

  3. Seleccione Ejecutar celda (el botón de ejecución a la izquierda de la celda) para ejecutar la consulta.

  4. Los resultados aparecen directamente debajo de la celda en una cuadrícula de datos enriquecida.

Para ejecutar todas las celdas del cuaderno secuencialmente, seleccione Ejecutar todo en la barra de herramientas del cuaderno.

Sugerencia

Use Ctrl+Entrar (Windows y Linux) o Cmd+Entrar (macOS) para ejecutar la celda actual y permanecer en ella. Utiliza Mayús+Enter para ejecutar la celda actual y avanzar a la siguiente.

Resultados de la consulta

Los resultados de la consulta en cuadernos de SQL proporcionan la misma experiencia de cuadrícula de datos enriquecida disponible en el editor de consultas estándar:

  • Ordenación: seleccione un encabezado de columna para ordenar los resultados ascendentes o descendentes.
  • Filtrado: use el icono de filtro en los encabezados de columna para filtrar los datos de resultados.
  • Selección de celdas: seleccione celdas individuales o rangos de celdas en la cuadrícula de resultados.
  • Resaltado nulo: NULL los valores se resaltan visualmente en la cuadrícula de resultados para facilitar la identificación.
  • Opciones de copia: haga clic con el botón derecho en las celdas seleccionadas para acceder a Copiar, Copiar con encabezados y Seleccionar todas las opciones.

Agregar celdas de Markdown

Puede usar celdas de Markdown para agregar texto con formato, encabezados, listas y vínculos junto con las celdas de código SQL. Úselos para documentar las consultas, explicar la lógica de negocios o agregar notas sobre los resultados esperados.

  1. Seleccione + Markdown en la barra de herramientas del cuaderno para agregar una nueva celda de texto.

  2. Escriba el contenido de Markdown. Se muestra una vista previa a medida que escribe.

  3. Seleccione fuera de la celda para representar el texto de Markdown.

Vuelva a seleccionar la celda para volver al modo de edición.

Usar múltiples núcleos

La extensión MSSQL proporciona el kernel de SQL de fábrica. Puede ampliar sus cuadernos de notas con más kernels de lenguaje con la instalación de la extensión de Jupyter, que agrupa la compatibilidad con Python y otros kernels. Puede combinar consultas de datos SQL con celdas de procesamiento y visualización de datos de Python en el mismo cuaderno.

Integración de GitHub Copilot

GitHub Copilot funciona con cuadernos de SQL para ayudarle a escribir consultas y generar cuadernos. Al instalar la extensión Copilot de GitHub, obtendrá lo siguiente:

  • Sugerencias en línea: mientras escribe en las celdas de código SQL, GitHub Copilot sugiere finalizaciones de consultas basadas en el contexto de la base de datos y en las celdas de Markdown circundantes.

  • Creación de cuadernos basados en chat: utilice GitHub Copilot Chat para generar cuadernos completos con celdas alternas de Markdown y SQL. Describir el análisis que desea realizar y GitHub Copilot crea la estructura completa del cuaderno.

Por ejemplo, puede abrir GitHub Copilot Chat y usar un indicador como:

I have a SQL Notebook open connected to AdventureWorks. Create cells for a sales
analysis: list all tables, find top 10 customers by revenue, show revenue by product
category, and demonstrate a safe data modification using BEGIN TRAN / ROLLBACK.

GitHub Copilot genera las celdas de documentación de Markdown y las celdas de código de T-SQL, que después se pueden ejecutar individualmente o todas a la vez mediante Ejecutar todo.

Cambiar bases de datos

Para cambiar a otra base de datos dentro de la misma conexión de servidor:

  1. Seleccione el nombre de la base de datos que se muestra en el área de estado de conexión del cuaderno.

  2. Elija una base de datos diferente de la lista desplegable.

Todas las ejecuciones de código en las celdas posteriores usan la base de datos recién seleccionada.

Nota:

Para cambiar a otro servidor, debe cambiar el perfil de conexión del cuaderno. Considere la posibilidad de crear un cuaderno independiente para cada servidor con el que necesite trabajar.

Limitaciones

Conexión de servidor único por cuaderno: actualmente, cada cuaderno se conecta a una instancia de SQL Server. Puede cambiar las bases de datos en ese servidor, pero no puede conectarse a un segundo servidor dentro del mismo cuaderno.

Comentarios y soporte

Si tiene ideas, comentarios o quiere interactuar con la comunidad, únase a la discusión en https://aka.ms/vscode-mssql-discussions. Para notificar un error, visite https://aka.ms/vscode-mssql-bug. Para solicitar una nueva característica, vaya a https://aka.ms/vscode-mssql-feature-request.

Contenido relacionado

  • Last updated on