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.
.gif "Icono de vínculo a temas")
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
Marcador 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'
Solo 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. .gif "Nota") 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 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 sólo 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 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 sólo se admite para la compatibilidad de las secuencias de comandos 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 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)
Notas
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 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.
Ejemplo
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
USE [AdventureWorks]
EXEC sp_helpmergepublication @publication = @publication;
GO
Vea también