Compartir a través de

Creación de un paso de trabajo de Transact-SQL

se aplica a:SQL Serverazure SQL Managed Instance

Importante

En Azure SQL Managed Instance, actualmente son compatibles la mayoría de las características del Agente SQL Server. Consulte Diferencias de T-SQL entre SQL Server y Azure SQL Managed Instance o Limitaciones de los trabajos del Agente SQL en SQL Managed Instance para obtener más información.

En este tema se describe cómo crear un paso de trabajo del Agente SQL Server de Microsoft que ejecute scripts Transact-SQL en SQL Server mediante SQL Server Management Studio, Transact-SQL o OBJETOS de administración de SQL Server.

Estos scripts de pasos de trabajo pueden llamar a procedimientos almacenados y procedimientos almacenados extendidos. Un solo paso de trabajo de Transact-SQL puede contener varios lotes y comandos GO incrustados. Para obtener más información sobre cómo crear un trabajo, vea Creación de trabajos.

Antes de empezar

Seguridad

Para obtener información detallada, consulte Implementación de la seguridad del Agente SQL Server.

Uso de SQL Server Management Studio

Para crear un paso de trabajo de Transact-SQL

  1. En Explorador de objetos, conecta a una instancia del Motor de Base de Datos de SQL Server y a continuación expande esa instancia.

  2. Expanda el Agente SQL Server, cree un trabajo o haga clic con el botón derecho en uno existente y, después, haga clic en Propiedades.

  3. En el cuadro de diálogo Propiedades del trabajo, haga clic en la página Pasos y, a continuación, haga clic en Nuevo.

  4. En el cuadro de diálogo Nuevo paso de trabajo, escriba un trabajo Nombre del paso.

  5. En la lista Tipo, haga clic en Transact-SQL Script (TSQL).

  6. En el cuadro Comando, escriba el nombre de los lotes de comandos Transact-SQL, o bien haga clic en Abrir para seleccionar un archivo Transact-SQL para utilizarlo como comando.

  7. Haga clic en Analizar para comprobar la sintaxis.

  8. El mensaje "Parse succeeded" (Analizar correctamente) se muestra cuando la sintaxis es correcta. Si se encuentra un error, corrija la sintaxis antes de continuar.

  9. Haga clic en la página Avanzadas para establecer opciones de paso de trabajo, como: qué acción realizar si el paso de trabajo se realiza correctamente o no, cuántas veces el Agente SQL Server debe intentar ejecutar el paso de trabajo y el archivo o tabla donde el Agente SQL Server puede escribir la salida del paso de trabajo. Solo los miembros del rol fijo de servidor sysadmin pueden escribir la salida de paso de trabajo en un archivo del sistema operativo. Todos los usuarios del Agente SQL Server pueden registrar la salida en una tabla.

  10. Si es miembro del rol fijo de servidor sysadmin y desea ejecutar este paso de trabajo con otro inicio de sesión de SQL, seleccione el inicio de sesión de SQL en la lista Ejecutar como usuario.

Uso de Transact-SQL

Para crear un paso de trabajo de Transact-SQL

  1. En Explorador de objetos, conéctese a una instancia del motor de base de datos.

  2. En la barra Estándar, haga clic en Nueva consulta.

  3. Copie y pegue el ejemplo siguiente en la ventana de consulta y haga clic en Ejecutar.

    -- creates a job step that uses Transact-SQL  
USE msdb;  
GO  
EXEC sp_add_jobstep  
    @job_name = N'Weekly Sales Data Backup',  
    @step_name = N'Set database to read only',  
    @subsystem = N'TSQL',  
    @command = N'ALTER DATABASE SALES SET READ_ONLY',   
    @retry_attempts = 5,  
    @retry_interval = 5 ;  
GO

Para obtener más información, vea sp_add_jobstep (Transact-SQL).

Uso de objetos de administración de SQL Server

Para crear un paso de trabajo de Transact-SQL

Use la clase JobStep mediante un lenguaje de programación que elija, como Visual Basic, Visual C# o PowerShell.