Dela via

sp_help_jobschedule (Transact-SQL)

Gäller för:SQL Server

Returnerar information om schemaläggning av jobb som används av SQL Server Management Studio för att utföra automatiserade aktiviteter.

Transact-SQL syntaxkonventioner

Syntax

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 ]
[ ; ]

Arguments

[ @job_id = ] 'job_id'

Jobbidentifieringsnumret. @job_id är unik identifierare, med standardvärdet .NULL

Antingen @job_id eller @job_name måste specificeras, men båda kan inte specificeras.

[ @job_name = ] N'job_name'

Namnet på tjänsten. @job_name är sysname, med standardvärdet .NULL

Antingen @job_id eller @job_name måste specificeras, men båda kan inte specificeras.

[ @schedule_name = ] N'schedule_name'

Namnet på schemaposten för jobbet. @schedule_name är sysname, med standardvärdet .NULL

[ @schedule_id = ] schedule_id

Identifikationsnumret för schemat för jobbet. @schedule_id är int, med standardvärdet .NULL

[ @include_description = ] include_description

Specificerar om beskrivningen av schemat ska inkluderas i resultatuppsättningen. @include_description är bit, med standardvärdet .0

  • När 0, ingår inte beskrivningen av schemat i resultatuppsättningen.
  • När 1, inkluderas beskrivningen av schemat i resultatuppsättningen.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Kolumnnamn Datatyp Description
schedule_id int Schemaidentifierarnummer.
schedule_name sysname Namnet på schemat.
enabled int Oavsett om schemat aktiverade (1) eller inte0.
freq_type int Värde som anger när jobbet ska utföras.

1 = En gång
4 = Dagligen
8 = Veckovis
16 = Månadsvis
32 = Månadsvis, relativt freq_interval
64 = Kör när SQL Server Agent-tjänsten startar.
freq_interval int Dagar då jobbet utförs. Värdet beror på värdet av freq_type. Mer information finns i sp_add_schedule.
freq_subday_type int Enheter för freq_subday_interval. Mer information finns i sp_add_schedule.
freq_subday_interval int Antal perioder freq_subday_type som ska inträffa mellan varje utförande av jobbet. Mer information finns i sp_add_schedule.
freq_relative_interval int Schemalagda jobb inträffar freq_interval varje månad. Mer information finns i sp_add_schedule.
freq_recurrence_factor int Antal månader mellan den planerade utförandet av jobbet.
active_start_date int Datum då schemat aktiveras.
active_end_date int Slutdatum för schemat.
active_start_time int Tid på dagen då schemat börjar.
active_end_time int Tidsschemat på dagen slutar.
date_created datetime Datum då schemat skapas.
schedule_description nvarchar(4000) En engelsk beskrivning av schemat som härleds från värden i msdb.dbo.sysschedules. När @include_description är 0, innehåller denna kolumn text som anger att beskrivningen inte begärdes.
next_run_date int Datera schemat nästa gång gör att jobbet körs.
next_run_time int Att tajma schemat nästa gång gör att jobbet körs.
schedule_uid uniqueidentifier Identifierare för schemat.
job_count int Antal återlämnade jobb.

Anmärkning

sp_help_jobschedule returnerar värden från dbo.sysjobschedules och dbo.sysschedules systemtabellerna i uppdateringar msdb.sysjobschedules var 20:e minut. Detta kan påverka de värden som returneras av denna lagrade procedur.

Anmärkningar

Parametrarna för sp_help_jobschedule kan endast användas i vissa kombinationer. Om @schedule_id anges kan @job_id och @job_name inte specificeras. Annars kan @job_id - eller @job_name-parametrarna användas med @schedule_name.

Permissions

Du kan ge EXECUTE behörigheter för denna procedur, men dessa behörigheter kan åsidosättas vid en SQL Server-uppgradering.

Andra användare måste tilldelas en av följande SQL Server Agent-fasta databasroller i databasen msdb :

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

För detaljer om behörigheterna för dessa roller, se SQL Server Agent Fixed Database Roles.

Medlemmar i SQLAgentUserRole kan endast se egenskaper för jobbscheman som de äger.

Examples

A. Returnera arbetsschemat för ett specifikt jobb

Följande exempel returnerar schemaläggningsinformationen för ett jobb med namnet BackupDatabase.

USE msdb;
GO

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

B. Returnera arbetsschemat för ett specifikt schema

Följande exempel returnerar informationen för schemat som heter NightlyJobs och jobbet som RunReportsheter .

USE msdb;
GO

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

C. Returnera arbetsschemat och schemabeskrivningen för ett specifikt schema

Följande exempel returnerar informationen för schemat som heter NightlyJobs och jobbet som RunReportsheter . Den resulterande uppsättningen innehåller en beskrivning av schemat.

USE msdb;
GO

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

Relaterat innehåll

  • Last updated on