Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Geldt op:SQL Server
Azure 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.