복제 큐 판독기 에이전트Replication Queue Reader Agent

복제 큐 판독기 에이전트는 MicrosoftMicrosoft SQL ServerSQL Server 큐 또는 MicrosoftMicrosoft 메시지 큐에 저장된 메시지를 읽고 해당 메시지를 게시자에 적용하는 실행 파일입니다.The Replication Queue Reader Agent is an executable that reads messages stored in a MicrosoftMicrosoft SQL ServerSQL Server queue or a MicrosoftMicrosoft Message Queue and then applies those messages to the Publisher. 큐 판독기 에이전트는 지연 업데이트를 허용하는 스냅숏 및 트랜잭션 게시와 함께 사용됩니다.Queue Reader Agent is used with snapshot and transactional publications that allow queued updating.

참고

매개 변수는 지정되는 순서에 제한을 받지 않습니다.Parameters can be specified in any order. 선택적 매개 변수가 지정되지 않은 경우 기본 에이전트 프로필을 기반으로 하여 미리 정의된 값이 사용됩니다.When optional parameters are not specified, predefined values based on the default agent profile are used.

구문Syntax


qrdrsvc [-?]  
[-Continuous]  
[-DefinitionFile definition_file]  
[-Distributor server_name[\instance_name]]  
[-DistributionDB distribution_database]  
[-DistributorLogin distributor_login]  
[-DistributorPassword distributor_password]  
[-DistributorSecurityMode [0|1]]  
[-EncryptionLevel [0|1|2]]  
[-HistoryVerboseLevel [0|1|2|3]]  
[-LoginTimeOut login_time_out_seconds]  
[-Output output_path_and_file_name]  
[-OutputVerboseLevel [0|1|2]]  
[-PollingInterval polling_interval]  
[-PublisherFailoverPartner server_name[\instance_name] ]  
[-ProfileName agent_profile_name]  
[-QueryTimeOut query_time_out_seconds]  
[-ResolverState [1|2|3]]  

인수Arguments

-?-?
사용법 정보를 표시합니다.Displays usage information.

-Continuous-Continuous
에이전트에서 지연된 트랜잭션의 처리를 계속 시도할지 여부를 지정합니다.Specifies whether the agent attempts to process queued transactions continuously. 이 인수가 지정된 경우 에이전트는 구독자에서 보류 중인 지연 트랜잭션이 없는 경우에도 실행을 계속합니다.If specified, the agent continues execution even if there are no queued transactions pending from any of the subscribers.

-DefinitionFile def_path_and_file_name-DefinitionFile def_path_and_file_name
에이전트 정의 파일의 경로입니다.Is the path of the agent definition file. 에이전트 정의 파일에는 에이전트의 명령줄 인수가 들어 있습니다.An agent definition file contains command-line arguments for the agent. 파일 내용은 실행 파일로 구문 분석됩니다.The content of the file is parsed as an executable file. 임의 문자가 있는 인수 값을 지정하려면 큰따옴표(")를 사용합니다.Use double quotation marks (") to specify argument values containing arbitrary characters.

-Distributor server_name[\instance_name]-Distributor server_name[\instance_name]
배포자 이름입니다.Is the Distributor name. 해당 서버에 있는 기본 인스턴스에 대해 server_name SQL ServerSQL Server 을 지정하고,Specify server_name for the default instance of SQL ServerSQL Server on that server. 해당 서버에 있는 기본 server_name\instance_name instance_name SQL ServerSQL Server 을 지정하고,Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server. 이 인수가 지정되지 않은 경우 로컬 컴퓨터에 있는 기본 SQL ServerSQL Server 인스턴스의 이름이 기본 이름이 됩니다.If not specified, the name defaults to the name of the default instance of SQL ServerSQL Server on the local computer.

-DistributionDB distribution_database-DistributionDB distribution_database
배포 데이터베이스입니다.Is the distribution database.

-DistributorLogin distributor_login-DistributorLogin distributor_login
배포자의 로그인 이름입니다.Is the Distributor login name.

-DistributorPassword distributor_password-DistributorPassword distributor_password
배포자 암호입니다.Is the Distributor password.

-DistributorSecurityMode [ 0| 1]-DistributorSecurityMode [ 0| 1]
배포자의 보안 모드를 지정합니다.Specifies the security mode of the Distributor. 0SQL ServerSQL Server 인증 모드(기본값)를 나타내며 값 1 은 Windows 인증 모드를 나타냅니다.A value of 0 indicates SQL ServerSQL Server Authentication Mode (default), and a value of 1 indicates Windows Authentication Mode.

-EncryptionLevel [ 0 | 1 | 2 ]-EncryptionLevel [ 0 | 1 | 2 ]
연결을 만들 때 큐 판독기 에이전트에서 사용하는 SSL(Secure Sockets Layer) 암호화의 수준입니다.Is the level of Secure Sockets Layer (SSL) encryption used by the Queue Reader Agent when making connections.

EncryptionLevel 값EncryptionLevel value 설명Description
00 SSL이 사용되지 않음을 지정합니다.Specifies that SSL is not used.
11 SSL이 사용되지만 에이전트에서 SSL 서버 인증서가 트러스트된 발급자에 의해 서명된 것인지 확인하지 않음을 지정합니다.Specifies that SSL is used, but the agent does not verify that the SSL server certificate is signed by a trusted issuer.
22 SSL이 사용되고 인증서가 확인됨을 지정합니다.Specifies that SSL is used, and that the certificate is verified.

자세한 내용은 보안 개요(복제)를 참조하세요.For more information, see Security Overview (Replication).

-HistoryVerboseLevel [ 0| 1| 2| 3]-HistoryVerboseLevel [ 0| 1| 2| 3]
큐 판독기 작업을 수행하는 동안 기록에 추가되는 양을 지정합니다.Specifies the amount of history logged during a queue reader operation. 1을 선택하여 성능에서 기록 로깅의 영향을 최소화할 수 있습니다.You can minimize the effect of history logging on performance by selecting 1.

HistoryVerboseLevel 값HistoryVerboseLevel value 설명Description
00 기록 로깅을 사용하지 않습니다(권장되지 않음).No history logging (not recommended).
11 기본.Default. 시작, 진행, 성공 등과 같이 상태가 동일한 이전 기록 메시지를 항상 업데이트합니다.Always update a previous history message of the same status (startup, progress, success, and so on). 상태가 같은 이전 레코드가 없으면 새 레코드를 삽입합니다.If no previous record with the same status exists, insert a new record.
22 유휴 메시지 또는 장기 실행 작업 메시지를 포함하여 새 기록 레코드를 삽입합니다.Insert new history records, including idle messages or long-running job messages.
33 문제 해결에 유용한 추가 정보를 포함하는 새 기록 레코드를 삽입합니다.Insert new history records that include additional details that may be useful for troubleshooting.

-LoginTimeOut login_time_out_seconds-LoginTimeOut login_time_out_seconds
로그인 시간이 초과될 때까지 걸리는 시간(초)입니다.Is the number of seconds before the login times out. 기본값은 15초입니다.The default is 15 seconds.

-Output output_path_and_file_name-Output output_path_and_file_name
에이전트 출력 파일의 경로입니다.Is the path of the agent output file. 파일 이름을 지정하지 않으면 출력이 콘솔로 전달됩니다.If the file name is not provided, the output is sent to the console. 지정된 파일 이름이 존재하면 출력이 파일에 추가됩니다.If the specified file name exists, the output is appended to the file.

-OutputVerboseLevel [ 0| 1| 2]-OutputVerboseLevel [ 0| 1| 2]
출력이 자세해야 하는지 여부를 지정합니다.Specifies whether the output should be verbose. 정보 표시 수준이 0이면 오류 메시지만 출력됩니다.If the verbose level is 0, only error messages are printed. 정보 표시 수준이 1이면 모든 진행률 보고 메시지가 출력됩니다.If the verbose level is 1, all the progress report messages are printed. 정보 표시 수준이 2 (기본값)이면 디버깅에 유용한 오류 메시지와 진행률 보고 메시지가 모두 출력됩니다.If the verbose level is 2 (default), all error messages and progress report messages are printed, which is useful for debugging.

-PollingInterval polling_interval-PollingInterval polling_interval
SQL ServerSQL Server 기반 큐를 사용하는 구독 업데이트에만 해당됩니다.Is relevant only for updating subscriptions that use SQL ServerSQL Server based queues. SQL ServerSQL Server 큐가 보류 중인 지연 트랜잭션에 대해 폴링되는 빈도(초)를 지정합니다.Specifies how often, in seconds, the SQL ServerSQL Server queue is polled for pending queued transactions. 이 값은 0초에서 240초 사이일 수 있습니다.The value can be between 0 and 240 seconds. 기본값은 5초입니다.The default is 5 seconds.

-PublisherFailoverPartner server_name[\instance_name]-PublisherFailoverPartner server_name[\instance_name]
게시 데이터베이스와 함께 데이터베이스 미러링 세션에 참여하는 SQL ServerSQL Server 의 장애 조치 파트너 인스턴스를 지정합니다.Specifies the failover partner instance of SQL ServerSQL Server participating in a database mirroring session with the publication database. 자세한 내용은 데이터베이스 미러링 및 복제(SQL Server)를 참조하세요.For more information, see Database Mirroring and Replication (SQL Server).

-ProfileName agent_profile_name-ProfileName agent_profile_name
에이전트에 대한 기본값 집합을 제공하는 데 사용되는 에이전트 프로필의 이름입니다.Is the name of an agent profile used to supply a set of default values to the agent. 자세한 내용은 복제 에이전트 프로필을 참조하세요.For information, see Replication Agent Profiles.

-QueryTimeOut query_time_out_seconds-QueryTimeOut query_time_out_seconds
쿼리 시간이 초과될 때까지 걸리는 시간(초)입니다.Is the number of seconds before the query times out. 기본값은 1800초입니다.The default is 1800 seconds.

-ResolverState [ 1| 2| 3]-ResolverState [ 1| 2| 3]
지연 업데이트 충돌의 해결 방법을 지정합니다.Specifies how queued updating conflicts are resolved. 1 은 충돌 시 게시자의 내용이 적용되고, 현재 충돌하는 지연 트랜잭션이 게시자 및 원래 업데이트 구독자에서 다시 롤백되며, 이후 지연 트랜잭션의 처리가 계속됨을 나타냅니다.A value of 1 indicates the Publisher wins the conflict, and the current conflicting queued transaction will be rolled back on the Publisher and the originating updating Subscriber; the processing of subsequent queued transactions will continue. 2 는 충돌 시 구독자의 내용이 적용되고 지연 트랜잭션이 게시자의 값을 재정의함을 나타냅니다.A value of 2 indicates the Subscriber wins the conflict, and the queued transaction will override the values on the Publisher. 3 은 충돌이 발생할 경우 구독자가 다시 초기화되고, 게시자의 내용이 적용되고, 이후 지연 트랜잭션의 처리가 종료되며, 구독이 다시 초기화됨을 나타냅니다.A value of 3 indicates that any conflict will result in Subscriber re-initialization; the Publisher wins the conflict, processing of subsequent queued transactions will be terminated, and the subscription will be reinitialized. 기본 설정은 트랜잭션 게시의 경우 1 이고 스냅숏 게시의 경우 3 입니다.The default setting is 1 for transactional publications and 3 for snapshot publications.

주의Remarks

큐 판독기 에이전트를 시작하려면 명령 프롬프트에서 qrdrsvc.exe 를 실행합니다.To start the Queue Reader Agent, execute qrdrsvc.exe from the command prompt. 자세한 내용은 복제 에이전트 실행 파일을 참조하십시오.For information, see Replication Agent Executables.

참고 항목See Also

복제 에이전트 관리Replication Agent Administration