sp_get_redirected_publisher (Transact-SQL)

Se aplica a:SQL Server

Los agentes de replicación usan para consultar a un distribuidor para determinar si se redirigió al publicador original.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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'

Nombre de la instancia de SQL Server que publicó originalmente la base de datos. @original_publisher es sysname, sin ningún valor predeterminado.

[ @publisher_db = ] N'publisher_db'

El nombre de la base de datos que se va a publicar. @publisher_db es sysname, sin ningún valor predeterminado.

[ @bypass_publisher_validation = ] bypass_publisher_validation

Se utiliza para omitir la validación del publicador redirigido. Si 0es , se realiza la validación. Si 1es , no se realiza la validación. @bypass_publisher_validation es bit, con un valor predeterminado de 0.

[ @multi_subnet_failover = ] multi_subnet_failover

Se aplica a: SQL Server 2022 (16.x) CU 10 y versiones posteriores

Se usa para pasar información para la creación del servidor vinculado dinámico. Si 0es , el servidor vinculado dinámico no se crea con el MultiSubnetFailover parámetro . Si 1es , el servidor vinculado dinámico se crea con el MultiSubnetFailover parámetro como 1. @multi_subnet_failover es bit, con un valor predeterminado de 0.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Nombre de la columna Tipo de datos Descripción
redirected_publisher sysname El nombre del publicador después de la redirección.
error_number int El número de error del error de validación.
error_severity int La gravedad del error de validación.
error_message nvarchar(4000) El texto del mensaje de error de validación.

Comentarios

redirected_publisher devuelve el nombre del publicador actual. Devuelve NULL si el publicador y las bases de datos de publicación no se redirigen mediante sp_redirect_publisher.

Si no se solicita la validación o si no existe ninguna entrada para el publicador y la base de datos de publicación, error_number y error_severity devuelve 0 y error_message devuelve NULL.

Si se solicita la validación, se llama al procedimiento almacenado de validación sp_validate_redirected_publisher (Transact-SQL) para comprobar que el destino de la redirección es un host adecuado para la base de datos de publicación. Si la validación se realiza correctamente, sp_get_redirected_publisher devuelve el nombre del publicador redirigido, 0 para las error_number columnas y error_severity y NULL en la error_message columna.

Si se solicita la validación y se produce un error, se devuelve el nombre del publicador redirigido junto con información sobre el error.

Permisos

El autor de la llamada debe ser miembro del rol fijo de servidor sysadmin , el rol fijo de base de datos db_owner para la base de datos de distribución o un miembro de una lista de acceso de publicación para una publicación definida asociada a la base de datos del publicador.