sys.sp_changepublication_snapshot (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Verandert de eigenschappen van de Snapshot Agent voor de gespecificeerde publicatie. Deze opgeslagen procedure wordt uitgevoerd bij Publisher in de publicatiedatabase.

Important

Wanneer je een Publisher configureert met een externe Distributor, worden de waarden die voor alle parameters, inclusief @job_login en @job_password, als platte tekst naar de Distributor gestuurd. Versleutel de verbinding tussen publisher en de externe distributeur voordat u deze opgeslagen procedure uitvoert. Zie SQL Server Database Engine configureren voor het versleutelen van verbindingenvoor meer informatie.

Transact-SQL syntaxis-conventies

Syntax

sys.sp_changepublication_snapshot
    [ @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 = ] N'publisher' ]
    [ , [ @job_security_mode = ] job_security_mode ]
[ ; ]

Arguments

[ @publication = ] N'publicatie'

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

[ @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

Specificeert de dagen waarop de makelaar 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

De eenheden voor @freq_subday_interval. @frequency_subday is int, en kan een van deze 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 Snapshot Agent draait. @frequency_relative_interval is int, met een standaard van NULL.

[ @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 Snapshot 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 Snapshot Agent stopt met het inplannen zijn, 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 Snapshot 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 Snapshot Agent stopt met het inplannen zijn, geformatteerd als HHmmss. @active_end_time_of_day is int, met als standaard .NULL

[ @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), met een standaard van NULL.

[ @publisher_security_mode = ] publisher_security_mode

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

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

Important

Gebruik waar mogelijk Windows-verificatie.

[ @publisher_login = ] N'publisher_login'

De login die wordt gebruikt bij het verbinden met de Publisher. @publisher_login is een systeemnaam, met als standaard .NULL

@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 een systeemnaam, met als standaard NULL.

Important

Gebruik geen leeg wachtwoord. Gebruik een sterk wachtwoord. 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.

[ @job_login = ] N'job_login'

De login voor het Windows-account waaronder de agent draait. @job_login is nvarchar(257), met een standaard van NULL. 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. Dit kan niet worden aangepast voor een niet-SQL Server uitgever.

[ @job_password = ] N'job_password'

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

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.

[ @publisher = ] N'uitgever'

Hiermee geeft u een niet-SQL Server-uitgever. @publisher is sysname, met als standaard NULL.

Note

@publisher mag niet gebruikt worden bij het aanmaken van een Snapshot Agent op een SQL Server Publisher.

[ @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_changepublication_snapshot wordt gebruikt in momentopnamereplicatie, transactionele replicatie en samenvoegingsreplicatie.

Permissions

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