Dela via

sp_help_schedule (Transact-SQL)

Gäller för:SQL Server

Listar information om scheman.

Transact-SQL syntaxkonventioner

Syntax

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

Arguments

[ @schedule_id = ] schedule_id

Identifieraren av schemat som ska listas. @schedule_id är int, med standardvärdet .NULL

Antingen @schedule_id eller @schedule_name kan specificeras.

[ @schedule_name = ] N'schedule_name'

Namnet på schemat som ska listas. @schedule_name är sysname, med standardvärdet .NULL

Antingen @schedule_id eller @schedule_name kan specificeras.

[ @attached_schedules_only = ] attached_schedules_only

Specificerar om man endast ska visa scheman som ett jobb är kopplat till. @attached_schedules_only är bit, med standardvärdet .0 När @attached_schedules_only är 0, visas alla scheman. När @attached_schedules_only är 1, innehåller resultatmängden endast scheman som är kopplade till ett jobb.

[ @include_description = ] include_description

Specificerar om beskrivningar ska inkluderas i resultatmängden. @include_description är bit, med standardvärdet .0 När @include_description är 0, innehåller den @schedule_description kolumnen i resultatmängden en platshållare. När @include_description är 1, inkluderas beskrivningen av schemat i resultatuppsättningen.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Denna procedur returnerar följande resultatuppsättning:

Kolumnnamn Datatyp Description
schedule_id int Schemaidentifierarnummer.
schedule_uid uniqueidentifier Identifierare för schemat.
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 SQLServerAgent-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 (om det efterfrågas).
job_count int Visar hur många jobb som refererar till detta schema.

Anmärkningar

När inga parametrar tillhandahålls, sp_help_schedule listas information för alla scheman i instansen.

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 de scheman de äger.

Examples

A. Listinformation för alla scheman i instansen

Följande exempel listar information för alla scheman i instansen.

USE msdb;
GO

EXECUTE dbo.sp_help_schedule;
GO

B. Listinformation för ett specifikt schema

Följande exempel listar information för schemat med namnet NightlyJobs.

USE msdb;
GO

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

Relaterat innehåll

  • Last updated on