sp_dropmergepublication (Transact-SQL)

Quita una publicación de mezcla y su Agente de instantáneas asociado. Antes de quitar una publicación de mezcla, 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 publicaciones.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

  • [ @publication=] 'publication'
    Es el nombre de la publicación que se va a quitar. publication es de tipo sysname y no tiene ningún valor predeterminado. Si es all, se quitan todas las publicaciones de mezcla existentes, así como el trabajo del Agente de instantáneas asociado a ellas. Si se especifica un valor concreto para publication, sólo se quita esa publicación y el trabajo del 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 de tipo bit y su valor predeterminado es 0. Este parámetro también se utiliza al volver a instalar el distribuidor.

  • [ @reserved=] reserved
    Está reservado para su uso futuro. reserved es de tipo bit y su valor predeterminado es 0.

  • [ @ignore_merge_metadata= ] ignore_merge_metadata
    Exclusivamente para uso interno.

Valores de código de retorno

0 (correcto) o 1 (error)

Notas

sp_dropmergepublication se utiliza en la replicación de mezcla.

sp_dropmergepublication quita recursivamente 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 tiene una o más suscripciones. Para obtener información acerca de cómo quitar suscripciones, vea Cómo eliminar una suscripción de inserción (programación de la replicación con Transact-SQL) y Cómo eliminar una suscripción de extracción (programación de la replicación con Transact-SQL).

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

Ejemplo

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

Sólo los miembros de la función fija de servidor sysadmin o de la función fija de base de datos db_owner pueden ejecutar sp_dropmergepublication.