Compartilhar via


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ópicoConvençõ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çãoObservaçã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çãoObservaçã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