Partilhar via

sp_help_schedule (Transact-SQL)

  • Artigo

Aplica-se a:SQL Server

Lista informações sobre agendas.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_help_schedule
    [ [ @schedule_id = ] schedule_id ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @attached_schedules_only = ] attached_schedules_only ]
    [ , [ @include_description = ] include_description ]
[ ; ]

Argumentos

@schedule_id [ = ] schedule_id

O identificador da agenda a ser listado. @schedule_id é int, com um padrão de NULL.

Qualquer @schedule_id ou @schedule_name pode ser especificado.

@schedule_name [ = ] N'schedule_name'

O nome da agenda a ser listada. @schedule_name é sysname, com um padrão de NULL.

Qualquer @schedule_id ou @schedule_name pode ser especificado.

@attached_schedules_only [ = ] attached_schedules_only

Especifica se apenas agendas com um trabalho anexado devem ser mostradas. @attached_schedules_only é bit, com um padrão de 0. Quando @attached_schedules_only é 0, todos os horários são mostrados. Quando @attached_schedules_only é 1, o conjunto de resultados contém apenas agendas anexadas a um trabalho.

@include_description [ = ] include_description

Especifica se descrições devem ser incluídas no conjunto de resultados. @include_description é bit, com um padrão de 0. Quando @include_description é 0, a coluna @schedule_description do conjunto de resultados contém um espaço reservado. Quando @include_description é 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

Este procedimento retorna o seguinte conjunto de resultados:

Nome da coluna Tipo de dados Descrição
schedule_id int Número do identificador de agenda.
schedule_uid uniqueidentifier Identificador da 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 SQLServerAgent é 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 (se solicitado).
job_count int Retorna o número de trabalhos que referenciam essa agenda.

Comentários

Quando nenhum parâmetro é fornecido, sp_help_schedule lista informações para todas as agendas na instância.

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 as agendas que possuem.

Exemplos

R. Listar informações para todas as agendas na instância

O exemplo a seguir lista as informações para todas as agendas na instância.

USE msdb;
GO

EXEC dbo.sp_help_schedule;
GO

B. Listar informações para uma agenda específica

O exemplo a seguir lista as informações para a agenda chamada NightlyJobs.

USE msdb;
GO

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

Conteúdo relacionado