Delen via

sp_help_schedule (Transact-SQL)

Van toepassing op:SQL Server

Geeft informatie over roosters op.

Transact-SQL syntaxis-conventies

Syntaxis

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

De identificatie van het te vermelden schema. @schedule_id is int, met als standaard .NULL

Zowel @schedule_id als @schedule_name kunnen worden gespecificeerd.

[ @schedule_name = ] N'schedule_name'

De naam van het schema om te vermelden. @schedule_name is een systeemnaam, met als standaard NULL.

Zowel @schedule_id als @schedule_name kunnen worden gespecificeerd.

[ @attached_schedules_only = ] attached_schedules_only

Geeft aan of alleen schema's getoond mogen worden waaraan een taak is gekoppeld. @attached_schedules_only is bit, met een standaard van 0. Wanneer @attached_schedules_only , 0worden alle schema's getoond. Wanneer @attached_schedules_only is 1, bevat de resultaatset alleen schema's die aan een taak zijn gekoppeld.

[ @include_description = ] include_description

Specificeert of beschrijvingen in de resultaatset moeten worden opgenomen. @include_description is bit, met als standaard .0 Wanneer @include_description is 0, bevat de @schedule_description kolom van de resultaatset een tijdelijke aanduiding. Wanneer @include_description is 1, wordt de beschrijving van het schema opgenomen in de resultaatset.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Resultaatset

Deze procedure geeft de volgende resultaatset terug:

Kolomnaam Gegevenstype Description
schedule_id int Schema-identificatienummer.
schedule_uid uniqueidentifier Identificatie voor het schema.
schedule_name sysname Naam van de planning.
enabled int Of het schema nu (1) inschakelde of niet instond (0).
freq_type int Waarde die aangeeft wanneer de taak uitgevoerd moet worden.

1 = Eens
4 = Dagelijks
8 = Wekelijks
16 = Maandelijks
32 = Maandelijks, ten opzichte van de freq_interval
64 = Voer uit wanneer de SQLServerAgent-service start.
freq_interval int Dagen waarop de klus wordt uitgevoerd. De waarde hangt af van de waarde van freq_type. Zie sp_add_schedule voor meer informatie.
freq_subday_type int Eenheden voor freq_subday_interval. Zie sp_add_schedule voor meer informatie.
freq_subday_interval int Aantal periodes freq_subday_type tussen elke uitvoering van de taak. Zie sp_add_schedule voor meer informatie.
freq_relative_interval int Het aantal opdrachten van de freq_interval opdracht is elke maand gepland. Zie sp_add_schedule voor meer informatie.
freq_recurrence_factor int Aantal maanden tussen de geplande uitvoering van de klus.
active_start_date int Datum waarop het schema wordt geactiveerd.
active_end_date int Einddatum van het schema.
active_start_time int Tijd van de dag waarop het schema begint.
active_end_time int Het tijdstip van de dag eindigt.
date_created datetime Datum waarop het schema wordt gemaakt.
schedule_description nvarchar(4000) Een Engelse beschrijving van het schema (indien gevraagd).
job_count int Geeft terug hoeveel banen naar dit rooster verwijzen.

Opmerkingen

Wanneer er geen parameters zijn gegeven, sp_help_schedule geeft het informatie voor alle schema's in de instantie weer op.

Permissions

Je kunt rechten verlenen EXECUTE op deze procedure, maar deze rechten kunnen worden overschreven tijdens een SQL Server-upgrade.

Andere gebruikers moeten een van de volgende vaste SQL Server Agent-databaserollen in de msdb database krijgen:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Voor details over de rechten van deze rollen, zie SQL Server Agent Fixed Database Roles.

Leden van SQLAgentUserRole kunnen alleen de schema's bekijken die zij bezitten.

Voorbeelden

Eén. Lijstinformatie voor alle schema's in de instantie

Het volgende voorbeeld geeft informatie voor alle schema's in de instantie.

USE msdb;
GO

EXECUTE dbo.sp_help_schedule;
GO

B. Lijstinformatie voor een specifiek schema

Het volgende voorbeeld geeft informatie voor het schema genaamd NightlyJobs.

USE msdb;
GO

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

Verwante inhoud

  • Last updated on