sp_get_redirected_publisher (Transact-SQL)

Artigo
05/07/2013

Usado por agentes de replicação consultar um distribuidor para determinar se o publicador original foi redirecionado.

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

Sintaxe

sp_get_redirected_publisher 
    [ @original_publisher = ] 'original_publisher',
    [ @publisher_db = ] 'database_name', 
    [ @bypass_publisher_validation = ] [0 | 1 ]

Argumentos

[ @original_publisher = ] 'original_publisher'
O nome do banco de dados que está sendo publicado. publisher_db é sysname, sem padrão.
[ @publisher_db = ] 'publisher_db'
O nome do banco de dados que está sendo publicado. publisher_db é sysname, sem padrão.
[ @bypass_publisher_validation = ] [0 | 1 ]
Usado para ignorar a validação do publicador redirecionado. Se 0, a validação é executada. Se 1, a validação não é executada. bypass_publisher_validation é bit, com um valor padrão 0.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
redirected_publisher	sysname	O nome do publicador após o redirecionamento.
error_number	int	O número do erro de validação.
error_severity	int	A severidade do erro de validação.
error_message	nvarchar(4000)	O texto da mensagem de erro de validação.

Comentários

redirected_publisher retorna o nome do publicador atual. Retornará nulo se o publicador e os bancos de dados de publicação não tiverem sido redirecionados com sp_redirect_publisher.

Se a validação não for solicitada ou se não houver nenhuma entrada para o publicador e o banco de dados de publicação, error_number e error_severity retornarão 0 e error_message retornará nulo.

se a validação for solicitada, o procedimento armazenado de validação sp_validate_redirected_publisher (Transact-SQL) será chamado para verificar se o destino do redirecionamento é um host adequado para o banco de dados de publicação. Se a validação for bem-sucedida, sp_get_redirected_publisher retornará o nome do publicador redirecionado, 0 para as colunas error_number e error_severity e nulo na coluna error_message.

Se a validação for solicitada e falhar, o nome do publicador redirecionado será retornado junto com informações de erro.

Permissões

O chamador deve ser membro da função de servidor fixa sysadmin, da função de banco de dados fixa db_owner para o banco de dados de distribuição ou membro de uma lista de acesso à publicação para uma publicação definida associada ao banco de dados publicador.