Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Platí na:
SQL ServerAzureSQL Managed Instance
Mění to stav stávajícího předplatitele. Tato uložená procedura se spustí v Publisheru v databázi publikace.
Syntax
sys.sp_changesubstatus
[ [ @publication = ] N'publication' ]
[ , [ @article = ] N'article' ]
[ , [ @subscriber = ] N'subscriber' ]
, [ @status = ] N'status'
[ , [ @previous_status = ] N'previous_status' ]
[ , [ @destination_db = ] N'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 = ] N'optional_command_line' ]
[ , [ @distribution_jobid = ] distribution_jobid OUTPUT ]
[ , [ @from_auto_sync = ] from_auto_sync ]
[ , [ @ignore_distributor = ] ignore_distributor ]
[ , [ @offloadagent = ] offloadagent ]
[ , [ @offloadserver = ] N'offloadserver' ]
[ , [ @dts_package_name = ] N'dts_package_name' ]
[ , [ @dts_package_password = ] N'dts_package_password' ]
[ , [ @dts_package_location = ] dts_package_location ]
[ , [ @skipobjectactivation = ] skipobjectactivation ]
[ , [ @distribution_job_name = ] N'distribution_job_name' ]
[ , [ @publisher = ] N'publisher' ]
[ , [ @ignore_distributor_failure = ] ignore_distributor_failure ]
[ ; ]
Arguments
[ @publication = ] N'publikace'
Název publikace.
@publication je sysname s výchozím nastavením %. Pokud @publication není specifikováno, jsou ovlivněny všechny publikace.
[ @article = ] N'článek'
Název článku.
@article je sysname s výchozím nastavením %. Musí být jedinečná pro danou publikaci. Pokud @article není specifikováno, všechny články jsou ovlivněny.
[ @subscriber = ] N'subscriber'
Jméno předplatitele, které je třeba změnit jeho stav.
@subscriber je sysname s výchozím nastavením %. Pokud @subscriber není uvedeno, stav se změní pro všechny předplatitele daného článku.
[ @status = ] N'status'
Stav předplatného syssubscriptions v tabulce.
@status je sysname a může být jednou z těchto hodnot.
| Value | Description |
|---|---|
active |
Účastník je synchronizován a přijímá data. |
inactive |
Vstup pro předplatitele existuje bez předplatného. |
subscribed |
Odběratel žádá data, ale zatím není synchronizován. |
[ @previous_status = ] N'previous_status'
Předchozí stav předplatného.
@previous_status je sysname s výchozím nastavením NULL. Tento parametr vám umožňuje změnit jakékoliv odběry, které aktuálně mají tento stav, čímž umožňuje skupinové funkce na konkrétní sadě odběrů (například nastavit všechna aktivní odběry zpět na ).subscribed
[ @destination_db = ] N'destination_db'
Název cílové databáze.
@destination_db je sysname s výchozím nastavením %.
[ @frequency_type = ] frequency_type
Specifikuje frekvenci, s jakou má být distribuční úloha plánována.
@frequency_type je int, s výchozím hodnotou NULL.
[ @frequency_interval = ] frequency_interval
Hodnota se vztahuje na frekvenci nastavenou @frequency_type.
@frequency_interval je int, s výchozím nastavením NULL.
[ @frequency_relative_interval = ] frequency_relative_interval
Datum úkolu distribuce. Tento parametr se používá, když je @frequency_type nastaveno na 32 (měsíční relativní). @frequency_relative_interval je int a může být jednou z těchto hodnot.
| Value | Description |
|---|---|
1 |
First |
2 |
Second |
4 |
Třetí |
8 |
Čtvrtý |
16 |
Poslední |
NULL (výchozí) |
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Faktor opakování používaný @frequency_type.
@frequency_recurrence_factor je int, s výchozím hodnotou NULL.
[ @frequency_subday = ] frequency_subday
Specifikuje, jak často a v minutách se má přeplánovat během definovaného období. @frequency_subday je int a může být jednou z těchto hodnot.
| Value | Description |
|---|---|
1 |
Jednou |
2 |
Second |
4 |
Minuta |
8 |
Hodina |
NULL (výchozí) |
[ @frequency_subday_interval = ] frequency_subday_interval
Přestávka na @frequency_subday.
@frequency_subday_interval je int, s výchozím nastavením NULL.
[ @active_start_time_of_day = ] active_start_time_of_day
Čas dne, kdy je úkol distribuce poprvé naplánován, formátovaný jako HHmmss.
@active_start_time_of_day je int, s výchozím nastavením NULL.
[ @active_end_time_of_day = ] active_end_time_of_day
Čas dne, kdy se distribuční úkol přestane plánovat, formátovaný jako HHmmss.
@active_end_time_of_day je , s výchozím nastavením NULL.
@active_start_date [ = ] active_start_date
Datum, kdy je distribuční úkol poprvé naplánován, formátováno jako yyyyMMdd.
@active_start_date je int, s výchozím nastavením NULL.
@active_end_date [ = ] active_end_date
Datum, kdy úkol distribuce přestane být plánován, je formátováno jako yyyyMMdd.
@active_end_date je int, s výchozím nastavením NULL.
[ @optional_command_line = ] N'optional_command_line'
Volitelný příkazový řádek.
@optional_command_line je nvarchar(4000), s výchozím hodnotou NULL.
[ @distribution_jobid = ] distribution_jobid VÝSTUP
Pracovní ID Distribution Agent u distributora při změně statusu předplatného z neaktivního na aktivní. V jiných případech to není definováno. Pokud je více než jeden Distribution Agent zapojen do jednoho volání této uložené procedury, výsledek není definován.
@distribution_jobid je OUTPUT parametr typu binární(16).
[ @from_auto_sync = ] from_auto_sync
Určeno pouze pro informační účely. Není podporováno. Budoucí kompatibilita není zaručena.
[ @ignore_distributor = ] ignore_distributor
Určeno pouze pro informační účely. Není podporováno. Budoucí kompatibilita není zaručena.
[ @offloadagent = ] offloadagent
Tento parametr je zastaralý a je zachován kvůli zpětné kompatibilitě skriptů. Nastavení @offloadagent na jinou hodnotu než 0 generuje chybu.
[ @offloadserver = ] N'offloadserver
Tento parametr je zastaralý a je zachován kvůli zpětné kompatibilitě skriptů. Nastavení @offloadserver na jakoukoli hodnotu mimo NULL způsobuje chybu.
[ @dts_package_name = ] N'dts_package_name'
Specifikuje název balíčku Data Transformation Services (DTS).
@dts_package_name je sysname s výchozím nastavením NULL. Například pro balíček jménem DTSPub_Package byste zadali @dts_package_name = N'DTSPub_Package'.
[ @dts_package_password = ] N'dts_package_password'
Specifikuje heslo na balení.
@dts_package_password je nvarchar(524), s výchozím nastavením NULL, což určuje, že vlastnost hesla má zůstat nezměněna.
Note
DTS balíček musí mít heslo.
[ @dts_package_location = ] dts_package_location
Specifikuje umístění balíčku.
@dts_package_location je int, s výchozím hodnotou 0.
- Pokud
0, je místo balíčku u distributora. - Pokud
1, je umístění balíčku u Subscriber.
Umístění balíčku může být distributor nebo subscriber.
[ @skipobjectactivation = ] přeskočit objektaktivaci
Určeno pouze pro informační účely. Není podporováno. Budoucí kompatibilita není zaručena.
[ @distribution_job_name = ] N'distribution_job_name'
Název distribuční práce.
@distribution_job_name je sysname s výchozím nastavením NULL.
[ @publisher = ] N'publisher'
Specifikuje vydavatele mimo SQL Server.
@publisher je sysname s výchozím nastavením NULL.
@publisher by se nemělo používat při změně vlastností článku na SQL Server Publisher.
[ @ignore_distributor_failure = ] ignore_distributor_failure
Určeno pouze pro informační účely. Není podporováno. Budoucí kompatibilita není zaručena.
Hodnoty návratového kódu
0 (úspěch) nebo 1 (selhání).
Remarks
sp_changesubstatus se používá při replikaci snapshotů a transakční replikaci.
sp_changesubstatus mění stav Odběratele v tabulce syssubscriptions se změněným stavem. Pokud je to potřeba, aktualizuje stav článku v tabulce a označuje aktivní sysarticles nebo neaktivní. Pokud je potřeba, zapne nebo vypne příznak replikace v tabulce pro replikovanou tabulku sysobjects .
Permissions
Pouze členové role pevného serveru sysadmina, db_owner pevné databázové role nebo tvůrce předplatného mohou vykonávat .sp_changesubstatus