sp_helpmergepublication (Transact-SQL)

Se aplica a:SQL Server

Devuelve información sobre una publicación de combinació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_helpmergepublication
    [ [ @publication = ] N'publication' ]
    [ , [ @found = ] found OUTPUT ]
    [ , [ @publication_id = ] 'publication_id' OUTPUT ]
    [ , [ @reserved = ] N'reserved' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
[ ; ]

Argumentos

[ @publication = ] N'publication'

Nombre de la publicación. @publication es sysname, con un valor predeterminado de %, que devuelve información sobre todas las publicaciones de combinación de la base de datos actual.

[ @found = ] se encontró OUTPUT

Marca que indica las filas devueltas. @found es un parámetro OUTPUT de tipo int.

  • 1 indica que se encuentra la publicación.
  • 0 indica que no se encuentra la publicación.

[ @publication_id = ] SALIDA 'publication_id'

El número de identificación de la publicación. @publication_id es un parámetro OUTPUT de tipo uniqueidentifier.

[ @reserved = ] N'reserved'

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

[ @publisher = ] N'publisher'

El nombre del publicador. @publisher es sysname, con un valor predeterminado de NULL.

[ @publisher_db = ] N'publisher_db'

Nombre de la base de datos de publicación. @publisher_db es sysname, con un valor predeterminado de NULL.

Conjunto 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 significa que no se permite una suscripción de inserción.
allow_pull int Determina si es posible crear suscripciones de extracción para la publicación indicada. 0 significa que no se permite una suscripción de extracción.
allow_anonymous int Determina si es posible crear suscripciones anónimas para la publicación indicada. 0 significa que no se permite una suscripción anónima.
centralized_conflicts int Determina si los registros de los conflictos se almacenan en el publicador dado:

0 = los registros de conflictos se almacenan tanto en el publicador como en el suscriptor que provocó el conflicto.

1 = todos los registros de 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 su uso.

1 = La instantánea no está lista para su uso.
publication_type int Tipo de publicación:

0 = Instantánea.

1 = Transaccional.

2 = Combinar.
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ánea en la tabla del sistema sysjobs , debe convertir este valor hexadecimal en uniqueidentifier.
enabled_for_internet int Determina si la publicación está habilitada para Internet. Si 1es , los archivos de sincronización de la publicación se colocan en el C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp directorio . El usuario debe crear el directorio FTP (Protocolo de transferencia de archivos). Si 0es , la publicación no está habilitada para el acceso a Internet.
dynamic_filter int Indica si se usa un filtro de fila parametrizado. 0 significa que no se usa un filtro de fila con parámetros.
has_subscription bit Indica si la publicación tiene alguna suscripción. 0 significa que actualmente no hay suscripciones a esta publicación.
snapshot_in_default_folder bit Especifica si los archivos de instantánea se almacenan en la carpeta predeterminada.

Si 1es , los archivos de instantánea se pueden encontrar en la carpeta predeterminada.

Si 0es , 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 todavía tiene una ubicación en el alt_snapshot_folder parámetro . 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 se ejecuta antes de cualquiera de los scripts de objetos replicados al aplicar la instantánea en un suscriptor.
post_snapshot_script nvarchar(255) Especifica un puntero a un archivo .sql que el Agente de mezcla se ejecuta después de que se hayan aplicado todos los demás scripts y datos de objetos replicados durante una sincronización inicial.
compress_snapshot bit Especifica que la instantánea escrita en la alt_snapshot_folder ubicación se comprime en el formato CAB de Microsoft.
ftp_address sysname Dirección de red del servicio FTP para el distribuidor. Especifica dónde se encuentran los archivos de instantánea de publicación para que el Agente de mezcla recoger.
ftp_port int 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 Nombre de usuario usado para conectarse al 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. Un valor de 0 significa que la sincronización no está optimizada y las particiones enviadas a todos los suscriptores se comprueban cuando los datos cambian en una partición.

1 significa que la sincronización está optimizada y solo los suscriptores que tienen filas en la partición modificada se ven afectados.

Nota: De forma predeterminada, las publicaciones de mezcla usan particiones precalutadas, que proporcionan un mayor grado de optimización que esta opción. Para obtener más información, vea Filtros con parámetros: filtros de fila con parámetros y filtros con parámetros: optimización para particiones precaladas.
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. No se permite copiar un valor de 0 significa que no se permite la copia.
allow_synctoalternate int Especifica si se permite un asociado de sincronización alternativo para sincronizar con este publicador. Un valor de 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 la información se particiona de forma coherente con cada combinación.
backward_comp_level int El nivel de compatibilidad de la base de datos y puede ser uno de los siguientes valores:

90 = SQL Server 2005 (9.x)

90 = SQL Server 2005 (9.x) SP1

90 = SQL Server 2005 (9.x) SP2

100 = SQL Server 2008 (10.0.x)
publish_to_activedirectory bit Especifica si la información de publicación se publica en Active Directory. Un valor de significa que la información de 0 publicación no está disponible en Active Directory.

Este parámetro está en desuso y se mantiene para la compatibilidad con versiones anteriores de los scripts. 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 0es , no hay ningún límite para 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 0es , no hay ningún límite en el número máximo de sesiones simultáneas de instantáneas de datos filtradas que se pueden ejecutar simultáneamente en la publicación en un momento dado.
use_partition_groups int Determina si se utilizan particiones precalculadas. Un valor de 1 significa que se usan particiones precaladas.
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. Un valor de 1 significa que los cambios de esquema se replican.
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. Un valor de significa que los suscriptores pueden iniciar el proceso de 1 instantánea.
allow_web_synchronization bit Determina si se habilita la publicación para sincronización web. Un valor de 1 significa que la sincronización web está habilitada.
web_synchronization_url nvarchar(500) Dirección URL de Internet que se usa para la sincronización web.
allow_partition_realignment bit Determina si se envían eliminaciones al suscriptor cuando una modificación de la fila del publicador provoca que se modifique su partición. Un valor de 1 significa que las eliminaciones se envían al suscriptor. Para obtener más información, consulte 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. Un valor de 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. Un valor de 0 indica que los registros de conflictos no se almacenan en el suscriptor. Un valor de 1 indica que los registros de conflicto 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. Un valor de indica que los cambios se cargan desde el suscriptor antes de 1 que se produzca una reinicialización automática. Un valor de 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 (erróneo).

Comentarios

sp_helpmergepublication se usa en la replicación de mezcla.

Permisos

Los miembros de la lista de acceso a la publicación de una publicación pueden ejecutarse 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 ejecutarse sp_helpmergepublication para obtener información sobre todas las publicaciones.

Ejemplos

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

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