Artigo
04/01/2012

sp_delete_schedule (Transact-SQL)

Exclui uma agenda.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

sp_delete_schedule { [ @schedule_id = ] schedule_id | [ @schedule_name = ] 'schedule_name' } ,
     [ @force_delete = ] force_delete

Argumentos

[ @schedule_id= ] schedule_id
O número de identificação da agenda a ser excluída. schedule_id é int, com um padrão NULL.

Observação

É necessário especificar a schedule_id ou o schedule_name, mas não é possível especificar ambos ao mesmo tempo.
[ @schedule_name= ] 'schedule_name'
O nome da agenda a ser excluída. schedule_name é sysname, com um padrão NULL.

Observação

É necessário especificar a schedule_id ou o schedule_name, mas não é possível especificar ambos ao mesmo tempo.
[ @force_delete = ] force_delete
Especifica se o procedimento deve falhar se a agenda estiver anexada a um trabalho. Force_delete é bit, com um padrão 0. Quando force_delete for 0, o procedimento armazenado falhará se a agenda estiver anexada a um trabalho. Quando force_delete for 1, a agenda será excluída, independentemente do fato de a agenda estar anexada a um trabalho.

Observação
É necessário especificar a schedule_id ou o schedule_name, mas não é possível especificar ambos ao mesmo tempo.

Observação
É necessário especificar a schedule_id ou o schedule_name, mas não é possível especificar ambos ao mesmo tempo.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

Por padrão, uma agenda não poderá ser excluída se estiver anexada a um trabalho. Para excluir uma agenda que esteja anexada a um trabalho, especifique o valor 1 para force_delete. A exclusão de uma agenda não pára trabalhos que estejam atualmente em execução.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Deve ser concedida a outros usuários uma das seguintes funções de banco de dados fixas do SQL Server Agent no banco de dados msdb:

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

Para obter detalhes sobre as permissões dessas funções, consulte Funções de banco de dados fixas do SQL Server Agent.

Somente os membros da função sysadmin podem excluir uma agenda de trabalho que pertença a outro usuário.

Exemplos

A. Excluindo uma agenda

O exemplo a seguir exclui a agenda NightlyJobs. Se a agenda estiver anexada a qualquer trabalho, o exemplo não excluirá a agenda.

USE msdb ;
GO

EXEC dbo.sp_delete_schedule
    @schedule_name = N'NightlyJobs' ;
GO

B. Excluindo uma agenda anexada a um trabalho

O exemplo a seguir exclui a agenda RunOnce, independentemente do fato de a agenda estar anexada a um trabalho.

USE msdb ;
GO

EXEC dbo.sp_delete_schedule
    @schedule_name = 'RunOnce',
    @force_delete = 1;
GO

Partilhar via