sp_changelogreader_agent(Transact-SQL)
적용 대상: SQL Server Azure SQL Managed Instance
로그 판독기 에이전트의 보안 속성을 변경합니다. 이 저장 프로시저는 게시 데이터베이스의 게시자에서 실행됩니다.
Important
원격 배포자를 사용하여 게시자를 구성할 때 job_login 및 job_password 비롯한 모든 매개 변수에 제공된 값은 일반 텍스트로 배포자로 전송됩니다. 이 저장 프로시저를 실행하기 전에 게시자와 해당 원격 배포자 간의 연결을 암호화해야 합니다. 자세한 내용은 데이터베이스 엔진에 대한 암호화된 연결 사용(SQL Server 구성 관리자)을 참조하세요.
구문
sp_changelogreader_agent [ [ @job_login = ] 'job_login' ]
[ , [ @job_password = ] 'job_password' ]
[ , [ @publisher_security_mode = ] publisher_security_mode ]
[ , [ @publisher_login = ] 'publisher_login' ]
[ , [ @publisher_password = ] 'publisher_password' ]
[ , [ @publisher = ] 'publisher' ]
인수
[ @job_login = ] 'job_login'
에이전트가 실행되는 계정에 대한 로그인입니다. job_login nvarchar(257)이며 기본값은 NULL입니다. Azure SQL Managed Instance에서 SQL Server 계정을 사용합니다. Microsoft SQL Server 이외 게시자에 대해서는 변경할 수 없습니다.
[ @job_password = ] 'job_password'
에이전트가 실행되는 계정의 암호입니다. job_password sysname이며 기본값은 NULL입니다.
Important
가능한 경우 런타임 시 사용자에게 보안 자격 증명을 입력하라는 메시지가 표시됩니다. 스크립트 파일에 자격 증명을 저장해야 하는 경우 무단 액세스를 방지하기 위해 파일을 보호해야 합니다.
[ @publisher_security_mode = ] publisher_security_mode
참고 항목
Microsoft Entra ID는 이전의 Azure AD(Azure Active Directory)입니다.
게시자에 연결할 때 에이전트가 사용하는 보안 모드입니다. publisher_security_mode 기본값이 NULL인 smallint입니다. 다음 값은 보안 모드를 정의합니다.
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 토큰 인증을 지정합니다.
Important
가능하면 Windows 인증을 사용하세요.
[ @publisher_login = ] 'publisher_login'
게시자에 연결할 때 사용되는 로그인입니다. publisher_login sysname이며 기본값은 NULL입니다. publisher_security_mode 0이면 publisher_login 지정해야 합니다. publisher_login NULL이고 publisher_security_mode 1이면 job_login 지정된 Windows 계정이 게시자에 연결할 때 사용됩니다.
[ @publisher_password = ] 'publisher_password'
게시자에 연결할 때 사용되는 암호입니다. publisher_password sysname이며 기본값은 NULL입니다.
Important
빈 암호를 사용하지 마세요. 강력한 암호를 사용하세요. 가능한 경우 런타임 시 사용자에게 보안 자격 증명을 입력하라는 메시지가 표시됩니다. 스크립트 파일에 자격 증명을 저장해야 하는 경우 무단 액세스를 방지하기 위해 파일을 보호해야 합니다.
[ @publisher = ] 'publisher'
게시자의 이름입니다. 게시자는 sysname이며 기본값은 NULL입니다. 이 매개 변수는 SQL Server가 아닌 게시자에 대해서만 지원됩니다.
반환 코드 값
0 (성공) 또는 1 (실패)
설명
sp_changelogreader_agent 트랜잭션 복제에 사용됩니다.
sp_changelogreader_agent 로그 판독기 에이전트가 실행되는 Windows 계정을 변경하는 데 사용됩니다. 기존 Windows 로그인의 암호를 변경하거나 새 Windows 로그인 및 암호를 제공할 수 있습니다.
에이전트 로그인 또는 암호를 변경한 후 에이전트를 중지하고 다시 시작해야 변경 내용이 적용됩니다.
사용 권한
sysadmin 고정 서버 역할 또는 db_owner 고정 데이터베이스 역할의 멤버만 sp_changelogreader_agent 실행할 수 있습니다.
참고 항목
복제 보안 설정 보기 및 수정
sp_helplogreader_agent(Transact-SQL)
sp_addlogreader_agent(Transact-SQL)
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기