Wyłącz publikację i dystrybucję

Dotyczy:SQL Server Azure SQL Managed Instance

Ten artykuł opisuje, jak wyłączyć publikowanie i dystrybucję w SQL Server za pomocą SQL Server Management Studio, Transact-SQL lub Replication Management Objects (RMO).

Możesz wykonać następujące kroki:

Usuń wszystkie bazy danych dystrybucji na Dystrybutorze.
Wyłącz wszystkich wydawców korzystających z dystrybutora i usuń wszystkie publikacje na tych wydawcach.
Usuń wszystkie subskrypcje publikacji. Dane w bazach publikacji i subskrypcji nie będą usuwane; jednak traci relację synchronizacyjną z jakimikolwiek bazami publikacji. Jeśli chcesz, aby dane na subskrybenta zostały usunięte, musisz usunąć je ręcznie.

Wymagania wstępne

Aby wyłączyć publikacje i dystrybucję, wszystkie bazy danych dystrybucji i publikacji muszą być online. Jeśli istnieją jakiekolwiek migawki bazy danych dla dystrybucji lub publikacji, musisz je usunąć przed wyłączeniem publikacji i dystrybucji. Migawka bazy danych to kopia bazy danych w trybie offline dostępna tylko do odczytu i nie jest powiązana z migawką replikacyjną. Aby uzyskać więcej informacji, zobacz Migawki bazy danych (SQL Server).

Korzystanie z programu SQL Server Management Studio

Użyj Kreatora wyłączania publikacji i dystrybucji, aby wyłączyć publikację i dystrybucję.

Aby uniemożliwić publikację i dystrybucję

Połącz się z Publisher lub Distributorem, którego chcesz wyłączyć w Microsoft SQL Server Management Studio, a następnie rozwiń węzeł serwera.
Kliknij prawym przyciskiem myszy na folder Replikacja , a następnie kliknij Wyłącz publikowanie i dystrybucję.
Wykonaj kroki w Kreatorze wyłączania publikowania i dystrybucji.

Korzystanie z Transact-SQL

Możesz wyłączyć publikowanie i dystrybucję, używając procedur przechowywanych w replikacji.

Aby uniemożliwić publikację i dystrybucję

Zatrzymaj wszystkie prace związane z replikacją. Listę nazw stanowisk można znaleźć w sekcji "Agent Security Under SQL Server Agent" w Replication Agent Security Model.
Na każdym Subskrybencie w bazie danych subskrypcji wykonaj sp_removedbreplication, aby usunąć z bazy obiekty replikacji. Ta procedura przechowywana nie usuwa zadań replikacyjnych w Dystrybutorze.
Na serwerze Publisher, w bazie danych publikacji, wykonaj sp_removedbreplication, aby usunąć obiekty replikacji z bazy danych.
Jeśli Publisher korzysta z zdalnego dystrybutora, wykonaj sp_dropdistributor.
Na serwerze Dystrybutora wykonaj polecenie sp_dropdistpublisher. Uruchom tę procedurę przechowywaną raz dla każdego Publisher zarejestrowanego u dystrybutora.
Na Dystrybutorze wykonaj sp_dropdistributiondb , aby usunąć bazę danych dystrybucji. Uruchom tę procedurę przechowywaną raz dla każdej bazy dystrybucji w Dystrybutorze. Ta akcja usuwa również wszelkie zadania Queue Reader Agent powiązane z bazą dystrybucji.
Na Dystrybutorze wykonaj sp_dropdistributor , aby usunąć oznaczenie Dystrybutora z serwera.

Uwaga / Notatka

Jeśli przed wykonaniem sp_dropdistpublisher i sp_dropdistributor nie usuniesz wszystkich obiektów publikacji i dystrybucji replikacji, procedury te zwrócą błąd. Aby usunąć wszystkie obiekty związane z replikacją, gdy Publisher lub Distributor zostanie usunięty, ustaw parametr @no_checks na 1. Jeśli Publisher lub Dystrybutor jest offline lub nieosiągalny, ustaw @ignore_distributor parametr na 1, aby móc go usunąć. Musisz jednak ręcznie usunąć wszelkie pozostałe obiekty publikacji i dystrybucji.

Przykłady (Transact-SQL)

Ten przykładowy skrypt usuwa obiekty replikacyjne z bazy subskrypcyjnej.

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

Ten przykładowy skrypt wyłącza publikowanie i dystrybucję na serwerze, który jest Publisher i Distributorem, oraz usuwa bazę danych dystrybucji.

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

Korzystanie z obiektów zarządzania replikacją (RMO)

Aby uniemożliwić publikację i dystrybucję

Usuń wszystkie subskrypcje publikacji korzystających z Dystrybutora. Więcej informacji znajdziesz w artykule Usuń subskrypcję Pull oraz Usuń subskrypcję Push.
Usuń wszystkie publikacje korzystające z Dystrybutora i wyłącz publikacje we wszystkich bazach danych, jeśli Publisher i Dystrybutor są na tym samym serwerze. Aby uzyskać więcej informacji, zobacz Usuwanie publikacji.
Utwórz połączenie z dystrybutorem przy użyciu klasy ServerConnection.
Utwórz wystąpienie klasy DistributionPublisher. Określ właściwość Name i przekaż obiekt ServerConnection z kroku 3.
(Opcjonalnie) Wywołaj metodęLoadProperties, aby uzyskać właściwości obiektu i zweryfikować, że Publisher istnieje. Jeśli ta metoda zwraca false, nazwa wydawcy ustawiona w kroku 4 była nieprawidłowa lub ten dystrybutor nie używa tego wydawcy.
Wywołaj metodę Remove . Przekaż wartość true dla parametru force, jeśli Publisher i Distributor znajdują się na różnych serwerach oraz gdy Publisher ma zostać odinstalowany na serwerze Distributor bez uprzedniego sprawdzenia, czy publikacje nie istnieją już na Publisher.
Utwórz wystąpienie klasy ReplicationServer. Przekaż ServerConnection obiekt z kroku 3.
Wywołaj metodę UninstallDistributor . Przekaż wartość true dla parametru force, aby usunąć wszystkie obiekty replikacji na Dystrybutorze bez uprzedniego sprawdzenia, czy wszystkie lokalne bazy danych publikacji są wyłączone, a bazy danych dystrybucji odinstalowane.

Przykłady (RMO)

Poniższy przykład usuwa rejestrację Publisher u dystrybutora, usuwa bazę danych dystrybucji i odinstalowuje dystrybutora.

// 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

Poniższy przykład odinstalowuje dystrybutora bez wcześniejszego wyłączania lokalnych baz danych publikacji lub rezygnacji z bazy dystrybucji.

// 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

Pojęcia dotyczące obiektów zarządzania replikacją
Pojęcia dotyczące procedur składowanych w systemie replikacji

Opinia

Czy ta strona była pomocna?

Last updated on 2026-09-04

Wyłącz publikację i dystrybucję

Wymagania wstępne

Korzystanie z programu SQL Server Management Studio

Aby uniemożliwić publikację i dystrybucję

Korzystanie z Transact-SQL

Aby uniemożliwić publikację i dystrybucję

Przykłady (Transact-SQL)

Korzystanie z obiektów zarządzania replikacją (RMO)

Aby uniemożliwić publikację i dystrybucję

Przykłady (RMO)

Treści powiązane

Opinia

Dodatkowe zasoby