Compartir a través de


Compatibilidad de T-SQL en los cuadernos de Microsoft Fabric

La característica de cuadernos de T-SQL en Microsoft Fabric le permite escribir y ejecutar código T-SQL en un cuaderno. Puede usar cuadernos de T-SQL para administrar consultas complejas y escribir mejor documentación de Markdown. También permite la ejecución directa de T-SQL en el almacenamiento conectado o el punto de conexión de análisis SQL. Al agregar un punto de conexión de almacenamiento de datos o de análisis SQL a un cuaderno, los desarrolladores de T-SQL pueden ejecutar consultas directamente en el punto de conexión conectado. Los analistas de BI también pueden realizar consultas entre bases de datos para recopilar información de varios almacenes y puntos de conexión de análisis SQL.

La mayoría de las funcionalidades de cuadernos existentes están disponibles para los cuadernos de T-SQL. Estos incluyen gráficos de resultados de consulta, coautoría de cuadernos, programación de ejecuciones regulares y desencadenamiento de la ejecución en canalizaciones de integración de datos.

Importante

Esta característica se encuentra en versión preliminar.

En este artículo aprenderá a:

  • Crear un cuaderno de SQL
  • Agregar un punto de conexión de almacenamiento de datos o de análisis SQL a un cuaderno
  • Crear y ejecutar código T-SQL en un cuaderno
  • Usar las características de gráfico para representar gráficamente los resultados de la consulta
  • Guardar la consulta como vista o tabla
  • Ejecutar consultas entre almacenes
  • Omitir la ejecución de código que no es T-SQL

Creación de un cuaderno de SQL

Para empezar a trabajar con esta experiencia, puede crear un cuaderno de T-SQL de las dos maneras siguientes:

  1. Cree un cuaderno de T-SQL desde la página principal de almacenamiento de datos: vaya a la experiencia de almacenamiento de datos y elija Cuaderno.

    Captura de pantalla de la creación de una entrada de cuaderno de T-SQL en la página principal del almacenamiento de datos

  2. Cree un cuaderno de T-SQL desde un editor de almacenamiento existente: vaya a un almacén existente, en la cinta de navegación superior, seleccione Nueva consulta SQL y, a continuación, Nuevo cuaderno de consulta T-SQL.

Captura de pantalla del cuaderno abierto desde el editor de SQL del almacenamiento de datos

Una vez creado el cuaderno, se establece T-SQL como lenguaje predeterminado. Puede agregar puntos de conexión de almacenamiento de datos o de análisis SQL desde el área de trabajo actual al cuaderno.

Adición de un punto de conexión de almacenamiento de datos o de análisis SQL a un cuaderno

Para agregar un punto de conexión de almacenamiento de datos o de análisis SQL a un cuaderno, en el editor de cuadernos, seleccione el botón + Orígenes de datos y elija Almacenes. En el panel del centro de datos, seleccione el punto de conexión de almacenamiento de datos o de análisis SQL al que quiere conectarse.

Captura de pantalla de cómo agregar un punto de conexión de almacenamiento de datos o de análisis SQL al cuaderno

Establecimiento de un almacén principal

Puede agregar varios almacenes o puntos de conexión de análisis SQL al cuaderno, con uno de ellos establecido como principal. El almacenamiento principal ejecuta el código T-SQL. Para establecerlo, vaya al explorador de objetos, seleccione ... junto al almacén y elija Establecer como principal.

Captura de pantalla de la configuración del almacenamiento principal

Para cualquier comando de T-SQL que admita la nomenclatura de tres partes, el almacenamiento principal se utiliza como almacenamiento predeterminado si no se especifica ningún otro.

Creación y ejecución de código T-SQL en un cuaderno

Para crear y ejecutar código T-SQL en un cuaderno, agregue una nueva celda y establezca T-SQL como lenguaje de celda.

Captura de pantalla que muestra cómo crear una celda de código de T-SQL

Puede generar automáticamente código T-SQL mediante la plantilla de código desde el menú contextual del explorador de objetos. Las plantillas siguientes están disponibles para los cuadernos de T-SQL:

  • Seleccionar los 100 primeros
  • Crear tabla
  • Crear como selección
  • Drop
  • Colocar y crear

Captura de pantalla de que muestra la plantilla de código T-SQL

Para ejecutar una celda de código T-SQL, seleccione el botón Ejecutar de la barra de herramientas de celda o ejecute todas las celdas seleccionando el botón Ejecutar todo de la barra de herramientas.

Nota:

Cada celda de código se ejecuta en una sesión independiente, por lo que las variables definidas en una celda no están disponibles en otra celda.

Dentro de la misma celda de código, puede contener varias líneas de código. El usuario puede seleccionar parte de este código y ejecutar únicamente las líneas seleccionadas. Cada ejecución también genera una nueva sesión.

Captura de pantalla que muestra cómo ejecutar-la celda de código seleccionada

Una vez ejecutado el código, expanda el panel de mensajes para comprobar el resumen de ejecución.

Captura de pantalla que muestra el resumen de ejecución.

En la pestaña Tabla se muestran los registros del conjunto de resultados devuelto. Si la ejecución contiene varios conjuntos de resultados, puede cambiar de uno a otro mediante el menú desplegable.

Captura de pantalla que muestra cómo cambiar en la pestaña de resultados

Usar las características de gráfico para representar gráficamente los resultados de la consulta

Al hacer clic en Inspeccionar, puede ver los gráficos que representan la calidad y distribución de los datos de cada columna.

Captura de pantalla que muestra la inspección del resultado en un gráfico

Guardar la consulta como una vista o tabla

Puede usar el menú Guardar como tabla para guardar los resultados de la consulta en la tabla mediante el comando CTAS. Para usar este menú, seleccione el texto de la consulta en la celda de código y seleccione el menú Guardar como tabla.

Captura de pantalla que muestra cómo guardar la consulta como una tabla

Captura de pantalla sobre cómo guardar una tabla como cuadro de diálogo

Del mismo modo, puede crear una vista a partir del texto de consulta seleccionado con el menú Guardar como vista de la barra de comandos de la celda.

Captura de pantalla que muestra cómo crear una vista

Captura de pantalla que muestra el cuadro de diálogo Guardar como vista

Nota:

  • Dado que los menús Guardar como tabla y Guardar como vista solo están disponibles para el texto de consulta seleccionado, debe seleccionar el texto de la consulta antes de usar estos menús.

  • Crear vista no admite la nomenclatura de tres partes, por lo que la vista siempre se crea en el almacenamiento principal cuando se establece como tal.

Consultas entre almacenamientos

Puede ejecutar consultas entre almacenamientos mediante la nomenclatura de tres partes. La nomenclatura de tres partes consta del nombre de la base de datos, el nombre del esquema y el nombre de la tabla. El nombre de la base de datos es el nombre del punto de conexión del almacenamiento o de análisis SQL y el nombre del esquema y el nombre de la tabla son los nombres correspondientes del esquema y la tabla.

Captura de pantalla que muestra cómo ejecutar una consulta entre almacenamientos

Omitir la ejecución de código que no es T-SQL

Dentro del mismo cuaderno, es posible crear celdas de código que usen diferentes lenguajes. Por ejemplo, una celda de código PySpark puede preceder a una celda de código T-SQL. En tal caso, el usuario puede optar por omitir la ejecución del código PySpark en el cuaderno de T-SQL. Este cuadro de diálogo aparece cuando se ejecutan todas las celdas de código haciendo clic en el botón Ejecutar todo de la barra de herramientas.

Captura de pantalla que muestra cómo omitir código que no es TSQL

Limitaciones de la vista preliminar pública

  • La celda de parámetro aún no se admite en el cuaderno de T-SQL. El parámetro pasado desde la canalización o el programador no podrá usarse en el cuaderno de T-SQL.
  • La característica Ejecución reciente aún no se admite en el cuaderno de T-SQL. Debe usar la característica de supervisión del almacenamiento de datos actual para comprobar el historial de ejecución del cuaderno de T-SQL. Consulte el artículo Supervisar el almacenamiento de datos de Fabric para obtener más información.
  • La dirección URL de supervisión dentro de la ejecución de la canalización aún no se admite en el cuaderno de T-SQL.
  • La característica de instantánea aún no se admite en el cuaderno de T-SQL.
  • La compatibilidad con la canalización de implementación y de Git aún no se admite en el cuaderno de T-SQL.

Para obtener más información sobre los cuadernos de Fabric, consulte los siguientes artículos.