Partilhar via

sp_help_jobschedule (Transact-SQL)

  • Artigo

Aplica-se a:SQL Server

Retorna informações sobre o agendamento de trabalhos usados pelo SQL Server Management Studio para executar atividades automatizadas.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_help_jobschedule
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @schedule_id = ] schedule_id ]
    [ , [ @include_description = ] include_description ]
[ ; ]

Argumentos

@job_id [ = ] 'job_id'

O número de identificação do trabalho. @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'

O nome do trabalho. @job_name é sysname, com um padrão de NULL.

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

@schedule_name [ = ] N'schedule_name'

O nome do item de agenda que será definido para o trabalho. @schedule_name é sysname, com um padrão de NULL.

@schedule_id [ = ] schedule_id

O número de identificação do item de agenda do trabalho. @schedule_id é int, com um padrão de NULL.

@include_description [ = ] include_description

Especifica se deve ser incluída a descrição da agenda no conjunto de resultados. @include_description é bit, com um padrão de 0.

  • Quando 0, a descrição da agenda não é incluída no conjunto de resultados.
  • Quando 1, a descrição do cronograma é incluída no conjunto de resultados.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
schedule_id int Número do identificador de agenda.
schedule_name sysname Nome da agenda.
enabled int Se o agendamento habilitado (1) ou não habilitado (0).
freq_type int Valor que indica quando o trabalho deve ser executado.

1 = Uma vez
4 = Diária
8 = Semanal
16 = Mensal
32 = Mensal, em relação ao freq_interval
64 = Executar quando o serviço SQL Server Agent é iniciado.
freq_interval int Dias em que o trabalho é executado. O valor depende do valor de freq_type. Para obter mais informações, consulte sp_add_schedule.
freq_subday_type int Unidades para freq_subday_interval. Para obter mais informações, consulte sp_add_schedule.
freq_subday_interval int Número de freq_subday_type períodos a ocorrer entre cada execução do trabalho. Para obter mais informações, consulte sp_add_schedule.
freq_relative_interval int Ocorrência de trabalho programado do freq_interval em cada mês. Para obter mais informações, consulte sp_add_schedule.
freq_recurrence_factor int Número de meses entre a execução agendada do trabalho.
active_start_date int Data em que a agenda foi ativada.
active_end_date int Data de término da agenda.
active_start_time int Hora do dia em que a agenda é iniciada.
active_end_time int Hora do dia em que a agenda é encerrada.
date_created datetime Data em que a agenda foi criada.
schedule_description nvarchar(4000) Uma descrição em inglês da agenda derivada de valores em msdb.dbo.sysschedules. Quando @include_description é 0, esta coluna contém texto informando que a descrição não foi solicitada.
next_run_date int A data da próxima agenda faz com que o trabalho seja executado.
next_run_time int O tempo em que a agenda se aproxima faz com que o trabalho seja executado.
schedule_uid uniqueidentifier Identificador da agenda.
job_count int Contagem de trabalhos retornados.

Observação

sp_help_jobscheduleRetorna valores das tabelas e dbo.sysschedules System em msdb.sysjobschedules atualizações a dbo.sysjobschedules cada 20 minutos. Isso pode afetar os valores que são retornados por esse procedimento armazenado.

Comentários

Os parâmetros de sp_help_jobschedule podem ser usados apenas em certas combinações. Se @schedule_id for especificado, @job_id e @job_name não poderão ser especificados. Caso contrário, os parâmetros @job_id ou @job_name podem ser usados com @schedule_name.

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.

Os membros de SQLAgentUserRole só podem exibir propriedades de agendas de trabalho que possuem.

Exemplos

R. Retornar a agenda de trabalho para um trabalho específico

O exemplo a seguir retorna todas as informações de agendamento do trabalho chamado BackupDatabase.

USE msdb;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'BackupDatabase' ;
GO

B. Retornar a agenda de trabalho para uma agenda específica

O exemplo a seguir retorna as informações da agenda chamada NightlyJobs e do trabalho chamado RunReports.

USE msdb;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'RunReports',
    @schedule_name = N'NightlyJobs';
GO

C. Retornar a agenda de trabalho e a descrição da agenda para uma agenda específica

O exemplo a seguir retorna as informações da agenda chamada NightlyJobs e do trabalho chamado RunReports. O conjunto de resultados retornado inclui uma descrição da agenda.

USE msdb;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'RunReports',
    @schedule_name = N'NightlyJobs',
    @include_description = 1;
GO

Conteúdo relacionado