Partilhar via

Criar uma etapa de trabalho Transact-SQL

  • Artigo

Aplica-se a:SQL ServerAzure SQL Managed Instance

Importante

Em Instância Gerida do Azure SQL, a maioria, mas não todos os recursos do SQL Server Agent estão atualmente suportados. Consulte as diferenças T-SQL da Instância Gerida do Azure SQL em comparação com o SQL Server para obter detalhes.

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

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

Antes de começar

Segurança

Para obter informações detalhadas, consulte Implementar o SQL Server Agent Security.

Usando 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 Server e, em seguida, expanda essa instância.

  2. Expanda SQL Server Agent, crie uma nova tarefa ou clique com o botão direito numa tarefa existente e clique em Propriedades.

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

  4. Na caixa de diálogo Nova Etapa do Trabalho, digite um trabalho Nome da etapa.

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

  6. Na caixa de comando , digite os conjuntos de comandos Transact-SQL ou clique em Abrir para selecionar um arquivo Transact-SQL para utilizar como comando.

  7. Clique em Analisar para verificar a sua sintaxe.

  8. A mensagem "Analisar com êxito" é exibida quando a sintaxe está correta. Se for encontrado um erro, corrija a sintaxe antes de continuar.

  9. Clique na página Avançado para definir opções de etapa de trabalho, como: qual ação tomar se a etapa de trabalho for bem-sucedida ou falhar, quantas vezes o SQL Server Agent deve tentar executar a etapa de trabalho e o arquivo ou tabela em que o SQL Server Agent pode gravar a saída da etapa de trabalho. Somente membros da função de servidor fixa sysadmin podem gravar a saída da etapa do 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 for membro da função de servidor fixa sysadmin e quiser executar este passo do trabalho com um logon SQL diferente, selecione o logon SQL na lista de 'Executar como usuário' .

Usando 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 objetos de gerenciamento do SQL Server

Para criar uma etapa de trabalho Transact-SQL

Use a classe JobStep usando uma linguagem de programação que você escolher, como Visual Basic, Visual C# ou PowerShell.