sp_get_redirected_publisher (Transact-SQL)

Lo utilizan los agentes de replicación para consultar a un distribuidor a fin de determinar si se ha redirigido el publicador original.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

  • [ @original_publisher = ] 'original_publisher'
    El nombre de la base de datos que se va a publicar. publisher_db es de tipo sysname y no tiene valor predeterminado.

  • [ @publisher_db = ] 'publisher_db'
    El nombre de la base de datos que se va a publicar. publisher_db es de tipo sysname y no tiene valor predeterminado.

  • [ @bypass_publisher_validation = ] [0 | 1 ]
    Se utiliza para omitir la validación del publicador redirigido. Si es 0, se realiza la validación. Si es 1, no se realiza la validación. bypass_publisher_validation es de tipo bit y su valor predeterminado es 0.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Nombre de 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 el valor NULL si la base de datos del publicador y la base de datos de publicación no se han redirigido mediante sp_redirect_publisher.

Si no se solicita la validación o no existe ninguna entrada para el publicador ni para la base de datos de publicación, error_number y error_severity devuelven 0 y error_message devuelve el valor 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 es correcta, sp_get_redirected_publisher devuelve el nombre del publicador redirigido, 0 para las columnas error_number y error_severity, y el valor NULL para la columna error_message.

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 o del rol fijo de base de datos db_owner para la base de datos de distribución, o de una lista de acceso a la publicación definida que esté asociada a la base de datos del publicador.

Vea también

Referencia

Procedimientos almacenados de replicación (Transact-SQL)

sp_validate_redirected_publisher (Transact-SQL)

sp_redirect_publisher (Transact-SQL)

sp_validate_replica_hosts_as_publishers (Transact-SQL)