sp_repldropcolumn (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

パブリッシュされた既存のテーブル アーティクルから列を削除します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。

重要

このストアド プロシージャは非推奨となり、主に下位互換性のためにサポートされています。 SQL Server 2000 (8.x) パブリッシャーと SQL Server 2000 (8.x) 再パブリッシュサブスクライバーでのみ使用してください。 この手順は、SQL Server 2005 (9.x) 以降のバージョンで導入されたデータ型を含む列では使用しないでください。

Transact-SQL 構文表記規則

構文

sp_repldropcolumn
    [ @source_object = ] N'source_object'
    , [ @column = ] N'column'
    [ , [ @from_agent = ] from_agent ]
    [ , [ @schema_change_script = ] N'schema_change_script' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
[ ; ]

引数

[ @source_object = ] N'source_object'

削除する列を含むテーブル アーティクルの名前。 @source_object は nvarchar(270)で、既定値はありません。

[ @column = ] N'column'

削除するテーブル内の列の名前。 @column は sysname で、既定値はありません。

[ @from_agent = ] from_agent

ストアド プロシージャがレプリケーション エージェントによって実行されているかどうかを指定します。 @from_agent は int で、既定値は 0 です。

このストアド プロシージャがレプリケーション エージェントによって実行されている場合は 1 を使用し、それ以外の場合は既定値の 0 を使用します。

[ @schema_change_script = ] N'schema_change_script'

システムによって生成されたカスタム ストアド プロシージャの変更に使用する SQL Server スクリプトの名前とパスを指定します。 @schema_change_script は nvarchar(4000) で、既定値は NULL です。

レプリケーションを使用すると、トランザクション レプリケーションで使用される 1 つ以上の既定のプロシージャを、ユーザー定義のカスタム ストアド プロシージャで置き換えることができます。 @schema_change_script は、 sp_repldropcolumnを使用してレプリケートテーブルアーティクルにスキーマ変更が行われた後に実行され、次のいずれかのオプションに使用できます。

• カスタム ストアド プロシージャが自動的に再生成される場合、 @schema_change_script を使用してこれらのカスタム ストアド プロシージャを削除し、新しいスキーマをサポートするユーザー定義のカスタム ストアド プロシージャに置き換えることができます。

• カスタム ストアド プロシージャが自動的に再生成されない場合は、 @schema_change_scriptこれらのストアド プロシージャを再生成したり、ユーザー定義のカスタム ストアド プロシージャを作成したりするために使用できます。

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

スナップショットを無効にする機能を有効または無効にします。 @force_invalidate_snapshot は ビットで、既定値は 1 です。

• 1 は、アーティクルに対する変更によってスナップショットが無効になる可能性があることを指定します。その場合は、 1 値を指定すると、新しいスナップショットが実行されるアクセス許可が付与されます。

• 0 は、アーティクルに対する変更によってスナップショットが無効になることがないように指定します。

[ @force_reinit_subscription = ] force_reinit_subscription

サブスクリプションを再初期化する機能を有効または無効にします。 @force_reinit_subscription は bit で、既定値は 0 です。

• 0 は、アーティクルに対する変更によってサブスクリプションが再初期化されないように指定します。

• 1 は、アーティクルに対する変更によってサブスクリプションが再初期化される可能性があることを指定します。その場合は、 1 値を指定すると、サブスクリプションの再初期化が実行されるアクセス許可が付与されます。

リターン コードの値

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

アクセス許可

パブリッシャーの sysadmin 固定サーバー ロールのメンバー、またはパブリケーション データベースの db_owner または db_ddladmin 固定データベース ロールのメンバーのみが、 sp_repldropcolumnを実行できます。

関連するコンテンツ

• SQL Server レプリケーションの非推奨の機能
• システム ストアド プロシージャ (Transact-SQL)