sys.sp_articleview (Transact-SQL)

Platí na:SQL ServerAzure SQL Managed Instance

Vytváří pohled, který definuje publikovaný článek, když je tabulka filtrována vertikálně nebo horizontálně. Tento pohled slouží jako filtrovaný zdroj schématu a dat pro cílové tabulky. Pouze odhlášené články mohou být tímto uloženým postupem upravovány. Tato uložená procedura se spustí v Publisheru v databázi publikace.

Transact-SQL konvence syntaxe

Syntax

sys.sp_articleview
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @view_name = ] N'view_name' ]
    [ , [ @filter_clause = ] N'filter_clause' ]
    [ , [ @change_active = ] change_active ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @refreshsynctranprocs = ] refreshsynctranprocs ]
    [ , [ @internal = ] internal ]
[ ; ]

Arguments

[ @publication = ] N'publikace'

Název publikace, která článek obsahuje. @publication je sysname, bez výchozího nastavení.

[ @article = ] N'článek'

Název článku. @article je sysname, bez výchozího nastavení.

[ @view_name = ] N'view_name'

Název názoru, který definuje publikovaný článek. @view_name je nvarchar(386), s výchozím hodnotou NULL.

[ @filter_clause = ] N'filter_clause'

Klauzule omezení (WHERE), která definuje horizontální filtr. Při zadávání klauzule o omezení vynechte klíčové slovo WHERE . @filter_clause je nvarchar(max), s výchozím hodnotou NULL.

[ @change_active = ] change_active

Umožňuje upravovat sloupce v publikacích, které mají předplatné. @change_active je int, s výchozím hodnotou 0.

Pokud 0, sloupce se nemění.
Pokud 1, lze zobrazit nebo znovu vytvořit na aktivních článcích, které mají předplatné.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Uznává, že akce provedená touto uloženou procedurou může zneplatnit existující snímek. @force_invalidate_snapshot je bit s výchozím nastavením 0.

0 určuje, že změny článku nezpůsobí, že snímek bude neplatný. Pokud uložená procedura zjistí, že změna vyžaduje nový snapshot, dojde k chybě a žádné změny nejsou provedeny.
1 specifikuje, že změny článku mohou způsobit, že snapshot bude neplatný, a pokud existují existující předplatné, která vyžadují nový snapshot, dává povolení označit stávající snapshot jako zastaralý a vytvořit nový snapshot.

[ @force_reinit_subscription = ] force_reinit_subscription

Uznává, že akce provedená touto uloženou procedurou může vyžadovat opětovnou inicializaci stávajících předplatných. @force_reinit_subscription je bit s výchozím nastavením 0.

0 určuje, že změny článku nezpůsobí opětovné inicializaci předplatného. Pokud uložená procedura zjistí, že změna by vyžadovala opětovnou inicializaci předplatného, dojde k chybě a žádné změny nejsou provedeny.
1 specifikuje, že změny článku způsobují opětovnou inicializaci stávajícího předplatného a dává povolení k jeho opětovné inicializaci.

[ @publisher = ] N'publisher'

Určuje vydavatele jiného typu než SQL Server. @publisher je sysname s výchozím nastavením NULL.

@publisher by se neměla používat při publikování z SQL Server Publisher.

[ @refreshsynctranprocs = ] refreshsynctranprocs

Specifikuje, zda jsou uložené procedury používané k synchronizaci replikace automaticky znovu vytvořeny. @refreshsynctranprocs je bit, s výchozím hodnotou 1.

1 znamená, že uložené procedury jsou znovu vytvořeny.
0 To znamená, že uložené procedury nejsou znovu vytvářeny.

[ @internal = ] vnitřní

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í).

Poznámky

sp_articleview vytvoří pohled, který definuje publikovaný článek, vloží ID tohoto pohledu do sloupce sync_objid tabulky sysarticles a vloží text klauzule omezení do sloupce filter_clause . Pokud jsou všechny sloupce replikované a neexistuje filter_clause, je v sync_objid tabulce sysarticles tabulka nastavena na ID základní tabulky a použití není sp_articleview nutné.

Pro publikování vertikálně filtrované tabulky (tedy filtrování sloupců) nejprve spusť sp_addarticle bez @sync_object parametru, poté sp_articlecolumn jednou, aby každý sloupec byl replikován (definuje vertikální filtr), a poté spusťte sp_articleview pro vytvoření pohledu, který definuje publikovaný článek.

Pro publikování tabulky s horizontálním filtrem (tedy pro filtrování řádků) spusťte sp_addarticle bez @filter_name parametru. Spusť sp_articlefilter, zadávej všechny parametry včetně @filter_clause. Poté spusťte sp_articleview, za kterých jsou všechny parametry včetně stejných @filter_clause.

Pro publikování vertikálně a horizontálně filtrované tabulky spusť sp_addarticle bez parametrů @sync_object nebo @filter_name . Spusť sp_articlecolumn jednou pro replikaci každého sloupce, poté spusťte sp_articlefilter a sp_articleview.

Pokud článek již má pohled, který definuje publikovaný článek, zruší sp_articleview stávající pohled a automaticky vytvoří nový. Pokud byl pohled vytvořen ručně (type v sysarticles je ), 5existující pohled není vyřazen.

Pokud vytvoříte vlastní uloženou proceduru filtru a pohled, který ručně definuje publikovaný článek, nespouštějte sp_articleview. Místo toho zadejte tyto hodnoty jako @filter_name a @sync_object parametry pro sp_addarticle spolu s příslušnou hodnotou @type .

Examples

DECLARE @publication    AS sysname;
DECLARE @table AS sysname;
DECLARE @filterclause AS nvarchar(500);
DECLARE @filtername AS nvarchar(386);
DECLARE @schemaowner AS sysname;
SET @publication = N'AdvWorksProductTran'; 
SET @table = N'Product';
SET @filterclause = N'[DiscontinuedDate] IS NULL'; 
SET @filtername = N'filter_out_discontinued';
SET @schemaowner = N'Production';

-- Add a horizontally and vertically filtered article for the Product table.
-- Manually set @schema_option to ensure that the Production schema 
-- is generated at the Subscriber (0x8000000).
EXEC sp_addarticle 
    @publication = @publication, 
    @article = @table, 
    @source_object = @table,
    @source_owner = @schemaowner, 
    @schema_option = 0x80030F3,
    @vertical_partition = N'true', 
    @type = N'logbased',
    @filter_clause = @filterclause;

-- (Optional) Manually call the stored procedure to create the 
-- horizontal filtering stored procedure. Since the type is 
-- 'logbased', this stored procedures is executed automatically.
EXEC sp_articlefilter 
    @publication = @publication, 
    @article = @table, 
    @filter_clause = @filterclause, 
    @filter_name = @filtername;

-- Add all columns to the article.
EXEC sp_articlecolumn 
    @publication = @publication, 
    @article = @table;

-- Remove the DaysToManufacture column from the article
EXEC sp_articlecolumn 
    @publication = @publication, 
    @article = @table, 
    @column = N'DaysToManufacture', 
    @operation = N'drop';

-- (Optional) Manually call the stored procedure to create the 
-- vertical filtering view. Since the type is 'logbased', 
-- this stored procedures is executed automatically.
EXEC sp_articleview 
    @publication = @publication, 
    @article = @table,
    @filter_clause = @filterclause;
GO

Permissions

Pouze členové role pevného serveru správce systému nebo role pevné databáze db_owner mohou vykonávat sp_articleview.

Váš názor

Byla tato stránka užitečná?

Poslední aktualizace v 2026-07-21