Compartir a través de


sp_helpmergepublication (Transact-SQL)

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.

Icono de vínculo a temasConvenciones 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 combinación de la base de datos actual.

  • [ @found = ] 'found' OUTPUT
    Marca para indicar las filas que se devuelven. found es de tipo int, es un parámetro OUTPUT y su valor predeterminado es 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
    Número de identificación de la publicación. publication_id es de tipo uniqueidentifier, es un parámetro OUTPUT y su valor predeterminado es 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'
    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 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 se pueden crear suscripciones de inserción para la publicación determinada. 0 significa que no se permite una suscripción de inserción.

allow_pull

int

Determina si se pueden crear suscripciones de extracción para la publicación determinada. 0 significa que no se permite una suscripción de extracción.

allow_anonymous

int

Determina si se pueden crear suscripciones anónimas para la publicación determinada. 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 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)

Id. 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 utiliza un filtro de fila con parámetros. 0 significa que no se utiliza un filtro de este tipo.

has_subscription

bit

Indica si la publicación tiene alguna suscripción. 0 significa que no hay ninguna suscripción a esta publicación en este momento.

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.

NotaNota
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 del distribuidor. ftp_port tiene el valor predeterminado 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. El valor predeterminado de keep_partition_changes es 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.

NotaNota
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 precalculadas.

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 de este suscriptor. Ayuda a comprobar que se hayan creado particiones de la información de manera coherente con cada mezcla.

backward_comp_level

int

Nivel de compatibilidad de la base de datos, que puede ser uno de los que se especifican a continuación:

10 = SQL Server 7.0

20 = SQL Server 7.0 SP1

30 = SQL Server 7.0 SP2

30 = SQL Server 7.0 SP3

30 = SQL Server 7.0 SP4

40 = SQL Server 2000

40 = SQL Server 2000 SP1

40 = SQL Server 2000 SP2

40 = SQL Server 2000 SP3

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 obsoleto 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. Para obtener más información, vea Cómo se realiza el seguimiento y la enumeración de los cambios en la réplica de mezcla.

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 mezcla.

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 publicaciones pueden ejecutar sp_helpmergepublication para obtener información de todas las publicaciones.

Ejemplo

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

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