sp_helpmergepartition (Transact-SQL)
Applies to: SQL Server
Returns partition information for the specified merge publication. This stored procedure is executed at the Publisher on any database.
Transact-SQL syntax conventions
Syntax
sp_helpmergepartition
[ @publication = ] N'publication'
[ , [ @suser_sname = ] N'suser_sname' ]
[ , [ @host_name = ] N'host_name' ]
[ ; ]
Arguments
[ @publication = ] N'publication'
The name of the publication. @publication is sysname, with no default.
[ @suser_sname = ] N'suser_sname'
The SUSER_SNAME value used to define a partition. @suser_sname is sysname, with a default of NULL
. Supply this parameter to limit the result set to only partitions where SUSER_SNAME
resolves to the supplied value.
When @suser_sname is supplied, @host_name must be NULL
.
[ @host_name = ] N'host_name'
The HOST_NAME value used to define a partition. @host_name is sysname, with a default of NULL
. Supply this parameter to limit the result set to only partitions where HOST_NAME
resolves to the supplied value.
When @suser_sname is supplied, @host_name must be NULL
.
Result set
Column name | Data type | Description |
---|---|---|
partition |
int | Identifies the Subscriber partition. |
host_name |
sysname | Value used when creating the partition for a subscription that is filtered by the value of the HOST_NAME function at the Subscriber. |
suser_sname |
sysname | Value used when creating the partition for a subscription that is filtered by the value of the SUSER_SNAME function at the Subscriber. |
dynamic_snapshot_location |
nvarchar(255) | Location of the filtered data snapshot for the Subscriber's partition. |
date_refreshed |
datetime | Last date that the snapshot job was run to generate the filtered data snapshot for the partition. |
dynamic_snapshot_jobid |
uniqueidentifier | Identifies the job that creates the filtered data snapshot for a partition. |
Return code values
0
(success) or 1
(failure).
Remarks
sp_helpmergepartition
is used in merge replication.
Permissions
Only members of the sysadmin fixed server role and the db_owner fixed database role can execute sp_helpmergepartition
.