sp_get_redirected_publisher (Transact-SQL)

Aplica-se a:SQL Server

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

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_get_redirected_publisher
    [ @original_publisher = ] N'original_publisher'
    , [ @publisher_db = ] N'publisher_db'
    [ , [ @bypass_publisher_validation = ] bypass_publisher_validation ]
    [ , [ @multi_subnet_failover = ] multi_subnet_failover ]
[ ; ]

Argumentos

@original_publisher [ = ] N'original_publisher'

O nome da instância do SQL Server que publicou originalmente o banco de dados. @original_publisher é sysname, sem padrão.

@publisher_db [ = ] N'publisher_db'

O nome do banco de dados que está sendo publicado. @publisher_db é sysname, sem padrão.

@bypass_publisher_validation [ = ] bypass_publisher_validation

Usado para ignorar a validação do publicador redirecionado. Se 0, a validação é executada. Se 1, a validação não for executada. @bypass_publisher_validation é bit, com um padrão de 0.

@multi_subnet_failover [ = ] multi_subnet_failover

Aplica-se a: SQL Server 2022 (16.x) 10 e versões posteriores

Usado para passar informações para a criação do servidor vinculado dinâmico. Se 0, o servidor vinculado dinâmico não for criado com o MultiSubnetFailover parâmetro. Se 1, o servidor vinculado dinâmico será criado com o MultiSubnetFailover parâmetro como 1. @multi_subnet_failover é bit, com um padrão de 0.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto 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 editor atual. Retorna NULL se os bancos de dados do editor e de publicação não forem redirecionados usando sp_redirect_publishero .

Se a validação não for solicitada ou se não houver entrada para o editor e o banco de dados de publicação, error_number e retornar e error_severityerror_message retornar 0NULL.

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, retornará o nome do editor redirecionado, sp_get_redirected_publisher0 para as error_number colunas NULL e error_severity na error_message coluna.

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