sp_helpmergepublication (Transact-SQL)

Artigo
05/07/2013

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 da 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 de 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 da publicação. publication_id é uniqueidentifier e um parâmetro OUTPUT, com um padrão de 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 de NULL.
[@publisher_db**=** ] 'publisher_db'
O nome do banco de dados de publicação. publisher_db é sysname, com um padrão de NULL.

Conjuntos de resultados

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 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 mais informações sobre essas 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 inscrição de envio por push não é permitida.

allow_pull

int

Determina se podem ser criadas assinaturas pull para a publicação especificada. 0 significa que 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 = 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)

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 = Mesclagem.

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 do 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 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. Se for 0, a publicação não está habilitada para acessar a Internet.

dynamic_filter

int

Indica se um filtro de linha parametrizado é 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 não há nenhuma assinatura atualmente para esta publicação.

snapshot_in_default_folder

bit

Especifica se os arquivos de instantâneo são armazenados na pasta padrão.

Se for 1, os arquivos de instantâneo poderão ser encontrados na pasta padrão.

Se for 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 serem recuperados 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 Agente de Mesclagem 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 Agente de Mesclagem executa depois que todos os outros dados e scripts de objeto replicado 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 os arquivos de instantâneo de publicação estão localizados para serem retirados pelo Agente de Mesclagem.

ftp_port

int

É o número da porta do serviço FTP para o 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 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, as publicações de mesclagem usam partições pré-calculadas que fornecem um grau maior de otimização do que essa opção. Para obter mais informações, consulte Filtros de linha com parâmetros e Otimizar o desempenho de filtro parametrizado com partições pré-computadas.

allow_subscription_copy

int

Especifica se a capacidade de copiar os bancos de dados de assinatura que assinam essa publicação foi habilitada. Um valor 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 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

O nível de compatibilidade do banco de dados, podendo ser um dos seguintes:

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 para o Active Directory. Um valor 0 significa que as informações de publicação não estão disponíveis a partir do Active Directory.

Esse parâmetro foi preterido e tem suporte somente para a 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 for 0, não há nenhum limite para o número de processos de mesclagem simultâneos em execução em um determinado 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 há 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 partições pré-calculadas são utilizadas. Um valor 1 significa que são utilizadas partições pré-calculadas.

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 à 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 a sincronização da 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 as exclusões serã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 serã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 = dia

1 = semana

2 = mês

3 = ano

has_downloadonly_articles

bit

Indica se os artigos pertencentes à publicação são de somente download. Um valor 1 indica que há artigos de somente 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 contido em uma geração. Uma geração é uma coleção de alterações que é entregue 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 1 indica que as alterações são carregadas do Assinante antes da ocorrência de uma reinicialização automática. 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

Os membros da lista de acesso a uma publicação podem executar 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 executar sp_helpmergepublication para obter informações sobre todas as publicações.

Exemplo

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

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