sp_helppublication (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

Retorna informações sobre uma publicação. Para uma publicação do Microsoft SQL Server, esse procedimento armazenado é executado no Publicador no banco de dados de publicação. Para uma publicação Oracle, esse procedimento armazenado é executado no Distribuidor, em qualquer banco de dados.

Convenções de sintaxe de Transact-SQL

Sintaxe

  
sp_helppublication [ [ @publication = ] 'publication' ]  
    [ , [ @found=] found OUTPUT]  
    [ , [ @publisher = ] 'publisher' ]

Argumentos

[ @publication = ] 'publication' É o nome da publicação a ser exibida. publication é sysname, com um padrão de %, que retorna informações sobre todas as publicações.

[ @found = ] 'found' OUTPUT É um sinalizador para indicar o retorno de linhas. found é int e um parâmetro OUTPUT, com um padrão de 23456. 1 indica que a publicação foi encontrada. 0 indica que a publicação não foi encontrada.

[ @publisher = ] 'publisher'Especifica um editor não SQL Server. publisher é sysname, com um padrão de NULL.

Observação

O editor não deve ser especificado ao solicitar informações de publicação de um publicador de SQL Server.

Conjuntos de resultados

Nome da coluna Tipo de dados Descrição
pubid int ID da publicação.
name sysname Nome da publicação.
restricted int Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.
status tinyint O status atual da publicação.

0 = Inativo.

1 = Ativo.
task Usado para compatibilidade com versões anteriores.
frequência de replicação tinyint Tipo de frequência de replicação:

0 = Transacional

1 = Instantâneo
método de sincronização tinyint Modo de sincronização:

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

1 = Cópia em massa de caracteres

3 = Simultâneo, o que significa que a cópia em massa nativa (utilitário bcp) é usada, mas as tabelas não são bloqueadas durante o instantâneo

4 = Concurrent_c, o que significa que a cópia em massa de caracteres é usada, mas as tabelas não são bloqueadas durante o instantâneo
descrição nvarchar(255) Descrição opcional para a publicação.
immediate_sync bit Se os arquivos de sincronização serão criados ou recriados em cada execução do Agente de Instantâneo.
enabled_for_internet bit Se os arquivos de sincronização para a publicação são expostos na Internet pelo FTP (File Transfer Protocol) e outros serviços.
allow_push bit Se são permitidas assinaturas push na publicação.
allow_pull bit Se são permitidas assinaturas pull na publicação.
allow_anonymous bit Se são permitidas assinatura anônimas na publicação.
independent_agent bit Se há um Agente de Distribuição autônomo para essa publicação.
immediate_sync_ready bit Se o Agente de Instantâneo gerou um instantâneo que está pronto para ser usado por novas assinaturas. Esse parâmetro só será definido se a publicação estiver definida para ter sempre um instantâneo disponível para assinaturas novas ou reiniciadas.
allow_sync_tran bit Se são permitidas assinaturas de atualização imediata na publicação.
autogen_sync_procs bit Se procedimentos armazenados devem ser gerados automaticamente dar suporte a assinaturas de atualização imediata.
snapshot_jobid binary(16) ID de tarefa agendada.
retenção int A quantidade de alteração, em horas, a ser salva para a publicação determinada.
has subscription bit Se a publicação tem assinatura ativas. 1 significa que a publicação tem assinaturas ativas e 0 significa que a publicação não tem assinaturas.
allow_queued_tran bit Especifica se o serviço de enfileiramento de alterações no Assinante foi desabilitado até que possam ser aplicadas no Publicador. Se 0, as alterações no Assinante não serão enfileiradas.
snapshot_in_defaultfolder bit Especifica se arquivos de instantâneo são armazenados na pasta padrão. Se 0, instantâneo arquivos foram armazenados no local alternativo especificado por alternate_snapshot_folder. Se 1, instantâneo arquivos podem ser encontrados na pasta padrão.
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 local de arquivo .sql . O Agente de Distribuição executará o script pré-instantâneo antes de executar qualquer script de objeto replicado, ao aplicar um instantâneo no Assinante.
post_snapshot_script nvarchar(255) Especifica um ponteiro para um local de arquivo .sql . O Agente de Distribuição executará o script pós-instantâneo depois que todos os outros scripts de objeto replicado tentam sido aplicados durante uma sincronização inicial.
compress_snapshot bit Especifica que o instantâneo gravado no local alt_snapshot_folder deve ser compactado no formato cab da Microsoft. 0 especifica que o instantâneo não será compactado.
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 ficam localizados para serem captados pelo Agente de Distribuição ou por um Assinante.
ftp_port int O número da porta do serviço FTP do Distribuidor.
ftp_subdirectory nvarchar(255) Especifica onde os arquivos de instantâneo estarão disponíveis para serem retirados pelo Agente de Distribuição ou Agente de Mesclagem do Assinante se a publicação oferecer suporte à propagação de instantâneo usando o FTP.
ftp_login sysname O nome de usuário usado para se conectar ao serviço FTP.
allow_dts bit Especifica que a publicação permite transformações de dados. 0 especifica que as transformações de DTS não são permitidas.
allow_subscription_copy bit Especifica se a capacidade para copiar os bancos de dados de assinatura que assinam esta publicação foi habilitada. 0 significa que a cópia não é permitida.
centralized_conflicts bit Especifica se registros de conflito são ou não armazenados no Publicador:

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

1 = Os registros de conflito são armazenados no Publicador.
conflict_retention int Especifica o período de retenção de conflito, em dias.
conflict_policy int Especifica a política de resolução de conflito seguida quando a opção de assinante de atualização enfileirado é usada. Pode ser um destes valores:

1 = O Publicador vence o conflito.

2 = Assinante vence o conflito.

3 = A assinatura é reinicializada.
queue_type Especifica o tipo de fila usado. Pode ser um destes valores:

msmq = Use o Enfileiramento de Mensagens da Microsoft para armazenar transações.

sql = Use SQL Server para armazenar transações.

Observação: o suporte para Enfileiramento de Mensagens foi descontinuado.
backward_comp_level O nível de compatibilidade do banco de dados, podendo ser um dos seguintes:

90 = Microsoft SQL Server 2005 (9.x)

100 = Microsoft SQL Server 2008 (10.0.x)
publish_to_AD bit Especifica se a publicação é publicada no Microsoft Active Directory. Um valor de 1 indica que ele foi publicado e um valor igual a 0 indica que ele não foi publicado.
allow_initialize_from_backup bit Indica se os Assinantes podem iniciar uma assinatura para essa publicação de um backup em vez de um instantâneo inicial. 1 significa que as assinaturas podem ser inicializadas de um backup e 0 significa que elas não podem. Para obter mais informações, consulte Inicializar uma assinatura transacional sem um instantâneo de um Assinante transacional sem um instantâneo.
replicate_ddl int Indica se há suporte para replicação de esquema para a publicação. 1 indica que as instruções DDL (linguagem de definição de dados) executadas no publicador são replicadas e 0 indica que as instruções DDL não são replicadas. Para obter mais informações, consulte Make Schema Changes on Publication Databases (Fazer alterações de esquema em bancos de dados de publicação).
enabled_for_p2p int Se a publicação pode ser usada em uma topologia de replicação ponto a ponto. 1 indica que a publicação dá suporte à replicação ponto a ponto. Para obter mais informações, consulte Peer-to-Peer Transactional Replication.
publish_local_changes_only int Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.
enabled_for_het_sub int Especifica se a publicação dá suporte a Assinantes não SQL Server. Um valor de 1 significa que assinantes não SQL Server têm suporte. Um valor igual a 0 significa que apenas SQL Server Assinantes têm suporte. Para obter mais informações, consulte Non-SQL Server Subscribers.
enabled_for_p2p_conflictdetection int Especifica se o Agente de Distribuição detecta conflitos para uma publicação que está habilitada para replicação ponto a ponto. Um valor de 1 significa que os conflitos são detectados. Para obter mais informações, consulte Conflict Detection in Peer-to-Peer Replication.
originator_id int Especifica uma ID para um nó em uma topologia ponto a ponto. Essa ID será usada para detecção de conflitos se enabled_for_p2p_conflictdetection estiver definido como 1. Para uma lista de IDs que já foram usadas, consulte a tabela do sistema Mspeer_originatorid_history .
p2p_continue_onconflict int Especifica se o Agente de Distribuição deve continuar processando alterações quando um conflito é detectado. Um valor de 1 significa que o agente continua a processar alterações.

**Cuidado** Recomendamos que você use o valor padrão de 0. Quando essa opção é definida como 1, o Agente de Distribuição tenta convergir dados na topologia aplicando a linha conflitante do nó que tem a ID do originador mais alta. Esse método não garante convergência. Verifique se a topologia está consistente depois que um conflito é detectado. Para obter mais informações, consulte “Controlando conflitos” em Conflict Detection in Peer-to-Peer Replication.
allow_partition_switch int Especifica se ALTER TABLE... As instruções SWITCH podem ser executadas no banco de dados publicado. Para obter mais informações, consulte Replicar tabelas e índices particionados.
replicate_partition_switch int Especifica se ALTER TABLE... As instruções SWITCH executadas no banco de dados publicado devem ser replicadas para Assinantes. Essa opção será válida somente se allow_partition_switch estiver definido como 1.
enabled_for_p2p_lastwriter_conflictdetection int A partir do SQL Server 2019 (15.x) CU 13, especifica se o Agente de Distribuição detecta conflitos do último gravador para uma publicação habilitada para replicação ponto a ponto. Um valor de 1 significa que os últimos conflitos de gravador são detectados.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_helppublication é usado em replicação transacional e de instantâneo.

sp_helppublication retornará informações sobre todas as publicações do usuário que executa este procedimento.

Exemplo

DECLARE @myTranPub AS sysname
SET @myTranPub = N'AdvWorksProductTran' 

USE [AdventureWorks2022]
EXEC sp_helppublication @publication = @myTranPub
GO

Permissões

Somente membros da função de servidor fixa sysadmin no Publicador ou membros da função de banco de dados fixa db_owner no banco de dados de publicação ou usuários na PAL (lista de acesso à publicação) podem executar sp_helppublication.

Para um Publicador não SQL Server, somente membros da função de servidor fixa sysadmin no Distribuidor ou membros do db_owner função de banco de dados fixa no banco de dados de distribuição ou usuários no PAL podem executar sp_helppublication.

Consulte Também

Exibir e modificar as propriedades da publicação
sp_addpublication (Transact-SQL)
sp_changepublication (Transact-SQL)
sp_droppublication (Transact-SQL)
Procedimentos armazenados de replicação (Transact-SQL)