sp_add_jobschedule (Transact-SQL)

  • Artigo

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

Cria uma agenda para um trabalho do SQL Server Agent.

Convenções de sintaxe de Transact-SQL

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.

Sintaxe

sp_add_jobschedule
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    , [ @name = ] N'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 ]
    [ , [ @schedule_id = ] schedule_id OUTPUT ]
    [ , [ @automatic_post = ] automatic_post ]
    [ , [ @schedule_uid = ] 'schedule_uid' OUTPUT ]
[ ; ]

Argumentos

@job_id [ = ] 'job_id'

Número de identificação do trabalho para o qual a agenda é adicionada. @job_id é uniqueidentifier, com um padrão de NULL.

Devem ser especificados @job_id ou @job_name , mas ambos não podem ser especificados.

@job_name [ = ] N'job_name'

Nome do trabalho ao qual a agenda é adicionada. @job_name é sysname, com um padrão de NULL.

Devem ser especificados @job_id ou @job_name , mas ambos não podem ser especificados.

@name [ = ] N'nome'

Nome da agenda. @name é sysname, sem padrão.

@enabled [ = ] habilitado

Indica o status atual da agenda. @enabled é tinyint, com um padrão de 1 (enabled). Se 0, o agendamento não estiver habilitado. Quando o agendamento está desabilitado, o trabalho não é executado.

@freq_type [ = ] freq_type

Valor que indica quando o trabalho será executado. @freq_type é int e pode ser um dos seguintes valores:

Valor Descrição
1 Uma vez
4 Diário
8 Semanal
16 Mensal
32 Mensalmente, em relação ao @freq_interval.
64 Execute quando o serviço SQL Server Agent for iniciado.
128 Executar quando o computador estiver ocioso.

@freq_interval [ = ] freq_interval

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

Valor da @freq_type Efeito na @freq_interval
1 (uma vez) @freq_interval não é utilizado.
4 (diárias) Todos os dias @freq_interval .
8 (semanal) @freq_interval é um ou mais dos seguintes (combinado com um OR operador lógico):

1 = Domingo
2 = Segunda-feira
4 = Terça-feira
8 = Quarta-feira
16 = Quinta-feira
32 = Sexta-feira
64 = Sábado
16 (mensal) No @freq_interval dia do mês.
32 (parente mensal) @freq_interval é um dos seguintes:

1 = Domingo
2 = Segunda-feira
3 = Terça-feira
4 = Quarta-feira
5 = Quinta-feira
6 = Sexta-feira
7 = Sábado
8 = Dia
9 = Dia da semana
10 = Dia de fim de semana
64 (quando o serviço SQL Server Agent é iniciado) @freq_interval não é utilizado.
128 @freq_interval não é utilizado.

@freq_subday_type [ = ] freq_subday_type

Especifica as unidades para @freq_subday_interval. @freq_subday_type é int e pode ser um destes valores:

Valor Descrição (unidade)
0x1 Na hora especificada
0x2 Segundos
0x4 Minutos
0x8 Horário

@freq_subday_interval [ = ] freq_subday_interval

Número de períodos @freq_subday_type a ocorrer entre cada execução do trabalho. @freq_subday_interval é int, com um padrão de 0.

@freq_relative_interval [ = ] freq_relative_interval

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

@freq_relative_interval é int, e pode ser um destes valores:

Valor Descrição (unidade)
1 Primeiro
2 Segundo
4 Terceiro
8 Quarto
16 Último

@freq_relative_interval indica a ocorrência do intervalo. Por exemplo, se @freq_relative_interval estiver definido como , @freq_type estiver definido como 322, e @freq_interval estiver definido como 3, o trabalho agendado ocorrerá na segunda terça-feira de cada mês.

@freq_recurrence_factor [ = ] freq_recurrence_factor

Número de semanas ou meses entre execuções agendadas do trabalho. @freq_recurrence_factor é int, com um padrão de 0. @freq_recurrence_factor é usado somente se @freq_type estiver definido como 8, 16ou 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 é formatada como yyyyMMdd. Se @active_start_date estiver definido, a data deverá ser maior ou igual a 19900101.

Depois que a agenda for criada, revise a data de início e confirme se é a data correta. Para obter mais informações, consulte a seção "Agendando data de início" em Criar e anexar agendas a trabalhos.

@active_end_date [ = ] active_end_date

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

@active_start_time [ = ] active_start_time

O tempo em qualquer dia entre @active_start_date e @active_end_date para iniciar a execução do trabalho. @active_start_time é int, com um padrão de 000000. A hora é formatada como HHmmss em um 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 encerrar a execução do trabalho. @active_end_time é int, com um padrão de 235959. A hora é formatada como HHmmss em um relógio de 24 horas.

@schedule_id [ = ] schedule_id SAÍDA

Número de identificação de agendamento atribuído à agenda se ela for criada com êxito. @schedule_id é um parâmetro OUTPUT do tipo int.

@automatic_post [ = ] automatic_post

Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.

@schedule_uid [ = ] SAÍDA 'schedule_uid'

Um identificador exclusivo da agenda. @schedule_uid é um parâmetro OUTPUT do tipo uniqueidentifier.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

As agendas de trabalho podem ser gerenciadas independentemente dos trabalhos. Para adicionar uma agenda a um trabalho, use sp_add_schedule para criar a agenda e sp_attach_schedule anexá-la a um trabalho.

Permissões

Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Outros usuários devem receber uma das seguintes funções de banco de dados fixas msdb do SQL Server Agent no banco de dados:

  • 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.

Exemplos

O exemplo a seguir atribui uma agenda de trabalho ao SaturdayReports, que é executado todos os sábados às 2:00 AM.

EXEC msdb.dbo.sp_add_jobschedule
    @job_name = N'SaturdayReports', -- Job name
    @name = N'Weekly_Sat_2AM', -- Schedule name
    @freq_type = 8, -- Weekly
    @freq_interval = 64, -- Saturday
    @freq_recurrence_factor = 1, -- every week
    @active_start_time = 20000 -- 2:00 AM

Conteúdo relacionado