プルサブスクリプションの削除

[アーティクル]
09/03/2023

適用対象: SQL Server Azure SQL Managed Instance

このトピックでは、SQL Server Management Studio、Transact-SQL、またはレプリケーション管理オブジェクト (RMO) を使用して、SQL Server でプルサブスクリプションを削除する方法について説明します。

このトピックの内容

プルサブスクリプションを削除するために使用するもの:

SQL Server Management Studio

Transact-SQL

レプリケーション管理オブジェクト (RMO)

SQL Server Management Studio を使用する

パブリッシャーまたはサブスクライバーで、プルサブスクリプションを削除します (パブリッシャーの場合は SQL Server Management Studio の [ローカルパブリケーション] フォルダーから、サブスクライバーの場合は [ローカルサブスクリプション] フォルダーから削除します)。サブスクリプションを削除しても、サブスクリプションのオブジェクトやデータは削除されません。これらは手動で削除する必要があります。

パブリッシャーでプルサブスクリプションを削除するには

SQL Server Management Studio でパブリッシャーに接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開し、 [ローカルパブリケーション] フォルダーを展開します。
削除するサブスクリプションに関連付けられているパブリケーションを展開します。
サブスクリプションを右クリックし、 [削除]をクリックします。
確認のダイアログボックスで、サブスクライバーに接続してサブスクリプション情報を削除するかどうかを選択します。 [サブスクライバーへの接続] チェックボックスをオフにする場合は、後でサブスクライバーに接続してこの情報を削除する必要があります。

サブスクライバーでプルサブスクリプションを削除するには

SQL Server Management Studio でサブスクライバ―に接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開し、 [ローカルサブスクリプション] フォルダーを展開します。
削除するサブスクリプションを右クリックし、 [削除]をクリックします。
確認のダイアログボックスで、パブリッシャーに接続してサブスクリプション情報を削除するかどうかを選択します。 [パブリッシャーへの接続] チェックボックスをオフにした場合は、後でパブリッシャーに接続してこの情報を削除する必要があります。

Transact-SQL の使用

プルサブスクリプションは、レプリケーションストアドプロシージャを使用してプログラムで削除できます。使用するストアドプロシージャは、サブスクリプションが属するパブリケーションの種類によって変わります。

スナップショットパブリケーションまたはトランザクションパブリケーションに対するプルサブスクリプションを削除するには

サブスクライバー側のサブスクリプションデータベースに対して、sp_droppullsubscription (Transact-SQL) を実行します。 @publication、 @publisher、および @publisher_dbを指定します。
パブリッシャー側のパブリケーションデータベースに対して、sp_dropsubscription (Transact-SQL) を実行します。 @publication と @subscriberを指定します。 @article に allを指定します。 (省略可) ディストリビューターにアクセスできない場合、 @ignore_distributor に 1 を指定して、ディストリビューターの関連オブジェクトを削除せずにサブスクリプションを削除します。

マージパブリケーションに対するプルサブスクリプションを削除するには

サブスクライバー側のサブスクリプションデータベースに対して、sp_dropmergepullsubscription (Transact-SQL) を実行します。 @publication、 @publisher、および @publisher_dbを指定します。
パブリッシャー側のパブリケーションデータベースに対して、sp_dropmergepullsubscription (Transact-SQL) を実行します。 @publication、 @subscriber、および @subscriber_dbを指定します。 @subscription_type には pullを指定します。 (省略可) ディストリビューターにアクセスできない場合、 @ignore_distributor に 1 を指定して、ディストリビューターの関連オブジェクトを削除せずにサブスクリプションを削除します。

例 (Transact-SQL)

次の例では、トランザクションパブリケーションへのプルサブスクリプションを削除します。最初のバッチはサブスクライバーで実行され、次のバッチはパブリッシャーで実行されます。

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- This is the batch executed at the Subscriber to drop 
-- a pull subscription to a transactional publication.
DECLARE @publication AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB     AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2022';

USE [AdventureWorks2022Replica]
EXEC sp_droppullsubscription 
  @publisher = @publisher, 
  @publisher_db = @publicationDB, 
  @publication = @publication;
GO

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- This batch is executed at the Publisher to remove 
-- a pull or push subscription to a transactional publication.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @subscriber = $(SubServer);

USE [AdventureWorks2022]
EXEC sp_dropsubscription 
  @publication = @publication, 
  @article = N'all',
  @subscriber = @subscriber;
GO

次の例では、マージパブリケーションに対するプルサブスクリプションを削除します。最初のバッチはサブスクライバーで実行され、次のバッチはパブリッシャーで実行されます。

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- This batch is executed at the Subscriber to remove 
-- a merge pull subscription.
DECLARE @publication AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publication_db AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @publisher = $(PubServer);
SET @publication_db = N'AdventureWorks2022';

USE [AdventureWorks2022Replica]
EXEC sp_dropmergepullsubscription 
  @publisher = @publisher, 
  @publisher_db = @publication_db, 
  @publication = @publication;
GO

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- This batch is executed at the Publisher to remove 
-- a pull or push subscription to a merge publication.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @subscriber = $(SubServer);
SET @subscriptionDB = N'AdventureWorks2022Replica';

USE [AdventureWorks2022]
EXEC sp_dropmergesubscription 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @subscriber_db = @subscriptionDB;
GO

レプリケーション管理オブジェクト (RMO) の使用

レプリケーション管理オブジェクト (RMO) を使用することで、プログラムによってプルサブスクリプションを削除できます。プルサブスクリプションの削除に使用する RMO クラスは、プルサブスクリプションをサブスクライブするパブリケーションの種類によって決まります。

スナップショットパブリケーションまたはトランザクションパブリケーションに対するプルサブスクリプションを削除するには

ServerConnection クラスを使用して、サブスクライバーおよびパブリッシャーへの接続を作成します。
TransPullSubscription クラスのインスタンスを作成し、 PublicationName、 DatabaseName、 PublisherName、および PublicationDBName の各プロパティを設定します。手順 1. のサブスクライバー接続を使用して、 ConnectionContext プロパティを設定します。
IsExistingObject プロパティをチェックして、サブスクリプションが存在することを確認します。このプロパティの値が falseの場合、手順 2. でサブスクリプションプロパティが不適切に定義されたか、サブスクリプションが存在していません。
Remove メソッドを呼び出します。
手順 1. のパブリッシャー接続を使用して、 TransPublication クラスのインスタンスを作成します。 Name、 DatabaseName 、および ConnectionContextを指定します。
LoadProperties メソッドを呼び出します。このメソッドが falseを返す場合、手順 5. で指定したプロパティが誤っているか、サーバーにパブリケーションが存在していません。
RemovePullSubscription メソッドを呼び出します。 subscriber パラメーターと subscriberDB パラメーターに、サブスクライバーの名前とサブスクリプションデータベースを指定します。

マージパブリケーションに対するプルサブスクリプションを削除するには

ServerConnection クラスを使用して、サブスクライバーおよびパブリッシャーへの接続を作成します。
MergePullSubscription クラスのインスタンスを作成し、 PublicationName、 DatabaseName、 PublisherName、および PublicationDBName の各プロパティを設定します。手順 1. の接続を使用して、 ConnectionContext プロパティを設定します。
IsExistingObject プロパティをチェックして、サブスクリプションが存在することを確認します。このプロパティの値が falseの場合、手順 2. でサブスクリプションプロパティが不適切に定義されたか、サブスクリプションが存在していません。
Remove メソッドを呼び出します。
手順 1. のパブリッシャー接続を使用して、 MergePublication クラスのインスタンスを作成します。 Name、 DatabaseName 、および ConnectionContextを指定します。
LoadProperties メソッドを呼び出します。このメソッドが falseを返す場合、手順 5. で指定したプロパティが誤っているか、サーバーにパブリケーションが存在していません。
RemovePullSubscription メソッドを呼び出します。 subscriber パラメーターと subscriberDB パラメーターに、サブスクライバーの名前とサブスクリプションデータベースを指定します。

例 (RMO)

次の例では、トランザクションパブリケーションに対するプルサブスクリプションを削除し、パブリッシャー側のサブスクリプション登録を削除します。

// Define the Publisher, publication, and databases.
string publicationName = "AdvWorksProductTran";
string publisherName = publisherInstance;
string subscriberName = subscriberInstance;
string subscriptionDbName = "AdventureWorks2022Replica";
string publicationDbName = "AdventureWorks2022";

//Create connections to the Publisher and Subscriber.
ServerConnection subscriberConn = new ServerConnection(subscriberName);
ServerConnection publisherConn = new ServerConnection(publisherName);

// Create the objects that we need.
TransPublication publication;
TransPullSubscription subscription;

try
{
    // Connect to the Subscriber.
    subscriberConn.Connect();

    // Define the pull subscription.
    subscription = new TransPullSubscription();
    subscription.ConnectionContext = subscriberConn;
    subscription.PublisherName = publisherName;
    subscription.PublicationName = publicationName;
    subscription.PublicationDBName = publicationDbName;
    subscription.DatabaseName = subscriptionDbName;

    // Define the publication.
    publication = new TransPublication();
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;
    publication.ConnectionContext = publisherConn;

    // Delete the pull subscription, if it exists.
    if (subscription.IsExistingObject)
    {
        if (publication.LoadProperties())
        {
            // Remove the pull subscription registration at the Publisher.
            publication.RemovePullSubscription(subscriberName, subscriptionDbName);
        }
        else
        {
            // Do something here if the publication does not exist.
            throw new ApplicationException(String.Format(
                "The publication '{0}' does not exist on {1}.",
                publicationName, publisherName));
        }
        // Delete the pull subscription at the Subscriber.
        subscription.Remove();
    }
    else
    {
        throw new ApplicationException(String.Format(
            "The subscription to {0} does not exist on {1}",
            publicationName, subscriberName));
    }
}
catch (Exception ex)
{
    // Implement the appropriate error handling here.
    throw new ApplicationException(String.Format(
        "The subscription to {0} could not be deleted.", publicationName), ex);
}
finally
{
    subscriberConn.Disconnect();
    publisherConn.Disconnect();
}

' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksProductTran"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2022Replica"
Dim publicationDbName As String = "AdventureWorks2022"

'Create connections to the Publisher and Subscriber.
Dim subscriberConn As ServerConnection = New ServerConnection(subscriberName)
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim publication As TransPublication
Dim subscription As TransPullSubscription

Try
    ' Connect to the Subscriber.
    subscriberConn.Connect()

    ' Define the pull subscription.
    subscription = New TransPullSubscription()
    subscription.ConnectionContext = subscriberConn
    subscription.PublisherName = publisherName
    subscription.PublicationName = publicationName
    subscription.PublicationDBName = publicationDbName
    subscription.DatabaseName = subscriptionDbName

    ' Define the publication.
    publication = New TransPublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = publisherConn

    ' Delete the pull subscription, if it exists.
    If subscription.IsExistingObject Then
       
        If publication.LoadProperties() Then
            ' Remove the pull subscription registration at the Publisher.
            publication.RemovePullSubscription(subscriberName, subscriptionDbName)
        Else
            ' Do something here if the publication does not exist.
            Throw New ApplicationException(String.Format( _
             "The publication '{0}' does not exist on {1}.", _
             publicationName, publisherName))
        End If
        ' Delete the pull subscription at the Subscriber.
        subscription.Remove()
    Else
        Throw New ApplicationException(String.Format( _
         "The subscription to {0} does not exist on {1}", _
         publicationName, subscriberName))
    End If
Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
        "The subscription to {0} could not be deleted.", publicationName), ex)
Finally
    subscriberConn.Disconnect()
    publisherConn.Disconnect()
End Try

次の例では、マージパブリケーションに対するプルサブスクリプションを削除し、パブリッシャー側のサブスクリプション登録を削除します。

// Define the Publisher, publication, and databases.
string publicationName = "AdvWorksSalesOrdersMerge";
string publisherName = publisherInstance;
string subscriberName = subscriberInstance;
string subscriptionDbName = "AdventureWorks2022Replica";
string publicationDbName = "AdventureWorks2022";

//Create connections to the Publisher and Subscriber.
ServerConnection subscriberConn = new ServerConnection(subscriberName);
ServerConnection publisherConn = new ServerConnection(publisherName);

// Create the objects that we need.
MergePublication publication;
MergePullSubscription subscription;

try
{
    // Connect to the Subscriber.
    subscriberConn.Connect();

    // Define the pull subscription.
    subscription = new MergePullSubscription();
    subscription.ConnectionContext = subscriberConn;
    subscription.PublisherName = publisherName;
    subscription.PublicationName = publicationName;
    subscription.PublicationDBName = publicationDbName;
    subscription.DatabaseName = subscriptionDbName;

    // Define the publication.
    publication = new MergePublication();
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;
    publication.ConnectionContext = publisherConn;

    // Delete the pull subscription, if it exists.
    if (subscription.IsExistingObject)
    {
        // Delete the pull subscription at the Subscriber.
        subscription.Remove();

        if (publication.LoadProperties())
        {
            publication.RemovePullSubscription(subscriberName, subscriptionDbName);
        }
        else
        {
            // Do something here if the publication does not exist.
            throw new ApplicationException(String.Format(
                "The publication '{0}' does not exist on {1}.",
                publicationName, publisherName));
        }
    }
    else
    {
        throw new ApplicationException(String.Format(
            "The subscription to {0} does not exist on {1}",
            publicationName, subscriberName));
    }
}
catch (Exception ex)
{
    // Implement the appropriate error handling here.
    throw new ApplicationException(String.Format(
        "The subscription to {0} could not be deleted.", publicationName), ex);
}
finally
{
    subscriberConn.Disconnect();
    publisherConn.Disconnect();
}

' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2022Replica"
Dim publicationDbName As String = "AdventureWorks2022"

'Create connections to the Publisher and Subscriber.
Dim subscriberConn As ServerConnection = New ServerConnection(subscriberName)
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim publication As MergePublication
Dim subscription As MergePullSubscription

Try
    ' Connect to the Subscriber.
    subscriberConn.Connect()

    ' Define the pull subscription.
    subscription = New MergePullSubscription()
    subscription.ConnectionContext = subscriberConn
    subscription.PublisherName = publisherName
    subscription.PublicationName = publicationName
    subscription.PublicationDBName = publicationDbName
    subscription.DatabaseName = subscriptionDbName

    ' Define the publication.
    publication = New MergePublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = publisherConn

    ' Delete the pull subscription, if it exists.
    If subscription.IsExistingObject Then

        ' Delete the pull subscription at the Subscriber.
        subscription.Remove()

        If publication.LoadProperties() Then
            publication.RemovePullSubscription(subscriberName, subscriptionDbName)
        Else
            ' Do something here if the publication does not exist.
            Throw New ApplicationException(String.Format( _
             "The publication '{0}' does not exist on {1}.", _
             publicationName, publisherName))
        End If
    Else
        Throw New ApplicationException(String.Format( _
         "The subscription to {0} does not exist on {1}", _
         publicationName, subscriberName))
    End If
Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
        "The subscription to {0} could not be deleted.", publicationName), ex)
Finally
    subscriberConn.Disconnect()
    publisherConn.Disconnect()
End Try

参照

Subscribe to Publications
レプリケーションセキュリティの推奨事項

次の方法で共有

プルサブスクリプションの削除

SQL Server Management Studio を使用する

パブリッシャーでプルサブスクリプションを削除するには

サブスクライバーでプルサブスクリプションを削除するには

Transact-SQL の使用

スナップショットパブリケーションまたはトランザクションパブリケーションに対するプルサブスクリプションを削除するには

マージパブリケーションに対するプルサブスクリプションを削除するには

例 (Transact-SQL)

レプリケーション管理オブジェクト (RMO) の使用

スナップショットパブリケーションまたはトランザクションパブリケーションに対するプルサブスクリプションを削除するには

マージパブリケーションに対するプルサブスクリプションを削除するには

例 (RMO)

参照

フィードバック

その他のリソース

次の方法で共有

プル サブスクリプションの削除

SQL Server Management Studio を使用する

パブリッシャーでプル サブスクリプションを削除するには

サブスクライバーでプル サブスクリプションを削除するには

Transact-SQL の使用

スナップショット パブリケーションまたはトランザクション パブリケーションに対するプル サブスクリプションを削除するには

マージ パブリケーションに対するプル サブスクリプションを削除するには

例 (Transact-SQL)

レプリケーション管理オブジェクト (RMO) の使用

スナップショット パブリケーションまたはトランザクション パブリケーションに対するプル サブスクリプションを削除するには

マージ パブリケーションに対するプル サブスクリプションを削除するには

例 (RMO)

参照

フィードバック

その他のリソース

プルサブスクリプションの削除

パブリッシャーでプルサブスクリプションを削除するには

サブスクライバーでプルサブスクリプションを削除するには

スナップショットパブリケーションまたはトランザクションパブリケーションに対するプルサブスクリプションを削除するには

マージパブリケーションに対するプルサブスクリプションを削除するには

スナップショットパブリケーションまたはトランザクションパブリケーションに対するプルサブスクリプションを削除するには

マージパブリケーションに対するプルサブスクリプションを削除するには