sp_get_redirected_publisher (Transact-SQL)
元のパブリッシャーがリダイレクトされているかどうかを判断するために、レプリケーション エージェントがディストリビューターに対してクエリを実行するときに使用されます。
.gif "トピック リンク アイコン")
構文
sp_get_redirected_publisher
[ @original_publisher = ] 'original_publisher',
[ @publisher_db = ] 'database_name',
[ @bypass_publisher_validation = ] [0 | 1 ]
引数
[ @original_publisher = ] 'original_publisher'
パブリッシュされるデータベースの名前。 publisher_db のデータ型は sysname で、既定値はありません。[ @publisher_db = ] 'publisher_db'
パブリッシュされるデータベースの名前。 publisher_db のデータ型は sysname で、既定値はありません。[ @bypass_publisher_validation = ] [0 | 1 ]
リダイレクトされたパブリッシャーの検証を省略するために使用されます。 0 の場合は、検証が実行されます。 1 の場合は、検証が実行されません。 bypass_publisher_validation のデータ型は bit で、既定値は 0 です。
リターン コード値
0 (成功) または 1 (失敗)
結果セット
列名 |
データ型 |
説明 |
|---|---|---|
redirected_publisher |
sysname |
リダイレクト後のパブリッシャーの名前。 |
error_number |
int |
検証エラーのエラー番号。 |
error_severity |
int |
検証エラーの重大度。 |
error_message |
nvarchar(4000) |
検証エラー メッセージのテキスト。 |
説明
redirected_publisher は現在のパブリッシャーの名前を返します。 パブリッシャーとパブリッシング データベースが sp_redirect_publisher によってリダイレクトされていない場合は null を返します。
検証が要求されなかった場合、またはパブリッシャーとパブリッシング データベースのエントリが存在しない場合、error_number と error_severity は 0 を返し、error_message は null を返します。
検証が要求された場合は、リダイレクトの対象がパブリッシング データベースに適したホストであることを検証するために、検証ストアド プロシージャ sp_validate_redirected_publisher (Transact-SQL) が呼び出されます。 検証が成功した場合、sp_get_redirected_publisher はリダイレクトされたパブリッシャーの名前を返し、error_number 列と error_severity 列で 0 を、error_message 列で null をそれぞれ返します。
検証が要求されて失敗した場合は、リダイレクトされたパブリッシャーの名前がエラー情報と一緒に返されます。
権限
呼び出し元はディストリビューション データベースの sysadmin 固定サーバー ロールおよび db_owner 固定データベース ロールのメンバーであるか、パブリッシャー データベースと関連付けられている定義済みパブリケーションのパブリケーション アクセス リストのメンバーである必要があります。
関連項目
参照
レプリケーション ストアド プロシージャ (Transact-SQL)
sp_validate_redirected_publisher (Transact-SQL)