sp_helpmergepublication (Transact-SQL)
Aplica-se a: 
SQL Server
Retorna informações sobre uma publicação de mesclagem. Esse procedimento armazenado é executado no Publicador, no banco de dados publicador.
Convenções de sintaxe de Transact-SQL
Sintaxe
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'publicação'
O nome da publicação. @publication é sysname, com um padrão de , que retorna informações sobre todas as publicações de mesclagem no banco de %dados atual.
@found [ = ] encontrado SAÍDA
Um sinalizador para indicar linhas de retorno. @found é um parâmetro OUTPUT do tipo int.
1indica que a publicação foi encontrada.0indica que a publicação não foi encontrada.
@publication_id [ = ] SAÍDA 'publication_id'
O número de identificação da publicação. @publication_id é um parâmetro OUTPUT do tipo uniqueidentifier.
@reserved [ = ] N'reservado'
Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.
@publisher [ = ] N'editor'
O nome do Editor. @publisher é sysname, com um padrão de NULL.
@publisher_db [ = ] N'publisher_db'
O nome do banco de dados de publicação. @publisher_db é sysname, com um padrão de NULL.
Conjunto de resultados
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
id |
int | Ordem sequencial da publicação na lista de conjunto de resultados. |
name |
sysname | Nome da publicação. |
description |
nvarchar(255) | Descrição da publicação. |
status |
tinyint | Indica quando os dados da publicação estão disponíveis. |
retention |
int | O tempo para salvar metadados sobre alterações para artigos na publicação. As unidades desse período de tempo podem ser dias, semanas, meses ou anos. Para obter informações sobre unidades, consulte a coluna retention_period_unit. |
sync_mode |
tinyint | O modo de sincronização dessa publicação:0 = Programa de cópia em massa nativo (utilitário bcp )1 = Cópia em massa de caracteres |
allow_push |
int | Determina se podem ser criadas assinaturas push para a publicação especificada. 0 significa que uma assinatura push não é permitida. |
allow_pull |
int | Determina se podem ser criadas assinaturas pull para a publicação especificada. 0 significa que uma assinatura pull não é permitida. |
allow_anonymous |
int | Determina se podem ser criadas assinaturas anônimas para a publicação determinada. 0 significa que uma assinatura anônima não é permitida. |
centralized_conflicts |
int | Determina se registros de conflito são armazenados no Publicador determinado:0 = Os registros de conflito são armazenados no publicador e no assinante que causou o conflito.1 = todos os registros de conflito são armazenados no Publicador. |
priority |
flutuador(8) | A prioridade da assinatura de loopback. |
snapshot_ready |
tinyint | Indica se o instantâneo da publicação está pronto:0 = O instantâneo está pronto para uso.1 = O instantâneo não está pronto para uso. |
publication_type |
int | O tipo de publicação:0 = Instantâneo.1 = Transacional.2 = Mesclar. |
pubid |
uniqueidentifier | O identificador exclusivo da publicação. |
snapshot_jobid |
binary(16) | A ID de trabalho do Agente de Instantâneo. Para obter a entrada para o trabalho de instantâneo na tabela do sistema sysjobs , você deve converter esse valor hexadecimal em uniqueidentifier. |
enabled_for_internet |
int | Determina se a publicação está habilitada para a Internet. Se 1, os arquivos de sincronização da publicação serão colocados no C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp diretório. O usuário deve criar o diretório de FTP. Se 0, a publicação não está habilitada para acesso à Internet. |
dynamic_filter |
int | Indica se um filtro de linha com parâmetros é usado. 0 significa que um filtro de linha parametrizado não é usado. |
has_subscription |
bit | Indica se a publicação tem alguma assinatura. 0 significa que atualmente não há assinaturas para esta publicação. |
snapshot_in_default_folder |
bit | Especifica se os arquivos de instantâneo são armazenados na pasta padrão. Se 1, os arquivos de instantâneo podem ser encontrados na pasta padrão.Se 0, os arquivos de instantâneo serão armazenados no local alternativo especificado por alt_snapshot_folder. Os locais alternativos podem ser um outro servidor, uma unidade de rede ou uma mídia removível (como um CD-ROM ou discos removíveis). Você também pode salvar os arquivos de instantâneo em um site de FTP para ser recuperado pelo Assinante posteriormenteNota: Este parâmetro pode ser verdadeiro e ainda ter um local no alt_snapshot_folder parâmetro. Essa combinação especifica que os arquivos de instantâneo serão armazenados nos locais padrão e alternativo. |
alt_snapshot_folder |
nvarchar(255) | Especifica o local da pasta alternativa para o instantâneo. |
pre_snapshot_script |
nvarchar(255) | Especifica um ponteiro para um arquivo .sql que o Merge Agent executa antes de qualquer um dos scripts de objeto replicados ao aplicar o instantâneo em um Assinante. |
post_snapshot_script |
nvarchar(255) | Especifica um ponteiro para um arquivo .sql que o Merge Agent executa depois que todos os outros scripts e dados de objeto replicados foram aplicados durante uma sincronização inicial. |
compress_snapshot |
bit | Especifica que o instantâneo gravado no alt_snapshot_folder local é compactado no formato CAB da Microsoft. |
ftp_address |
sysname | O endereço de rede do serviço FTP para o Distribuidor. Especifica onde os arquivos de instantâneo de publicação estão localizados para o Merge Agent selecionar. |
ftp_port |
int | O número da porta do serviço FTP do Distribuidor. ftp_port tem um padrão de 21. Especifica onde os arquivos de instantâneo de publicação estão localizados para serem retirados pelo Agente de Mesclagem. |
ftp_subdirectory |
nvarchar(255) | Especifica onde os arquivos de instantâneo de publicação estão disponíveis para serem retirados pelo Agente de Mesclagem quando o instantâneo é entregue por meio do FTP. |
ftp_login |
sysname | O nome de usuário usado para se conectar ao serviço FTP. |
conflict_retention |
int | Especifica o período de retenção, em dias, durante o qual os conflitos são retidos. Quando o número de dias especificado for ultrapassado, a linha de conflito será limpa na tabela de conflitos. |
keep_partition_changes |
int | Especifica se otimização de sincronização está ocorrendo para esta publicação. keep_partition_changes tem um padrão de 0. Um valor de 0 significa que a sincronização não está otimizada e as partições enviadas a todos os Assinantes são verificadas quando os dados são alterados em uma partição.1 significa que a sincronização está otimizada e apenas os Assinantes com linhas na partição alterada são afetados.Observação: Por padrão, as publicações de mesclagem usam partições pré-computadas, que fornecem um grau maior de otimização do que essa opção. Para obter mais informações, consulte Filtros com parâmetros - Filtros de linha com parâmetros e Filtros com parâmetros - Otimizar para partições pré-computadas. |
allow_subscription_copy |
int | Especifica se a capacidade para copiar os bancos de dados de assinatura que assinam esta publicação foi habilitada. Um valor de 0 significa que a cópia não é permitida. |
allow_synctoalternate |
int | Especifica se um parceiro de sincronização alternativo tem permissão para sincronizar com esse Publicador. Um valor de significa que um parceiro de 0 sincronização não é permitido. |
validate_subscriber_info |
nvarchar(500) | Lista as funções que estão sendo usadas para recuperar informações do Assinante e validar os critérios de filtragem de linha com parâmetros no Assinante. Ajuda a verificar se as informações são particionadas de forma consistente com cada mesclagem. |
backward_comp_level |
int | Nível de compatibilidade do banco de dados e pode ser um dos seguintes 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 se as informações de publicação são publicadas para o Active Directory. Um valor de significa que as informações da 0 publicação não estão disponíveis no Active Directory.Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. Você não pode mais adicionar informações de publicação no Active Directory. |
max_concurrent_merge |
int | O número de processos de mesclagem simultâneos. Se 0, não há limite para o número de processos de mesclagem simultâneos em execução a qualquer momento. |
max_concurrent_dynamic_snapshots |
int | O número máximo de sessões de instantâneo de dados filtrados simultâneas que pode ser executado na publicação de mesclagem. Se 0, não há limite para o número máximo de sessões simultâneas de instantâneo de dados filtrados que podem ser executadas simultaneamente na publicação a qualquer momento. |
use_partition_groups |
int | Determina se partições pré-calculadas são utilizadas. Um valor de 1 significa que partições pré-computadas são usadas. |
num_of_articles |
int | Número de artigos na publicação. |
replicate_ddl |
int | Se as alterações de esquema de tabelas publicadas são replicadas. Um valor de significa que as alterações de 1 esquema são replicadas. |
publication_number |
smallint | Número atribuído à publicação. |
allow_subscriber_initiated_snapshot |
bit | Determina se os Assinantes podem iniciar o processo de geração de instantâneo de dados filtrados. Um valor de significa que os Assinantes podem iniciar o processo de 1 instantâneo. |
allow_web_synchronization |
bit | Determina se a publicação está habilitada para sincronização da Web. Um valor de significa que a sincronização da 1 Web está habilitada. |
web_synchronization_url |
nvarchar(500) | A URL da Internet usada para a sincronização da Web. |
allow_partition_realignment |
bit | Determina se exclusões serão enviadas para o Assinante quando modificação da linha no Publicador causar a mudança de sua partição. Um valor de 1 significa que as exclusões são enviadas ao Assinante. Para obter mais informações, consulte sp_addmergepublication (Transact-SQL). |
retention_period_unit |
tinyint | Define a unidade usada ao definir a retenção. Esse valor pode ser um dos seguintes:0 = dia1 = semana2 = mês3 = ano |
has_downloadonly_articles |
bit | Indica se os artigos pertencentes à publicação são de somente download. Um valor de 1 indica que há artigos somente para download. |
decentralized_conflicts |
int | Indica se os registros de conflito são armazenados no Assinante que causou o conflito. Um valor de indica que os registros de 0 conflito não são armazenados no Assinante. Um valor de indica que os registros de 1 conflito são armazenados no Assinante. |
generation_leveling_threshold |
int | Especifica o número de alterações contidas em uma geração. Uma geração é uma coleção de alterações que são entregues a um Publicador ou Assinante |
automatic_reinitialization_policy |
bit | Indica se as alterações são carregadas do Assinante antes da ocorrência de uma reinicialização automática. Um valor de 1 indica que as alterações são carregadas do Assinante antes que ocorra uma reinicialização automática. Um valor de 0 indica que as alterações não são carregadas antes de uma reinicialização automática. |
Valores do código de retorno
0 (sucesso) ou 1 (falha).
Comentários
sp_helpmergepublication é usado na replicação de mesclagem.
Permissões
Os membros da lista de acesso à publicação de uma publicação podem ser executados sp_helpmergepublication para essa publicação. Os membros da função de banco de dados fixa db_owner no banco de dados de publicação podem ser executados sp_helpmergepublication para obter informações sobre todas as publicações.
Exemplos
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
USE [AdventureWorks2022]
EXEC sp_helpmergepublication @publication = @publication;
GO