sp_droparticle (Transact-SQL)

[アーティクル]
12/15/2008

スナップショットパブリケーションまたはトランザクションパブリケーションからアーティクルを削除します。1 つでもサブスクリプションがあると、そのアーティクルは削除できません。このストアドプロシージャは、パブリッシャ側でパブリケーションデータベースについて実行されます。

トピックリンクアイコン Transact-SQL 構文表記規則

構文

sp_droparticle [ @publication= ] 'publication'
        , [ @article= ] 'article'
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @force_invalidate_snapshot= ] force_invalidate_snapshot ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @from_drop_publication = ] from_drop_publication ]

引数

[ @publication=] 'publication'
削除するアーティクルを含むパブリケーションの名前を指定します。publication のデータ型は sysname で、既定値はありません。

[ @article = ] 'article'
削除するアーティクルの名前を指定します。article のデータ型は sysname で、既定値はありません。

[ @ignore_distributor =] ignore_distributor
内部使用のみです。

[ @force_invalidate_snapshot = ] force_invalidate_snapshot
このストアドプロシージャが実行する操作によって、既存のスナップショットが無効になることを許可します。force_invalidate_snapshot のデータ型は bit で、既定値は 0 です。

0 に設定すると、アーティクルへの変更によってスナップショットが無効になることはありません。変更に新しいスナップショットが必要であることをストアドプロシージャが検出すると、エラーが発生し、変更は行われません。

1 に設定すると、アーティクルの変更によってスナップショットが無効になることがあります。また、新しいスナップショットを必要とする既存のサブスクリプションがある場合は、既存のスナップショットに古いスナップショットのマークを付けて、新しいスナップショットを生成することができます。

[ @publisher= ] 'publisher'
Microsoft SQL Server 以外のパブリッシャを指定します。publisher のデータ型は sysname で、既定値は NULL です。

メモ :

SQL Server パブリッシャでアーティクルのプロパティを変更する場合は、publisher を使用できません。

メモ :
SQL Server パブリッシャでアーティクルのプロパティを変更する場合は、publisher を使用できません。

[ @from_drop_publication= ] from_drop_publication
内部使用のみです。

解説

sp_droparticle は、スナップショットおよびトランザクションレプリケーションで使用します。

行方向にフィルタ選択されたアーティクルの場合、sp_droparticle は sysarticles (Transact-SQL) テーブルのアーティクルの type 列を調べて、ビューやフィルタも削除する必要があるかどうかを判別します。自動作成されたビューまたはフィルタは、アーティクルと共に削除されます。手動で作成した場合は、削除されません。

sp_droparticle を実行してパブリケーションからアーティクルを削除しても、パブリケーションデータベースからオブジェクトが削除されたり、サブスクリプションデータベースから対応するオブジェクトが削除されるわけではありません。これらのオブジェクトは、必要に応じて DROP <object> を使用して手動で削除します。

権限

sp_droparticle を実行できるのは、sysadmin 固定サーバーロールまたは db_owner 固定データベースロールのメンバだけです。

戻り値

0 (成功) または 1 (失敗)

使用例

DECLARE @publication AS sysname;
DECLARE @article AS sysname;
SET @publication = N'AdvWorksProductTran'; 
SET @article = N'Product'; 

-- Drop the transactional article.
USE [AdventureWorks]
EXEC sp_droparticle 
  @publication = @publication, 
  @article = @article,
  @force_invalidate_snapshot = 1;
GO

参照

その他の技術情報

アーティクルを削除する方法 (レプリケーション Transact-SQL プログラミング)
既存のパブリケーションへのアーティクルの追加および削除

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

sp_droparticle (Transact-SQL)

構文

引数

解説

権限

戻り値

使用例

参照

関連項目

その他の技術情報

ヘルプおよび情報

その他のリソース