sp_helpmergepublication (Transact-SQL)

Artículo
05/08/2013

Devuelve información sobre una publicación de combinación. Este procedimiento almacenado se ejecuta en el publicador en la base de datos de publicación.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_helpmergepublication [ [ @publication = ] 'publication' ]
    [ , [ @found = ] 'found' OUTPUT ]
    [ , [ @publication_id = ] 'publication_id' OUTPUT ]
    [ , [ @reserved = ] 'reserved' ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @publisher_db = ] 'publisher_db' ]

Argumentos

[ @publication**=** ] 'publication'
Nombre de la publicación. publication es de tipo sysname y su valor predeterminado es %, que devuelve información sobre todas las publicaciones de mezcla de la base de datos actual.
[ @found**=** ] 'found' OUTPUT
Marca que indica las filas devueltas. foundes de tipo int y un parámetro OUTPUT, con un valor predeterminado de NULL. 1 indica que la publicación se ha encontrado. 0 indica que la publicación no se ha encontrado.
[ @publication\_id**=**\] **'**publication_id' OUTPUT
El número de identificación de la publicación. publication_id es de tipo uniqueidentifier y un parámetro OUTPUT, con un valor predeterminado de NULL.
[ @reserved**=**\] 'reserved'
Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. reserved es de tipo nvarchar(20) y su valor predeterminado es NULL.
[ @publisher**=** ] 'publisher'
El nombre del publicador. publisher es de tipo sysname y su valor predeterminado es NULL.
[@publisher_db**=** ] 'publisher_db'
Nombre de la base de datos de publicación. publisher_db es de tipo sysname y su valor predeterminado es NULL.

Conjuntos de resultados

Nombre de la columna	Tipo de datos	Descripción
id	int	Orden secuencial de la publicación en la lista del conjunto de resultados.
name	sysname	Nombre de la publicación.
description	nvarchar(255)	Descripción de la publicación.
status	tinyint	Indica cuándo están disponibles los datos de la publicación.
retention	int	Tiempo durante el que guardar los metadatos sobre los cambios de los artículos de la publicación. Las unidades de este período pueden ser días, semanas, meses o años. Para obtener información sobre las unidades, vea la columna retention_period_unit.
sync_mode	tinyint	Modo de sincronización de esta publicación: 0 = Programa nativo de copia masiva (utilidad bcp ). 1 = Copia masiva de caracteres
allow_push	int	Determina si es posible crear suscripciones de inserción para la publicación indicada. 0 indica que no se permiten suscripciones de inserción.
allow_pull	int	Determina si es posible crear suscripciones de extracción para la publicación indicada. 0 indica que no se permiten suscripciones de extracción.
allow_anonymous	int	Determina si es posible crear suscripciones anónimas para la publicación indicada. 0 indica que no se permiten suscripciones anónimas.
centralized_conflicts	int	Determina si los registros de los conflictos se almacenan en el publicador dado: 0 = Los registros de los conflictos se almacenan en el publicador y en el suscriptor que creó el conflicto. 1 = Todos los registros de los conflictos se almacenan en el publicador.
priority	float(8)	Prioridad de la suscripción en bucle invertido.
snapshot_ready	tinyint	Indica si la instantánea de esta publicación está lista: 0 = La instantánea está lista para usarse. 1 = La instantánea no está lista para usarse.
publication_type	int	Tipo de publicación: 0 = Instantánea. 1 = Transaccional. 2 = Combinación.
pubid	uniqueidentifier	Identificador único de esta publicación.
snapshot_jobid	binary(16)	Identificador de trabajo del Agente de instantáneas. Para obtener la entrada del trabajo de instantáneas en la tabla del sistema sysjobs, debe convertir este valor hexadecimal a uniqueidentifier.
enabled_for_internet	int	Determina si la publicación está habilitada para Internet. Si el valor es 1, los archivos de sincronización de la publicación se colocan en el directorio C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp. El usuario debe crear el directorio FTP (Protocolo de transferencia de archivos). Si el valor es 0, la publicación no está habilitada para el acceso a Internet.
dynamic_filter	int	Indica si se debe usar el filtro de filas con parámetros. 0 indica que no se utiliza un filtro de filas con parámetros.
has_subscription	bit	Indica si la publicación tiene alguna suscripción. 0 indica que actualmente no hay suscripciones para esta publicación.
snapshot_in_default_folder	bit	Especifica si los archivos de instantánea se almacenan en la carpeta predeterminada. Si el valor es 1, los archivos de instantánea se encuentran en la carpeta predeterminada. Si el valor es 0, los archivos de instantánea se almacenan en la ubicación alternativa especificada por alt_snapshot_folder. Las ubicaciones alternativas pueden encontrarse en otro servidor, en una unidad de red o en medios extraíbles (como CD-ROM o discos extraíbles). También puede guardar los archivos de instantánea en un sitio FTP, para que el suscriptor los recupere más tarde. [!NOTA] Este parámetro puede ser TRUE y seguir teniendo una ubicación en el parámetro alt_snapshot_folder. Esta combinación especifica que los archivos de instantánea se almacenan tanto en la ubicación predeterminada como en la alternativa.
alt_snapshot_folder	nvarchar(255)	Especifica la ubicación de la carpeta alternativa de la instantánea.
pre_snapshot_script	nvarchar(255)	Especifica un puntero a un archivo .sql que el Agente de mezcla ejecuta antes que los scripts de objetos replicados cuando se aplica la instantánea en un suscriptor.
post_snapshot_script	nvarchar(255)	Especifica un puntero a un archivo .sql que el Agente de mezcla ejecuta una vez que se hayan aplicado todos los demás datos y scripts de objetos replicados durante una sincronización inicial.
compress_snapshot	bit	Especifica que la instantánea escrita en la ubicación alt_snapshot_folder está comprimida en el formato CAB de Microsoft.
ftp_address	sysname	Es la dirección de red del servicio FTP para el distribuidor. Especifica dónde se encuentran los archivos de instantánea de la publicación para que los recoja el Agente de mezcla.
ftp_port	int	Es el número de puerto del servicio FTP para el distribuidor. ftp_port tiene un valor predeterminado de 21. Especifica dónde se encuentran los archivos de instantánea de la publicación para que los recoja el Agente de mezcla.
ftp_subdirectory	nvarchar(255)	Especifica dónde se encuentran los archivos de instantánea para que los recoja el Agente de mezcla cuando se envía la instantánea mediante FTP.
ftp_login	sysname	Es el nombre de usuario que se utiliza para conectar con el servicio FTP.
conflict_retention	int	Especifica el período de retención, expresado en días, durante el que se conservan los conflictos. Transcurrido el número de días especificado, se purga la fila del conflicto de la tabla de conflictos.
keep_partition_changes	int	Especifica si se está optimizando la sincronización para esta publicación. keep_partition_changes tiene un valor predeterminado de 0. El valor 0 significa que la sincronización no se optimiza; las particiones enviadas a todos los suscriptores se comprueban cuando se modifican datos en una partición. El valor 1 significa que la sincronización se optimiza y solo se ven afectados los suscriptores con filas en la partición modificada. [!NOTA] De manera predeterminada, las publicaciones de combinación utilizan particiones previamente calculadas, lo que proporciona un mayor grado de optimización que esta opción. Para obtener más información, vea Filtros de fila con parámetros y Optimizar el rendimiento de los filtros con parámetros con particiones calculadas previamente.
allow_subscription_copy	int	Especifica si se ha habilitado la capacidad de copiar las bases de datos de suscripciones que se suscriben a esta publicación. El valor 0 significa que no se permite copiar.
allow_synctoalternate	int	Especifica si se permite un asociado de sincronización alternativo para sincronizar con este publicador. El valor 0 significa que no se permite un asociado de sincronización.
validate_subscriber_info	nvarchar(500)	Enumera las funciones que se están utilizando para recuperar información del suscriptor y validar los criterios de filtrado de filas con parámetros del suscriptor. Ayuda a comprobar que se hayan creado particiones de la información de manera coherente con cada combinación.
backward_comp_level	int	Nivel de compatibilidad de la base de datos, que puede ser uno de los que se especifican a continuación: 90 = SQL Server 2005 90 = SQL Server 2005 SP1 90 = SQL Server 2005 SP2 100 = SQL Server 2008
publish_to_activedirectory	bit	Especifica si la información de publicación se publica en Active Directory. El valor 0 significa que la información de publicación no está disponible en Active Directory. Este parámetro ha quedado desusado y solo se admite para la compatibilidad de scripts con versiones anteriores. Ya no es posible agregar información de publicación a Active Directory.
max_concurrent_merge	int	Número de procesos de combinación simultáneos. Si el valor es 0, no hay ningún límite en el número de procesos de combinación simultáneos que se ejecutan en un momento dado.
max_concurrent_dynamic_snapshots	int	Número máximo de sesiones de instantáneas de datos filtrados simultáneas que se pueden ejecutar con la publicación de combinación. Si el valor es 0, no hay ningún límite en el número máximo de sesiones de instantáneas de datos filtrados simultáneas que se pueden ejecutar al mismo tiempo que la publicación en un momento determinado.
use_partition_groups	int	Determina si se utilizan particiones precalculadas. El valor 1 significa que se utilizan particiones precalculadas.
num_of_articles	int	Número de artículos de la publicación.
replicate_ddl	int	Indica si se replican los cambios de esquema realizados en tablas publicadas. El valor 1 significa que se replican los cambios de esquema.
publication_number	smallint	Número asignado a esta publicación.
allow_subscriber_initiated_snapshot	bit	Determina si los suscriptores pueden iniciar el proceso de generación de instantáneas de datos filtrados. El valor 1 significa que los suscriptores pueden iniciar el proceso de generación de instantáneas.
allow_web_synchronization	bit	Determina si se habilita la publicación para sincronización web. El valor 1 significa que se habilita la sincronización web.
web_synchronization_url	nvarchar(500)	Dirección URL de Internet que se usa para la sincronización web.
allow_partition_realignment	bit	Determina si las eliminaciones se envían al suscriptor cuando la modificación de la fila en el publicador hace que se cambie su partición. El valor 1 significa que las eliminaciones se envían al suscriptor. Para obtener más información, vea sp_addmergepublication (Transact-SQL).
retention_period_unit	tinyint	Define la unidad que se utiliza al definir la retención. Puede ser uno de los siguientes valores: 0 = día 1 = semana 2 = mes 3 = año
has_downloadonly_articles	bit	Indica si alguno de los artículos pertenecientes a la publicación son artículos de solo descarga. El valor 1 indica que hay artículos de solo descarga.
decentralized_conflicts	int	Indica si los registros de los conflictos se almacenan en el suscriptor que provocó el conflicto. El valor 0 indica que los registros de los conflictos no se almacenan en el suscriptor. El valor 1 indica que los registros de los conflictos se almacenan en el suscriptor.
generation_leveling_threshold	int	Especifica el número de cambios contenidos en una generación. Una generación es un conjunto de cambios que se entregan a un publicador o a un suscriptor
automatic_reinitialization_policy	bit	Indica si se cargan los cambios desde el suscriptor antes de que se produzca una reinicialización automática. El valor 1 indica que los cambios se cargan desde el suscriptor antes de que se produzca una reinicialización automática. El valor 0 indica que los cambios no se cargan antes de una reinicialización automática.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_helpmergepublication se utiliza en la replicación de combinación.

Permisos

Los miembros de la lista de acceso a la publicación pueden ejecutar sp_helpmergepublication para esa publicación. Los miembros del rol fijo de base de datos db_owner en la base de datos de publicación pueden ejecutar sp_helpmergepublication para obtener información de todas las publicaciones.

Ejemplo

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';

USE [AdventureWorks2012]
EXEC sp_helpmergepublication @publication = @publication;
GO