sp_helppublication (Transact-SQL)

Artigo
05/07/2013

Retorna informações sobre uma publicação. Para uma publicação 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.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

[ @publication = ] 'publication'
É o nome da publicação a ser exibida. publication is sysname, com um padrão de %, que retorna informações sobre todas as publicações.
[ @found = ] 'found' OUTPUT
É um sinalizador para indicar linhas de retorno. foundé int e um parâmetro de OUTPUT, com um padrão de 23456. 1 indica que a publicação foi localizada. 0 indica que a publicação não foi localizada.
[ @publisher = ] 'publisher'
Especifica um publicador que não é do SQL Server. publisher é sysname, com um padrão de NULL.

Observação

publisher não deve ser especificado ao pedir informações de publicação de um Publicador do SQL Server.

Observação
publisher não deve ser especificado ao pedir informações de publicação de um Publicador do SQL Server.

Conjuntos de resultados

pubid

int

ID da publicação.

name

sysname

O nome da publicação.

restricted

int

Identificado apenas para fins informativos. Sem 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.

replication frequency

tinyint

Tipo de frequência de replicação:

0 = Transacional

1 = Instantâneo

synchronization method

tinyint

Modo de sincronização:

0 = Programa de cópia em massa (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

description

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.

retention

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 for 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 for 0, arquivos de instantâneo foram armazenados no local alternativo especificado por alternate_snapshot_folder. Se for 1 1, arquivos de instantâneo poderão ser localizados 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 transformações 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 não é permitido copiar.

centralized_conflicts

bit

Especifica se registros de conflito são ou não armazenados no Publicador:

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

1 = 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 ganha o conflito.

2 = O Assinante ganha o conflito.

3 = A assinatura é reiniciada.

queue_type

Especifica o tipo de fila usado. Pode ser um destes valores:

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

sql = Usar o SQL Server para armazenar transações.

Observação
O suporte ao Serviço de 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

100 = Microsoft SQL Server 2008

publish_to_AD

bit

Especifica se a publicação é publicada no Microsoft Active Directory™. Um valor de 1 indica que é publicada e um valor de 0 indica que não é publicada.

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 iniciadas de um backup e 0 significa que não podem. Para obter mais informações, consulte Inicializar uma assinatura transacional sem um instantâneo um Assinante transacional sem um instantâneo.

replicate_ddl

int

Indica se replicação de esquema tem suporte para a publicação. 1 indica que instruções DDL (linguagem de definição de dados) executadas no Publicador são replicadas e 0 indica que instruções DDL não são replicadas. Para obter mais informações, consulte 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 oferece suporte a replicação ponto a ponto. Para obter mais informações, consulte Replicação transacional ponto a ponto.

publish_local_changes_only

int

Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.

enabled_for_het_sub

int

Especifica se a publicação oferece suporte a Assinantes não SQL Server. Um valor de 1 significa que Assinantes não SQL Server têm suporte. Um valor de 0 significa que somente Assinantes SQL Server têm suporte. Para obter mais informações, consulte Assinantes não SQL Server.

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 são detectados conflitos. Para obter mais informações, consulte Detecção de conflitos na replicação ponto a ponto.

originator_id

int

Especifica uma ID para um nó em uma topologia ponto a ponto. Essa ID será usada para detecção de conflito se enabled_for_p2p_conflictdetection for 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 processando alterações.

Recomendamos que você use o valor padrão de 0. Quando essa opção é definida como 1, o Agente de Distribuição tenta convergir os dados na topologia aplicando a linha conflitante do nó que tem a ID de origem 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 Detecção de conflitos na replicação ponto a ponto.

alllow_partition_switch

int

Especifica se as instruções ALTER TABLE…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 as instruções ALTER TABLE…SWITCH que são executadas no banco de dados publicado devem ser replicadas para Assinantes. Essa opção só será válida se allow_partition_switch for definido como 1.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

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

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

Exemplo

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

USE [AdventureWorks2012]
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 que não é do SQL Server, somente membros da função de servidor fixa sysadmin no Distribuidor ou membros da função de banco de dados fixa db_owner no banco de dados de distribuição ou usuários da PAL podem executar sp_helppublication.