sys.sp_changepublication_snapshot (Transact-SQL)

Dotyczy:SQL ServerAzure SQL Managed Instance

Zmienia właściwości Snapshot Agent dla określonej publikacji. Ta procedura składowana jest wykonywana w programie Publisher w bazie danych publikacji.

Ważna

Gdy konfigurujesz Publisher z odległym dystrybutorem, wartości dla wszystkich parametrów, w tym @job_login i @job_password, są przesyłane do dystrybutora jako tekst zwykły. Przed wykonaniem tej procedury składowanej należy zaszyfrować połączenie między wydawcą a jego zdalnym dystrybutorem. Aby uzyskać więcej informacji, zobacz sekcję Konfigurowanie silnika bazy danych SQL Server w celu szyfrowania połączeń.

Transact-SQL konwencje składni

Składnia

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

Nazwa publikacji. @publication to sysname, bez domyślnego zapisu.

[ @frequency_type = ] frequency_type

Określa częstotliwość planowania agenta. @frequency_type to int i może być jedną z następujących wartości.

Value Description
1 Jeden raz
2 Na żądanie
4 Codziennie
8 Co tydzień
16 Miesięczny
32 Miesięczny pokrewny
64 Autostart
128 Płatność cykliczna
NULL (ustawienie domyślne)

[ @frequency_interval = ] frequency_interval

Określa dni, w których agent działa. @frequency_interval to int i może być jedną z następujących wartości.

Value Description
1 Niedziela
2 Poniedziałek
3 Tuesday
4 Środa
5 Czwartek
6 Piątek
7 Sobota
8 Dzień
9 Dni powszednie
10 Dni weekendowe
NULL (ustawienie domyślne)

[ @frequency_subday = ] frequency_subday

Jednostki do @freq_subday_interval. @frequency_subday jest int i może być jedną z tych wartości.

Value Description
1 Raz
2 Second
4 Minuta
8 Godzina
NULL (ustawienie domyślne)

[ @frequency_subday_interval = ] frequency_subday_interval

Przerwa na @frequency_subday. @frequency_subday_interval jest int, z domyślnym .NULL

[ @frequency_relative_interval = ] frequency_relative_interval

Data, kiedy Snapshot Agent biegnie. @frequency_relative_interval jest int, z domyślnym .NULL

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Współczynnik powtarzalności używany przez @frequency_type. @frequency_recurrence_factor jest int, z domyślnym .NULL

[ @active_start_date = ] active_start_date

Data, kiedy Snapshot Agent jest po raz pierwszy zaplanowany, sformatowana jako yyyyMMdd. @active_start_date jest int, z domyślnym .NULL

[ @active_end_date = ] active_end_date

Data, kiedy Snapshot Agent przestaje być zaplanowany, sformatowana jako yyyyMMdd. @active_end_date jest int, z domyślnym .NULL

[ @active_start_time_of_day = ] active_start_time_of_day

Pora dnia, w której Snapshot Agent jest po raz pierwszy zaplanowany, sformatowana jako HHmmss. @active_start_time_of_day jest int, z domyślnym .NULL

[ @active_end_time_of_day = ] active_end_time_of_day

Pora dnia, kiedy Snapshot Agent przestaje być planowany, sformatowana jako HHmmss. @active_end_time_of_day jest int, z domyślnym obciążeniem NULL.

[ @snapshot_job_name = ] N'snapshot_job_name'

Nazwa istniejącej nazwy stanowiska Snapshot Agent, jeśli używane jest już stanowisko. @snapshot_job_name to nvarchar(100), z domyślnym obciążeniem NULL.

[ @publisher_security_mode = ] publisher_security_mode

Tryb bezpieczeństwa używany przez agenta podczas łączenia z Publisher. @publisher_security_mode jest int, z domyślnym obciążeniem NULL. Dla wydawców niebędących SQL Server musi być określona wartość .0

  • 0 określa uwierzytelnianie SQL Server
  • 1 określa uwierzytelnianie Windows

Ważna

Jeśli to możliwe, użyj uwierzytelniania systemu Windows.

[ @publisher_login = ] N'publisher_login'

Login używany podczas łączenia się z Publisher. @publisher_login to nazwa systemu, z domyślnym .NULL

@publisher_login musi być określony, gdy @publisher_security_mode jest .0 Jeśli @publisher_login jest i NULL@publisher_security_mode to , 1to konto Windows określone w @job_login jest używane podczas łączenia z Publisher.

[ @publisher_password = ] N'publisher_password'

Hasło używane podczas łączenia się z Wydawcą. @publisher_password jest nazwą systemu z domyślnym .NULL

Ważna

Nie używaj pustego hasła. Użyj silnego hasła. Jeśli to możliwe, monituj użytkowników o wprowadzenie poświadczeń zabezpieczeń w czasie wykonywania. Jeśli musisz przechowywać poświadczenia w pliku skryptu, musisz zabezpieczyć plik, aby zapobiec nieautoryzowanemu dostępowi.

[ @job_login = ] N'job_login'

Logowanie do konta Windows, na którym agent działa. @job_login to nvarchar(257), z domyślnym obciążeniem NULL. To konto Windows jest zawsze używane do połączeń agentów z dystrybutorem. Musisz podać ten parametr podczas tworzenia nowego zadania Snapshot Agent. Nie da się tego zmienić w przypadku wydawcy spoza SQL Server.

[ @job_password = ] N'job_password'

Hasło do konta Windows, pod którym działa agent. @job_password to nazwa systemu, z domyślnym .NULL Musisz podać ten parametr podczas tworzenia nowego zadania Snapshot Agent.

Ważna

Jeśli to możliwe, monituj użytkowników o wprowadzenie poświadczeń zabezpieczeń w czasie wykonywania. Jeśli musisz przechowywać poświadczenia w pliku skryptu, musisz zabezpieczyć plik, aby zapobiec nieautoryzowanemu dostępowi.

[ @publisher = ] N'publisher'

Określa wydawcę programu innego niż SQL Server. @publisher to nazwa systemu, z domyślnym .NULL

Note

@publisher nie powinno być używane przy tworzeniu Snapshot Agent na SQL Server Publisher.

[ @job_security_mode = ] job_security_mode

Zidentyfikowane tylko do celów informacyjnych. Niewspierane. Zgodność w przyszłości nie jest gwarantowana.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Remarks

sp_changepublication_snapshot jest używany w replikacji migawki, replikacji transakcyjnej i replikacji scalania.

Permissions

Tylko członkowie roli stałego serwera systemowego lub stałej db_owner stałej bazy danych mogą wykonywać sp_changepublication_snapshot.