Sdílet prostřednictvím

sp_help_jobschedule (Transact-SQL)

platí pro:SQL Server

Vrací informace o plánování úloh používaných SQL Server Management Studio k provádění automatizovaných aktivit.

Transact-SQL konvence syntaxe

Syntaxe

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'

Identifikační číslo úlohy. @job_id je uniqueidentifier, s výchozím nastavením NULL.

Buď @job_id , nebo @job_name musí být specifikovány, ale ani jedno nelze specifikovat.

[ @job_name = ] N'job_name'

Název úlohy. @job_name je sysname s výchozím nastavením NULL.

Buď @job_id , nebo @job_name musí být specifikovány, ale ani jedno nelze specifikovat.

[ @schedule_name = ] N'schedule_name'

Název položky v rozpisu pro danou práci. @schedule_name je sysname s výchozím nastavením NULL.

[ @schedule_id = ] schedule_id

Identifikační číslo položky v rozvrhu pro danou práci. @schedule_id je int, s výchozím nastavením NULL.

[ @include_description = ] include_description

Specifikuje, zda má být popis harmonogramu zahrnut do výsledné množiny. @include_description je bit, s výchozím hodnotou 0.

  • Když 0, popis rozvrhu není zahrnut ve výsledné množině.
  • Když 1, popis rozvrhu je zahrnut do výsledné množiny.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Název sloupce Datový typ Description
schedule_id int Identifikační číslo rozpisu.
schedule_name sysname Název plánu
enabled int Ať už byl plán povolen (1) nebo ne (0).
freq_type int Hodnota označující, kdy má být úkol vykonán.

1 = Jednou
4 = Denně
8 = Týden
16 = Měsíční
32 = Měsíčně, vzhledem k freq_interval
64 = Spustit při spuštění služby SQL Server Agent.
freq_interval int Dny, kdy je práce vykonána. Hodnota závisí na hodnotě .freq_type Další informace najdete v tématu sp_add_schedule.
freq_subday_type int Jednotky pro freq_subday_interval. Další informace najdete v tématu sp_add_schedule.
freq_subday_interval int Počet period, freq_subday_type které musí nastat mezi jednotlivými vykonáními úkolu. Další informace najdete v tématu sp_add_schedule.
freq_relative_interval int Plánované freq_interval práce se vyskytují každý měsíc. Další informace najdete v tématu sp_add_schedule.
freq_recurrence_factor int Počet měsíců mezi plánovaným dokončením zakázky.
active_start_date int Datum aktivace rozpisu.
active_end_date int Datum ukončení rozpisu.
active_start_time int Čas dne, kdy začíná rozvrh.
active_end_time int Denní rozvrh končí.
date_created datetime Datum vytvoření rozpisu.
schedule_description nvarchar(4000) Anglický popis plánu odvozený z hodnot v msdb.dbo.sysschedules. Když @include_description je 0, tento sloupec obsahuje text, který uvádí, že popis nebyl požádán.
next_run_date int Datum dalšího rozvrhu způsobí, že se úkol spustí.
next_run_time int Časování dalšího rozvrhu způsobí, že se úkol spustí.
schedule_uid uniqueidentifier Identifikátor rozvrhu.
job_count int Počet vrácených pracovních míst.

Poznámka:

sp_help_jobschedule vrací hodnoty z tabulek dbo.sysjobschedulesdbo.sysschedules a systém v msdb.sysjobschedules aktualizacích každých 20 minut. To může ovlivnit hodnoty, které tato uložená procedura vrací.

Poznámky

Parametry lze sp_help_jobschedule použít pouze v určitých kombinacích. Pokud je @schedule_id specifikováno, @job_id a @job_name nelze specifikovat. Jinak lze @job_id nebo @job_name parametry použít s @schedule_name.

Povolení

Na tomto postupu můžete udělit EXECUTE oprávnění, ale tato oprávnění mohou být během upgradu SQL Serveru přepsána.

Ostatní uživatelé musí mít v databázi msdb přiděleny některé z následujících pevných databázových rolí SQL Server Agent:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Podrobnosti o oprávněních těchto rolí naleznete v SQL Server Agent Fixed Database Roles.

Členové SQLAgentUserRole mohou zobrazit pouze vlastnosti rozvrhů úloh, které vlastní.

Examples

A. Vraťte rozvrh úkolů pro konkrétní práci

Následující příklad vrací informace o plánování pro úkol jménem BackupDatabase.

USE msdb;
GO

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

B. Vraťte rozvrh prací pro konkrétní rozvrh

Následující příklad vrací informace o pojmenovaném plánu NightlyJobs a o práci s názvem RunReports.

USE msdb;
GO

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

C. Vraťte rozvrh práce a popis rozvrhu pro konkrétní rozvrh

Následující příklad vrací informace o pojmenovaném plánu NightlyJobs a o práci s názvem RunReports. Vrácená sada výsledků obsahuje popis harmonogramu.

USE msdb;
GO

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

Související obsah

  • Last updated on