sp_get_redirected_publisher (Transact-SQL)

  • Article

S’applique à :SQL Server

Utilisé par les agents de réplication pour interroger un serveur de distribution pour déterminer si l’éditeur d’origine a été redirigé.

Conventions de la syntaxe Transact-SQL

Syntaxe

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 ]
[ ; ]

Arguments

[ @original_publisher = ] N’original_publisher'

Nom de l’instance de SQL Server qui a publié la base de données à l’origine. @original_publisher est sysname, sans valeur par défaut.

[ @publisher_db = ] N’publisher_db'

Nom de la base de données publiée. @publisher_db est sysname, sans valeur par défaut.

[ @bypass_publisher_validation = ] bypass_publisher_validation

Utilisé pour ignorer la validation du serveur de publication redirigé. Si 0, la validation est effectuée. Si 1la validation n’est pas effectuée. @bypass_publisher_validation est bit, avec la valeur par défaut 0.

[ @multi_subnet_failover = ] multi_subnet_failover

S’applique à : SQL Server 2022 (16.x) CU 10 et versions ultérieures

Utilisé pour transmettre des informations pour la création du serveur lié dynamique. Si 0, le serveur lié dynamique n’est pas créé avec le MultiSubnetFailover paramètre. Si 1, le serveur lié dynamique est créé avec le MultiSubnetFailover paramètre en tant que 1. @multi_subnet_failover est bit, avec la valeur par défaut 0.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

Nom de la colonne Type de données Description
redirected_publisher sysname Nom du serveur de publication après redirection.
error_number int Numéro de l'erreur de validation.
error_severity int Gravité de l'erreur de validation.
error_message nvarchar(4000) Texte du message d'erreur de validation.

Notes

redirected_publisher retourne le nom actuel de l’éditeur. Retourne NULL si les bases de données de publication et de publication ne sont pas redirigées à l’aide sp_redirect_publisherde .

Si la validation n’est pas demandée ou si aucune entrée n’existe pour l’éditeur et la base de données de publication, error_number puis error_severity retourne 0 et error_message retourne NULL.

Si la validation est demandée, la procédure stockée de validation sp_validate_redirected_publisher (Transact-SQL) est appelée pour vérifier que la cible de la redirection est un hôte approprié pour la base de données de publication. Si la validation réussit, sp_get_redirected_publisher retourne le nom de l’éditeur redirigé, 0 pour les error_number colonnes et error_severity les colonnes, et NULL dans la error_message colonne.

Si la validation est requise et échoue, le nom du serveur de publication redirigé est retourné avec les informations d'erreur.

Autorisations

L’appelant doit être membre du rôle serveur fixe sysadmin , du rôle de base de données fixe db_owner pour la base de données de distribution ou d’un membre d’une liste d’accès à la publication pour une publication définie associée à la base de données de l’éditeur.

Contenu connexe