sp_helpmergepublication (Transact-SQL)

Actualizado: 12 de diciembre de 2006

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

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'
  Es el 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
  Es un indicador que especifica que se devuelven filas. found es de tipo int, es un parámetro OUTPUT y su valor predeterminado es NULL. 1 indica que se ha encontrado la publicación. 0 indica que no se ha encontrado la publicación.

• [ @publication_id=] 'publication_id' OUTPUT
  Es el 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'
  Se reserva para usos posteriores. reserved es de tipo nvarchar(20) y su valor predeterminado es NULL.

• [ @publisher = ] 'publisher'
  Es el nombre del publicador. publisher es de tipo sysname y su valor predeterminado es NULL.

• [@publisher_db = ] 'publisher_db'
  Es el nombre de la base de datos de publicaciones. 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

Volumen de cambio, en días, que se debe guardar para la publicación indicada.

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

Indica si se pueden 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

Indica si se pueden 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

Indica si se pueden crear suscripciones anónimas para la publicación indicada. 0 significa que no se permite una suscripción anónima.

centralized_conflicts

int

Indica si los registros de los conflictos se almacenan en el publicador indicado.

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

1 = todos los registros de conflictos se almacenan en el publicador.

priority

float(8)

Prioridad de la suscripción en bucle cerrado.

snapshot_ready

tinyint

Indica si está lista la instantánea de esta publicación:

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 = Mezcla

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 esta valor hexadecimal a uniqueidentifier.

enabled_for_internet

int

Indica si la publicación está habilitada para Internet. Si 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 es 0, la publicación no está habilitada para el acceso a Internet.

dynamic_filter

int

Indica si se utiliza un filtro de filas con parámetros. 0 significa que no se utiliza un filtro de filas 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 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 almacenarán 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 ejecuta el Agente de mezcla antes de las secuencias de comandos 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 ejecutará el Agente de mezcla una vez que se hayan aplicado todos los demás datos y secuencias de comandos 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 Microsoft CAB.

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. El valor predeterminado de ftp_port es 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.

0 significa que la sincronización no se optimiza; las particiones enviadas a todos los suscriptores se comprueban cuando se modifican los datos de una partición.

1 significa que se ha optimizado la sincronización y sólo se han visto afectados los suscriptores con filas en la partición que ha cambiado.

Nota:

De manera predeterminada, las publicaciones de mezcla 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. 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. 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 siguientes:

10 = Microsoft SQL Server 7.0

20 = Service Pack 1 de SQL Server 7.0

30 = Service Pack 2 de SQL Server 7.0

35 = Service Pack 3 de SQL Server 7.0

40 = Microsoft SQL Server 2000

50 = Service Pack 1 de SQL Server 2000

60 = Service Pack 3 de SQL Server 2000

90 = Microsoft SQL Server 2005

publish_to_activedirectory

bit

Especifica si la información de publicación se publica en Microsoft Active Directory. 0 significa que la información de la publicación no está disponible en Active Directory.

Este parámetro ya no se utiliza y sólo se admite para la compatibilidad de las secuencias de comandos con versiones anteriores. Ya no se puede agregar información de publicación a Microsoft Active Directory.

max_concurrent_merge

int

Número de procesos de mezcla simultáneos. El valor 0 de esta propiedad significa que no hay límite en el número de procesos de mezcla simultáneos que se ejecutan en un momento determinado.

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 mezcla. Si el valor es 0, no hay límite para el número máximo de sesiones de instantáneas de datos filtrados simultáneas que se pueden ejecutar al mismo tiempo con la publicación en un momento determinado.

use_partition_groups

int

Indica si se utilizan particiones previamente calculadas. 1 significa que se utilizan particiones previamente calculadas.

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. 1 significa que se replican los cambios de esquema.

publication_number

smallint

Número asignado a esta publicación.

allow_subscriber_initiated_snapshot

bit

Indica si los suscriptores pueden iniciar el proceso de generación de instantáneas de datos filtrados. 1 significa que los suscriptores pueden iniciar el proceso de generación de instantáneas.

allow_web_synchronization

bit

Indica si se habilita la publicación para sincronización Web. 1 significa que se habilita la sincronización Web.

web_synchronization_url

nvarchar(500)

Dirección URL de Internet utilizada para sincronización Web.

allow_partition_realignment

bit

Indica si se envían las eliminaciones al suscriptor cuando la modificación de la fila en el publicador hace que ésta cambie la partición.

1 significa que se envían las eliminaciones al suscriptor.

0 significa que no se envían las eliminaciones. Para obtener más información, vea sp_addmergepublication (Transact-SQL)

retention_period_unit

tinyint

Define la unidad utilizada en la definición de la retención, con los siguientes valores posibles:

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 sólo descarga. El valor 1 indica que son artículos de sólo descarga.

decentralized_conflicts

int

Indica si se almacenan los registros de conflictos en el suscriptor que causó el conflicto:

0 = Los registros de conflictos no se almacenan en el suscriptor.

1 = Los registros de 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 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.

1 = se cargan los cambios desde el suscriptor antes de que se produzca una reinicialización automática.

0 = no se cargan los cambios antes de que se produzca una reinicialización automática.

Notas

sp_helpmergepublication se utiliza en la réplica de mezcla.

Permisos

Los miembros de la lista de acceso a la nueva publicación pueden ejecutar sp_helpmergepublication para esa publicación. Los miembros de la función fija 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.

Valores de código de retorno

0 (correcto) o 1 (error)

Ejemplo

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

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

Vea también

Referencia

sp_addmergepublication (Transact-SQL)
sp_changemergepublication (Transact-SQL)
sp_dropmergepublication (Transact-SQL)
Procedimientos almacenados de réplica (Transact-SQL)

Otros recursos

How to: View and Modify Publication Properties (Replication Transact-SQL Programming)

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión	Historial
12 de diciembre de 2006	Contenido nuevo: Se agregó información acerca de la columna generation_leveling_threshold.