sp_helpmergepublication (Transact-SQL)

  • Artigo

Aplica-se: 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.

  • 1 indica que a publicação foi encontrada.
  • 0 indica 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 estar em outro servidor, em uma unidade de rede ou em uma mídia removível (como discos removíveis). Você também pode salvar os arquivos de instantâneo em um site de FTP para ser recuperado pelo Assinante posteriormente

Nota: 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) SP1

90 = SQL Server 2005 (9.x) SP2

100 = 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 = 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 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

Conteúdo relacionado