sp_get_redirected_publisher (Transact-SQL)
Область применения: SQL Server
Используется агентами репликации для запроса распространителя, чтобы определить, был ли перенаправлен исходный издатель.
Соглашения о синтаксисе Transact-SQL
Синтаксис
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 ]
[ ; ]
Аргументы
[ @original_publisher = ] N'original_publisher'
Имя экземпляра SQL Server, который первоначально опубликовал базу данных. @original_publisher — sysname без значения по умолчанию.
[ @publisher_db = ] N'publisher_db'
Имя опубликованной базы данных. @publisher_db — sysname без значения по умолчанию.
[ @bypass_publisher_validation = ] bypass_publisher_validation
Используется для пропуска проверки перенаправленного издателя. Если 0
выполняется проверка. Если 1
проверка не выполняется. @bypass_publisher_validation бит с значением по умолчанию0
.
[ @multi_subnet_failover = ] multi_subnet_failover
Область применения: SQL Server 2022 (16.x) CU 10 и более поздних версий
Используется для передачи сведений о создании динамического связанного сервера. Если 0
динамический связанный сервер не создается с параметром MultiSubnetFailover
. Если 1
динамический связанный сервер создается с параметром MultiSubnetFailover
как 1
. @multi_subnet_failover бит с значением по умолчанию0
.
Значения кода возврата
0
(успешно) или 1
(сбой).
Результирующий набор
Имя столбца | Тип данных | Description |
---|---|---|
redirected_publisher |
sysname | Имя издателя после перенаправления. |
error_number |
int | Номер ошибки проверки. |
error_severity |
int | Серьезность ошибки проверки. |
error_message |
nvarchar(4000) | Текст сообщения ошибки проверки. |
Замечания
redirected_publisher
возвращает текущее имя издателя. Возвращает, NULL
если базы данных издателя и публикации не перенаправляются с помощью sp_redirect_publisher
.
Если проверка не запрашивается или если для издателя и базы данных публикации нет записи, error_number
а также error_severity
возвращается 0
и error_message
возвращается NULL
.
При запросе проверки вызывается хранимая процедура проверки sp_validate_redirected_publisher (Transact-SQL), чтобы убедиться, что целевой объект перенаправления является подходящим узлом для базы данных публикации. Если проверка выполнена успешно, sp_get_redirected_publisher
возвращает имя перенаправленного издателя для 0
error_number
столбцов и error_severity
столбцов.NULL
error_message
Если проверка запрошена и завершилась неудачей, имя перенаправленного издателя возвращается вместе с информацией об ошибке.
Разрешения
Вызывающий объект должен быть членом предопределенной роли сервера sysadmin, db_owner предопределенной роли базы данных распространителя или членом списка доступа к публикации для определенной публикации, связанной с базой данных издателя.