適用対象:
SQL ServerAzure SQL Managed Instance
ログ リーダー エージェントのセキュリティ プロパティを変更します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。
重要
リモート ディストリビューターを使用してパブリッシャーを構成する場合、 @job_login や @job_passwordを含むすべてのパラメーターに指定された値がプレーン テキストとしてディストリビューターに送信されます。 このストアド プロシージャを実行する前に、パブリッシャーとリモート ディストリビューターの間の接続を暗号化する必要があります。 詳細については、「接続を暗号化するために SQL Server データベース エンジンを構成する」を参照してください。
構文
sys.sp_changelogreader_agent
[ [ @job_login = ] N'job_login' ]
[ , [ @job_password = ] N'job_password' ]
[ , [ @publisher_security_mode = ] publisher_security_mode ]
[ , [ @publisher_login = ] N'publisher_login' ]
[ , [ @publisher_password = ] N'publisher_password' ]
[ , [ @publisher = ] N'publisher' ]
[ , [ @job_security_mode = ] job_security_mode ]
[ ; ]
引数
[ @job_login = ] N'job_login'
エージェントが実行されているアカウントのログイン。
@job_login は nvarchar(257) で、既定値は NULL です。 Azure SQL Managed Instance では、SQL Server アカウントを使用します。
Note
SQL Server 以外のパブリッシャーの場合、これは変更できません。
[ @job_password = ] N'job_password
エージェントを実行するアカウントのパスワード。
@job_password は sysname で、既定値は NULL です。
重要
可能であれば、実行時、ユーザーに対してセキュリティ資格情報の入力を要求します。 スクリプト ファイルに資格情報を格納する必要がある場合は、不正アクセスを防ぐために、ファイルを保護します。
[ @publisher_security_mode = ] publisher_security_mode
パブリッシャーに接続するときにエージェントによって使用されるセキュリティ モード。
@publisher_security_mode は smallint で、既定値は NULL です。 次の値は、セキュリティ モードを定義します。
-
0は SQL Server 認証を指定します。 -
1はWindows 認証を指定します。 -
2は、SQL Server 2022 (16.x) CU 6 以降の Microsoft Entra パスワード認証を指定します。 -
3は、SQL Server 2022 (16.x) CU 6 以降の Microsoft Entra 統合認証を指定します。 -
4は、SQL Server 2022 (16.x) CU 6 以降の Microsoft Entra トークン認証を指定します。
重要
可能な場合は、Windows 認証を使用します。
[ @publisher_login = ] N'publisher_login
パブリッシャーに接続するときに使用されるログイン。
@publisher_login は sysname で、既定値は NULL です。
0を指定する必要があります。
@publisher_loginがNULLされ、@publisher_security_modeが1されている場合、@job_loginで指定された Windows アカウントがパブリッシャーに接続するときに使用されます。
[ @publisher_password = ] N'publisher_password'
パブリッシャーに接続するときに使用するパスワード。
@publisher_password は sysname で、既定値は NULL です。
重要
空白のパスワードを使用しないでください。 強力なパスワードを使用してください。 可能であれば、実行時、ユーザーに対してセキュリティ資格情報の入力を要求します。 スクリプト ファイルに資格情報を格納する必要がある場合は、不正アクセスを防ぐために、ファイルを保護します。
[ @publisher = ] N'publisher'
パブリッシャーの名前。
@publisher は sysname で、既定値は NULL です。 このパラメーターは、SQL Server 以外のパブリッシャーでのみサポートされます。
[ @job_security_mode = ] job_security_mode
単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。
リターン コードの値
0 (成功) または 1 (失敗)。
解説
sp_changelogreader_agent はトランザクション レプリケーションで使用されます。
sp_changelogreader_agent は、ログ リーダー エージェントを実行する Windows アカウントを変更するために使用されます。 既存の Windows ログインのパスワードを変更することも、新しい Windows ログインとパスワードを指定することもできます。
エージェントのログインまたはパスワードを変更した後、変更を有効にするには、エージェントを停止して再起動する必要があります。
アクセス許可
sysadmin固定サーバー ロールまたはdb_owner固定データベース ロールのメンバーのみが、sp_changelogreader_agentを実行できます。