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

Pode ser especificado @schedule_id ou @schedule_name .

@schedule_name [ = ] N'schedule_name'

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

Pode ser especificado @schedule_id ou @schedule_name .

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 do msdb 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 administrador de sistema podem exibir contagens de 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