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 1 es , 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 0 es , 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 1 es , los archivos de instantánea se pueden encontrar en la carpeta predeterminada.Si 0 es , 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) SP190 = SQL Server 2005 (9.x) SP2100 = 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 0 es , 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 0 es , 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ía1 = semana2 = mes3 = 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