sys.sp_changepublication_snapshot (Transact-SQL)

Geldt 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 syntaxisconventies

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 standaardnaam.

[ @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 een standaard van 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 een standaard van 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 een standaard van 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 een standaard van 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 een standaard van 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 een standaard van NULL. Er moet een waarde van 0 worden gespecificeerd voor niet-SQL Server Publishers.

  • 0specificeert SQL Server-authenticatie
  • 1specificeert Windows authentication
  • 5specificeert Microsoft Entra beheerde identiteitsauthenticatie met behulp van de standaard beheerde identiteit van Distributor. Alleen van toepassing wanneer zowel Distributor als Publisher Azure SQL Managed Instance-resources zijn.

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 sysname, met een standaard van NULL.

@publisher_login moet worden opgegeven 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. Niet gebruikt als @publisher_security_mode is 5.

[ @publisher_password = ] N'publisher_password'

Het wachtwoord dat wordt gebruikt bij het verbinden met de uitgever. @publisher_password is sysname, met een standaard van NULL. Niet gebruikt als @publisher_security_mode is 5.

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. Niet gebruikt als @job_security_mode is 5.

[ @job_password = ] N'job_password'

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

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 een standaard van NULL.

Note

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

[ @job_security_mode = ] job_security_mode

  • 0specificeert SQL Server-authenticatie van de agent naar de Distributor.
  • 1specificeert Windows authentication van de agent naar de Distributor.
  • 5specificeert Microsoft Entra beheerde identiteitsauthenticatie van de agent aan de distributeur met behulp van de standaard beheerde identiteit van de distributeur. Deze waarde is alleen van toepassing bij transactionele replicatie wanneer zowel de Distributor als de Publisher Azure SQL Managed Instance-resources zijn.

Codewaarden retourneren

0 (succes) of 1 (mislukking).

Remarks

sp_changepublication_snapshot wordt gebruikt bij snapshotreplicatie, transactionele replicatie en merge-replicatie.

Permissions

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