Compartilhar via


sp_helppublication (Transact-SQL)

Retorna informações sobre uma publicação. Para uma publicação MicrosoftSQL 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ópicoConvençõ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çãoObservaçã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. Não há 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çãoObservaçã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 = MicrosoftSQL 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 = MicrosoftSQL Server 2000

50 = SQL Server 2000 Service Pack 1

60 = SQL Server 2000 Service Pack 3

90 = MicrosoftSQL Server 2005

100 = MicrosoftSQL 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 transação ponto a ponto.

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 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.

Observação sobre cuidadosCuidado
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 [AdventureWorks]
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.