sys.sp_MSchange_snapshot_agent_properties (Transact-SQL)

Van toepassing op:SQL Server

Verandert de eigenschappen van een Snapshot Agent-taak die draait op een SQL Server 2005 (9.x) of latere versie Distributor. Deze opgeslagen procedure wordt gebruikt om eigenschappen te wijzigen wanneer de Publisher draait op een instantie van SQL Server 2000 (8.x). Deze opgeslagen procedure wordt uitgevoerd bij de distributeur in de distributiedatabase.

Transact-SQL syntaxis-conventies

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

De naam van de uitgever. @publisher is sysname, zonder standaardinstelling.

[ @publisher_db = ] N'publisher_db'

De naam van de publicatiedatabase. @publisher_db is systeemnaam, zonder standaard.

[ @publication = ] N'publicatie'

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

[ @frequency_type = ] frequency_type

Specificeert de frequentie waarmee de Snapshot Agent wordt uitgevoerd. @frequency_type is int, en kan een van deze waarden zijn.

[ @frequency_interval = ] frequency_interval

De waarde die moet worden toegepast op de frequentie die door @frequency_type wordt ingesteld. @frequency_interval is int, zonder standaard.

[ @frequency_subday = ] frequency_subday

De eenheden voor @frequency_subday_interval. @frequency_subday is int, en kan een van deze waarden zijn.

[ @frequency_subday_interval = ] frequency_subday_interval

De pauze voor @frequency_subday. @frequency_subday_interval is int, zonder standaard.

[ @frequency_relative_interval = ] frequency_relative_interval

De datum waarop de Snapshot Agent draait. @frequency_relative_interval is int, zonder standaard.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

De door @frequency_type gebruikte recurrence factor @frequency_recurrence_factor is int, zonder standaard.

[ @active_start_date = ] active_start_date

De datum waarop de Snapshot Agent voor het eerst wordt gepland, geformatteerd als yyyyMMdd. @active_start_date is int, zonder standaard.

[ @active_end_date = ] active_end_date

De datum waarop de Snapshot Agent stopt met het inplannen zijn, geformatteerd als yyyyMMdd. @active_end_date is int, zonder standaard.

[ @active_start_time_of_day = ] active_start_time_of_day

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

[ @active_end_time_of_day = ] active_end_time_of_day

Het tijdstip waarop de Snapshot Agent stopt met het inplannen zijn, geformatteerd als HHmmss. @active_end_time_of_day is int, zonder standaard.

[ @snapshot_job_name = ] N'snapshot_job_name'

De naam van een bestaande Snapshot Agent-functienaam als een bestaande taak wordt gebruikt. @snapshot_job_name is nvarchar(100), zonder standaard.

[ @publisher_security_mode = ] publisher_security_mode

De beveiligingsmodus die de agent gebruikt bij het verbinden met de Publisher. @publisher_security_mode is int, zonder standaard. Er moet een waarde van 0 worden gespecificeerd voor niet-SQL Server Publishers.

• 0 specificeert SQL Server-authenticatie
• 1 specificeert Windows-authenticatie

Gebruik waar mogelijk Windows-verificatie.

[ @publisher_login = ] N'publisher_login'

De login die wordt gebruikt bij het verbinden met de Publisher. @publisher_login is sysname, zonder standaard. @publisher_login moet worden gespecificeerd wanneer @publisher_security_mode is 0. Als @publisher_login is NULL en @publisher_security_mode is 1, dan wordt het Windows account dat in @job_login is gespecificeerd gebruikt bij het verbinden met de Publisher.

[ @publisher_password = ] N'publisher_password'

Het wachtwoord dat wordt gebruikt bij het verbinden met de uitgever. @publisher_password is nvarchar(524), zonder standaard.

[ @job_login = ] N'job_login'

De login voor het Windows-account waaronder de agent draait. @job_login is nvarchar(257), zonder standaard. Dit Windows-account wordt altijd gebruikt voor agentverbindingen met de Distributor. Je moet deze parameter invoeren bij het aanmaken van een nieuwe Snapshot Agent-taak.

[ @job_password = ] N'job_password'

Het wachtwoord voor het Windows-account waaronder de agent draait. @job_password is sysname, zonder standaard. Je moet deze parameter invoeren bij het aanmaken van een nieuwe Snapshot Agent-taak.

[ @publisher_type = ] N'publisher_type'

Specificeert het type Publisher wanneer de Publisher niet draait in een instantie van SQL Server. @publisher_typesysname is en kan een van de volgende waarden zijn.

Voor meer informatie over de verschillen tussen een Oracle Publisher en een Oracle Gateway Publisher, zie Oracle Publishing Overzicht.

[ @job_security_mode = ] job_security_mode

Alleen ter informatie geïdentificeerd. Wordt niet ondersteund. Toekomstige compatibiliteit is niet gegarandeerd.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Remarks

sp_MSchange_snapshot_agent_properties wordt gebruikt in momentopnamereplicatie, transactionele replicatie en samenvoegingsreplicatie.

Je moet alle parameters specificeren bij het uitvoeren sp_MSchange_snapshot_agent_propertiesvan . Voer sp_helppublication_snapshot uit om de huidige eigenschappen van de Snapshot Agent taak terug te geven.

Je kunt sp_changepublication_snapshot op de Publisher gebruiken om eigenschappen van een Snapshot Agent baan te veranderen.

Permissions

Alleen leden van de sysadmin-vaste serverrol bij de Distributor kunnen uitvoeren sp_MSchange_snapshot_agent_properties.

Verwante inhoud

• sys.sp_addpublication_snapshot (Transact-SQL)