Partilhar via


Excluir uma assinatura push

Aplica-se ao: SQL Server Banco de Dados SQL do Azure

Este tópico descreve como excluir uma assinatura push no SQL Server usando o SQL Server Management Studio, o Transact-SQL ou o Replication Management Objects (RMO).

Neste tópico

Como usar o SQL Server Management Studio.

Exclua uma assinatura push no Publicador (da pasta Publicações Locais no SQL Server Management Studio) ou no Assinante (da pasta Assinaturas Locais). A exclusão de uma assinatura não remove objetos ou dados da assinatura; eles devem ser removidos manualmente.

Para excluir uma assinatura push no Publicador

  1. Conecte-se ao Publicador no Microsoft SQL Server Management Studio e, em seguida, expanda o nó de servidor.

  2. Expanda a pasta Replicação e, em seguida, a pasta Publicações Locais .

  3. Expanda a publicação associada à assinatura que você deseja excluir.

  4. Clique como botão direito do mouse na assinatura e, então, clique em Excluir.

  5. Na caixa de diálogo de confirmação, selecione onde conectar-se ao Assinante para excluir as informações de assinatura. Se você desmarcar a caixa de seleção Conectar-se ao Assinante , será necessário conectar-se ao Assinante, posteriormente, para excluir as informações.

Para excluir uma assinatura push no Assinante

  1. Conecte-se ao Assinante no SQL Server Management Studio e, em seguida, expanda o nó de servidor.

  2. Expanda a pasta Replicação e, então, expanda a pasta Assinaturas Locais .

  3. Clique com o botão direito na assinatura a ser excluída e clique em Excluir.

  4. Na caixa de diálogo de confirmação, selecione se deseja se conectar ao Publicador para excluir as informações de assinatura. Se você desmarcar a caixa de seleção Conectar-se ao Publicador , será necessário se conectar ao Publicador posteriormente para excluir as informações.

Usando o Transact-SQL

As assinaturas push podem ser excluídas programaticamente, usando procedimentos armazenados de replicação. Os procedimentos armazenados usados dependem do tipo de publicação ao qual a assinatura pertence.

Para excluir uma assinatura push de um instantâneo ou publicação transacional

  1. No Publicador do banco de dados de publicação, execute sp_dropsubscription (Transact-SQL). Especifique @publication e @subscriber. Especifique um valor de all para @article. (Opcional) Se o Distribuidor não puder ser acessado, especifique um valor de 1 para @ignore_distributor para excluir a assinatura sem remover objetos relacionados no Distribuidor.

  2. No Assinante no banco de dados de assinatura, execute sp_subscription_cleanup (Transact-SQL) para remover metadados de replicação no banco de dados de assinatura.

Para excluir uma assinatura push para uma publicação de mesclagem.

  1. No Publicador, execute sp_dropmergesubscription (Transact-SQL) especificando @publication, @subscriber e @subscriber_db. (Opcional) Se o Distribuidor não puder ser acessado, especifique um valor de 1 para @ignore_distributor para excluir a assinatura sem remover objetos relacionados no Distribuidor.

  2. No Assinante no banco de dados de assinatura, execute sp_mergesubscription_cleanup (Transact-SQL). Especifique @publisher, @publisher_db, e @publication. Isso remove metadados de mesclagem do banco de dados de assinatura.

Exemplos (Transact-SQL)

Esse exemplo exclui uma assinatura push para uma publicação transacional.

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

Esse exemplo exclui uma assinatura push para uma publicação de mesclagem.

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

Usando o RMO (Replication Management Objects)

As classes RMO a serem usadas para excluir uma assinatura push dependem do tipo de publicação em que a assinatura push está inscrita.

Para excluir uma assinatura push de um instantâneo ou publicação transacional

  1. Crie uma conexão com o Publicador usando a classe ServerConnection .

  2. Criar uma instância da classe TransSubscription.

  3. Defina as propriedades PublicationName, SubscriptionDBName, SubscriberNamee DatabaseName .

  4. Defina a propriedade ServerConnection da etapa 1 para o ConnectionContext .

  5. Verifique a propriedade IsExistingObject para verificar se a assinatura existe. Se o valor dessa propriedade for false, as propriedades de assinatura na etapa 2 foram definidas incorretamente ou a assinatura não existe.

  6. Chame o método Remove .

Para excluir uma assinatura push para uma publicação de mesclagem.

  1. Crie uma conexão com o Publicador usando a classe ServerConnection .

  2. Criar uma instância da classe MergeSubscription.

  3. Defina as propriedades PublicationName, SubscriptionDBName, SubscriberNamee DatabaseName .

  4. Defina a propriedade ServerConnection da etapa 1 para o ConnectionContext .

  5. Verifique a propriedade IsExistingObject para verificar se a assinatura existe. Se o valor dessa propriedade for false, as propriedades de assinatura na etapa 2 foram definidas incorretamente ou a assinatura não existe.

  6. Chame o método Remove .

Exemplos (RMO)

Você pode excluir assinaturas push programaticamente, usando o RMO (Replication Management Objects).

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

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

// Create the objects that we need.
TransSubscription subscription;

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

    // Define the pull subscription.
    subscription = new TransSubscription();
    subscription.ConnectionContext = conn;
    subscription.SubscriberName = subscriberName;
    subscription.PublicationName = publicationName;
    subscription.SubscriptionDBName = subscriptionDbName;
    subscription.DatabaseName = publicationDbName;

    // Delete the pull subscription, if it exists.
    if (subscription.IsExistingObject)
    {
        // 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
{
    conn.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 a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim subscription As TransSubscription

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

    ' Define the pull subscription.
    subscription = New TransSubscription()
    subscription.ConnectionContext = conn
    subscription.SubscriberName = subscriberName
    subscription.PublicationName = publicationName
    subscription.SubscriptionDBName = subscriptionDbName
    subscription.DatabaseName = publicationDbName

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

        ' 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
    conn.Disconnect()
End Try

Confira também

Subscribe to Publications
Replication Security Best Practices