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:
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.
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.
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.
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.
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.
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
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.
Una vez ejecutado el código, expanda el panel de mensajes para comprobar 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.
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.
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.
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.
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.
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.
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.
Contenido relacionado
Para obtener más información sobre los cuadernos de Fabric, consulte los siguientes artículos.
- ¿Qué es el almacenamiento de datos en Microsoft Fabric?
- ¿Tiene alguna pregunta? Intente preguntar a la comunidad de Fabric.
- ¿Sugerencias? Contribuir a las ideas para mejorar Fabric.