sp_addmergepullsubscription_agent(Transact-SQL)sp_addmergepullsubscription_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 agent job used to schedule synchronization of a pull subscription to a merge publication. 이 저장 프로시저는 구독 데이터베이스의 구독자에서 실행됩니다.This stored procedure is executed at the Subscriber on the subscription database.

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

구문Syntax


sp_addmergepullsubscription_agent [ [ @name = ] 'name' ]   
        , [ @publisher = ] 'publisher'   
        , [ @publisher_db = ] 'publisher_db'  
        , [ @publication =] 'publication'   
    [ , [ @publisher_security_mod e= ] publisher_security_mode ]   
    [ , [ @publisher_login = ] 'publisher_login' ]   
    [ , [ @publisher_password = ] 'publisher_password' ]   
    [ , [ @publisher_encrypted_password = ] publisher_encrypted_password ]   
    [ , [ @subscriber = ] 'subscriber' ]   
    [ , [ @subscriber_db = ] 'subscriber_db' ]   
    [ , [ @subscriber_security_mode = ] subscriber_security_mode ]   
    [ , [ @subscriber_login = ] 'subscriber_login' ]   
    [ , [ @subscriber_password= ] 'subscriber_password' ]   
    [ , [ @distributor = ] 'distributor' ]   
    [ , [ @distributor_security_mode = ] distributor_security_mode ]   
    [ , [ @distributor_login = ] 'distributor_login' ]   
    [ , [ @distributor_password = ] 'distributor_password' ]   
    [ , [ @encrypted_password = ] encrypted_password ]   
    [ , [ @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 ]   
    [ , [ @optional_command_line = ] 'optional_command_line' ]   
    [ , [ @merge_jobid = ] merge_jobid ]   
    [ , [ @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' ]   
    [ , [ @reserved = ] 'reserved' ]   
    [ , [ @use_interactive_resolver = ] 'use_interactive_resolver' ]   
    [ , [ @offloadagent = ] 'remote_agent_activation' ]   
    [ , [ @offloadserver = ] 'remote_agent_server_name']   
    [ , [ @job_name = ] 'job_name' ]   
    [ , [ @dynamic_snapshot_location = ] 'dynamic_snapshot_location' ]  
    [ , [ @use_web_sync = ] use_web_sync ]  
        [ , [ @internet_url = ] 'internet_url' ]  
    [ , [ @internet_login = ] 'internet_login' ]  
        [ , [ @internet_password = ] 'internet_password' ]  
    [ , [ @internet_security_mode = ] internet_security_mode ]  
        [ , [ @internet_timeout = ] internet_timeout ]  
    [ , [ @hostname = ] 'hostname' ]  
        [ , [ @job_login = ] 'job_login' ]   
    [ , [ @job_password = ] 'job_password' ]   

인수Arguments

[ @name = ] 'name'[ @name = ] 'name'
에이전트의 이름입니다.Is the name of the agent. 이름sysname, 기본값은 NULL입니다.name is sysname, with a default of NULL.

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

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

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

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

중요

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

[ @publisher_login = ] 'publisher_login'[ @publisher_login = ] 'publisher_login'
동기화 시 게시자에 연결하는 데 사용할 로그인입니다.Is the login to use when connecting to a Publisher when synchronizing. publisher_loginsysname, 기본값은 NULL입니다.publisher_login is sysname, with a default of NULL.

[ @publisher_password = ] 'publisher_password'[ @publisher_password = ] 'publisher_password'
게시자에 연결할 때 사용하는 암호입니다.Is the password used when connecting to the Publisher. publisher_passwordsysname, 기본값은 NULL입니다.publisher_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.

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

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

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

[ @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, 기본값은 1입니다.subscriber_security_mode is int, with a default of 1. 경우 0, 지정 SQL ServerSQL Server 인증 합니다.If 0, specifies SQL ServerSQL Server Authentication. 경우 1, Windows 인증을 지정 합니다.If 1, specifies Windows Authentication.

참고

이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다.This parameter has been deprecated and is maintained for backward compatibility of scripts. 병합 에이전트는 항상 Windows 인증을 사용해 로컬 구독자로 연결됩니다.The Merge Agent always connects to the local Subscriber using Windows Authentication. 이 매개 변수의 값을 지정하면 경고 메시지가 반환되고 값은 무시됩니다.If a value is specified for this parameter, a warning message will be returned, but the value will be ignored.

[ @subscriber_login = ] 'subscriber_login'[ @subscriber_login = ] 'subscriber_login'
동기화 시 구독자에 연결하는 데 사용할 구독자 로그인입니다.Is the Subscriber login to use when connecting to a Subscriber when synchronizing. subscriber_login 경우 필요한 subscriber_security_mode 로 설정 된 0합니다.subscriber_login is required if subscriber_security_mode is set to 0. subscriber_loginsysname, 기본값은 NULL입니다.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 will be returned, but the value will be ignored.

[ @subscriber_password = ] 'subscriber_password'[ @subscriber_password = ] 'subscriber_password'
SQL ServerSQL Server 인증을 위한 구독자 암호입니다.Is the Subscriber password for SQL ServerSQL Server Authentication. 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.

참고

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

[ @distributor = ] '배포자'[ @distributor = ] 'distributor'
배포자의 이름입니다.Is the name of the Distributor. 배포자sysname, 기본값은 게시자; 즉, 게시자가 배포자 역할도 합니다.distributor is sysname, with a default of publisher; that is, the Publisher is also the Distributor.

[ @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, 기본값은 0입니다.distributor_security_mode is int, with a default of 0. 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.

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

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

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

참고

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

[ @frequency_interval = ] frequency_interval[ @frequency_interval = ] frequency_interval
병합 에이전트가 실행되는 요일입니다.The day or days that the Merge Agent runs. frequency_intervalint, 다음이 값 중 하나일 수 있습니다.frequency_interval is int, and can be one of these values.

ValueValue 설명Description
11 일요일Sunday
22 월요일Monday
33 화요일Tuesday
44 수요일Wednesday
55 목요일Thursday
66 금요일Friday
77 토요일Saturday
88 DayDay
99 평일Weekdays
1010 주말Weekend days
NULL(기본값)NULL (default)

[ @frequency_relative_interval = ] frequency_relative_interval[ @frequency_relative_interval = ] frequency_relative_interval
병합 에이전트의 날짜입니다.Is the date of the Merge 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 these values.

ValueValue 설명Description
11 첫째First
22 둘째Second
44 셋째Third
88 넷째Fourth
1616 마지막Last
NULL(기본값)NULL (default)

[ @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, 기본값은 NULL입니다.frequency_recurrence_factor is int, with a default of NULL.

[ @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 these values.

ValueValue 설명Description
11 한 번Once
22 둘째Second
44 MinuteMinute
88 HourHour
NULL(기본값)NULL (default)

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

[ @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 Merge Agent is first scheduled, formatted as HHMMSS. active_start_time_of_dayint, 기본값은 NULL입니다.active_start_time_of_day is int, with a default of NULL.

[ @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 Merge Agent stops being scheduled, formatted as HHMMSS. active_end_time_of_dayint, 기본값은 NULL입니다.active_end_time_of_day is int, with a default of NULL.

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

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

[ @optional_command_line = ] 'optional_command_line'[ @optional_command_line = ] 'optional_command_line'
병합 에이전트에 제공되는 선택적 명령 프롬프트입니다.Is an optional command prompt that is supplied to the Merge Agent. optional_command_linenvarchar (255), 기본값은 ' '.optional_command_line is nvarchar(255), with a default of ' '. 병합 에이전트에 추가 매개 변수를 제공하는 데 사용할 수 있으며 다음 예에서는 기본 쿼리 제한 시간을 600초로 늘립니다.Can be used to supply additional parameters to the Merge Agent, such as in the following example that increases the default query time-out to 600 seconds:

@optional_command_line = N'-QueryTimeOut 600'  

[ @merge_jobid = ] merge_jobid[ @merge_jobid = ] merge_jobid
작업 ID의 출력 매개 변수입니다.Is the output parameter for the job ID. merge_jobidbinary (16), 기본값은 NULL입니다.merge_jobid is binary(16), with a default of NULL.

[ @enabled_for_syncmgr = ] 'enabled_for_syncmgr'[ @enabled_for_syncmgr = ] 'enabled_for_syncmgr'
Windows 동기화 관리자를 통해 구독을 동기화할 수 있는지 여부를 지정합니다.Specifies if the subscription can be synchronized through Windows 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 from which to pick up the snapshot files. alternate_snapshot_foldernvarchar (255), 기본값은 NULL입니다.alternate_snapshot_folder is nvarchar(255), with a default of NULL. NULL인 경우 게시자가 지정한 기본 위치에 스냅숏이 선택됩니다.If NULL, the snapshot files will be picked up from the default location specified by the Publisher.

[ @working_directory = ] 'working_directory'[ @working_directory = ] 'working_directory'
FTP를 사용하여 스냅숏 파일을 전송할 때 게시에 있는 스키마 파일 및 데이터를 임시로 저장하는 데 사용하는 작업 디렉터리의 이름입니다.Is the name of the working directory used to temporarily store data and schema files for the publication when FTP is used to transfer snapshot files. working_directorynvarchar (255), 기본값은 NULL입니다.working_directory is nvarchar(255), with a default of NULL.

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

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

[ @use_interactive_resolver = ] 'use_interactive_resolver' ][ @use_interactive_resolver = ] 'use_interactive_resolver' ]
대화형 해결을 허용하는 모든 아티클의 충돌을 해결하기 위해 대화형 해결 프로그램을 사용합니다.Uses interactive resolver to resolve conflicts for all articles that allow interactive resolution. use_interactive_resolvernvarchar (5), 기본값은 FALSE입니다.use_interactive_resolver is nvarchar(5), with a default of FALSE.

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

[ @dynamic_snapshot_location = ] 'dynamic_snapshot_location' ][ @dynamic_snapshot_location = ] 'dynamic_snapshot_location' ]
필터링된 데이터 스냅숏을 사용하는 경우에 스냅숏 파일을 읽을 대상 폴더 경로입니다.The path to the folder where the snapshot files will be read from if a filtered data snapshot is to be used. dynamic_snapshot_locationnvarchar (260), 기본값은 NULL입니다.dynamic_snapshot_location is nvarchar(260), with a default of NULL. 자세한 내용은 Parameterized Row Filters를 참조하세요.For more information, see Parameterized Row Filters.

[ @use_web_sync = ] use_web_sync[ @use_web_sync = ] use_web_sync
웹 동기화를 사용할 수 있음을 나타냅니다.Indicates that Web synchronization is enabled. use_web_sync비트, 기본값은 0입니다.use_web_sync is bit, with a default of 0. 1 HTTP를 사용 하 여 인터넷을 통해 끌어오기 구독을 동기화 할 수 있음을 지정 합니다.1 specifies that the pull subscription can be synchronized over the internet using HTTP.

[ @internet_url = ] 'internet_url'[ @internet_url = ] 'internet_url'
웹 동기화용 복제 수신기(REPLISAPI.DLL)의 위치입니다.Is the location of the replication listener (REPLISAPI.DLL) for Web synchronization. internet_urlnvarchar (260), 기본값은 NULL입니다.internet_url is nvarchar(260), with a default of NULL. internet_url 형식의 정규화 된 URL은 http://server.domain.com/directory/replisapi.dll합니다.internet_url is a fully qualified URL, in the format http://server.domain.com/directory/replisapi.dll. 서버가 포트 80 이외의 다른 포트에서 수신하도록 구성된 경우 포트 번호도 http://server.domain.com:portnumber/directory/replisapi.dll 형식으로 제공되어야 합니다. 여기서 portnumber는 포트를 나타냅니다.If the server is configured to listen on a port other than port 80, the port number must also be supplied in the format http://server.domain.com:portnumber/directory/replisapi.dll, where portnumber represents the port.

[ @internet_login = ] 'internet_login'[ @internet_login = ] 'internet_login'
병합 에이전트가 HTTP 기본 인증을 사용하여 웹 동기화를 호스팅하는 웹 서버에 연결할 때 사용하는 로그인입니다.Is the login that the Merge Agent uses when connecting to the Web server that is hosting Web synchronization using HTTP Basic Authentication. internet_loginsysname, 기본값은 NULL입니다.internet_login is sysname, with a default of NULL.

[ @internet_password = ] 'internet_password'[ @internet_password = ] 'internet_password'
병합 에이전트가 HTTP 기본 인증을 사용하여 웹 동기화를 호스팅하는 웹 서버에 연결할 때 사용하는 암호입니다.Is the password that the Merge Agent uses when connecting to the Web server that is hosting Web synchronization using HTTP Basic Authentication. internet_passwordnvarchar (524), 기본값은 NULL입니다.internet_password is nvarchar(524), with a default value of NULL.

중요

빈 암호를 사용하지 마세요.Do not use a blank password. 강력한 암호를 사용하세요.Use a strong password.

[ @internet_security_mode = ] internet_security_mode[ @internet_security_mode = ] internet_security_mode
HTTPS를 사용하여 웹 동기화 동안 웹 서버에 연결할 때 병합 에이전트에서 사용하는 인증 방법입니다.Is the authentication method used by the Merge Agent when connecting to the Web server during Web synchronization using HTTPS. internet_security_modeint 이며 다음이 값 중 하나일 수 있습니다.internet_security_mode is int and can be one of these values.

ValueValue 설명Description
00 기본 인증이 사용됩니다.Basic Authentication is used.
1 (기본값)1 (default) Windows 통합 인증이 사용됩니다.Windows Integrated Authentication is used.

참고

웹 동기화에는 기본 인증을 사용하는 것이 좋습니다.We recommend using Basic Authentication with Web synchronization. 웹 동기화를 사용하려면 웹 서버에 SSL 연결을 해야 합니다.To use Web synchronization, you must make an SSL connection to the Web server. 자세한 내용은 웹 동기화 구성을 참조하세요.For more information, see Configure Web Synchronization.

[ @internet_timeout = ] internet_timeout[ @internet_timeout = ] internet_timeout
웹 동기화 요청이 만료되기 전까지의 시간(초)입니다.Is the length of time, in seconds, before a Web synchronization request expires. internet_timeoutint, 기본값은 300 초입니다.internet_timeout is int, with a default of 300 seconds.

[ @hostname = ] 'hostname'[ @hostname = ] 'hostname'
이 함수가 매개 변수가 있는 필터의 WHERE 절에 사용되는 경우 HOST_NAME()의 값보다 우선합니다.Overrides the value of HOST_NAME() when this function is used in the WHERE clause of a parameterized filter. 호스트 이름sysname, 기본값은 NULL입니다.hostname is sysname, with a default of NULL.

[ @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 계정은 Windows 통합 인증을 사용하는 경우 에이전트를 구독자에 연결하고 배포자 및 게시자에 연결할 때 항상 사용됩니다.This Windows account is always used for agent connections to the Subscriber and for connections to the Distributor and Publisher when using Windows Integrated authentication.

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

중요

스크립트 파일에 인증 정보를 저장하지 않도록 합니다.Do not store authentication information in script files. 최상의 보안을 위해 런타임에 로그인 이름과 암호를 제공해야 합니다.For best security, login names and passwords should be supplied at runtime.

반환 코드 값Return Code Values

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

주의Remarks

sp_addmergepullsubscription_agent 병합 복제에 사용 되 고와 유사한 기능을 사용 하 여 sp_addpullsubscription_agent합니다.sp_addmergepullsubscription_agent is used in merge replication and uses functionality similar to sp_addpullsubscription_agent.

실행할 때 보안 설정을 올바르게 지정 하는 방법의 예에 대 한 sp_addmergepullsubscription_agent, 참조 Create a Pull Subscription합니다.For an example of how to correctly specify security settings when executing sp_addmergepullsubscription_agent, see Create a Pull Subscription.

예제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;
DECLARE @hostname AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2012';
SET @hostname = N'adventure-works\david8';

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

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

PermissionsPermissions

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

관련 항목:See Also

끌어오기 구독 만들기 Create a Pull Subscription
게시 구독 Subscribe to Publications
sp_addmergepullsubscription (TRANSACT-SQL) sp_addmergepullsubscription (Transact-SQL)
sp_changemergepullsubscription (TRANSACT-SQL) sp_changemergepullsubscription (Transact-SQL)
sp_dropmergepullsubscription (TRANSACT-SQL) sp_dropmergepullsubscription (Transact-SQL)
sp_helpmergepullsubscription (TRANSACT-SQL) sp_helpmergepullsubscription (Transact-SQL)
sp_helpsubscription_properties(Transact-SQL)sp_helpsubscription_properties (Transact-SQL)