Partilhar via


sp_help_jobcount (Transact-SQL)

Aplica-se a:SQL Server

Fornece o número de trabalhos aos quais uma agenda é anexada.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_help_jobcount
    [ [ @schedule_name = ] N'schedule_name' ]
    [ , [ @schedule_id = ] schedule_id ]
[ ; ]

Argumentos

@schedule_id [ = ] schedule_id

O identificador da agenda a ser listado. @schedule_id é int, sem padrão.

Qualquer @schedule_id ou @schedule_name pode ser especificado.

@schedule_name [ = ] N'schedule_name'

O nome da agenda a ser listada. @schedule_name é sysname, sem padrão.

Qualquer @schedule_id ou @schedule_name pode ser especificado.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Retorna o seguinte conjunto de resultados:

Nome da coluna Tipo de dados Descrição
JobCount int Número de trabalhos para a agenda especificada.

Comentários

Este procedimento lista o número de trabalhos anexados à agenda especificada.

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.

Somente membros do sysadmin podem exibir contagens para trabalhos que pertencem a outras pessoas.

Exemplos

O exemplo a seguir lista o número de trabalhos anexados à agenda NightlyJobs.

USE msdb;
GO

EXEC sp_help_jobcount
    @schedule_name = N'NightlyJobs';
GO