パブリケーションの削除

[アーティクル]
10/05/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 内の [ローカルパブリケーション] フォルダーから出版物を削除します。

パブリケーションを削除するには

Management Studio でパブリッシャーに接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開し、 [ローカルパブリケーション] フォルダーを展開します。
削除するパブリケーションを右クリックし、 [削除]をクリックします。

Transact-SQL の使用

パブリケーションは、レプリケーションのストアドプロシージャを使用してプログラムから削除できます。どのストアドプロシージャを使用するかは、削除するパブリケーションの種類によって異なります。

Note

パブリケーションを削除しても、パブリッシュされたオブジェクトはパブリケーションデータベースから削除されず、対応するオブジェクトはサブスクリプションデータベースから削除されません。これらのオブジェクトは、必要に応じて DROP <object> コマンドを使用し、手動で削除します。

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

次のいずれかの操作を行います。
- 単一のパブリケーションを削除するには、パブリッシャーのパブリケーションデータベースで sp_droppublication を実行します。
- すべてのパブリケーションを削除し、パブリッシュされたデータベースからすべてのレプリケーションオブジェクトを削除するには、パブリッシャーで sp_removedbreplication を実行します。 @type には tranを指定します。 (省略可) ディストリビューターにアクセスできない場合や、ディストリビューターのデータベースステータスがオフラインになっている可能性がある場合は、 @force に 1を指定します。 (省略可) パブリケーションデータベースに対して sp_removedbreplication を実行しない場合は、 @dbname にデータベースの名前を指定します。
  
  Note
  
  @force に 1 を指定すると、レプリケーション関連のパブリッシングオブジェクトがデータベース上に残されます。
(省略可) このデータベースに他の出版物が存在しない場合は、sp_replicationdboption (Transact-SQL) を実行し、スナップショットレプリケーションまたはトランザクションレプリケーションを使用した、現在のデータベースのパブリケーションを無効にします。
(省略可) サブスクライバーのサブスクリプションデータベースで sp_subscription_cleanup を実行して、サブスクリプションデータベースに残っているレプリケーションメタデータをすべて削除します。

マージパブリケーションを削除するには

次のいずれかの操作を行います。
- 単一の出版物を削除するには、パブリッシャーのパブリケーションデータベースで sp_dropmergepublication (Transact-SQL) を実行します。
- すべてのパブリケーションを削除し、パブリッシュされたデータベースからすべてのレプリケーションオブジェクトを削除するには、パブリッシャーで sp_removedbreplication を実行します。 @type には mergeを指定します。 (省略可) ディストリビューターにアクセスできない場合や、ディストリビューターのデータベースステータスがオフラインになっている可能性がある場合は、 @force に 1を指定します。 (省略可) パブリケーションデータベースに対して sp_removedbreplication を実行しない場合は、 @dbname にデータベースの名前を指定します。
  
  Note
  
  @force に 1 を指定すると、レプリケーション関連のパブリッシングオブジェクトがデータベース上に残されます。
(省略可) このデータベースに他の出版物が存在しない場合は、sp_replicationdboption (Transact-SQL) を実行し、マージレプリケーションを使用した、現在のデータベースのパブリケーションを無効にします。
(省略可) サブスクライバー側のサブスクリプションデータベースに対して sp_mergesubscription_cleanup (Transact-SQL) を実行し、サブスクリプションデータベースに残っているレプリケーションメタデータをすべて削除します。

例 (Transact-SQL)

次の例は、トランザクションパブリケーションを削除し、データベースのトランザクションパブリッシングを無効にする方法を示しています。すべてのサブスクリプションがあらかじめ削除されていることを想定しています。詳細については、「 Delete a Pull Subscription 」または「 Delete a Push Subscription」を参照してください。

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
SET @publicationDB = N'AdventureWorks'; 
SET @publication = N'AdvWorksProductTran'; 

-- Remove a transactional publication.
USE [AdventureWorks2022]
EXEC sp_droppublication @publication = @publication;

-- Remove replication objects from the database.
USE [master]
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname = N'publish', 
  @value = N'false';
GO

次の例は、マージパブリケーションを削除し、データベースのマージパブリッシングを無効にする方法を示しています。すべてのサブスクリプションがあらかじめ削除されていることを想定しています。詳細については、「 Delete a Pull Subscription 」または「 Delete a Push Subscription」を参照してください。

DECLARE @publication AS sysname
DECLARE @publicationDB    AS sysname
SET @publication = N'AdvWorksSalesOrdersMerge' 
SET @publicationDB = N'AdventureWorks'

-- Remove the merge publication.
USE [AdventureWorks]
EXEC sp_dropmergepublication @publication = @publication;

-- Remove replication objects from the database.
USE master
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname = N'merge publish', 
  @value = N'false'
GO

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

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

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

ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。
TransPublication クラスのインスタンスを作成します。
パブリケーションの Name プロパティおよび DatabaseName プロパティを設定し、 ConnectionContext プロパティに手順 1. で作成した接続を設定します。
IsExistingObject プロパティをチェックして、パブリケーションが存在することを確認します。このプロパティの値が falseである場合は、手順 3. でパブリケーションプロパティが不適切に定義されたか、パブリケーションが存在していません。
Remove メソッドを呼び出します。
(省略可) このデータベースに他のトランザクションパブリケーションが存在する場合は、次に示すように、トランザクションパブリッシングに対してデータベースを無効にすることができます。
1. ReplicationDatabase クラスのインスタンスを作成します。手順 1. の ConnectionContext インスタンスを ServerConnection プロパティに設定します。
2. LoadProperties メソッドを呼び出します。このメソッドにより falseが返された場合は、データベースが存在することを確認してください。
3. パブリケーションの EnabledTransPublishing プロパティを falseフォルダーからパブリケーションを削除します。
4. CommitPropertyChanges メソッドを呼び出します。
接続を閉じます。

マージパブリケーションを削除するには

ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。
MergePublication クラスのインスタンスを作成します。
パブリケーションの Name プロパティおよび DatabaseName プロパティを設定し、 ConnectionContext プロパティに手順 1. で作成した接続を設定します。
IsExistingObject プロパティをチェックして、パブリケーションが存在することを確認します。このプロパティの値が falseである場合は、手順 3. でパブリケーションプロパティが不適切に定義されたか、パブリケーションが存在していません。
Remove メソッドを呼び出します。
(省略可) このデータベースに他のマージパブリケーションが存在する場合は、次に示すように、マージパブリッシングに対してデータベースを無効にすることができます。
1. ReplicationDatabase クラスのインスタンスを作成します。 ConnectionContext プロパティを、手順 1. の ServerConnection のインスタンスに設定します。
2. LoadProperties メソッドを呼び出します。このメソッドが falseを返す場合、データベースが存在するかどうかを確認してください。
3. パブリケーションの EnabledMergePublishing プロパティを falseフォルダーからパブリケーションを削除します。
4. CommitPropertyChanges メソッドを呼び出します。
接続を閉じます。

例 (RMO)

次の例では、トランザクションパブリケーションを削除します。このデータベースに対して他のトランザクションパブリケーションが存在しない場合は、トランザクションパブリッシングも無効になります。

// Define the Publisher, publication database, 
// and publication names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2022";

TransPublication publication;
ReplicationDatabase publicationDb;

// Create a connection to the Publisher 
// using Windows Authentication.
ServerConnection conn = new ServerConnection(publisherName);

try
{
    conn.Connect();

    // Set the required properties for the transactional publication.
    publication = new TransPublication();
    publication.ConnectionContext = conn;
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;

    // Delete the publication, if it exists and has no subscriptions.
    if (publication.LoadProperties() && !publication.HasSubscription)
    {
        publication.Remove();
    }
    else
    {
        // Do something here if the publication does not exist
        // or has subscriptions.
        throw new ApplicationException(String.Format(
            "The publication {0} could not be deleted. " +
            "Ensure that the publication exists and that all " +
            "subscriptions have been deleted.",
            publicationName, publisherName));
    }

    // If no other transactional publications exists,
    // disable publishing on the database.
    publicationDb = new ReplicationDatabase(publicationDbName, conn);
    if (publicationDb.LoadProperties())
    {
        if (publicationDb.TransPublications.Count == 0)
        {
            publicationDb.EnabledTransPublishing = false;
        }
    }
    else
    {
        // Do something here if the database does not exist.
        throw new ApplicationException(String.Format(
            "The database {0} does not exist on {1}.",
            publicationDbName, publisherName));
    }
}
catch (Exception ex)
{
    // Implement application error handling here.
    throw new ApplicationException(String.Format(
        "The publication {0} could not be deleted.",
        publicationName), ex);
}
finally
{
    conn.Disconnect();
}

' Define the Publisher, publication database, 
' and publication names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2022"

Dim publication As TransPublication
Dim publicationDb As ReplicationDatabase

' Create a connection to the Publisher 
' using Windows Authentication.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Try
    conn.Connect()

    ' Set the required properties for the transactional publication.
    publication = New TransPublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' Delete the publication, if it exists and has no subscriptions.
    If publication.LoadProperties() And Not publication.HasSubscription Then
        publication.Remove()
    Else
        ' Do something here if the publication does not exist
        ' or has subscriptions.
        Throw New ApplicationException(String.Format( _
         "The publication {0} could not be deleted. " + _
         "Ensure that the publication exists and that all " + _
         "subscriptions have been deleted.", _
         publicationName, publisherName))
    End If

    ' If no other transactional publications exists,
    ' disable publishing on the database.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)
    If publicationDb.LoadProperties() Then
        If publicationDb.TransPublications.Count = 0 Then
            publicationDb.EnabledTransPublishing = False
        End If
    Else
        ' Do something here if the database does not exist.
        Throw New ApplicationException(String.Format( _
         "The database {0} does not exist on {1}.", _
         publicationDbName, publisherName))
    End If
Catch ex As Exception
    ' Implement application error handling here.
    Throw New ApplicationException(String.Format( _
     "The publication {0} could not be deleted.", _
     publicationName), ex)
Finally
    conn.Disconnect()
End Try

次の例では、マージパブリケーションを削除します。このデータベースに対して他のマージパブリケーションが存在しない場合は、マージパブリッシングも無効になります。

// Define the Publisher, publication database, 
// and publication names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2022";

MergePublication publication;
ReplicationDatabase publicationDb;

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

try
{
    // Connect to the Publisher.
    conn.Connect();

    // Set the required properties for the merge publication.
    publication = new MergePublication();
    publication.ConnectionContext = conn;
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;

    // Delete the publication, if it exists and has no subscriptions.
    if (publication.LoadProperties() && !publication.HasSubscription)
    {
        publication.Remove();
    }
    else
    {
        // Do something here if the publication does not exist
        // or has subscriptions.
        throw new ApplicationException(String.Format(
            "The publication {0} could not be deleted. " +
            "Ensure that the publication exists and that all " +
            "subscriptions have been deleted.",
            publicationName, publisherName));
    }

    // If no other merge publications exists,
    // disable publishing on the database.
    publicationDb = new ReplicationDatabase(publicationDbName, conn);
    if (publicationDb.LoadProperties())
    {
        if (publicationDb.MergePublications.Count == 0 && publicationDb.EnabledMergePublishing)
        {
            publicationDb.EnabledMergePublishing = false;
        }
    }
    else
    {
        // Do something here if the database does not exist.
        throw new ApplicationException(String.Format(
            "The database {0} does not exist on {1}.",
            publicationDbName, publisherName));
    }
}
catch (Exception ex)
{
    // Implement application error handling here.
    throw new ApplicationException(String.Format(
        "The publication {0} could not be deleted.",
        publicationName), ex);
}
finally
{
    conn.Disconnect();
}

' Define the Publisher, publication database, 
' and publication names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2022"

Dim publication As MergePublication
Dim publicationDb As ReplicationDatabase

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Set the required properties for the merge publication.
    publication = New MergePublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' Delete the publication, if it exists and has no subscriptions.
    If (publication.LoadProperties() And Not publication.HasSubscription) Then
        publication.Remove()
    Else
        ' Do something here if the publication does not exist
        ' or has subscriptions.
        Throw New ApplicationException(String.Format( _
         "The publication {0} could not be deleted. " + _
         "Ensure that the publication exists and that all " + _
         "subscriptions have been deleted.", _
         publicationName, publisherName))
    End If

    ' If no other merge publications exists,
    ' disable publishing on the database.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)
    If publicationDb.LoadProperties() Then
        If publicationDb.MergePublications.Count = 0 _
        And publicationDb.EnabledMergePublishing Then
            publicationDb.EnabledMergePublishing = False
        End If
    Else
        ' Do something here if the database does not exist.
        Throw New ApplicationException(String.Format( _
         "The database {0} does not exist on {1}.", _
         publicationDbName, publisherName))
    End If
Catch ex As Exception
    ' Implement application error handling here.
    Throw New ApplicationException(String.Format( _
     "The publication {0} could not be deleted.", _
     publicationName), ex)
Finally
    conn.Disconnect()
End Try

参照

Replication System Stored Procedures Concepts
データとデータベースオブジェクトのパブリッシュ

次の方法で共有

パブリケーションの削除

SQL Server Management Studio を使用する

パブリケーションを削除するには

Transact-SQL の使用

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

マージパブリケーションを削除するには

例 (Transact-SQL)

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

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

マージパブリケーションを削除するには

例 (RMO)

参照

フィードバック

その他のリソース

次の方法で共有

パブリケーションの削除

SQL Server Management Studio を使用する

パブリケーションを削除するには

Transact-SQL の使用

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

マージ パブリケーションを削除するには

例 (Transact-SQL)

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

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

マージ パブリケーションを削除するには

例 (RMO)

参照

フィードバック

その他のリソース

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

マージパブリケーションを削除するには

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

マージパブリケーションを削除するには