Definir fluxo de êxito ou falha da etapa de trabalho

Aplica-se a: SQL Server Instâ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.

Ao criar os trabalhos do Microsoft SQL Server Agent é possível especificar qual ação o SQL Server deverá executar em caso de falha durante a execução do trabalho. Determine a ação a ser tomada pelo SQL Server em caso de êxito ou falha de cada etapa de trabalho. Use o procedimento a seguir para configurar a lógica do fluxo de ações da etapa de trabalho, usando o SQL Server Agent.

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 definir o fluxo da etapa de trabalho segundo o êxito ou falha

  1. No Pesquisador de Objetos, expanda SQL Server Agente, em seguida, expanda Trabalhos.

  2. Clique com o botão direito do mouse no trabalho que deseja editar e selecione Propriedades.

  3. Selecione a página Etapas, selecione uma etapa e, em seguida, selecione Editar.

  4. Na caixa de diálogo Propriedades da Etapa de Trabalho , selecione a página Avançado .

  5. Na lista Ação ao obter êxito, selecione a ação a executar se a etapa de trabalho for concluída com êxito.

  6. Na caixa Tentativas de repetição, insira o número de vezes, de 0 a 9999, que a etapa de trabalho deve ser repetida antes de ser considerada como falha. Se você inserir um valor maior que 0 na caixa Tentativas de repetição , insira na caixa Intervalo de repetição (minutos) o número de minutos, de 1 a 9999, que devem decorrer antes de uma nova tentativa da etapa de trabalho.

  7. Na lista Ação ao falhar, selecione a ação a executar caso a etapa de trabalho falhe.

  8. Se o trabalho for um script TransactSQL, você poderá escolher entre as seguintes opções:

    • Na caixa Arquivo de saída , insira o nome de um arquivo de saída no qual o script deverá ser gravado. Por padrão, o arquivo é substituído sempre que a etapa de trabalho é executada. Se não quiser que o arquivo de saída seja substituído, marque Anexar saída ao arquivo existente.

    • Marque Registrar na tabela , se desejar registrar a etapa de trabalho em uma tabela de banco de dados. Por padrão, o conteúdo da tabela é substituído sempre que a etapa de trabalho é executada. Se não quiser que o conteúdo da tabela seja substituído, marque Anexar saída à entrada existente na tabela. Após a execução da etapa de trabalho, o conteúdo dessa tabela pode ser visualizado clicando-se em Exibir.

    • Marque Incluir saída da etapa no histórico , se desejar que a saída seja incluída no histórico da etapa. A saída será exibida apenas se não houver erros. A saída também pode ser truncada.

  9. Se a lista Executar como usuário estiver disponível, selecione a conta proxy com as credenciais que o trabalho usará.

Usando o Transact-SQL

Para definir o fluxo da etapa de trabalho segundo o êxito ou falha

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

  2. Na barra Padrão, selecione Nova Consulta.

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

    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',   
        @on_success_action = 1;  
    GO  
    

Para obter mais informações, consulte sp_add_jobstep (Transact-SQL).

Usando o SQL Server Management Objects

Para definir o fluxo da etapa de trabalho segundo o êxito ou falha

Use a classe JobStep com uma linguagem de programação à sua escolha, como Visual Basic, Visual C# ou PowerShell. Para obter mais informações, veja SMO (SQL Server Management Objects).

Confira também