sys.sp_changedynamicsnapshot_job (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Modifierar agentjobbet som genererar ögonblicksbildskopian för en prenumeration på en publikation med ett parameteriserat radfilter. Den här lagrade proceduren körs i Publisher i publikationsdatabasen.

Transact-SQL syntaxkonventioner

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'publicering'

Namnet på publikationen. @publication är sysname, utan standard.

[ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname'

Namnet på snapshot-jobbet ändras. @dynamic_snapshot_jobname är sysname, med standardvärdet .%

Om @dynamic_snapshot_jobid anges måste du använda standardvärdet för @dynamic_snapshot_jobname.

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'

ID:t för snapshot-jobbet ändras. @dynamic_snapshot_jobid är unik identifierare, med standardvärdet .NULL

Om @dynamic_snapshot_jobname anges måste du använda standardvärdet för @dynamic_snapshot_jobid.

[ @frequency_type = ] frequency_type

Specificerar hur ofta agenten ska schemalis. @frequency_type är int, och kan vara ett av följande värden.

Value Description
1 En gång
2 På begäran
4 Daglig
8 En gång i veckan
16 Monthly
32 Månadssläkting
64 Automatisk start
128 Återkommande
NULL (standardinställning)

[ @frequency_interval = ] frequency_interval

De dagar då agenten är på drift. @frequency_interval är int, och kan vara ett av följande värden.

Value Description
1 Sunday
2 Måndag
3 Tuesday
4 Onsdag
5 Torsdag
6 Fredag
7 lördag
8 Dag
9 Vardagar
10 Helgdagar
NULL (standardinställning)

[ @frequency_subday = ] frequency_subday

Specificerar hur ofta man ska boka om under den definierade perioden. @frequency_subday är int, och kan vara ett av följande värden.

Value Description
1 En gång
2 Second
4 Minut
8 Timme
NULL (standardinställning)

[ @frequency_subday_interval = ] frequency_subday_interval

Pausen för @frequency_subday. @frequency_subday_interval är int, med standardvärdet .NULL

[ @frequency_relative_interval = ] frequency_relative_interval

Datumet då Merge Agent körs. Denna parameter används när @frequency_type sätts till 32 (månatlig relativ). @frequency_relative_interval är int, och kan vara ett av följande värden.

Value Description
1 First
2 Second
4 Third
8 Fourth
16 Sist
NULL (standardinställning)

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Upprepningsfaktorn som används av @frequency_type. @frequency_recurrence_factor är int, med standardvärdet .NULL

[ @active_start_date = ] active_start_date

Datumet då Merge Agent först schemaläggs och formateras som yyyyMMdd. @active_start_date är int, med standardvärdet .NULL

[ @active_end_date = ] active_end_date

Datumet då Merge Agent slutar schemalagas, formaterat som yyyyMMdd. @active_end_date är int, med standardvärdet .NULL

[ @active_start_time_of_day = ] active_start_time_of_day

Den tid på dygnet då Merge Agent först schemaläggs och formateras som HHmmss. @active_start_time_of_day är int, med standardvärdet .NULL

[ @active_end_time_of_day = ] active_end_time_of_day

Den tid på dygnet då Merge Agent slutar schemaläggas och formateras som HHmmss. @active_end_time_of_day är int, med standardvärdet .NULL

[ @job_login = ] N'job_login'

Det Windows-konto som Snapshot Agent körs under när snapshoten genereras för en prenumeration med ett parameteriserat radfilter. @job_login är nvarchar(257), med en standard på NULL.

[ @job_password = ] N'job_password'

Lösenordet för Windows-kontot under vilket Snapshot Agent körs när snapshoten genereras för en prenumeration med ett parameteriserat radfilter. @job_password är sysname, med standardvärdet .NULL

Important

När det är möjligt uppmanar du användarna att ange säkerhetsautentiseringsuppgifter vid körning. Om du måste lagra autentiseringsuppgifter i en skriptfil måste du skydda filen för att förhindra obehörig åtkomst.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Remarks

sp_changedynamicsnapshot_job används i sammanslagningsreplikering för publikationer med parameteriserade radfilter.

Efter att ha bytt agentinloggning eller lösenord måste du stoppa och starta om agenten innan ändringen träder i kraft.

Permissions

Endast medlemmar av sysadmin-fasta serverrollen eller db_owner fasta databasrollen kan köra sp_changedynamicsnapshot_job.