sp_changepublication (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed Instance

Cambia las propiedades de una publicación. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicación.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_changepublication [ [ @publication = ] 'publication' ]  
    [ , [ @property = ] 'property' ]  
    [ , [ @value = ] 'value' ]  
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]  
    [ , [ @publisher = ] 'publisher' ]

Argumentos

[ @publication = ] 'publication' Es el nombre de la publicación. publication es sysname, con un valor predeterminado de NULL.

[ @property = ] 'property' Es la propiedad de publicación que se va a cambiar. property es nvarchar(255).

[ @value = ] 'value' Es el nuevo valor de propiedad. value es nvarchar(255), con un valor predeterminado de NULL.

Esta tabla describe las propiedades de la publicación que se pueden cambiar y las restricciones de los valores de esas propiedades.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot Confirma que la acción realizada por este procedimiento almacenado puede invalidar una instantánea existente. force_invalidate_snapshot es un poco, con un valor predeterminado de 0.

• 0 especifica que los cambios realizados en el artículo no hacen que la instantánea no sea válida. Si el procedimiento almacenado detecta que el cambio requiere una nueva instantánea, se producirá un error y no se realizarán cambios.
• 1 especifica que los cambios realizados en el artículo pueden hacer que la instantánea no sea válida. Si existen suscripciones que requieran una nueva instantánea, este valor da permiso para que la instantánea existente se marque como obsoleta y se genere otra nueva.
  Vea en la sección de Notas las propiedades que, si se cambian, requieren que se genere una instantánea nueva.

[@force_reinit_subscription = ] force_reinit_subscription
Confirma que la acción realizada por este procedimiento almacenado puede requerir que se reinicialicen las suscripciones existentes. force_reinit_subscription es un bit con un valor predeterminado de 0.

• 0 especifica que los cambios realizados en el artículo no hacen que se reinicialice la suscripción. Si el procedimiento almacenado detecta que el cambio requiere la reinicialización de las suscripciones existentes, se producirá un error y no se realizarán cambios.
• 1 especifica que los cambios realizados en el artículo hacen que se reinicialice la suscripción existente y que se conceda permiso para que se produzca la reinicialización de la suscripción.

[ @publisher = ] 'publisher' Especifica un publicador que no es de SQL Server. publisher es sysname, con un valor predeterminado de NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_changepublication se usa en la replicación de instantáneas y la replicación transaccional.

Después de cambiar cualquiera de las propiedades siguientes, debe generar una nueva instantánea y debe especificar un valor de 1 para el parámetro force_invalidate_snapshot.

• alt_snapshot_folder
• compress_snapshot
• enabled_for_het_sub
• ftp_address
• ftp_login
• ftp_password
• ftp_port
• ftp_subdirectory
• post_snapshot_script
• pre_snapshot_script
• snapshot_in_defaultfolder
• sync_mode

Para enumerar objetos de publicación en Active Directory mediante el parámetro publish_to_active_directory , el objeto de SQL Server ya debe crearse en Active Directory.

Impacto de la sincronización inmediata

Cuando la sincronización inmediata está activada, se realiza un seguimiento de todos los cambios en el registro inmediatamente después de que se genere la instantánea inicial incluso si no hay suscripciones. Los cambios registrados se usan cuando un cliente usa la copia de seguridad para agregar un nuevo nodo del mismo nivel. Una vez restaurada la copia de seguridad, el elemento del mismo nivel se sincroniza con cualquier otro cambio que se produzca después de realizar la copia de seguridad. Dado que se realiza un seguimiento de los comandos en la base de datos de distribución, la lógica de sincronización puede examinar el último LSN de copia de seguridad y usarlo como punto de partida, sabiendo que el comando está disponible si la copia de seguridad se realizó dentro del período de retención máximo. (El valor predeterminado para el período de retención mínimo es de 0 horas y el período máximo de retención es de 24 horas).

Cuando la sincronización inmediata está desactivada, los cambios se mantienen al menos el período de retención mínimo y se limpian inmediatamente para todas las transacciones que ya se han replicado. Si la sincronización inmediata está desactivada y configurada con el período de retención predeterminado, es probable que se hayan limpiado los cambios necesarios una vez realizada la copia de seguridad y que el nuevo nodo del mismo nivel no se inicialice correctamente. La única opción que queda es poner en modo inactivo la topología. Activar la sincronización inmediata proporciona mayor flexibilidad y es el valor recomendado para la replicación P2P.

Ejemplo

DECLARE @publication AS sysname
SET @publication = N'AdvWorksProductTran' 

-- Turn off DDL replication for the transactional publication.
USE [AdventureWorks2022]
EXEC sp_changepublication 
  @publication = @publication, 
  @property = N'replicate_ddl', 
  @value = 0
GO

Permisos

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

Consulte también

Ver y modificar propiedades de publicación
Cambiar las propiedades de la publicación y de los artículos
sp_addpublication (Transact-SQL)
sp_droppublication (Transact-SQL)
sp_helppublication (Transact-SQL)
Procedimientos almacenados de replicación (Transact-SQL)