sp_changesubstatus (języka Transact-SQL)
Zmienia stan istniejących subskrybenta.Ta procedura składowana jest wykonywany Wydawca publikacja bazy danych.
.gif "Ikona łącza do tematu")
Składnia
sp_changesubstatus [ [ @publication = ] 'publication' ]
[ , [ @article = ] 'article' ]
[ , [ @subscriber = ] 'subscriber' ]
, [ @status = ] 'status'
[ , [ @previous_status = ] 'previous_status' ]
[ , [ @destination_db = ] 'destination_db' ]
[ , [ @frequency_type = ] frequency_type ]
[ , [ @frequency_interval = ] frequency_interval ]
[ , [ @frequency_relative_interval = ] frequency_relative_interval ]
[ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
[ , [ @frequency_subday = ] frequency_subday ]
[ , [ @frequency_subday_interval = ] frequency_subday_interval ]
[ , [ @active_start_time_of_day = ] active_start_time_of_day ]
[ , [ @active_end_time_of_day = ] active_end_time_of_day ]
[ , [ @active_start_date = ] active_start_date ]
[ , [ @active_end_date = ] active_end_date ]
[ , [ @optional_command_line = ] 'optional_command_line' ]
[ , [ @distribution_jobid = ] distribution_jobid ]
[ , [ @from_auto_sync = ] from_auto_sync ]
[ , [ @ignore_distributor = ] ignore_distributor ]
[ , [ @offloadagent= ] remote_agent_activation ]
[ , [ @offloadserver= ] 'remote_agent_server_name' ]
[ , [ @dts_package_name= ] 'dts_package_name' ]
[ , [ @dts_package_password= ] 'dts_package_password' ]
[ , [ @dts_package_location= ] dts_package_location ]
[ , [ @skipobjectactivation = ] skipobjectactivation
[ , [ @distribution_job_name= ] 'distribution_job_name' ]
[ , [ @publisher = ] 'publisher' ]
Argumenty
[ @publikacja =] 'publication'
Jest to nazwa publikacja.publicationjest Sysname, domyślna %.Jeśli publication nie jest określony, wszystkie publikacje, których dotyczy problem.[ @artykuł=] 'article'
Jest nazwą artykuł.Musi być unikatowa dla publikacja.articlejest Sysname, domyślna %.Jeśli article nie jest określony, wszystkie artykuły, których dotyczy problem.[ @subskrybent =] 'subscriber'
Jest to nazwa subskrybenta do zmiany stanu.subscriberjest Sysname, domyślna %.Jeśli subscriber nie jest określony, zmiany stanu wszystkich abonentów określonego artykuł.[ @ Stan =] 'status'
Jest to stan subskrypcja w syssubscriptions tabela.statusjest Sysname, z domyślnej nie może mieć jedną z tych wartości.Wartość
Opis
aktywne
Abonent jest synchronizowane i odbierania danych.
nieaktywny
Istnieje wpis subskrybenta bez subskrypcja.
subskrybowane
Subskrybent żąda danych, ale nie jest jeszcze zsynchronizowane.
[ @ previous_status =] 'previous_status'
Jest poprzedni stan subskrypcja.previous_statusjest Sysname, domyślna wartość NULL.Ten parametr umożliwia zmianę żadnych subskrypcji, które obecnie ma tego statusu, umożliwiając funkcje grup na określony zestaw subskrypcji (na przykład, ustawienie wszystkie aktywne subskrypcje z powrotem do subskrybowane).[ @ destination_db =] 'destination_db'
Jest to nazwa obiekt docelowy bazy danych.destination_dbjest Sysname, domyślna %.[ @ frequency_type =] frequency_type
Jest częstotliwość zaplanować zadanie dystrybucji.frequency_typejest int, domyślna wartość NULL.[ @ frequency_interval =] frequency_interval
Jest wartością, którą stosuje się do częstotliwości zestaw przez frequency_type.frequency_intervaljest int, domyślna wartość NULL.[ @ frequency_relative_interval =] frequency_relative_interval
Jest to data zadanie dystrybucji.Ten parametr jest używany podczas frequency_type jest zestaw 32 (względne miesięcznych).frequency_relative_intervaljest int, i może być jedną z tych wartości.Wartość
Opis
1
First
2
Drugie
4
Trzecia
8
Czwarty
16
Last
Wartość NULL (wartość domyślna)
[ @ frequency_recurrence_factor =] frequency_recurrence_factor
Jest używany przez współczynnik cykl frequency_type.frequency_recurrence_factorjest int, domyślna wartość NULL.[ @ frequency_subday =] frequency_subday
Jak często jest w minutach, aby ponownie zaplanować w definiowanym okresie.frequency_subdayjest int, i może być jedną z tych wartości.Wartość
Opis
1
Raz
2
Drugie
4
Minuta
8
Godzina
Wartość NULL (wartość domyślna)
[ @ frequency_subday_interval =] frequency_subday_interval
Interwał dla frequency_subday.frequency_subday_intervaljest int, domyślna wartość NULL.[ @ active_start_time_of_day =] active_start_time_of_day
czas po pierwsze zadanie dystrybucji zaplanowano, sformatowane jako HHMMSS.active_start_time_of_dayjest int, domyślna wartość NULL.[ @ active_end_time_of_day =] active_end_time_of_day
czas kiedy Zatrzymuje zadanie dystrybucji jest zaplanowane, sformatowane jako HHMMSS.active_end_time_of_dayjest int, domyślna wartość NULL.[ @ active_start_date =] active_start_date
Jest data w przypadku dystrybucji najpierw zadanie jest, w formacie RRRRMMDD.active_start_datejest int, domyślna wartość NULL.[ @ active_end_date =] active_end_date
Jest data zatrzymania zadania dystrybucji planowany, w formacie RRRRMMDD.active_end_datejest int, domyślna wartość NULL.[ @ optional_command_line =] 'optional_command_line'
To opcjonalny wiersz polecenia.optional_command_linejest nvarchar(4000), domyślna wartość NULL.[ @ distribution_jobid =] distribution_jobid
To identyfikator zadanie agenta dystrybucji u dystrybutora subskrypcja podczas zmiany stanu subskrypcja z nieaktywny na aktywny.W innych przypadkach nie jest zdefiniowane.Jeśli więcej niż jednego agenta dystrybucji jest zaangażowany w jednym wywołaniu tej procedura składowana, wynik nie jest zdefiniowany.distribution_jobidjest Binary(16), domyślna wartość NULL.[ @ from_auto_sync =] from_auto_sync
Określone tylko w celach informacyjnych. Nieobsługiwane. Przyszła zgodność nie jest gwarantowana.[ @ ignore_distributor =] ignore_distributor
Określone tylko w celach informacyjnych. Nieobsługiwane. Przyszła zgodność nie jest gwarantowana.[ @ offloadagent = ] remote_agent_activation
Ostrzeżenie
Agenta zdalnego aktywacja zaniechano i nie jest już obsługiwany.Ten parametr jest obsługiwany tylko w celu zachowania zgodności z poprzednimi wersjami skryptów.Ustawienie remote_agent_activation na wartość inną niż 0 generuje błąd.
[ @ offloadserver = ] 'remote_agent_server_name'
Ostrzeżenie
Agenta zdalnego aktywacja zaniechano i nie jest już obsługiwany.Ten parametr jest obsługiwany tylko w celu zachowania zgodności z poprzednimi wersjami skryptów.Ustawienie remote_agent_server_name dowolną wartość NIEZEROWĄ generuje błąd.
[ @ dts_package_name= ] 'dts_package_name'
Określa nazwę pakietusług transformacji danych (DTS).dts_package_namejest Sysname, domyślna wartość NULL.Na przykład dla pakiet o nazwie DTSPub_Package należy określić @dts_package_name = N'DTSPub_Package'.[ @ dts_package_password= ] 'dts_package_password'
Określa hasło na pakiet.dts_package_passwordjest Sysname Domyślna wartość NULL Określa, że hasła właściwość ma pozostać niezmieniona.Ostrzeżenie
pakiet DTS musi mieć hasło.
[ @ dts_package_location= ] dts_package_location
Określa lokalizację pakiet .dts_package_locationjest int, domyślna 0.Jeżeli 0, lokalizacja pakiet jest u dystrybutora.Jeżeli 1, lokalizacja pakiet jest przez subskrybenta.Lokalizacja pakiet może być dystrybutor lub subskrybent.[ @ skipobjectactivation= ] skipobjectactivation
Określone tylko w celach informacyjnych. Nieobsługiwane. Przyszła zgodność nie jest gwarantowana.[ @ distribution_job_name = ] 'distribution_job_name'
Jest to nazwa dystrybucji zadanie.distribution_job_namejest Sysname, domyślna wartość NULL.[ program publisher @= ] 'publisher'
Określa różna-Microsoft SQL Server Wydawca.publisherjest Sysname, domyślna wartość NULL.Ostrzeżenie
publishernie należy używać podczas zmieniania właściwości artykuł na SQL Server Wydawca.
Wartości kodów powrotnych
0 (sukces) lub 1 (błąd)
Uwagi
sp_changesubstatus jest używany w migawka replikacja i replikacjatransakcyjnej.
sp_changesubstatus Zmienia stan abonenta w syssubscriptions tabela z zmieniony stan.Jeśli to konieczne, aktualizuje stan artykuł sysarticles tabela wskazuje aktywny lub nieaktywny.Jeśli to konieczne, ustawia flagę replikacja lub wyłączyć sysobjects tabela w zreplikowanej tabela.
Uprawnienia
Tylko członkowie sysadmin stała rola serwera db_owner Stała rola bazy danychlub twórca subskrypcja można wykonać sp_changesubstatus.