sp_addpullsubscription_agent(Transact-SQL)sp_addpullsubscription_agent (Transact-SQL)

이 항목은 다음에 적용됩니다.예SQL Server(2008부터)아니요Azure SQL Database아니요Azure SQL Data Warehouse 아니요병렬 데이터 웨어하우스 THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

끌어오기 구독을 동기화하는 데 사용하는 새로 예약된 에이전트 작업을 트랜잭션 게시에 추가합니다.Adds a new scheduled agent job used to synchronize a pull subscription to a transactional publication. 이 저장 프로시저는 구독 데이터베이스의 구독자에서 실행됩니다.This stored procedure is executed at the Subscriber on the subscription database.

항목 링크 아이콘 Transact-SQL 구문 규칙Topic link icon Transact-SQL Syntax Conventions

구문Syntax


sp_addpullsubscription_agent [ @publisher = ] 'publisher'  
    [ , [ @publisher_db = ] 'publisher_db' ]          , [ @publication = ] 'publication'  
    [ , [ @subscriber = ] 'subscriber' ]  
    [ , [ @subscriber_db = ] 'subscriber_db' ]  
    [ , [ @subscriber_security_mode = ] subscriber_security_mode ]  
    [ , [ @subscriber_login = ] 'subscriber_login' ]  
    [ , [ @subscriber_password = ] 'subscriber_password' ]  
    [ , [ @distributor = ] 'distributor' ]  
    [ , [ @distribution_db = ] 'distribution_db' ]  
    [ , [ @distributor_security_mode = ] distributor_security_mode ]  
    [ , [ @distributor_login = ] 'distributor_login' ]  
    [ , [ @distributor_password = ] 'distributor_password' ]  
    [ , [ @optional_command_line = ] 'optional_command_line' ]  
    [ , [ @frequency_type = ] frequency_type ]  
    [ , [ @frequency_interval = ] frequency_interval ]  
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ]  
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]  
    [ , [ @frequency_subday = ] frequency_subday ]  
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ]  
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ]  
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ]  
    [ , [ @active_start_date = ] active_start_date ]  
    [ , [ @active_end_date = ] active_end_date ]  
    [ , [ @distribution_jobid = ] distribution_jobid OUTPUT ]  
    [ , [ @encrypted_distributor_password = ] encrypted_distributor_password ]  
    [ , [ @enabled_for_syncmgr = ] 'enabled_for_syncmgr' ]  
    [ , [ @ftp_address = ] 'ftp_address' ]  
    [ , [ @ftp_port = ] ftp_port ]  
    [ , [ @ftp_login = ] 'ftp_login' ]  
    [ , [ @ftp_password = ] 'ftp_password' ]  
    [ , [ @alt_snapshot_folder = ] 'alternate_snapshot_folder' ]  
    [ , [ @working_directory = ] 'working_directory' ]  
    [ , [ @use_ftp = ] 'use_ftp' ]  
    [ , [ @publication_type = ] publication_type ]  
    [ , [ @dts_package_name = ] 'dts_package_name' ]  
    [ , [ @dts_package_password = ] 'dts_package_password' ]  
    [ , [ @dts_package_location = ] 'dts_package_location' ]  
    [ , [ @reserved = ] 'reserved' ]  
    [ , [ @offloadagent = ] 'remote_agent_activation' ]  
    [ , [ @offloadserver = ] 'remote_agent_server_name']  
    [ , [ @job_name = ] 'job_name' ]  
    [ , [ @job_login = ] 'job_login' ]   
    [ , [ @job_password = ] 'job_password' ]   

인수Arguments

[ @publisher=] 'publisher'[ @publisher=] 'publisher'
게시자의 이름입니다.Is the name of the Publisher. 게시자sysname, 기본값은 없습니다.publisher is sysname, with no default.

[ @publisher_db=] ' * * * publisher_db'*[ **@publisher_db=] 'publisher_db'
게시자 데이터베이스의 이름입니다.Is the name of the Publisher database. publisher_dbsysname, 기본값은 NULL입니다.publisher_db is sysname, with a default value of NULL. publisher_db Oracle 게시자에 의해 무시 됩니다.publisher_db is ignored by Oracle Publishers.

[ @publication=] 'publication'[ @publication=] 'publication'
게시의 이름입니다.Is the name of the publication. 게시sysname, 기본값은 없습니다.publication is sysname, with no default.

[ @subscriber=] '구독자'[ @subscriber=] 'subscriber'
구독자의 이름입니다.Is the name of the Subscriber. 구독자sysname, 기본값은 NULL입니다.subscriber is sysname, with a default of NULL.

참고

이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다.This parameter has been deprecated and is maintained for backward compatibility of scripts.

[ @subscriber_db=] 'subscriber_db'[ @subscriber_db=] 'subscriber_db'
구독 데이터베이스의 이름입니다.Is the name of the subscription database. subscriber_dbsysname, 기본값은 NULL입니다.subscriber_db is sysname, with a default of NULL.

참고

이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다.This parameter has been deprecated and is maintained for backward compatibility of scripts.

[ @subscriber_security_mode=] subscriber_security_mode[ @subscriber_security_mode=] subscriber_security_mode
동기화 시 구독자에 연결하는 데 사용할 보안 모드입니다.Is the security mode to use when connecting to a Subscriber when synchronizing. subscriber_security_modeint, 기본값은 NULL입니다.subscriber_security_mode is int, with a default of NULL. 0 지정 SQL ServerSQL Server 인증 합니다.0 specifies SQL ServerSQL Server Authentication. 1 Windows 인증을 지정 합니다.1 specifies Windows Authentication.

참고

이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다.This parameter has been deprecated and is maintained for backward compatibility of scripts. 배포 에이전트는 항상 Windows 인증을 사용하여 로컬 구독자에 연결합니다.The Distribution Agent always connects to the local Subscriber using Windows Authentication. NULL이 아닌 값 또는 1 지정이 매개 변수에 대 한 경고 메시지가 반환 됩니다.If a value other than NULL or 1 is specified for this parameter, a warning message is returned.

[ @subscriber_login =] 'subscriber_login'[ @subscriber_login =] 'subscriber_login'
동기화 시 구독자에 연결할 때 사용할 구독자 로그인이입니다. subscriber_loginsysname, 기본값은 NULL입니다.Is the Subscriber login to use when connecting to a Subscriber when synchronizing.subscriber_login is sysname, with a default of NULL.

참고

이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다.This parameter has been deprecated and is maintained for backward compatibility of scripts. 이 매개 변수의 값을 지정하면 경고 메시지가 반환되고 값은 무시됩니다.If a value is specified for this parameter, a warning message is returned, but the value is ignored.

[ @subscriber_password=] 'subscriber_password'[ @subscriber_password=] 'subscriber_password'
구독자 암호입니다.Is the Subscriber password. subscriber_password 경우 필요한 subscriber_security_mode 로 설정 된 0합니다.subscriber_password is required if subscriber_security_mode is set to 0. subscriber_passwordsysname, 기본값은 NULL입니다.subscriber_password is sysname, with a default of NULL. 구독자 암호가 사용되는 경우에는 자동으로 암호화됩니다.If a subscriber password is used, it is automatically encrypted.

참고

이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다.This parameter has been deprecated and is maintained for backward compatibility of scripts. 이 매개 변수의 값을 지정하면 경고 메시지가 반환되고 값은 무시됩니다.If a value is specified for this parameter, a warning message is returned, but the value is ignored.

[ @distributor=] '배포자'[ @distributor=] 'distributor'
배포자의 이름입니다.Is the name of the Distributor. 배포자sysname, 기본값에 지정 된 값은 게시자합니다.distributor is sysname, with a default of the value specified by publisher.

[ @distribution_db=] 'distribution_db'[ @distribution_db=] 'distribution_db'
배포 데이터베이스의 이름입니다.Is the name of the distribution database. distribution_dbsysname, 기본값은 NULL입니다.distribution_db is sysname, with a default value of NULL.

[ @distributor_security_mode=] distributor_security_mode[ @distributor_security_mode=] distributor_security_mode
동기화 시 배포자에 연결하는 데 사용할 보안 모드입니다.Is the security mode to use when connecting to a Distributor when synchronizing. distributor_security_modeint, 기본값은 1합니다.distributor_security_mode is int, with a default of 1. 0 지정 SQL ServerSQL Server 인증 합니다.0 specifies SQL ServerSQL Server Authentication. 1 Windows 인증을 지정 합니다.1 specifies Windows Authentication.

중요

가능하면 Windows 인증을 사용하세요.When possible, use Windows Authentication.

[ @distributor_login=] 'distributor_login'[ @distributor_login=] 'distributor_login'
동기화 시 배포자에 연결하는 데 사용할 배포자 로그인입니다.Is the Distributor login to use when connecting to a Distributor when synchronizing. distributor_login 경우 필요한 distributor_security_mode 로 설정 된 0합니다.distributor_login is required if distributor_security_mode is set to 0. distributor_loginsysname, 기본값은 NULL입니다.distributor_login is sysname, with a default of NULL.

[ @distributor_password =] 'distributor_password'[ @distributor_password =] 'distributor_password'
배포자 암호입니다.Is the Distributor password. distributor_password 경우 필요한 distributor_security_mode 로 설정 된 0합니다.distributor_password is required if distributor_security_mode is set to 0. distributor_passwordsysname, 기본값은 NULL입니다.distributor_password is sysname, with a default of NULL.

중요

빈 암호를 사용하지 마세요.Do not use a blank password. 강력한 암호를 사용하세요.Use a strong password. 가능한 경우 런타임 시 사용자에게 보안 자격 증명을 입력하라는 메시지가 표시됩니다.When possible, prompt users to enter security credentials at runtime. 자격 증명을 스크립트 파일에 저장해야 하는 경우에는 파일에 무단으로 액세스하지 못하도록 보안을 설정해야 합니다.If you must store credentials in a script file, you must secure the file to prevent unauthorized access.

[ @optional_command_line=] 'optional_command_line'[ @optional_command_line=] 'optional_command_line'
배포 에이전트에 공급되는 선택적 명령 프롬프트입니다.Is an optional command prompt supplied to the Distribution Agent. 예를 들어 -DefinitionFile C:\Distdef.txt 또는 -CommitBatchSize 10입니다.For example, -DefinitionFile C:\Distdef.txt or -CommitBatchSize 10. optional_command_linenvarchar (4000), 기본값은 빈 문자열입니다.optional_command_line is nvarchar(4000), with a default of empty string.

[ @frequency_type=] frequency_type[ @frequency_type=] frequency_type
배포 에이전트를 예약하는 빈도입니다.Is the frequency with which to schedule the Distribution Agent. frequency_typeint, 다음 값 중 하나가 될 수 있습니다.frequency_type is int, and can be one of the following values.

ValueValue 설명Description
11 한 번One time
2 (기본값)2 (default) 요청 시On demand
44 일별Daily
88 매주Weekly
1616 매월Monthly
3232 매월 상대적Monthly relative
6464 자동 시작Autostart
128128 되풀이Recurring

참고

값을 지정 64 하면 배포 에이전트가 연속 모드로 실행 되도록 합니다.Specifying a value of 64 causes the Distribution Agent to run in continuous mode. 이 설정에 해당 하는 -연속 에이전트에 대 한 매개 변수입니다.This corresponds to setting the -Continuous parameter for the agent. 자세한 내용은 Replication Distribution Agent을 참조하세요.For more information, see Replication Distribution Agent.

[ @frequency_interval=] frequency_interval[ @frequency_interval=] frequency_interval
값 설정 된 빈도에 적용 하려면 frequency_type합니다.Is the value to apply to the frequency set by frequency_type. frequency_intervalint, 기본값은 1입니다.frequency_interval is int, with a default of 1.

[ @frequency_relative_interval=] frequency_relative_interval[ @frequency_relative_interval=] frequency_relative_interval
배포 에이전트의 날짜입니다.Is the date of the Distribution Agent. 이 매개 변수는 때 frequency_type 로 설정 된 32 (매월 상대)입니다.This parameter is used when frequency_type is set to 32 (monthly relative). frequency_relative_intervalint, 다음 값 중 하나가 될 수 있습니다.frequency_relative_interval is int, and can be one of the following values.

ValueValue DescriptionDescription
1 (기본값)1 (default) 첫째First
22 둘째Second
44 셋째Third
88 넷째Fourth
1616 마지막Last

[ @frequency_recurrence_factor=] frequency_recurrence_factor[ @frequency_recurrence_factor=] frequency_recurrence_factor
사용 하는 되풀이 비율 frequency_type합니다.Is the recurrence factor used by frequency_type. frequency_recurrence_factorint, 기본값은 1합니다.frequency_recurrence_factor is int, with a default of 1.

[ @frequency_subday=] frequency_subday[ @frequency_subday=] frequency_subday
정의된 기간 동안 다시 예약하는 빈도입니다.Is how often to reschedule during the defined period. frequency_subdayint, 다음 값 중 하나가 될 수 있습니다.frequency_subday is int, and can be one of the following values.

ValueValue DescriptionDescription
1 (기본값)1 (default) 한 번Once
22 둘째Second
44 MinuteMinute
88 HourHour

[ @frequency_subday_interval=] frequency_subday_interval[ @frequency_subday_interval=] frequency_subday_interval
에 대 한 간격인 frequency_subday합니다.Is the interval for frequency_subday. frequency_subday_intervalint, 기본값은 1합니다.frequency_subday_interval is int, with a default of 1.

[ @active_start_time_of_day=] active_start_time_of_day[ @active_start_time_of_day=] active_start_time_of_day
하루 중에서 배포 에이전트가 처음으로 실행되도록 예약된 시간이며 HHMMSS 형식으로 표시됩니다.Is the time of day when the Distribution Agent is first scheduled, formatted as HHMMSS. active_start_time_of_dayint, 기본값은 0합니다.active_start_time_of_day is int, with a default of 0.

[ @active_end_time_of_day=] active_end_time_of_day[ @active_end_time_of_day=] active_end_time_of_day
하루 중에서 배포 에이전트가 마지막으로 실행되도록 예약된 시간이며 HHMMSS 형식으로 표시됩니다.Is the time of day when the Distribution Agent stops being scheduled, formatted as HHMMSS. active_end_time_of_dayint, 기본값은 0합니다.active_end_time_of_day is int, with a default of 0.

[ @active_start_date=] active_start_date[ @active_start_date=] active_start_date
배포 에이전트가 처음으로 실행되도록 예약된 날짜이며 YYYYMMDD 형식으로 표시됩니다.Is the date when the Distribution Agent is first scheduled, formatted as YYYYMMDD. active_start_dateint, 기본값은 0합니다.active_start_date is int, with a default of 0.

[ @active_end_date=] active_end_date[ @active_end_date=] active_end_date
배포 에이전트가 마지막으로 실행되도록 예약된 날짜이며 YYYYMMDD 형식으로 표시됩니다.Is the date when the Distribution Agent stops being scheduled, formatted as YYYYMMDD. active_end_dateint, 기본값은 0합니다.active_end_date is int, with a default of 0.

[ @distribution_jobid =] distribution_jobid * * * 출력[ **@distribution_jobid =] *distribution_jobidOUTPUT
이 작업의 배포 에이전트 ID입니다.Is the ID of the Distribution Agent for this job. distribution_jobidbinary (16), 기본값은 null 이며 출력 매개 변수입니다.distribution_jobid is binary(16), with a default of NULL, and it is an OUTPUT parameter.

[ @encrypted_distributor_password=] encrypted_distributor_password[ @encrypted_distributor_password=] encrypted_distributor_password
설정 encrypted_distributor_password 더 이상 지원 합니다.Setting encrypted_distributor_password is no longer supported. 이 설정 하는 비트 매개 변수를 1 에서 오류가 발생 합니다.Attempting to set this bit parameter to 1 will result in an error.

[ @enabled_for_syncmgr=] 'enabled_for_syncmgr'[ @enabled_for_syncmgr=] 'enabled_for_syncmgr'
구독을 통해 동기화 할 수 있는지 여부는 MicrosoftMicrosoft 동기화 관리자입니다.Is whether the subscription can be synchronized through MicrosoftMicrosoft Synchronization Manager. enabled_for_syncmgrnvarchar (5), 기본값은 FALSE입니다.enabled_for_syncmgr is nvarchar(5), with a default of FALSE. 경우 false의 구독이 동기화 관리자에 등록 되지 않습니다.If false, the subscription is not registered with Synchronization Manager. 경우 true, 구독이 동기화 관리자에 등록 및 시작 하지 않고 동기화 할 수 SQL Server Management StudioSQL Server Management Studio합니다.If true, the subscription is registered with Synchronization Manager and can be synchronized without starting SQL Server Management StudioSQL Server Management Studio.

[ @ftp_address=] 'ftp_address'[ @ftp_address=] 'ftp_address'
이전 버전과의 호환성을 위해서만 지원됩니다.For backward compatibility only.

[ @ftp_port=] ftp_port[ @ftp_port=] ftp_port
이전 버전과의 호환성을 위해서만 지원됩니다.For backward compatibility only.

[ @ftp_login=] 'ftp_login'[ @ftp_login=] 'ftp_login'
이전 버전과의 호환성을 위해서만 지원됩니다.For backward compatibility only.

[ @ftp_password=] 'ftp_password'[ @ftp_password=] 'ftp_password'
이전 버전과의 호환성을 위해서만 지원됩니다.For backward compatibility only.

[ @alt_snapshot_folder= ] ' * * * alternate_snapshot_folder'*[ **@alt_snapshot_folder= ] 'alternate_snapshot_folder'
스냅숏의 대체 폴더 위치를 지정합니다.Specifies the location of the alternate folder for the snapshot. alternate_snapshot_foldernvarchar (255), 기본값은 NULL입니다.alternate_snapshot_folder is nvarchar(255), with a default of NULL.

[ @working_directory=] 'working_director'[ @working_directory= ] 'working_director'
게시용 데이터 및 스키마 파일을 저장하기 위해 사용하는 작업 디렉터리의 이름입니다.Is the name of the working directory used to store data and schema files for the publication. working_directorynvarchar (255), 기본값은 NULL입니다.working_directory is nvarchar(255), with a default of NULL. 이름은 UNC 형식으로 지정해야 합니다.The name should be specified in UNC format.

[ @use_ftp=] 'use_ftp'[ @use_ftp= ] 'use_ftp'
일반 프로토콜 대신 FTP를 사용하여 스냅숏을 검색하도록 지정합니다.Specifies the use of FTP instead of the regular protocol to retrieve snapshots. use_ftpnvarchar (5), 기본값은 FALSE입니다.use_ftp is nvarchar(5), with a default of FALSE.

[ @publication_type=] publication_type[ @publication_type= ] publication_type
게시의 복제 유형을 지정합니다.Specifies the replication type of the publication. publication_typetinyint 기본값인 0합니다.publication_type is a tinyint with a default of 0. 경우 0, 게시는 트랜잭션 유형입니다.If 0, publication is a transaction type. 경우 1, 게시는 스냅숏 유형입니다.If 1, publication is a snapshot type. 경우 2, 게시는 병합 유형입니다.If 2, publication is a merge type.

[ @dts_package_name=] 'dts_package_name'[ @dts_package_name= ] 'dts_package_name'
DTS 패키지의 이름을 지정합니다.Specifies the name of the DTS package. dts_package_namesysname 기본값은 NULL입니다.dts_package_name is a sysname with a default of NULL. 예를 들어 DTSPub_Package의 패키지를 지정하려면 매개 변수가 @dts_package_name = N'DTSPub_Package'여야 합니다.For example, to specify a package of DTSPub_Package, the parameter would be @dts_package_name = N'DTSPub_Package'.

[ @dts_package_password=] 'dts_package_password'[ @dts_package_password= ] 'dts_package_password'
패키지의 암호를 지정합니다.Specifies the password on the package, if there is one. dts_package_passwordsysname 이며 기본값은 NULL 의미 하는 패키지에 암호가 없습니다.dts_package_password is sysname with a default of NULL, which means a password is not on the package.

참고

경우에 암호를 지정 해야 dts_package_name 지정 됩니다.You must specify a password if dts_package_name is specified.

[ @dts_package_location=] 'dts_package_location'[ @dts_package_location= ] 'dts_package_location'
패키지 위치를 지정합니다.Specifies the package location. dts_package_locationnvarchar (12), 기본값은 구독자합니다.dts_package_location is a nvarchar(12), with a default of subscriber. 패키지의 위치 일 수 있습니다 배포자 또는 구독자합니다.The location of the package can be distributor or subscriber.

[ @reserved=] '예약'[ @reserved= ] 'reserved'
정보를 제공하기 위해서만 확인됩니다.Identified for informational purposes only. 지원되지 않습니다.Not supported. 향후 호환성은 보장되지 않습니다.Future compatibility is not guaranteed.

[ @offloadagent=] 'remote_agent_activation'[ @offloadagent= ] 'remote_agent_activation'

참고

원격 에이전트 활성화는 더 이상 사용되지 않으며 지원되지 않습니다.Remote agent activation has been deprecated and is no longer supported. 이 매개 변수는 이전 버전 스크립트와의 호환성을 유지하기 위한 목적으로만 지원됩니다.This parameter is supported only to maintain backward compatibility of scripts. 설정 remote_agent_activation 이외의 다른 값으로 false 오류가 생성 됩니다.Setting remote_agent_activation to a value other than false will generate an error.

[ @offloadserver=] 'remote_agent_server_name'[ @offloadserver= ] 'remote_agent_server_name'

참고

원격 에이전트 활성화는 더 이상 사용되지 않으며 지원되지 않습니다.Remote agent activation has been deprecated and is no longer supported. 이 매개 변수는 이전 버전 스크립트와의 호환성을 유지하기 위한 목적으로만 지원됩니다.This parameter is supported only to maintain backward compatibility of scripts. 설정 remote_agent_server_name NULL이 아닌 값으로 오류가 생성 됩니다.Setting remote_agent_server_name to any non-NULL value will generate an error.

[ @job_name=] 'job_name'[ @job_name= ] 'job_name'
기존 에이전트 작업의 이름입니다.Is the name of an existing agent job. job_namesysname, 기본값은 NULL입니다.job_name is sysname, with a default value of NULL. 이 매개 변수는 새로 만든 작업(기본값) 대신 기존 작업을 사용하여 구독이 동기화될 경우에만 지정됩니다.This parameter is only specified when the subscription will be synchronized using an existing job instead of a newly created job (the default). 구성원이 아닌 경우는 sysadmin 고정 서버 역할을 지정 해야 job_loginjob_password 지정 하는 경우 job_name.If you are not a member of the sysadmin fixed server role, you must specify job_login and job_password when you specify job_name.

[ @job_login=] 'job_login'[ @job_login= ] 'job_login'
에이전트 실행에 사용되는 Windows 계정의 로그인입니다.Is the login for the Windows account under which the agent runs. job_loginnvarchar (257), 기본값은 없습니다.job_login is nvarchar(257), with no default. 이 Windows 계정은 에이전트가 구독자에 연결할 때 항상 사용됩니다.This Windows account is always used for agent connections to the Subscriber.

[ @job_password=] 'job_password'[ @job_password= ] 'job_password'
에이전트 실행에 사용되는 Windows 계정의 암호입니다.Is the password for the Windows account under which the agent runs. job_passwordsysname, 기본값은 없습니다.job_password is sysname, with no default.

중요

가능한 경우 런타임 시 사용자에게 보안 자격 증명을 입력하라는 메시지가 표시됩니다.When possible, prompt users to enter security credentials at runtime. 자격 증명을 스크립트 파일에 저장해야 하는 경우에는 파일에 무단으로 액세스하지 못하도록 보안을 설정해야 합니다.If you must store credentials in a script file, you must secure the file to prevent unauthorized access.

반환 코드 값Return Code Values

0 (성공) 또는 1 (실패)0 (success) or 1 (failure)

주의Remarks

sp_addpullsubscription_agent 스냅숏 복제 및 트랜잭션 복제에 사용 됩니다.sp_addpullsubscription_agent is used in snapshot replication and transactional replication.

예제Example

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- Execute this batch at the Subscriber.
DECLARE @publication AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2012';

-- At the subscription database, create a pull subscription 
-- to a transactional publication.
USE [AdventureWorks2012Replica]
EXEC sp_addpullsubscription 
  @publisher = @publisher, 
  @publication = @publication, 
  @publisher_db = @publicationDB;

-- Add an agent job to synchronize the pull subscription.
EXEC sp_addpullsubscription_agent 
  @publisher = @publisher, 
  @publisher_db = @publicationDB, 
  @publication = @publication, 
  @distributor = @publisher, 
  @job_login = $(Login), 
  @job_password = $(Password);
GO

PermissionsPermissions

구성원만는 sysadmin 고정된 서버 역할 또는 db_owner 고정된 데이터베이스 역할을 실행할 수 있는 sp_addpullsubscription_agent합니다.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_addpullsubscription_agent.

관련 항목:See Also

끌어오기 구독 만들기 Create a Pull Subscription
게시 구독 Subscribe to Publications
sp_addpullsubscription (TRANSACT-SQL) sp_addpullsubscription (Transact-SQL)
sp_change_subscription_properties (TRANSACT-SQL) sp_change_subscription_properties (Transact-SQL)
sp_droppullsubscription (TRANSACT-SQL) sp_droppullsubscription (Transact-SQL)
sp_helppullsubscription (TRANSACT-SQL) sp_helppullsubscription (Transact-SQL)
sp_helpsubscription_properties(Transact-SQL)sp_helpsubscription_properties (Transact-SQL)