sp_dropmergepublication (Transact-SQL)

Se aplica a:SQL Server

Quita una publicación de combinación y su Agente de instantáneas asociado. Antes de quitar una publicación de combinación, es necesario quitar todas las suscripciones. Los artículos de la publicación se quitan automáticamente. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicación.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_dropmergepublication
    [ @publication = ] N'publication'
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @reserved = ] reserved ]
    [ , [ @ignore_merge_metadata = ] ignore_merge_metadata ]
[ ; ]

Argumentos

[ @publication = ] N'publication'

Nombre de la publicación que se va a quitar. @publication es sysname, sin ningún valor predeterminado. Si alles , se quitan todas las publicaciones de combinación existentes, así como el trabajo de Agente de instantáneas asociado a ellas. Si especifica un valor determinado para @publication, solo se quita esa publicación y su trabajo de Agente de instantáneas asociado.

[ @ignore_distributor = ] ignore_distributor

Se utiliza para quitar una publicación sin realizar tareas de limpieza en el distribuidor. @ignore_distributor es bit, con un valor predeterminado de 0. Este parámetro también se utiliza al volver a instalar el distribuidor.

[ @reserved = ] reserved

Reservado para uso futuro. @reserved es bit, con un valor predeterminado de 0.

[ @ignore_merge_metadata = ] ignore_merge_metadata

Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_dropmergepublication se usa en la replicación de mezcla.

sp_dropmergepublication quita de forma recursiva todos los artículos asociados a una publicación y, a continuación, quita la propia publicación. No se puede quitar una publicación si se trata de una o varias suscripciones a ella. Para obtener información sobre cómo quitar suscripciones, vea Eliminar una suscripción de inserción y Eliminar una suscripción de extracción.

sp_dropmergepublication La ejecución de para quitar una publicación no quita los objetos publicados de la base de datos de publicación ni los objetos correspondientes de la base de datos de suscripciones. Si es necesario, utilice DROP <object> para quitar estos objetos manualmente.

Ejemplos

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

Permisos

Solo los miembros del rol fijo de servidor sysadmin o el rol fijo de base de datos db_owner pueden ejecutar sp_dropmergepublication.