sp_update_schedule (Transact-SQL)

Aplica-se a:SQL Server

Altera as definições para um agendamento do SQL Server Agent.

Transact-SQL convenções de sintaxe

Sintaxe

sp_update_schedule
    [ [ @schedule_id = ] schedule_id ]
    [ , [ @name = ] N'name' ]
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @freq_type = ] freq_type ]
    [ , [ @freq_interval = ] freq_interval ]
    [ , [ @freq_subday_type = ] freq_subday_type ]
    [ , [ @freq_subday_interval = ] freq_subday_interval ]
    [ , [ @freq_relative_interval = ] freq_relative_interval ]
    [ , [ @freq_recurrence_factor = ] freq_recurrence_factor ]
    [ , [ @active_start_date = ] active_start_date ]
    [ , [ @active_end_date = ] active_end_date ]
    [ , [ @active_start_time = ] active_start_time ]
    [ , [ @active_end_time = ] active_end_time ]
    [ , [ @owner_login_name = ] N'owner_login_name' ]
    [ , [ @automatic_post = ] automatic_post ]
[ ; ]

Arguments

[ @schedule_id = ] schedule_id

O identificador do anexo a modificar. @schedule_id é int, com um padrão de NULL.

Deve ser especificado @schedule_id ou @name .

[ @name = ] N'nome'

O nome do calendário a modificar. @name é sysname, com um padrão de NULL.

Deve ser especificado @schedule_id ou @name .

[ @new_name = ] N'new_name'

O novo nome para o horário. @new_name é sysname, com um padrão de NULL. Quando @new_name é NULL, o nome do horário mantém-se inalterado.

[ @enabled = ] ativado

Indica o estado atual do calendário. @enabled é tinyint, com o padrão de 1 (ativado). Se 0, o horário não está ativado. Quando o horário não está ativado, nenhum trabalho será executado nesse horário.

[ @freq_type = ] freq_type

Um valor que indica quando um trabalho deve ser executado. @freq_type é int, e pode ser um desses valores.

[ @freq_interval = ] freq_interval

Os dias em que um trabalho é executado. @freq_interval é int, com um padrão de 0, e depende do valor de @freq_type conforme indicado na tabela seguinte:

[ @freq_subday_type = ] freq_subday_type

Especifica as unidades para @freq_subday_interval. @freq_subday_type é int, e pode ser um desses valores.

[ @freq_subday_interval = ] freq_subday_interval

O número de períodos de @freq_subday_type a ocorrer entre cada execução de uma tarefa. @freq_subday_interval é int, com um padrão de 0.

[ @freq_relative_interval = ] freq_relative_interval

Define ainda o @freq_interval quando @freq_type é definido para 32 (relativo mensal).

@freq_relative_interval é int, e pode ser um desses valores.

@freq_relative_interval indica a ocorrência do intervalo. Por exemplo, se @freq_relative_interval estiver definido para 2, @freq_type for definido para 32, e @freq_interval para 3, o trabalho agendado ocorreria na segunda terça-feira de cada mês.

[ @freq_recurrence_factor = ] freq_recurrence_factor

O número de semanas ou meses entre a execução agendada de um trabalho. @freq_recurrence_factor é int, com um padrão de 0. @freq_recurrence_factor é usado apenas se @freq_type estiver definido como 8, 16, ou 32.

[ @active_start_date = ] active_start_date

A data em que a execução do trabalho pode começar. @active_start_date é int, com um padrão de NULL. A data está formatada como yyyyMMdd. Se @active_start_date for definido, a data deve ser maior ou igual a 19900101.

Depois de criar o horário, reveja a data de início e confirme se é a data correta. Para mais informações, consulte a secção "Agendamento da Data de Início" em Criar e Anexar Agendamentos a Trabalhos.

[ @active_end_date = ] active_end_date

Data em que a execução do trabalho pode parar. @active_end_date é int, com um padrão de 99991231. A data está formatada como yyyyMMdd.

[ @active_start_time = ] active_start_time

O tempo em qualquer dia entre @active_start_date e @active_end_date para começar a execução do trabalho. @active_start_time é int, com um padrão de 000000. A hora está formatada como HHmmss num relógio de 24 horas.

[ @active_end_time = ] active_end_time

O tempo em qualquer dia entre active_start_date e @active_end_date para terminar a execução do trabalho. @active_end_time é int, com um padrão de 235959. A hora está formatada como HHmmss num relógio de 24 horas.

[ @owner_login_name = ] N'owner_login_name'

O nome do principal servidor que detém o horário. @owner_login_name é sysname, com um padrão de NULL, que indica que o horário pertence ao criador.

[ @automatic_post = ] automatic_post

Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Observações

Todos os empregos que usam o horário usam imediatamente as novas definições. No entanto, alterar um horário não impede os trabalhos que já estão a funcionar.

Permissions

Pode conceder EXECUTE permissões neste procedimento, mas essas permissões podem ser anuladas durante uma atualização do SQL Server.

Outros utilizadores devem receber um dos seguintes papéis fixos de base de dados SQL Server Agent na msdb base de dados:

• SQLAgentUserRole
• SQLAgentReaderRole
• SQLAgentOperatorRole

Para detalhes sobre as permissões destes papéis, consulte Funções de Base de Dados Fixas do Agente SQL Server.

Só os membros do sysadmin podem modificar um horário pertencente a outro utilizador.

Examples

O exemplo seguinte altera o estado ativado do NightlyJobs anexo para 0 e define o proprietário para terrid.

USE msdb;
GO

EXECUTE dbo.sp_update_schedule
    @name = 'NightlyJobs',
    @enabled = 0,
    @owner_login_name = 'terrid';
GO

Conteúdo relacionado

• Criar e Anexar Agendas a Trabalhos
• Agendar um Emprego
• Crie um Calendário
• Procedimentos armazenados do SQL Server Agent (Transact-SQL)
• sp_add_schedule (Transact-SQL)
• sp_add_jobschedule (Transact-SQL)
• sp_delete_schedule (Transact-SQL)
• sp_help_schedule (Transact-SQL)
• sp_attach_schedule (Transact-SQL)