Partilhar via

sp_helpmergepublication (Transact-SQL)

Aplica-se a:SQL Server

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

Transact-SQL convenções de sintaxe

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 OUTPUT

Um sinalizador para indicar linhas que retornam. @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 suportado. A compatibilidade futura não é garantida.

[ @publisher = ] N'editora'

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 no set list de resultados.
name sysname Nome da publicação.
description Nvarchar(255) Descrição da publicação.
status tinyint Indica quando os dados de publicação estão disponíveis.
retention Int Quantidade de tempo para salvar metadados sobre alterações para artigos na publicação. As unidades para este 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 Modo de sincronização desta publicação:

0 = Programa nativo de cópia em massa (utilitário bcp )

1 = Cópia em massa de caracteres
allow_push Int Determina se as assinaturas push podem ser criadas para determinada publicação. 0 significa que uma subscrição push não é permitida.
allow_pull Int Determina se as assinaturas pull podem ser criadas para determinada publicação. 0 significa que uma subscrição pull não é permitida.
allow_anonymous Int Determina se podem ser criadas subscrições anónimas para uma determinada publicação. 0 significa que uma subscrição anónima não é permitida.
centralized_conflicts Int Determina se os registros de conflito são armazenados no editor determinado:

0 = Os registros de conflito são armazenados no editor e no assinante que causou o conflito.

1 = todos os registros de conflito são armazenados no Editor.
priority flutuador(8) Prioridade da assinatura de loop-back.
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 Tipo de publicação:

0 = Instantâneo.

1 = Transacional.

2 = Mesclar.
pubid identificador único Identificador único desta publicação.
snapshot_jobid binário(16) ID do trabalho do Snapshot Agent. 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 para a publicação são colocados no C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp diretório. O usuário deve criar o diretório FTP (File Transfer Protocol). Se 0o , a publicação não estiver habilitada para acesso à 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 assinaturas. 0 significa que não existem atualmente subscrições desta 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 forem armazenados no local alternativo especificado pelo 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 FTP, para recuperação pelo Assinante posteriormente.

Observação: Este parâmetro pode ser verdadeiro e ainda ter uma localização no alt_snapshot_folder parâmetro. Essa combinação especifica que os arquivos de instantâneo sã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 de .sql que o Merge Agent executa antes de qualquer um dos scripts de objeto replicado ao aplicar o instantâneo em um Assinante.
post_snapshot_script Nvarchar(255) Especifica um ponteiro para um arquivo de .sql que o Merge Agent executa depois que todos os outros scripts de objeto replicados e dados foram aplicados durante uma sincronização inicial.
compress_snapshot bit Especifica que o instantâneo gravado no alt_snapshot_folder local é compactado no formato Microsoft CAB.
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 pegar.
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 o Merge Agent pegar.
ftp_subdirectory Nvarchar(255) Especifica onde os arquivos de instantâneo estão disponíveis para o Merge Agent pegar quando o snapshot é entregue usando 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 mantidos. Após o número especificado de dias, a linha de conflito é removida 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 de significa que a sincronização não está otimizada e as partições enviadas a todos os Subscritores são verificadas 0 quando os dados são alterados numa partição.

1 significa que a sincronização é otimizada e apenas os Subscritores com linhas na partição alterada 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 parametrizados - Filtros de linha parametrizados e Filtros parametrizados - Otimizar para partições pré-calculadas.
allow_subscription_copy Int Especifica se a capacidade de copiar os bancos de dados de assinatura que assinam esta publicação foi habilitada. Não é permitida a cópia de um valor de 0 meios.
allow_synctoalternate Int Especifica se um parceiro de sincronização alternativo tem permissão para sincronizar com este Editor. 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 parametrizada 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 no Ative Directory. Um valor significa que as informações de 0 publicação não estão disponíveis no Ative Directory.

Este parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts. Não é mais possível adicionar informações de publicação ao Ative 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 em um determinado momento.
max_concurrent_dynamic_snapshots Int O número máximo de sessões simultâneas de instantâneo de dados filtrados que podem ser executadas na publicação de mesclagem. Se 0o , não houver 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é-computadas são usadas. Um valor de 1 significa que partições pré-calculadas são usadas.
num_of_articles Int Número de artigos na publicação.
replicate_ddl Int Se as alterações de esquema nas tabelas publicadas forem replicadas. Um valor de significa que as alterações de 1 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 de significa que os assinantes podem iniciar o processo de 1 snapshot.
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 Web está habilitada 1 .
web_synchronization_url Nvarchar(500) URL da Internet que é 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 editor faz com que ele altere 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.
retention_period_unit tinyint Define a unidade que é usada ao definir retenção. Este pode ser um dos seguintes valores:

0 = dia

1 = semana

2 = mês

3 = ano
has_downloadonly_articles bit Indica se quaisquer artigos que pertencem à publicação são artigos somente para download. Um valor de indica que há artigos somente 1 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 Editor ou Assinante
automatic_reinitialization_policy bit Indica se as alterações são carregadas do Assinante antes que ocorra uma reinicialização automática. Um valor de indica que as alterações são carregadas do Assinante antes que 1 ocorra 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 (sucesso) ou 1 (fracasso).

Observações

sp_helpmergepublication é usado na replicação de mesclagem.

Permissões

Os membros da lista de acesso à publicação de uma publicação podem executar sp_helpmergepublication 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

  • Last updated on