sp_articleview （Transact-SQL）

  • 發行項

適用於：SQL ServerAzure SQL 受控執行個體

建立檢視，這個檢視會在數據表垂直或水平篩選時定義已發佈的發行項。 此檢視會做為目的地數據表架構和數據篩選的來源。 此預存程式只能修改未訂閱的發行項。 這個預存程式會在發行集資料庫的發行者端執行。

Transact-SQL 語法慣例

語法

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 ]
[ ; ]

引數

[ @publication = ] N'publication'

包含發行項的發行集名稱。 @publication為 sysname，沒有預設值。

[ @article = ] N'article'

發行項的名稱。 @article為 sysname，沒有預設值。

[ @view_name = ] N'view_name'

定義已發佈發行項的檢視名稱。 @view_name為 nvarchar（386），預設值為 NULL。

[ @filter_clause = ] N'filter_clause'

定義水平篩選的限制 （WHERE） 子句。 輸入限制子句時，請省略 WHERE 關鍵詞。 @filter_clause為 nvarchar（max），預設值為 NULL。

[ @change_active = ] change_active

允許修改具有訂閱之發行集中的數據行。 @change_active為 int，預設值為 0。

  • 如果 0為 ，則不會變更數據行。
  • 如果 1為 ，可以在具有訂用帳戶的作用中發行項上建立或重新建立檢視。

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

確認此預存程式所採取的動作可能會使現有的快照集失效。 @force_invalidate_snapshot為 bit，預設值為 0。

  • 0 指定發行項的變更不會造成快照集無效。 如果預存程式偵測到變更確實需要新的快照集，就會發生錯誤，而且不會進行任何變更。
  • 1 會指定發行項的變更可能會導致快照集無效，而且如果有現有的訂用帳戶需要新的快照集，則提供現有快照集標示為過時和產生新快照集的許可權。

[ @force_reinit_subscription = ] force_reinit_subscription

確認此預存程式所採取的動作可能需要重新初始化現有的訂用帳戶。 @force_reinit_subscription為 bit，預設值為 0。

  • 0 指定發行項的變更不會使訂閱重新初始化。 如果預存程式偵測到變更需要重新初始化訂閱，就會發生錯誤，而且不會進行任何變更。
  • 1 指定發行項的變更會導致現有的訂閱重新初始化，並授與重新初始化訂閱的許可權。

[ @publisher = ] N'publisher'

指定非 SQL Server 發行者。 @publisher為 sysname，預設值為 NULL。

從 SQL Server 發行者發佈時，不應該使用@publisher。

[ @refreshsynctranprocs = ] refreshsynctranprocs

指定是否自動重新建立用來同步復寫的預存程式。 @refreshsynctranprocs為 bit，預設值為 1。

  • 1 表示預存程式會重新建立。
  • 0 表示不會重新建立預存程式。

[ @internal = ] internal

僅供參考之用。 不支援。 我們無法保證未來的相容性。

傳回碼值

0 (成功) 或 1 (失敗)。

備註

sp_articleview會建立定義已發佈發行項的檢視，並將這個檢視sync_objid的標識碼插入 sysarticles （Transact-SQL） 數據表的數據行中，並將限制子句的文字插入數據行中filter_clause。 如果複寫所有數據行且沒有 filter_clause，sysarticles （Transact-SQL） 資料表中的 會設定為基表的識別碼，而且不需要使用 sp_articleviewsync_objid 。

若要發佈垂直篩選數據表（也就是篩選數據行），請先sp_addarticle執行不含@sync_object參數、針對要複寫的每個數據行執行一次sp_articlecolumn（Transact-SQL），然後執行 sp_articleview 以建立定義已發行發行發行項的檢視。

若要發佈水平篩選資料表（也就是篩選資料列），請執行沒有@filter_name參數sp_addarticle （Transact-SQL）。 執行 sp_articlefilter （Transact-SQL），提供所有參數，包括 @filter_clause。 然後執行 sp_articleview，提供所有參數，包括相同的 @filter_clause。

若要以垂直和水準方式發行數據表，請執行沒有@sync_object或@filter_name參數的 sp_addarticle （Transact-SQL）。 針對要復寫的每個資料行執行 sp_articlecolumn （Transact-SQL） 一次，然後執行 sp_articlefilter （Transact-SQL） 和 sp_articleview。

如果發行項已經有定義已發佈發行項的檢視， sp_articleview 請卸除現有的檢視，並自動建立新的檢視。 如果以手動方式建立檢視 （type在 sysarticles （Transact-SQL） 中為 ），5則不會卸除現有的檢視。

如果您建立自訂篩選預存程式和手動定義已發佈發行項的檢視，請勿執行 sp_articleview。 相反地，請提供這些值作為@filter_name和@sync_object參數來sp_addarticle （Transact-SQL），以及適當的@type值。

範例

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

權限

只有系統管理員固定伺服器角色或db_owner固定資料庫角色的成員才能執行 sp_articleview。

相關內容