복제 배포 에이전트Replication Distribution Agent

복제 배포 에이전트는 스냅숏(스냅숏 복제 및 트랜잭션 복제의 경우) 및 배포 데이터베이스 테이블에 저장된 트랜잭션(트랜잭션 배포의 경우)을 구독자의 대상 테이블로 이동하는 실행 파일입니다.The Replication Distribution Agent is an executable that moves the snapshot (for snapshot replication and transactional replication) and the transactions held in the distribution database tables (for transactional replication) to the destination tables at the Subscribers.

참고

매개 변수는 지정되는 순서에 제한을 받지 않습니다.Parameters can be specified in any order. 선택적 매개 변수가 지정되지 않은 경우 로컬 컴퓨터의 미리 정의된 레지스트리 설정 값이 사용됩니다.When optional parameters are not specified, values from predefined registry settings on the local computer are used.

구문Syntax


distrib [-?]  
-Publisher server_name[\instance_name]  
-PublisherDB publisher_database  
-Subscriber server_name[\instance_name]  
-SubscriberDB subscriber_database   
[-AltSnapshotFolder alt_snapshot_folder_path]   
[-BcpBatchSize bcp_batch_size]  
[-CommitBatchSize commit_batch_size]  
[-CommitBatchThreshold commit_batch_threshold]  
[-Continuous]  
[-DefinitionFile def_path_and_file_name]  
[-Distributor distributor]  
[-DistributorLogin distributor_login]  
[-DistributorPassword distributor_password]  
[-DistributorSecurityMode [0|1]]  
[-EncryptionLevel [0|1|2]]  
[-ErrorFile error_path_and_file_name]  
[-ExtendedEventConfigFile configuration_path_and_file_name]  
[-FileTransferType [0|1]]  
[-FtpAddress ftp_address]  
[-FtpPassword ftp_password]   
[-FtpPort ftp_port]  
[-FtpUserName ftp_user_name]  
[-HistoryVerboseLevel [0|1|2|3]]  
[-Hostname host_name]  
[-KeepAliveMessageInterval keep_alive_message_interval_seconds]  
[-LoginTimeOut login_time_out_seconds]  
[-MaxBcpThreads]  
[-MaxDeliveredTransactions number_of_transactions]  
[-MessageInterval message_interval]  
[-OledbStreamThreshold oledb_stream_threshold]  
[-Output output_path_and_file_name]  
[-OutputVerboseLevel [0|1|2]]  
[-PacketSize packet_size]  
[-PollingInterval polling_interval]  
[-ProfileName profile_name]  
[-Publication publication]  
[-QueryTimeOut query_time_out_seconds]  
[-QuotedIdentifier quoted_identifier]  
[-SkipErrors native_error_id [:...n]]  
[-SubscriberDatabasePath subscriber_path]  
[-SubscriberLogin subscriber_login]  
[-SubscriberPassword subscriber_password]  
[-SubscriberSecurityMode [0|1]]  
[-SubscriberType [0|1|3]]  
[-SubscriptionStreams [1|2|...64]]  
[-SubscriptionTableName subscription_table]  
[-SubscriptionType [0|1|2]]  
[-TransactionsPerHistory [0|1|...10000]]  
[-UseDTS]  
[-UseInprocLoader]  
[-UseOledbStreaming]  

인수Arguments

-?-?
사용 가능한 모든 매개 변수를 출력합니다.Prints all available parameters.

-Publisher server_name[\instance_name]-Publisher server_name[\instance_name]
게시자의 이름입니다.Is the name of the Publisher. 해당 서버에 있는 기본 server_name 인스턴스에 대해 MicrosoftMicrosoft SQL ServerSQL Server 을 지정합니다.Specify server_name for the default instance of MicrosoftMicrosoft SQL ServerSQL Server on that server. 해당 서버에 있는 명명된 server_name\instance_name instance_name SQL ServerSQL Server 인스턴스에 대해 server_name을 지정하고,Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server.

-PublisherDB publisher_database-PublisherDB publisher_database
게시자 데이터베이스의 이름입니다.Is the name of the Publisher database.

-Subscriber server_name[\instance_name]-Subscriber server_name[\instance_name]
구독자의 이름입니다.Is the name of the Subscriber. 해당 서버에 있는 기본 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 인스턴스에 대해 server_name을 지정하고,Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server.

-SubscriberDB subscriber_database-SubscriberDB subscriber_database
구독자 데이터베이스의 이름입니다.Is the name of the Subscriber database.

-AltSnapshotFolder alt_snapshot_folder_path-AltSnapshotFolder alt_snapshot_folder_path
구독에 대한 초기 스냅숏이 들어 있는 폴더의 경로입니다.Is the path to the folder that contains the initial snapshot for a subscription.

-BcpBatchSize bcp_batch_size-BcpBatchSize bcp_batch_size
대량 복사 작업에서 보낼 행 수입니다.Is the number of rows to send in a bulk copy operation. bcp in 작업을 수행하는 경우 일괄 처리 크기는 한 번의 트랜잭션으로 서버에 보낼 행 수이며 배포 에이전트가 bcp 진행 메시지를 기록하기 전에 보내야 하는 행 수이기도 합니다.When performing a bcp in operation, the batch size is the number of rows to send to the server as one transaction, and also the number of rows that must be sent before the Distribution Agent logs a bcp progress message. bcp out 작업을 수행하는 경우 고정 일괄 처리 크기로 1000 이 사용됩니다.When performing a bcp out operation, a fixed batch size of 1000 is used.

-CommitBatchSize commit_batch_size-CommitBatchSize commit_batch_size
COMMIT 문을 실행하기 전에 구독자에 대해 실행할 트랜잭션의 개수입니다.Is the number of transactions to be issued to the Subscriber before a COMMIT statement is issued. 기본값은 100입니다.The default is 100.

-CommitBatchThreshold commit_batch_threshold-CommitBatchThreshold commit_batch_threshold
COMMIT 문을 실행하기 전에 구독자에 대해 실행할 복제 명령의 개수입니다.Is the number of replication commands to be issued to the Subscriber before a COMMIT statement is issued. 기본값은 1000입니다.The default is 1000.

-Continuous-Continuous
에이전트에서 복제된 트랜잭션의 폴링을 계속 시도할지 여부를 지정합니다.Specifies whether the agent attempts to poll replicated transactions continually. 이 인수가 지정된 경우 에이전트는 보류 중인 트랜잭션이 없는 경우에도 원본의 복제된 트랜잭션을 폴링 간격에 따라 폴링합니다.If specified, the agent polls replicated transactions from the source at polling intervals, even if there are no transactions pending.

-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 prompt 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 distributor-Distributor distributor
배포자 이름입니다.Is the Distributor name. 배포자(밀어넣기) 배포의 경우에는 로컬 배포자의 이름이 기본 이름이 됩니다.For Distributor (push) distribution, the name defaults to the name of the local Distributor.

-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. 값 0은 SQL ServerSQL Server 인증 모드를 나타내고 값 1은 Windows 인증 모드(기본값)를 나타냅니다.A value of 0 indicates SQL ServerSQL Server Authentication Mode, and a value of 1 indicates Windows Authentication Mode (default).

-EncryptionLevel [ 0 | 1 | 2 ]-EncryptionLevel [ 0 | 1 | 2 ]
연결을 만들 때 배포 에이전트에서 사용하는 SSL(Secure Sockets Layer) 암호화의 수준입니다.Is the level of Secure Sockets Layer (SSL) encryption used by the Distribution 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).

-ErrorFile error_path_and_file_name-ErrorFile error_path_and_file_name
배포 에이전트에서 생성한 오류 파일의 경로 및 파일 이름입니다.Is the path and file name of the error file generated by the Distribution Agent. 이 파일은 구독자에서 복제 트랜잭션을 적용하는 동안 오류가 발생할 때마다 생성되며 게시자나 배포자에서 발생한 오류는 이 파일에 기록되지 않습니다.This file is generated at any point where failure occurred while applying replication transactions at the Subscriber; errors that occur at the Publisher or Distributor are not logged in this file. 이 파일에는 실패한 복제 트랜잭션 및 관련 오류 메시지가 들어 있습니다.This file contains the failed replication transactions and associated error messages. 지정하지 않으면 오류 파일이 배포 에이전트의 현재 디렉터리에 생성됩니다.When not specified, the error file is generated in the current directory of the Distribution Agent. 오류 파일 이름은 배포 에이전트의 이름에 .err 확장명을 붙인 것입니다.The error file name is the name of the Distribution Agent with an .err extension. 지정된 파일 이름이 존재하면 오류 메시지가 파일에 추가됩니다.If the specified file name exists, error messages are appended to the file. 이 매개 변수는 최대 256개의 유니코드 문자일 수 있습니다.This parameter can be a maximum of 256 Unicode characters.

-ExtendedEventConfigFile configuration_path_and_file_name-ExtendedEventConfigFile configuration_path_and_file_name
확장 이벤트 XML 구성 파일의 경로 및 파일 이름을 지정합니다.Specifies the path and file name for the extended events XML configuration file. 확장 이벤트 구성 파일에서는 세션을 구성하고 추적 이벤트를 사용하도록 설정할 수 있습니다.The extended events configuration file allows you to configure sessions and enable events for tracking.

-FileTransferType [ 0| 1]-FileTransferType [ 0| 1]
파일 전송 유형을 지정합니다.Specifies the file transfer type. 0 은 UNC(Universal Naming Convention)를 나타내고, 값 1 은 FTP(File Transfer Protocol)를 나타냅니다.A value of 0 indicates UNC (universal naming convention), and a value of 1 indicates FTP (file transfer protocol).

-FtpAddress ftp_address-FtpAddress ftp_address
배포자용 FTP 서비스의 네트워크 주소입니다.Is the network address of the FTP service for the Distributor. 지정되지 않은 경우, DistributorAddress 가 사용됩니다.When not specified, DistributorAddress is used. DistributorAddress 가 지정되지 않은 경우 Distributor 가 사용됩니다.If DistributorAddress is not specified, Distributor is used.

-FtpPassword ftp_password-FtpPassword ftp_password
FTP 서비스에 연결할 때 사용되는 사용자 암호입니다.Is the user password used to connect to the FTP service.

-FtpPort ftp_port-FtpPort ftp_port
배포자용 FTP 서비스의 포트 번호입니다.Is the port number of the FTP service for the Distributor. 지정되지 않은 경우, FTP 서비스용 기본 포트 번호(21)가 사용됩니다.When not specified, the default port number for FTP service (21) is used.

-FtpUserName ftp_user_name-FtpUserName ftp_user_name
FTP 서비스에 연결할 때 사용할 사용자 이름입니다.Is the user name used to connect to the FTP service. 지정되지 않은 경우, anonymous 가 사용됩니다.When not specified, anonymous is used.

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

HistoryVerboseLevel 값HistoryVerboseLevel value 설명Description
00 진행 메시지를 콘솔이나 출력 파일에 씁니다.Progress messages are written either to the console or to an output file. 기록 레코드는 배포 데이터베이스에 기록되지 않습니다.History records are not logged in the distribution database.
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 unless the record is for such things as idle messages or long-running job messages, in which case update the previous records.
33 유휴 메시지에 대한 레코드가 없으면 항상 새 레코드를 삽입합니다.Always insert new records, unless it is for idle messages.

-Hostname host_name-Hostname host_name
게시자에 연결할 때 사용하는 호스트 이름입니다.Is the host name used when connecting to the Publisher. 이 매개 변수는 최대 128개의 유니코드 문자일 수 있습니다.This parameter can be a maximum of 128 Unicode characters.

-KeepAliveMessageInterval keep_alive_message_interval_seconds-KeepAliveMessageInterval keep_alive_message_interval_seconds
기록 스레드가 기존 연결에서 서버의 응답을 기다리고 있는지 확인할 때까지 걸리는 시간(초)입니다.Is the number of seconds before the history thread checks if any of the existing connections is waiting for a response from the server. 이 값을 줄이면 장기 실행 일괄 처리를 실행할 때 점검 에이전트에서 배포 에이전트를 주의 대상으로 표시하지 않도록 할 수 있습니다.This value can be decreased to avoid having the checkup agent mark the Distribution Agent as suspect when executing a long-running batch. 기본값은 300 초입니다.The default is 300 seconds.

-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.

-MaxBcpThreads number_of_threads-MaxBcpThreads number_of_threads
병렬로 수행할 수 있는 대량 복사 작업 수를 지정합니다.Specifies the number of bulk copy operations that can be performed in parallel. 동시에 존재하는 스레드 및 ODBC 연결의 최대 개수는 MaxBcpThreads 와 배포 데이터베이스의 동기화 트랜잭션에 나타나는 대량 복사 요청 수 중 더 작은 값입니다.The maximum number of threads and ODBC connections that exist simultaneously is the lesser of MaxBcpThreads or the number of bulk copy requests that appear in the synchronization transaction in the distribution database. MaxBcpThreads 값은 0 보다 크고 하드 코딩된 상한값이 없어야 합니다.MaxBcpThreads must have a value greater than 0 and has no hard-coded upper limit. 기본값은 최대값이 8 인 프로세서 수의 2배입니다.The default is 2 times the number of processors, up to a maximum value of 8. 게시자에서 동시 스냅숏 옵션을 사용하여 생성된 스냅숏을 적용할 경우 MaxBcpThreads에 지정한 숫자에 관계없이 하나의 스레드가 사용됩니다.When applying a snapshot that was generated at the Publisher using the concurrent snapshot option, one thread is used, regardless of the number you specify for MaxBcpThreads.

-MaxDeliveredTransactions number_of_transactions-MaxDeliveredTransactions number_of_transactions
한 번의 동기화에서 구독자에 적용되는 밀어넣기 또는 끌어오기 트랜잭션의 최대 개수입니다.Is the maximum number of push or pull transactions applied to Subscribers in one synchronization. 0 은 최대값이 무한개의 트랜잭션임을 나타냅니다.A value of 0 indicates that the maximum is an infinite number of transactions. 다른 값은 구독자가 게시자에서 끌어오는 동기화의 기간을 줄이는 데 사용할 수 있습니다.Other values can be used by Subscribers to shorten the duration of a synchronization being pulled from a Publisher.

참고

-MaxDeliveredTransactions와 -Continuous를 둘 다 지정한 경우 배포 에이전트는 -Continuous가 지정되었음에도 불구하고 지정된 개수의 트랜잭션을 제공한 다음 중지합니다.If -MaxDeliveredTransactions and -Continuous are both specified, the Distribution Agent delivers the specified number of transactions and then stops (even though -Continuous is specified). 작업이 완료되면 배포 에이전트를 다시 시작해야 합니다.You must restart the Distribution Agent after the job completes.

-MessageInterval message_interval-MessageInterval message_interval
기록 로깅에 사용되는 시간 간격입니다.Is the time interval used for history logging. 기록 이벤트는 다음과 같은 경우에 기록됩니다.A history event is logged when one of these parameters is reached:

  • 마지막 기록 이벤트가 기록된 후 TransactionsPerHistory 값에 도달한 경우The TransactionsPerHistory value is reached after the last history event is logged.

  • 마지막 기록 이벤트가 기록된 후 MessageInterval 값에 도달한 경우The MessageInterval value is reached after the last history event is logged.

    원본에 사용할 수 있는 복제된 트랜잭션이 없는 경우 에이전트에서는 배포자에 트랜잭션 없음 메시지를 보고합니다.If there is no replicated transaction available at the source, the agent reports a no-transaction message to the Distributor. 이 옵션은 다른 트랜잭션 없음 메시지를 보고하기 전에 에이전트에서 기다리는 시간을 지정합니다.This option specifies how long the agent waits before reporting another no-transaction message. 에이전트에서는 이전에 복제된 트랜잭션을 처리한 후 원본에 사용할 수 있는 트랜잭션이 없는지 감지할 때 항상 트랜잭션 없음 메시지를 보고합니다.Agents always report a no-transaction message when they detect that there are no transactions available at the source after previously processing replicated transactions. 기본값은 60초입니다.The default is 60 seconds.

    -OledbStreamThreshold oledb_stream_threshold-OledbStreamThreshold oledb_stream_threshold
    BLOB(Binary Large Object)의 최소 크기(바이트)를 지정합니다. 이 크기를 넘으면 데이터가 스트림으로 바인딩됩니다.Specifies the minimum size, in bytes, for binary large object data above which the data will be bound as a stream. 이 매개 변수를 사용하려면 –UseOledbStreaming 을 지정해야 합니다.You must specify –UseOledbStreaming to use this parameter. 값은 400바이트에서 1048576바이트 사이일 수 있으며 기본값은 16384바이트입니다.Values can range from 400 to 1048576 bytes, with a default of 16384 bytes.

    -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.

    -PacketSize packet_size-PacketSize packet_size
    패킷 크기(바이트)입니다.Is the packet size, in bytes. 기본값은 4096바이트입니다.The default is 4096 (bytes).

    -PollingInterval polling_interval-PollingInterval polling_interval
    배포 데이터베이스에서 복제된 트랜잭션을 쿼리하는 빈도(초)입니다.Is how often, in seconds, the distribution database is queried for replicated transactions. 기본값은 5초입니다.The default is 5 seconds.

    -ProfileName profile_name-ProfileName profile_name
    에이전트 매개 변수에 사용할 에이전트 프로필을 지정합니다.Specifies an agent profile to use for agent parameters. ProfileName 이 NULL이면 에이전트 프로필이 사용되지 않습니다.If ProfileName is NULL, the agent profile is disabled. ProfileName 이 지정되지 않으면 에이전트 유형에 대한 기본 프로필이 사용됩니다.If ProfileName is not specified, the default profile for the agent type is used. 자세한 내용은 복제 에이전트 프로필을 참조하세요.For information, see Replication Agent Profiles.

    -Publication publication-Publication publication
    게시의 이름입니다.Is the name of the publication. 이 매개 변수는 게시가 새 구독이나 다시 초기화된 구독에 대해 항상 스냅숏을 사용할 수 있도록 설정된 경우에만 유효합니다.This parameter is only valid if the publication is set to always have a snapshot available for new or reinitialized subscriptions.

    -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.

    -QuotedIdentifier quoted_identifier-QuotedIdentifier quoted_identifier
    사용할 따옴표 붙은 식별자 문자를 지정합니다.Specifies the quoted identifier character to use. 값의 첫 번째 문자는 배포 에이전트에서 사용하는 값을 나타냅니다.The first character of the value indicates the value the Distribution Agent uses. 값을 지정하지 않고 QuotedIdentifier 를 사용하면 배포 에이전트에서는 공백을 사용합니다.If QuotedIdentifier is used with no value, the Distribution Agent uses a space. QuotedIdentifier 를 사용하지 않는 경우 배포 에이전트에서는 구독자가 지원하는 따옴표 붙은 식별자를 사용합니다.If QuotedIdentifier is not used, the Distribution Agent uses whatever quoted identifier the Subscriber supports.

    -SkipErrors native_error_id [:...n]-SkipErrors native_error_id [:...n]
    이 에이전트에서 건너뛸 오류 번호를 지정하는 콜론으로 구분된 목록입니다.Is a colon-separated list that specifies the error numbers to be skipped by this agent.

    -SubscriberDatabasePath subscriber_database_path-SubscriberDatabasePath subscriber_database_path
    SubscriberType2 로서, ODBC DSN(데이터 원본 이름)이 없는 Jet 데이터베이스에 대한 연결이 허용되는 경우 Jet 데이터베이스(.mdb 파일)의 경로입니다.Is the path to the Jet database (.mdb file) if SubscriberType is 2 (allows a connection to a Jet database without an ODBC Data Source Name (DSN)).

    -SubscriberLogin subscriber_login-SubscriberLogin subscriber_login
    구독자의 로그인 이름입니다.Is the Subscriber login name. SubscriberSecurityMode0 ( SQL ServerSQL Server 인증의 경우)이면 이 매개 변수를 지정해야 합니다.If SubscriberSecurityMode is 0 (for SQL ServerSQL Server Authentication), this parameter must be specified.

    -SubscriberPassword subscriber_password-SubscriberPassword subscriber_password
    구독자 암호입니다.Is the Subscriber password. SubscriberSecurityMode0 ( SQL ServerSQL Server 인증의 경우)이면 이 매개 변수를 지정해야 합니다.If SubscriberSecurityMode is 0 (for SQL ServerSQL Server Authentication), this parameter must be specified.

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

    -SubscriberType [ 0| 1| 3]-SubscriberType [ 0| 1| 3]
    배포 에이전트에서 사용하는 구독자 연결 유형을 지정합니다.Specifies the type of Subscriber connection used by the Distribution Agent.

SubscriberType 값SubscriberType value 설명Description
00 SQL ServerSQL Server
11 ODBC 데이터 원본ODBC data source
33 OLE DB 데이터 원본OLE DB data source

-SubscriptionStreams [0|1|2|...64]-SubscriptionStreams [0|1|2|...64]
단일 스레드를 사용할 때 나타나는 여러 가지 트랜잭션 특징을 유지하면서 변경 내용의 일괄 처리를 구독자에 대해 병렬로 적용하기 위해 배포 에이전트당 허용된 연결 수입니다.Is the number of connections allowed per Distribution Agent to apply batches of changes in parallel to a Subscriber, while maintaining many of the transactional characteristics present when using a single thread. SQL ServerSQL Server 게시자의 경우 1에서 64 사이의 값 범위가 지원됩니다.For a SQL ServerSQL Server Publisher, a range of values from 1 to 64 is supported. 이 매개 변수는 게시자 및 배포자가 SQL Server 2005SQL Server 2005 이상 버전에서 실행 중인 경우에만 지원됩니다.This parameter is only supported when the Publisher and Distributor are running on SQL Server 2005SQL Server 2005 or later versions. SQL ServerSQL Server 이외 구독자 또는 피어 투 피어 구독의 경우 이 매개 변수가 지원되지 않거나 0이어야 합니다.This parameter is not supported or must be 0 for non- SQL ServerSQL Server Subscribers or peer-to-peer subscriptions.

참고

여러 연결 중 하나가 실행 또는 커밋되지 않으면 모든 연결에서 현재 일괄 처리를 중지하고 에이전트가 단일 스트림을 사용하여 실패한 일괄 처리를 다시 시도합니다.If one of the connections fails to execute or commit, all connections will abort the current batch, and the agent will use a single stream to retry the failed batches. 이러한 재시도 단계가 완료되기 전에는 구독자에 임시 트랜잭션 불일치가 발생할 수 있으며Before this retry phase completes, there can be temporary transactional inconsistencies at the Subscriber. 실패한 일괄 처리가 성공적으로 커밋되면 구독자의 트랜잭션 일관성이 다시 유지됩니다.After the failed batches are successfully committed, the Subscriber is brought back to a state of transactional consistency.

중요

-SubscriptionStreams의 값으로 2 이상을 지정할 경우 구독자에서 트랜잭션을 받는 순서가 게시자에서 트랜잭션을 만든 순서와 다를 수 있습니다.When you specify a value of 2 or greater for -SubscriptionStreams, the order in which transactions are received at the Subscriber may differ from the order in which they were made at the Publisher. 이 동작으로 인해 동기화 중 제약 조건 위반이 발생할 경우에는 동기화할 때 NOT FOR REPLICATION 옵션을 사용하여 제약 조건이 적용되지 않도록 해야 합니다.If this behavior causes constraint violations during synchronization, you should use the NOT FOR REPLICATION option to disable the enforcement of constraints during synchronization. 자세한 내용은 동기화하는 동안 트리거 및 제약 조건 동작 제어(복제 Transact-SQL 프로그래밍)를 참조하세요.For more information, see Control the Behavior of Triggers and Constraints During Synchronization (Replication Transact-SQL Programming).

참고

Subscriptionstreams는 Transact-SQLTransact-SQL을 제공하도록 구성된 아티클에 대해서는 작동하지 않습니다.Subscriptionstreams do not work for articles configured to deliver Transact-SQLTransact-SQL. subscriptionstreams를 사용하려면 대신 저장 프로시저 호출을 제공하도록 아티클을 구성하십시오.To use subscriptionstreams, configure articles to deliver stored procedure calls instead.

-SubscriptionTableName subscription_table-SubscriptionTableName subscription_table
지정된 구독자에서 생성되거나 사용된 구독 테이블의 이름입니다.Is the name of the subscription table generated or used at the given Subscriber. 지정되지 않은 경우 MSreplication_subscriptions(Transact-SQL) 테이블이 사용됩니다.When not specified, the MSreplication_subscriptions (Transact-SQL) table is used. 긴 파일 이름을 지원하지 않는 DBMS(데이터베이스 관리 시스템)의 경우에 이 옵션을 사용합니다.Use this option for database management systems (DBMS) that do not support long file names.

-SubscriptionType [ 0| 1| 2]-SubscriptionType [ 0| 1| 2]
배포의 구독 유형을 지정합니다.Specifies the subscription type for distribution. 0 은 밀어넣기 구독을, 값 1 은 끌어오기 구독을, 값 2 는 익명 구독을 나타냅니다.A value of 0 indicates a push subscription, a value of 1 indicates a pull subscription, and a value of 2 indicates an anonymous subscription.

-TransactionsPerHistory [ 0| 1|... 10000]-TransactionsPerHistory [ 0| 1|... 10000]
기록 로깅의 트랜잭션 간격을 지정합니다.Specifies the transaction interval for history logging. 기록 로깅의 마지막 인스턴스 후 커밋된 트랜잭션의 수가 이 옵션보다 클 경우 기록 메시지가 기록됩니다.If the number of committed transactions after the last instance of history logging is greater than this option, a history message is logged. 기본값은 100입니다.The default is 100. 값이 0 이면 TransactionsPerHistory에는 제한이 없습니다.A value of 0 indicates infinite TransactionsPerHistory. See the preceding –MessageIntervalparameter.See the preceding –MessageIntervalparameter.

-UseDTS-UseDTS
데이터 변환을 허용하는 게시의 매개 변수로 지정해야 합니다.Must be specified as a parameter for a publication that allows data transformation.

-UseInprocLoader-UseInprocLoader
배포 에이전트에서 구독자에 스냅숏 파일을 적용할 때 BULK INSERT 명령을 사용하도록 지정하여 초기 스냅숏의 성능을 향상시킵니다.Improves the performance of the initial snapshot by causing the Distribution Agent to use the BULK INSERT command when applying snapshot files to the Subscriber. 이 매개 변수는 XML 데이터 형식과 호환되지 않으므로 이후에는 지원되지 않습니다.This parameter is deprecated because it is not compatible with the XML data type. XML 데이터를 복제하지 않을 계획이라면 이 매개 변수를 사용할 수 있습니다.If you are not replicating XML data, this parameter can be used. 이 매개 변수는 문자 모드 스냅숏 또는 SQL ServerSQL Server 이외 구독자와 함께 사용할 수 없습니다.This parameter cannot be used with character mode snapshots or non- SQL ServerSQL Server Subscribers. 이 매개 변수를 사용하려면 구독자의 SQL ServerSQL Server 서비스 계정에 스냅숏 .bcp 데이터 파일이 있는 디렉터리에 대한 읽기 권한이 있어야 합니다.If you use this parameter, the SQL ServerSQL Server service account at the Subscriber must have read permissions on the directory where the snapshot .bcp data files are located. 이 매개 변수를 사용하지 않으면 에이전트( SQL ServerSQL Server 이외 구독자의 경우) 또는 에이전트에서 로드한 ODBC 드라이버( SQL ServerSQL Server 구독자의 경우)가 파일 내용을 읽으므로 SQL ServerSQL Server 서비스 계정의 보안 컨텍스트가 사용되지 않습니다.When this parameter is not used, the agent (for non- SQL ServerSQL Server Subscribers) or the ODBC driver loaded by the agent (for SQL ServerSQL Server Subscribers) reads from the files, so the security context of the SQL ServerSQL Server service account is not used.

-UseOledbStreaming-UseOledbStreaming
이 인수를 지정하면 BLOB(Binary Large Object) 데이터를 스트림으로 바인딩할 수 있습니다.When specified, enables the binding of binary large object data as a stream. 크기(바이트)가 얼마 이상일 때 스트림을 사용할지를 지정하려면 -OledbStreamThreshold 를 사용합니다.Use -OledbStreamThreshold to specify the size, in bytes, above which a stream will be used. UseOledbStreaming 은 기본적으로 사용하도록 설정됩니다.UseOledbStreaming is enabled by default. UseOledbStreamingC:\Program Files\Microsoft SQL Server\\COM 폴더에 데이터를 씁니다.UseOledbStreaming writes to the C:\Program Files\Microsoft SQL Server\\COM folder.

주의Remarks

중요

도메인 사용자 계정(기본값)이 아닌 로컬 시스템 계정에서 실행되도록 SQL ServerSQL Server 에이전트를 설치한 경우 해당 서비스에서는 로컬 컴퓨터에만 액세스할 수 있습니다.If you have installed SQL ServerSQL Server Agent to run under a local system account rather than under a domain user account (the default), the service can only access the local computer. SQL ServerSQL Server 에이전트에서 실행되는 배포 에이전트가 SQL ServerSQL Server의 인스턴스에 로그인할 때 Windows 인증 모드를 사용하도록 구성된 경우 해당 배포 에이전트가 실패합니다.If the Distribution Agent that runs under SQL ServerSQL Server Agent is configured to use Windows Authentication Mode when it logs in to an instance of SQL ServerSQL Server, the Distribution Agent fails. 기본 설정은 SQL ServerSQL Server 인증입니다.The default setting is SQL ServerSQL Server Authentication. 보안 계정을 변경하는 방법에 대한 자세한 내용은 View and Modify Replication Security Settings을 참조하십시오.For information on changing security accounts, see View and Modify Replication Security Settings.

배포 에이전트를 시작하려면 명령 프롬프트에서 distrib.exe 를 실행합니다.To start the Distribution Agent, execute distrib.exe from the command prompt. 자세한 내용은 복제 에이전트 실행 파일 개념을 참조하세요.For information, see Replication Agent Executables Concepts.

변경 내역Change History

업데이트된 내용Updated content
-ExtendedEventConfigFile 매개 변수를 추가했습니다.Added the -ExtendedEventConfigFile parameter.

관련 항목:See Also

복제 에이전트 관리Replication Agent Administration