Menonaktifkan Penerbitan dan Distribusi

Artikel
09/25/2024

Berlaku untuk: SQL Server Azure SQL Managed Instance

Topik ini menjelaskan cara menonaktifkan penerbitan dan distribusi di SQL Server dengan menggunakan SQL Server Management Studio, Transact-SQL, atau Replication Management Objects (RMO).

Anda dapat melakukan tindakan berikut:

Hapus semua database distribusi di Distributor.
Nonaktifkan semua Penerbit yang menggunakan Distributor dan hapus semua publikasi pada Penerbit tersebut.
Hapus semua langganan ke publikasi. Data dalam database publikasi dan langganan tidak akan dihapus; namun, ia kehilangan hubungan sinkronisasinya ke database publikasi apa pun. Jika Anda ingin data di Pelanggan dihapus, Anda harus menghapusnya secara manual.

Dalam Topik Ini

Sebelum Anda mulai:

Prasyarat
Untuk menonaktifkan penerbitan dan distribusi, gunakan:

SQL Server Management Studio

T-SQL

Objek Manajemen Replikasi (RMO)

Sebelum Anda mulai

Prasyarat

Untuk menonaktifkan penerbitan dan distribusi, semua database distribusi dan publikasi harus online. Jika ada rekam jepret database untuk database distribusi atau publikasi, rekam jepret tersebut harus dihilangkan sebelum menonaktifkan penerbitan dan distribusi. Rekam jepret database adalah salinan database offline baca-saja dan tidak terkait dengan rekam jepret replikasi. Untuk informasi selengkapnya, lihat Rekam Jepret Database (SQL Server).

Menggunakan SQL Server Management Studio

Nonaktifkan penerbitan dan distribusi dengan menggunakan Wizard Nonaktifkan Penerbitan dan Distribusi.

Untuk menonaktifkan penerbitan dan distribusi

Sambungkan ke Penerbit atau Distributor yang ingin Anda nonaktifkan di Microsoft SQL Server Management Studio, lalu perluas simpul server.
Klik kanan folder Replikasi, lalu klik Nonaktifkan Penerbitan dan Distribusi.
Selesaikan langkah-langkah dalam Wizard Nonaktifkan Penerbitan dan Distribusi.

Menggunakan T-SQL

Penerbitan dan pendistribusian dapat dinonaktifkan secara terprogram menggunakan prosedur tersimpan replikasi.

Untuk menonaktifkan penerbitan dan distribusi

Hentikan semua pekerjaan terkait replikasi. Untuk daftar nama pekerjaan, lihat bagian "Keamanan Agen Di Bawah Agen SQL Server" dari Model Keamanan Agen Replikasi.
Di setiap Pelanggan pada database langganan, jalankan sp_removedbreplication untuk menghapus objek replikasi dari database. Prosedur tersimpan ini tidak akan menghapus pekerjaan replikasi di Distributor.
Di Publisher pada database publikasi, jalankan sp_removedbreplication untuk menghapus objek replikasi dari database.
Jika Publisher menggunakan Distributor jarak jauh, jalankan sp_dropdistributor.
Di Distributor, jalankan sp_dropdistpublisher. Prosedur tersimpan ini harus dijalankan sekali untuk setiap Penerbit yang terdaftar di Distributor.
Di Distributor, jalankan sp_dropdistributiondb untuk menghapus database distribusi. Prosedur tersimpan ini harus dijalankan sekali untuk setiap database distribusi di Distributor. Ini juga menghapus pekerjaan Agen Pembaca Antrean apa pun yang terkait dengan database distribusi.
Di Distributor, jalankan sp_dropdistributor untuk menghapus penunjukan Distributor dari server.

Catatan

Jika semua objek penerbitan dan distribusi replikasi tidak dihilangkan sebelum Anda menjalankan sp_dropdistpublisher dan sp_dropdistributor, prosedur ini akan mengembalikan kesalahan. Untuk menghilangkan semua objek terkait replikasi saat Penerbit atau Distributor dihilangkan, @no_checks parameter harus diatur ke 1. Jika Penerbit atau Distributor offline atau tidak dapat dijangkau, @ignore_distributor parameter dapat diatur ke 1 sehingga dapat dihilangkan; namun, setiap objek penerbitan dan distribusi yang tertinggal harus dihapus secara manual.

Contoh (Transact-SQL)

Contoh skrip ini menghapus objek replikasi dari database langganan.

-- Remove replication objects from the subscription database on MYSUB.
DECLARE @subscriptionDB AS sysname
SET @subscriptionDB = N'AdventureWorks2022Replica'

-- Remove replication objects from a subscription database (if necessary).
USE master
EXEC sp_removedbreplication @subscriptionDB
GO

Contoh skrip ini menonaktifkan penerbitan dan distribusi di server yang merupakan Penerbit dan Distributor dan menghilangkan database distribusi.

-- 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".

-- Disable publishing and distribution.
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB as sysname;
SET @distributionDB = N'distribution';
SET @publisher = $(DistPubServer);
SET @publicationDB = N'AdventureWorks2022';

-- Disable the publication database.
USE [AdventureWorks2022]
EXEC sp_removedbreplication @publicationDB;

-- Remove the registration of the local Publisher at the Distributor.
USE master
EXEC sp_dropdistpublisher @publisher;

-- Delete the distribution database.
EXEC sp_dropdistributiondb @distributionDB;

-- Remove the local server as a Distributor.
EXEC sp_dropdistributor;
GO

Menggunakan Objek Manajemen Replikasi (RMO)

Untuk menonaktifkan penerbitan dan distribusi

Hapus semua langganan ke publikasi yang menggunakan Distributor. Untuk informasi selengkapnya, lihat Menghapus Langganan Pull dan Menghapus Langganan Push.
Hapus semua publikasi yang menggunakan Distributor, dan nonaktifkan penerbitan untuk semua database jika Penerbit dan Distributor berada di server yang sama. Untuk informasi selengkapnya, lihat Menghapus Publikasi.
Buat koneksi ke Distributor dengan menggunakan ServerConnection kelas .
Membuat instans kelas DistributionPublisher. Tentukan Name properti , dan teruskan ServerConnection objek dari langkah 3.
(Opsional) LoadProperties Panggil metode untuk mendapatkan properti objek dan verifikasi bahwa Publisher ada. Jika metode ini mengembalikan false, nama Publisher yang ditetapkan di langkah 4 salah atau Publisher tidak digunakan oleh Distributor ini.
Panggil Remove metode. Berikan nilai true untuk paksa jika Penerbit dan Distributor berada di server yang berbeda, dan ketika Penerbit harus dihapus instalasinya di Distributor tanpa terlebih dahulu memverifikasi bahwa publikasi tidak lagi ada di Penerbit.
Membuat instans kelas ReplicationServer. Teruskan ServerConnection objek dari langkah 3.
Panggil UninstallDistributor metode. Berikan nilai true untuk paksa menghapus semua objek replikasi di Distributor tanpa terlebih dahulu memverifikasi bahwa semua database publikasi lokal telah dinonaktifkan, dan database distribusi telah dihapus instalasinya.

Contoh (RMO)

Contoh ini menghapus pendaftaran Penerbit di Distributor, menghilangkan database distribusi, dan menghapus instalasi Distributor.

// Set the Distributor and publication database names.
// Publisher and Distributor are on the same server instance.
string publisherName = publisherInstance;
string distributorName = publisherInstance;
string distributionDbName = "distribution";
string publicationDbName = "AdventureWorks2022";

// Create connections to the Publisher and Distributor
// using Windows Authentication.
ServerConnection publisherConn = new ServerConnection(publisherName);
ServerConnection distributorConn = new ServerConnection(distributorName);

// Create the objects we need.
ReplicationServer distributor =
    new ReplicationServer(distributorConn);
DistributionPublisher publisher;
DistributionDatabase distributionDb =
    new DistributionDatabase(distributionDbName, distributorConn);
ReplicationDatabase publicationDb;
publicationDb = new ReplicationDatabase(publicationDbName, publisherConn);

try
{
    // Connect to the Publisher and Distributor.
    publisherConn.Connect();
    distributorConn.Connect();

    // Disable all publishing on the AdventureWorks2022 database.
    if (publicationDb.LoadProperties())
    {
        if (publicationDb.EnabledMergePublishing)
        {
            publicationDb.EnabledMergePublishing = false;
        }
        else if (publicationDb.EnabledTransPublishing)
        {
            publicationDb.EnabledTransPublishing = false;
        }
    }
    else
    {
        throw new ApplicationException(
            String.Format("The {0} database does not exist.", publicationDbName));
    }

    // We cannot uninstall the Publisher if there are still Subscribers.
    if (distributor.RegisteredSubscribers.Count == 0)
    {
        // Uninstall the Publisher, if it exists.
        publisher = new DistributionPublisher(publisherName, distributorConn);
        if (publisher.LoadProperties())
        {
            publisher.Remove(false);
        }
        else
        {
            // Do something here if the Publisher does not exist.
            throw new ApplicationException(String.Format(
                "{0} is not a Publisher for {1}.", publisherName, distributorName));
        }

        // Drop the distribution database.
        if (distributionDb.LoadProperties())
        {
            distributionDb.Remove();
        }
        else
        {
            // Do something here if the distribition DB does not exist.
            throw new ApplicationException(String.Format(
                "The distribution database '{0}' does not exist on {1}.",
                distributionDbName, distributorName));
        }

        // Uninstall the Distributor, if it exists.
        if (distributor.LoadProperties())
        {
            // Passing a value of false means that the Publisher 
            // and distribution databases must already be uninstalled,
            // and that no local databases be enabled for publishing.
            distributor.UninstallDistributor(false);
        }
        else
        {
            //Do something here if the distributor does not exist.
            throw new ApplicationException(String.Format(
                "The Distributor '{0}' does not exist.", distributorName));
        }
    }
    else
    {
        throw new ApplicationException("You must first delete all subscriptions.");
    }
}
catch (Exception ex)
{
    // Implement appropriate error handling here.
    throw new ApplicationException("The Publisher and Distributor could not be uninstalled", ex);
}
finally
{
    publisherConn.Disconnect();
    distributorConn.Disconnect();
}

' Set the Distributor and publication database names.
' Publisher and Distributor are on the same server instance.
Dim publisherName As String = publisherInstance
Dim distributorName As String = subscriberInstance
Dim distributionDbName As String = "distribution"
Dim publicationDbName As String = "AdventureWorks2022"

' Create connections to the Publisher and Distributor
' using Windows Authentication.
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)
Dim distributorConn As ServerConnection = New ServerConnection(distributorName)

' Create the objects we need.
Dim distributor As ReplicationServer
distributor = New ReplicationServer(distributorConn)
Dim publisher As DistributionPublisher
Dim distributionDb As DistributionDatabase
distributionDb = New DistributionDatabase(distributionDbName, distributorConn)
Dim publicationDb As ReplicationDatabase
publicationDb = New ReplicationDatabase(publicationDbName, publisherConn)

Try
    ' Connect to the Publisher and Distributor.
    publisherConn.Connect()
    distributorConn.Connect()

    ' Disable all publishing on the AdventureWorks2022 database.
    If publicationDb.LoadProperties() Then
        If publicationDb.EnabledMergePublishing Then
            publicationDb.EnabledMergePublishing = False
        ElseIf publicationDb.EnabledTransPublishing Then
            publicationDb.EnabledTransPublishing = False
        End If
    Else
        Throw New ApplicationException( _
            String.Format("The {0} database does not exist.", publicationDbName))
    End If

    ' We cannot uninstall the Publisher if there are still Subscribers.
    If distributor.RegisteredSubscribers.Count = 0 Then
        ' Uninstall the Publisher, if it exists.
        publisher = New DistributionPublisher(publisherName, distributorConn)
        If publisher.LoadProperties() Then
            publisher.Remove(False)
        Else
            ' Do something here if the Publisher does not exist.
            Throw New ApplicationException(String.Format( _
                "{0} is not a Publisher for {1}.", publisherName, distributorName))
        End If

        ' Drop the distribution database.
        If distributionDb.LoadProperties() Then
            distributionDb.Remove()
        Else
            ' Do something here if the distribition DB does not exist.
            Throw New ApplicationException(String.Format( _
             "The distribution database '{0}' does not exist on {1}.", _
             distributionDbName, distributorName))
        End If

        ' Uninstall the Distributor, if it exists.
        If distributor.LoadProperties() Then
            ' Passing a value of false means that the Publisher 
            ' and distribution databases must already be uninstalled,
            ' and that no local databases be enabled for publishing.
            distributor.UninstallDistributor(False)
        Else
            'Do something here if the distributor does not exist.
            Throw New ApplicationException(String.Format( _
                "The Distributor '{0}' does not exist.", distributorName))
        End If
    Else
        Throw New ApplicationException("You must first delete all subscriptions.")
    End If

Catch ex As Exception
    ' Implement appropriate error handling here.
    Throw New ApplicationException("The Publisher and Distributor could not be uninstalled", ex)

Finally
    publisherConn.Disconnect()
    distributorConn.Disconnect()

End Try

Contoh ini menghapus instalan Distributor tanpa terlebih dahulu menonaktifkan database publikasi lokal atau menghilangkan database distribusi.

// Set the Distributor and publication database names.
// Publisher and Distributor are on the same server instance.
string distributorName = publisherInstance;

// Create connections to the Distributor
// using Windows Authentication.
ServerConnection conn = new ServerConnection(distributorName);
conn.DatabaseName = "master";

// Create the objects we need.
ReplicationServer distributor = new ReplicationServer(conn);

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


    // Uninstall the Distributor, if it exists.
    // Use the force parameter to remove everthing.  
    if (distributor.IsDistributor && distributor.LoadProperties())
    {
        // Passing a value of true means that the Distributor 
        // is uninstalled even when publishing objects, subscriptions,
        // and distribution databases exist on the server.
        distributor.UninstallDistributor(true);
    }
    else
    {
        //Do something here if the distributor does not exist.
    }
}
catch (Exception ex)
{
    // Implement appropriate error handling here.
    throw new ApplicationException("The Publisher and Distributor could not be uninstalled", ex);
}
finally
{
    conn.Disconnect();
}

' Set the Distributor and publication database names.
' Publisher and Distributor are on the same server instance.
Dim distributorName As String = publisherInstance

' Create connections to the Distributor
' using Windows Authentication.
Dim conn As ServerConnection = New ServerConnection(distributorName)
conn.DatabaseName = "master"

' Create the objects we need.
Dim distributor As ReplicationServer = New ReplicationServer(conn)

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


    ' Uninstall the Distributor, if it exists.
    ' Use the force parameter to remove everthing.  
    If distributor.IsDistributor And distributor.LoadProperties() Then
        ' Passing a value of true means that the Distributor 
        ' is uninstalled even when publishing objects, subscriptions,
        ' and distribution databases exist on the server.
        distributor.UninstallDistributor(True)
    Else
        'Do something here if the distributor does not exist.
    End If

Catch ex As Exception
    ' Implement appropriate error handling here.
    Throw New ApplicationException("The Publisher and Distributor could not be uninstalled", ex)

Finally
    conn.Disconnect()

End Try

Bagikan melalui

Menonaktifkan Penerbitan dan Distribusi

Sebelum Anda mulai

Prasyarat

Menggunakan SQL Server Management Studio

Untuk menonaktifkan penerbitan dan distribusi

Menggunakan T-SQL

Untuk menonaktifkan penerbitan dan distribusi

Contoh (Transact-SQL)

Menggunakan Objek Manajemen Replikasi (RMO)

Untuk menonaktifkan penerbitan dan distribusi

Contoh (RMO)

Saran dan Komentar

Sumber Daya Tambahan:

Bagikan melalui

Menonaktifkan Penerbitan dan Distribusi

Sebelum Anda mulai

Prasyarat

Menggunakan SQL Server Management Studio

Untuk menonaktifkan penerbitan dan distribusi

Menggunakan T-SQL

Untuk menonaktifkan penerbitan dan distribusi

Contoh (Transact-SQL)

Menggunakan Objek Manajemen Replikasi (RMO)

Untuk menonaktifkan penerbitan dan distribusi

Contoh (RMO)

Konten terkait

Saran dan Komentar

Sumber Daya Tambahan: