sys.sp_changedynamicsnapshot_job (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Wijzigt de agent-taak die de snapshot genereert voor een abonnement op een publicatie met een geparametriseerd rijfilter. Deze opgeslagen procedure wordt uitgevoerd bij Publisher in de publicatiedatabase.

Transact-SQL syntaxis-conventies

Syntax

sys.sp_changedynamicsnapshot_job
    [ @publication = ] N'publication'
    [ , [ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname' ]
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]
    [ , [ @frequency_type = ] frequency_type ]
    [ , [ @frequency_interval = ] frequency_interval ]
    [ , [ @frequency_subday = ] frequency_subday ]
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ]
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ]
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
    [ , [ @active_start_date = ] active_start_date ]
    [ , [ @active_end_date = ] active_end_date ]
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ]
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ]
    [ , [ @job_login = ] N'job_login' ]
    [ , [ @job_password = ] N'job_password' ]
[ ; ]

Arguments

[ @publication = ] N'publicatie'

De naam van de publicatie. @publication is sysname, zonder standaard.

[ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname'

De naam van de snapshot-klus wordt veranderd. @dynamic_snapshot_jobname is sysname, met als standaard .%

Als @dynamic_snapshot_jobid is opgegeven, moet je de standaardwaarde voor @dynamic_snapshot_jobname gebruiken.

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'

De ID van de snapshot-taak wordt veranderd. @dynamic_snapshot_jobid is uniqueidentifier, met een standaard van NULL.

Als @dynamic_snapshot_jobname is opgegeven, moet je de standaardwaarde voor @dynamic_snapshot_jobid gebruiken.

[ @frequency_type = ] frequency_type

Geeft de frequentie aan waarmee de agent gepland moet worden. @frequency_type is int, en kan een van de volgende waarden zijn.

Value Description
1 Eenmaal
2 Op aanvraag
4 Dagelijks
8 Wekelijks
16 Maandelijks
32 Maandelijkse verwant
64 Autostart
128 Terugkerend
NULL (standaard)

[ @frequency_interval = ] frequency_interval

De dagen waarop de agent werkt. @frequency_interval is int, en kan een van de volgende waarden zijn.

Value Description
1 Zondag
2 maandag
3 Tuesday
4 woensdag
5 donderdag
6 Vrijdag
7 Zaterdag
8 Dag
9 Doordeweeks
10 Weekenddagen
NULL (standaard)

[ @frequency_subday = ] frequency_subday

Geeft aan hoe vaak je verzet moet worden tijdens de vastgestelde periode. @frequency_subday is int, en kan een van de volgende waarden zijn.

Value Description
1 Eenmaal
2 Second
4 Minuut
8 Uur
NULL (standaard)

[ @frequency_subday_interval = ] frequency_subday_interval

De pauze voor @frequency_subday. @frequency_subday_interval is int, met als standaard .NULL

[ @frequency_relative_interval = ] frequency_relative_interval

De datum waarop de Merge Agent draait. Deze parameter wordt gebruikt wanneer @frequency_type is ingesteld op 32 (maandelijkse relatieve). @frequency_relative_interval is int, en kan een van de volgende waarden zijn.

Value Description
1 First
2 Second
4 Third
8 Fourth
16 Laatste
NULL (standaard)

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

De door @frequency_type gebruikte recurrence factor @frequency_recurrence_factor is int, met als standaard .NULL

[ @active_start_date = ] active_start_date

De datum waarop de Merge Agent voor het eerst wordt gepland, geformatteerd als yyyyMMdd. @active_start_date is int, met een standaard van NULL.

[ @active_end_date = ] active_end_date

De datum waarop de Merge Agent stopt met worden gepland, geformatteerd als yyyyMMdd. @active_end_date is int, met als standaard .NULL

[ @active_start_time_of_day = ] active_start_time_of_day

Het tijdstip waarop de Merge Agent voor het eerst wordt gepland, geformatteerd als HHmmss. @active_start_time_of_day is int, met als standaard .NULL

[ @active_end_time_of_day = ] active_end_time_of_day

Het tijdstip waarop de Merge Agent stopt met worden gepland, geformatteerd als HHmmss. @active_end_time_of_day is int, met als standaard .NULL

[ @job_login = ] N'job_login'

Het Windows-account waaronder de Snapshot Agent draait bij het genereren van de snapshot voor een abonnement met een geparametriseerd rijfilter. @job_login is nvarchar(257), met een standaard van NULL.

[ @job_password = ] N'job_password'

Het wachtwoord voor het Windows-account waaronder de Snapshot Agent draait bij het genereren van de snapshot voor een abonnement met een geparametriseerd rijfilter. @job_password is systeemnaam, met als standaard .NULL

Important

Indien mogelijk vraagt u gebruikers om beveiligingsreferenties in te voeren tijdens runtime. Als u referenties in een scriptbestand moet opslaan, moet u het bestand beveiligen om onbevoegde toegang te voorkomen.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Remarks

sp_changedynamicsnapshot_job wordt gebruikt bij merge-replicatie voor publicaties met geparametriseerde rijfilters.

Na het wijzigen van een agent-login of wachtwoord moet je de agent stoppen en opnieuw starten voordat de wijziging van kracht wordt.

Permissions

Alleen leden van de sysadmin-vaste serverrol of db_owner vaste databaserol kunnen uitvoeren sp_changedynamicsnapshot_job.