Artigo
04/01/2012

sp_helpmergepublication (Transact-SQL)

Retorna informações sobre uma publicação de mesclagem. Esse procedimento armazenado é executado no Publicador, no banco de dados de publicação.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

sp_helpmergepublication [ [ @publication = ] 'publication' ]
    [ , [ @found = ] 'found' OUTPUT ]
    [ , [ @publication_id = ] 'publication_id' OUTPUT ]
    [ , [ @reserved = ] 'reserved' ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @publisher_db = ] 'publisher_db' ]

Argumentos

[ @publication = ] 'publication'
O nome da publicação. publication é sysname, com um padrão %, que retorna informações sobre todas as publicações de mesclagem no banco de dados atual.
[ @found = ] 'found' OUTPUT
Um sinalizador para indicar linhas de retorno. found é int e um parâmetro OUTPUT, com um padrão de NULL. 1 indica que a publicação foi localizada. 0 indica que a publicação não foi localizada.
[ @publication_id**=**\] **'**publication_id' OUTPUT
É o número de identificação de publicação. publication_id é uniqueidentifier e um parâmetro OUTPUT, com um padrão NULL.
[ @reserved**=**\] 'reserved'
Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida. reserved é nvarchar(20), com um padrão NULL.
[ @publisher**=** ] 'publisher'
O nome do Publicador. publisher é sysname, com um padrão NULL.
[@publisher_db = ] 'publisher_db'
O nome do banco de dados de publicação. publisher_db é sysname, com um padrão NULL.

Conjuntos 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	O nome da publicação.
description	nvarchar(255)	A descrição da publicação.
status	tinyint	Indica quando os dados da publicação estarão disponíveis.
retenção	int	O tempo para salvar metadados sobre alterações a 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 desta 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 assinaturas push podem ser criadas para a uma determinada publicação. 0 significa que uma assinatura push não é permitida.
allow_pull	int	Determina se assinaturas pull podem ser criadas para uma determinada publicação. 0 significa que uma assinatura pull não é permitida.
allow_anonymous	int	Determina se assinaturas anônimas podem ser criadas para uma determinada publicação. 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 = 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	float(8)	Prioridade da assinatura de autorretorno.
snapshot_ready	tinyint	Indica se o instantâneo desta 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 = Mesclagem.
pubid	uniqueidentifier	Identificador exclusivo desta publicação.
snapshot_jobid	binary(16)	ID de trabalho do Snapshot Agent. Para obter a entrada para o trabalho de instantâneo na tabela do sistema sysjobs é necessário converter esse valor hexadecimal em uniqueidentifier.
enabled_for_internet	int	Determina se a publicação está habilitada para a Internet. Se for 1, os arquivos de sincronização para a publicação serão colocados no diretório C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp. O usuário deve criar o diretório de FTP (File Transfer Protocol). Se for 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 qualquer assinatura. 0 significa que, atualmente, não há nenhuma assinatura para esta publicação.
snapshot_in_default_folder	bit	Especifica se arquivos de instantâneo são armazenados na pasta padrão. Se for 1, arquivos de instantâneo poderão ser encontrados na pasta padrão. Se 0, arquivos de instantâneo serão armazenados no local alternativo, especificado por alt_snapshot_folder. Locais alternativos podem ser em outro servidor, em uma unidade de rede, ou uma mídia removível (como um CD-ROM ou disco removível). Você também pode salvar os arquivos de instantâneo em um site de FTP para ser recuperado pelo Assinante posteriormente. Observação Esse parâmetro pode ser verdadeiro e ainda assim ter um local no parâmetro alt_snapshot_folder. 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 script de objeto replicado 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 de objeto replicado e dados foram aplicados, durante uma sincronização inicial.
compress_snapshot	bit	Especifica que o instantâneo gravado no local alt_snapshot_folder está compactado no formato CAB da Microsoft.
ftp_address	sysname	É o endereço de rede do serviço FTP para o Distribuidor. Especifica onde arquivos de instantâneo de publicação ficam localizados para serem retirados pelo Merge Agent.
ftp_port	int	É o número da porta de serviço de FTP para o Distribuidor. ftp_port tem um padrão 21. Especifica onde os arquivos de instantâneo de publicação ficam localizados para serem retirados pelo Merge Agent.
ftp_subdirectory	nvarchar(255)	Especifica onde os arquivos de instantâneo de publicação ficam disponíveis para serem retirados pelo Merge Agent quando o instantâneo é entregue usando o 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 para o qual os conflitos são retidos. Quando o número especificado de dias passa, a linha de conflito é limpa da tabela de conflitos.
keep_partition_changes	int	Especifica se a otimização da sincronização está ocorrendo para esta publicação. keep_partition_changes tem um padrão de 0. Um valor 0 significa que a sincronização não é 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 é otimizada e somente Assinantes com linhas nas partições alteradas são afetados. Observação Por padrão, 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 Filtro de linha com parâmetros e Otimizando o desempenho de filtro com parâmetros com 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 0 não é permitido.
allow_synctoalternate	int	Especifica se um parceiro de sincronização alternativo tem permissão para sincronizar com este Publicador. Um valor 0 significa que um parceiro de 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 estão consistentemente particionadas com cada mesclagem.
backward_comp_level	int	Nível de compatibilidade do banco de dados e pode ser um dos seguintes: 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 se as informações de publicação são publicadas no Active Directory. Um valor 0 significa que as informações de publicação não estão disponíveis do Active Directory. Esse parâmetro foi preterido e tem suporte somente para compatibilidade com versões anteriores. 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 for 0, não há nenhum limite para o número de processos de mesclagem simultâneos que executam 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 for 0, não haverá limite para o número máximo de sessões de instantâneo de dados filtrados simultâneas que podem ser executadas simultaneamente na publicação, a qualquer momento.
use_partition_groups	int	Determina se são usadas partições pré-computadas. Um valor 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 1 significa que alterações de esquema são replicadas.
publication_number	smallint	Número atribuído a esta 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 1 significa que os Assinantes podem iniciar o processo de instantâneo.
allow_web_synchronization	bit	Determina se a publicação está habilitada para sincronização da Web. Um valor 1 significa que sincronização da Web está habilitada.
web_synchronization_url	nvarchar(500)	URL da Internet usada para sincronização da Web.
allow_partition_realignment	bit	Determina se as exclusões são enviadas ao assinante quando a modificação da linha no publicador gerar uma alteração na partição. Um valor 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 que é usada ao definir retenção. Este valor pode ser um dos seguintes: 0 = dia 1 = semana 2 = mês 3 = ano
has_downloadonly_articles	bit	Indica se qualquer artigo que pertence à publicação é artigo somente download. Um valor 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 0 indica que os registros de conflito não são armazenados no Assinante. Um valor 1 indica que os registros de 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 é entregue a um Publicador ou Assinante. Para obter mais informações, consulte Como a replicação de mesclagem rastreia e enumera alterações.
automatic_reinitialization_policy	bit	Indica se as alterações são carregadas do Assinante antes que uma reinicialização automática ocorra. Um valor 1 indica que as alterações são carregadas do Assinante antes que uma reinicialização automática ocorra. Um valor 0 indica que as alterações não são carregadas antes de uma reinicialização automática.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_helpmergepublication é usado em replicação de mesclagem.

Permissões

Membros da lista de acesso à publicação de uma publicação podem executar sp_helpmergepublication para aquela publicação. Membros da função de banco de dados fixa db_owner no banco de dados de publicação podem executar sp_helpmergepublication para obter informações sobre todas as publicações.

Exemplo

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

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