Uso de la actividad Script

En este artículo, se presenta información sobre cómo agregar una nueva actividad de secuencia de comandos de SQL, agregar una nueva conexión y configurar el contenido de secuencia de comandos. La actividad "Script" ejecuta scripts SQL de consulta y de no consulta en almacenes de datos compatibles con el lenguaje de manipulación de datos (DML) y el lenguaje de definición de datos (DDL).

Puede usar la actividad Script para invocar un script SQL en uno de los siguientes almacenes de datos:

• Base de datos SQL en Fabric
• Almacenamiento de datos de tejido
• Base de datos de Azure para PostgreSQL
• Azure SQL Database
• Instancia administrada de Azure SQL
• Azure Synapse Analytics
• Base de datos de Oracle
• Base de datos de SQL Server
• Snowflake

Requisitos previos

Para empezar, complete los siguientes requisitos previos:

• Una cuenta de inquilino con una suscripción activa. Cree una cuenta gratuita.
• Se crea un área de trabajo.

Añadir una actividad de script a una canalización (Pipeline) con la interfaz de usuario

1. Abra una canalización existente o cree una nueva canalización.

2. Seleccione Agregar una actividad de canalización y busque Script.

   

3. Alternativamente, puede buscar la actividad Script en la barra de Actividades de la canalización y seleccionarla para añadirla al área de trabajo de la canalización.

   

4. Seleccione la nueva actividad de Script en el lienzo si aún no está seleccionada.

   

Para obtener instrucciones sobre la configuración general, consulte Configuración general.

Configurar la actividad de script

1. Seleccione la pestaña Configuración y elija una conexión existente en la lista desplegable o cree una nueva.

2. Después de seleccionar la conexión, elija Consulta para obtener un resultado de datos o NonQuery para cualquier operación de catálogo. La consulta devuelve un conjunto de resultados (instrucciones SELECT). NonQuery ejecuta instrucciones que no devuelven datos (INSERT, UPDATE, DELETE, CREATE, DROP).

   

3. Escriba contenido en el cuadro de expresión de script. Puede escribir contenido de script en el cuadro de expresión de varias maneras:

   1. Agregue contenido dinámico seleccionando en el cuadro o seleccionando el icono de contenido dinámico en el lado derecho. Aparece un panel desplegable, como se ve en la siguiente captura de pantalla, que muestra contenido dinámico y funciones que puede usar para crear sus expresiones. Si está familiarizado con Power Automate, la experiencia es similar.

      

   2. Edite directamente el código de script en el editor de código seleccionando el icono de lápiz en el lado derecho, como se muestra en la captura de pantalla siguiente. Después de seleccionarlo, aparece un nuevo cuadro de diálogo para que pueda escribir y editar el código.

      

   3. Use el generador de expresiones que usa la finalización de código de IntelliSense para resaltar, comprobar sintaxis y autocompletar para crear expresiones. Para obtener más información, consulte Lenguaje de expresiones.

Guardar y ejecutar o programar la pipeline

Cambie a la pestaña Inicio de la parte superior del editor de canalizaciones y seleccione el botón Guardar para guardar la canalización. Seleccione Ejecutar para ejecutarlo directamente o Programar para programar ejecuciones en intervalos o horas específicos. Para más información sobre las ejecuciones de canalización, consulte: ejecuciones de canalización programadas.

Una vez que se haya ejecutado, puede supervisar la ejecución de la canalización y ver el historial de ejecución desde la pestaña Salida debajo del lienzo.

Contenido relacionado

• Cómo administrar las ejecuciones de canalización en Microsoft Fabric