Create a Transact-SQL Job Step

Se aplica a: SQL Server Azure 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 entre T-SQL de Azure SQL Managed Instance y SQL Server para más información.

En este tema, se describe cómo crear un paso de trabajo del Agente Microsoft SQL Server que ejecute scripts Transact-SQL en SQL Server mediante SQL Server Management Studio, Transact-SQL u 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 procesos por lotes y comandos GO insertados. Para obtener más información acerca de la creación de un trabajo, vea Crear trabajos.

Antes de empezar

Seguridad

Para obtener información detallada, vea Implementar la seguridad del Agente SQL Server.

Uso de SQL Server Management Studio

Para crear un paso de trabajo de Transact-SQL

  1. En el Explorador de objetos , conéctese a una instancia de Motor de base de datos de SQL Servery, después, expándala.

  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 nombre para el paso de trabajo en 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 "Análisis correcto" aparece 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 las opciones de los pasos de trabajo, como qué acción realizar si el paso de trabajo funciona o no correctamente, cuántas veces el Agente SQL Server debe intentar ejecutar el paso de trabajo y el archivo o la tabla en la que el Agente SQL Server puede escribir la salida de 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 .

Usar Transact-SQL

Para crear un paso de trabajo de Transact-SQL

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

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

  3. Copie y pegue el siguiente ejemplo 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 más información, consulte sp_add_jobstep (Transact-SQL).

Usar 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 de su elección, como Visual Basic, Visual C# o PowerShell.