sys.sp_MSchange_snapshot_agent_properties (Transact-SQL)

Gäller för:SQL Server

Ändrar egenskaperna för ett Snapshot Agent-jobb som körs på en SQL Server 2005 (9.x) eller senare version av Distributor. Denna lagrade procedur används för att ändra egenskaper när Publisher körs på en instans av SQL Server 2000 (8.x). Denna lagrade procedur utförs hos distributören i distributionsdatabasen.

Transact-SQL syntaxkonventioner

Syntax

sys.sp_MSchange_snapshot_agent_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'publication'
    , [ @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
    , [ @snapshot_job_name = ] N'snapshot_job_name'
    , [ @publisher_security_mode = ] publisher_security_mode
    , [ @publisher_login = ] N'publisher_login'
    , [ @publisher_password = ] N'publisher_password'
    , [ @job_login = ] N'job_login'
    , [ @job_password = ] N'job_password'
    , [ @publisher_type = ] N'publisher_type'
    [ , [ @job_security_mode = ] job_security_mode ]
[ ; ]

Arguments

[ @publisher = ] N'publisher'

Namnet på utgivaren. @publisher är sysname, utan standard.

[ @publisher_db = ] N'publisher_db'

Namnet på publikationsdatabasen. @publisher_db är sysname, utan standard.

[ @publication = ] N'publicering'

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

[ @frequency_type = ] frequency_type

Specificerar hur ofta Snapshot Agent körs. @frequency_type är int, och kan vara ett av dessa värden.

Value Beskrivning
1 En gång
2 På begäran
4 Daglig
8 En gång i veckan
10 Monthly
20 Månadsvis, relativt frekvensintervallet
40 När SQL Server Agent startar

[ @frequency_interval = ] frequency_interval

Värdet som gäller för frekvensen som sätts av @frequency_type. @frequency_interval är int, utan standard.

[ @frequency_subday = ] frequency_subday

Enheterna för @frequency_subday_interval. @frequency_subday är int, och kan vara ett av dessa värden.

Value Beskrivning
1 En gång
2 Second
4 Minut
8 Timme

[ @frequency_subday_interval = ] frequency_subday_interval

Pausen för @frequency_subday. @frequency_subday_interval är int, utan standard.

[ @frequency_relative_interval = ] frequency_relative_interval

Datumet då Snapshot Agent körs. @frequency_relative_interval är int, utan standard.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Upprepningsfaktorn som används av @frequency_type. @frequency_recurrence_factor är int, utan standard.

[ @active_start_date = ] active_start_date

Datumet då Snapshot Agent först schemaläggs och formateras som yyyyMMdd. @active_start_date är int, utan standard.

[ @active_end_date = ] active_end_date

Datumet då Snapshot Agent slutar schemalagas, formaterat som yyyyMMdd. @active_end_date är int, utan standard.

[ @active_start_time_of_day = ] active_start_time_of_day

Den tid på dagen då Snapshot Agent först schemaläggs och formateras som HHmmss. @active_start_time_of_day är int, utan standard.

[ @active_end_time_of_day = ] active_end_time_of_day

Den tid på dagen då Snapshot Agent slutar schemaläggas och formateras som HHmmss. @active_end_time_of_day är int, utan standard.

[ @snapshot_job_name = ] N'snapshot_job_name'

Namnet på ett befintligt Snapshot Agent-jobb om ett befintligt jobb används. @snapshot_job_name är nvarchar(100), utan standard.

[ @publisher_security_mode = ] publisher_security_mode

Säkerhetsläget som agenten använder när de ansluter till Publisher. @publisher_security_mode är int, utan standard. Ett värde på 0 måste anges för icke-SQL Server Publishers.

  • 0 specificerar SQL Server-autentisering
  • 1 specificerar Windows-autentisering

Använd Windows-autentisering när det är möjligt.

[ @publisher_login = ] N'publisher_login'

Inloggningen som används vid anslutning till Publisher. @publisher_login är sysname, utan standard. @publisher_login måste specificeras när @publisher_security_mode är 0. Om @publisher_login är NULL och @publisher_security_mode är 1, används det Windows konto som anges i @job_login när man ansluter till Publisher.

[ @publisher_password = ] N'publisher_password'

Lösenordet som används vid anslutning till utgivaren. @publisher_password är nvarchar(524), utan standard.

Important

Spara inte autentiseringsinformation i skriptfiler. För att förbättra säkerheten rekommenderar vi att du anger inloggningsnamn och lösenord vid körning.

[ @job_login = ] N'job_login'

Inloggningen för Windows-kontot där agenten körs. @job_login är nvarchar(257), utan standard. Detta Windows-konto används alltid för agentanslutningar till distributören. Du måste ange denna parameter när du skapar ett nytt Snapshot Agent-jobb.

Note

Denna egendom kan inte ändras mot en icke-SQL Server Publisher.

[ @job_password = ] N'job_password'

Lösenordet till Windows-kontot som agenten körs under. @job_password är sysname, utan standard. Du måste ange denna parameter när du skapar ett nytt Snapshot Agent-jobb.

Important

Spara inte autentiseringsinformation i skriptfiler. För att förbättra säkerheten rekommenderar vi att du anger inloggningsnamn och lösenord vid körning.

[ @publisher_type = ] N'publisher_type'

Specificerar Publisher-typen när Publisher inte körs i en instans av SQL Server. @publisher_type är sysname och kan vara ett av följande värden.

Value Beskrivning
MSSQLSERVER Anger en SQL Server Publisher.
ORACLE Anger en Standard Oracle Publisher.
ORACLE GATEWAY Anger en Oracle Gateway-utgivare.

För mer information om skillnaderna mellan en Oracle Publisher och en Oracle Gateway Publisher, se Oracle Publishing Overview.

[ @job_security_mode = ] job_security_mode

Identifieras endast i informationssyfte. Stöds ej. Framtida kompatibilitet garanteras inte.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Remarks

sp_MSchange_snapshot_agent_properties används i replikering av ögonblicksbilder, transaktionsreplikering och sammanslagningsreplikering.

Du måste specificera alla parametrar sp_MSchange_snapshot_agent_propertiesnär du kör . Kör sp_helppublication_snapshot för att returnera de aktuella egenskaperna för Snapshot Agent jobbet.

Du kan använda sp_changepublication_snapshot på Publisher för att ändra egenskaper hos ett Snapshot Agent jobb.

Permissions

Endast medlemmar av sysadmin-fasta serverrollen hos distributören kan köra sp_MSchange_snapshot_agent_properties.