Artigo
04/01/2012

sp_helppublication (Transact-SQL)

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 de 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 é o 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 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 não-SQL Server. publisher é o sysname com um padrão de NULL.

Observação

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

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

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
pubid	int	ID da publicação.
nome	sysname	Nome da publicação.
restrito	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.
tarefa		Usado para compatibilidade com versões anteriores.
freqüência de replicação	tinyint	Tipo de freqüê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 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 Snapshot Agent.
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 Distribution Agent autônomo para essa publicação.
immediate_sync_ready	bit	Se o Snapshot Agent 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 Distribution Agent 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 Distribution Agent 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 Distribution Agent 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 Distribution Agent ou Merge Agent 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 de 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		Nível de compatibilidade do banco de dados e pode ser um dos seguintes: 10 = Microsoft SQL Server 7.0 20 = SQL Server 7.0 Service Pack 1 30 = SQL Server 7.0 Service Pack 2 35 = SQL Server 7.0 Service Pack 3 40 = Microsoft SQL Server 2000 50 = SQL Server 2000 Service Pack 1 60 = SQL Server 2000 Service Pack 3 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 Inicializando 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 Fazendo 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 de 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 Distribution Agent 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 Distribution Agent deve continuar processando alterações quando um conflito é detectado. Um valor de 1 significa que o agente continua processando alterações. Cuidado Recomendamos que você use o valor padrão de 0. Quando essa opção é definida como 1, o Distribution Agent 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 Replicando 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 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 [AdventureWorks2008R2]
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 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.