Create a Transact-SQL Job Step

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

Importante

Atualmente, na Instância Gerenciada de SQL do Azure, a maioria dos recursos do SQL Server Agent é compatível, mas não todos. Confira Diferenças entre o T-SQL da Instância Gerenciada de SQL do Azure e o SQL Server para obter detalhes.

Este tópico descreve como criar uma etapa de trabalho do Microsoft SQL Server Agent que execute scripts Transact-SQL no SQL Server usando o SQL Server Management Studio, o Transact-SQL ou o SQL Server Management Objects.

Esses scripts de etapa de trabalho podem chamar procedimentos armazenados e procedimentos armazenados estendidos. Uma mesma etapa de trabalho Transact-SQL pode conter vários lotes e comandos GO inseridos. Para obter mais informações sobre como criar um trabalho, consulte Criando trabalhos.

Antes de começar

Segurança

Para obter informações detalhadas, consulte Implementar a segurança do SQL Server Agent.

Como usar o SQL Server Management Studio.

Para criar uma etapa de trabalho Transact-SQL

  1. No Pesquisador de Objetos , conecte-se a uma instância do Mecanismo de Banco de Dados do SQL Servere a expanda.

  2. Expanda SQL Server Agent, crie um novo trabalho ou clique com o botão direito do mouse em um trabalho existente e clique em Propriedades.

  3. Na caixa de diálogo Propriedades do Trabalho , clique na página Etapas e, em seguida, em Nova.

  4. Na caixa de diálogo Nova Etapa de Trabalho , digite o Nome da etapade trabalho.

  5. Na lista Tipo , clique em Script Transact-SQL (TSQL).

  6. Na caixa Comando, digite os lotes de comandos Transact-SQL ou clique em Abrir para selecionar um arquivo Transact-SQL a ser usado como comando.

  7. Clique em Analisar para verificar a sintaxe.

  8. A mensagem "Êxito da análise" será exibida se a sintaxe estiver correta. Se um erro for encontrado, corrija a sintaxe antes de continuar.

  9. Clique na página Avançado para definir opções para a etapa de trabalho, tais como: que ação deve ser adotada em caso de êxito ou falha da etapa, quantas vezes o SQL Server Agent deve tentar executar a etapa e em que arquivo ou tabela o SQL Server Agent deve gravar a saída da etapa de trabalho. Só membros da função de servidor fixa sysadmin podem gravar a saída de etapas de trabalho em um arquivo do sistema operacional. Todos os usuários do SQL Server Agent podem registrar a saída em uma tabela.

  10. Se você for membro da função de servidor fixa sysadmin e desejar executar a etapa de trabalho como um logon SQL diferente, selecione esse logon na lista Executar como usuário .

Usando o Transact-SQL

Para criar uma etapa de trabalho Transact-SQL

  1. No Pesquisador de Objetos, conecte-se a uma instância do Mecanismo de Banco de Dados.

  2. Na barra Padrão, clique em Nova Consulta.

  3. Copie e cole o exemplo a seguir na janela de consulta e clique em Executar.

    -- 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 obter mais informações, consulte sp_add_jobstep (Transact-SQL).

Usando o SQL Server Management Objects

Para criar uma etapa de trabalho Transact-SQL

Use a classe JobStep com uma linguagem de programação à sua escolha, como Visual Basic, Visual C# ou PowerShell.