sp_addsubscriber(Transact-SQL)

새 구독자를 게시자에 추가하여 게시한 내용을 받을 수 있도록 합니다. 이 저장 프로시저는 스냅숏 및 트랜잭션 게시를 위한 게시 데이터베이스의 게시자에서 실행됩니다. 원격 배포자를 사용하는 병합 게시의 경우에는 이 저장 프로시저가 배포자에서 실행됩니다.

중요 정보중요

이 저장 프로시저는 더 이상 사용되지 않습니다. 더 이상 게시자에서 구독자를 명시적으로 등록할 필요가 없습니다.

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

sp_addsubscriber [ @subscriber = ] 'subscriber'
    [ , [ @type = ] type ] 
    [ , [ @login = ] 'login' ]
    [ , [ @password = ] 'password' ]
    [ , [ @commit_batch_size = ] commit_batch_size ]
    [ , [ @status_batch_size = ] status_batch_size ]
    [ , [ @flush_frequency = ] flush_frequency ]
    [ , [ @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 ]
    [ , [ @description = ] 'description' ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @encrypted_password = ] encrypted_password ]
    [ , [ @publisher = ] 'publisher' ]

인수

  • [ @subscriber=] 'subscriber'
    이 서버의 게시에 유효한 구독자로 추가되는 서버의 이름입니다. subscriber는 sysname이며 기본값은 없습니다.

  • [ @type=] type
    구독자의 유형입니다. type은 tinyint이며 다음 값 중 하나일 수 있습니다.

    설명

    0(기본값)

    Microsoft SQL Server 구독자

    1

    ODBC 데이터 원본 서버

    2

    Microsoft Jet 데이터베이스

    3

    OLE DB 공급자

  • [ @login=] 'login'
    SQL Server 인증에 대한 로그인 ID입니다. login은 sysname이며 기본값은 NULL입니다.

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @password = ] 'password'
    SQL Server 인증에 대한 암호입니다. password는 nvarchar(524)이며 기본값은 NULL입니다.

    보안 정보보안 정보

    빈 암호를 사용하지 마십시오. 강력한 암호를 사용하십시오.

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @commit_batch_size=] commit_batch_size
    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다.

    [!참고]

    값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @status_batch_size=] status_batch_size
    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다.

    [!참고]

    값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @flush_frequency=] flush_frequency
    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다.

    [!참고]

    값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @frequency_type = ] frequency_type
    복제 에이전트를 예약하는 빈도입니다. frequency_type은 int이며 다음 값 중 하나일 수 있습니다.

    설명

    1

    한 번

    2

    요청 시

    4

    매일

    8

    매주

    16

    매월

    32

    매월 상대적

    64(기본값)

    자동 시작

    128

    되풀이

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [@frequency_interval= ] frequency_interval
    frequency_type에서 설정된 빈도에 적용되는 값입니다. frequency_interval은 int이며 기본값은 1입니다.

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @frequency_relative_interval = ]frequency_relative_interval
    복제 에이전트의 날짜입니다. 이 매개 변수는 frequency_type이 32(매월 상대적)로 설정되어 있을 때 사용됩니다. frequency_relative_interval은 int이며 다음 값 중 하나일 수 있습니다.

    설명

    1(기본값)

    첫째

    2

    둘째

    4

    셋째

    8

    넷째

    16

    마지막

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @frequency_recurrence_factor = ] frequency_recurrence_factor
    frequency_type에 사용되는 되풀이 비율입니다. frequency_recurrence_factor는 int이며 기본값은 0입니다.

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @frequency_subday = ]frequency_subday
    정의된 기간 동안 다시 예약하는 빈도입니다. frequency_subday는 int이며 다음 값 중 하나일 수 있습니다.

    설명

    1

    한 번

    2

    4(기본값)

    8

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @frequency_subday_interval = ]frequency_subday_interval
    frequency_subday에 대한 간격입니다. frequency_subday_interval은 int이며 기본값은 5입니다.

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @active_start_time_of_day = ] active_start_time_of_day
    하루 중에서 복제 에이전트가 처음으로 실행되도록 예약된 시간이며 HHMMSS 형식으로 표시됩니다. active_start_time_of_day는 int이며 기본값은 0입니다.

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @active_end_time_of_day = ] active_end_time_of_day
    하루 중에서 복제 에이전트가 마지막으로 실행되도록 예약된 시간이며 HHMMSS 형식으로 표시됩니다. active_end_time_of_day는 int이며 기본값은 24시간 시계를 기준으로 하여 11:59:59 P.M.을 의미하는 235959입니다.

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @active_start_date = ] active_start_date
    복제 에이전트가 처음으로 실행되도록 예약된 날짜이며 YYYYMMDD 형식으로 표시됩니다. active_start_date는 int이며 기본값은 0입니다.

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @active_end_date = ] active_end_date
    복제 에이전트가 마지막으로 실행되도록 예약된 날짜이며 YYYYMMDD 형식으로 표시됩니다. active_end_date는 int이며 기본값은 9999년 12월 31일을 의미하는 99991231입니다.

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @description =] 'description'
    구독자의 텍스트 설명입니다. description은 nvarchar(255)이며 기본값은 NULL입니다.

  • [ @security_mode=] security_mode
    구현된 보안 모드입니다. security_mode는 int이며 기본값은 1입니다. 0은 SQL Server 인증을 나타내며 1은 Windows 인증을 지정합니다.

    [!참고]

    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 유지 관리됩니다. 이 속성은 이제 sp_addsubscription을 실행할 때 구독 단위로 지정됩니다. 값을 지정하면 해당 값은 이 구독자에서 구독을 만들 때 기본값으로 사용되며 경고 메시지가 반환됩니다.

  • [ @encrypted_password=] encrypted_password
    이 매개 변수는 더 이상 사용되지 않으며 encrypted_password를 임의의 값으로 설정하는 이전 버전과의 호환성을 위해서만 제공되지만 0을 지정하면 오류가 발생합니다.

  • [ @publisher = ] 'publisher'
    SQL Server 이외 게시자를 지정합니다. publisher는 sysname이며 기본값은 NULL입니다.

    [!참고]

    SQL Server 게시자에서 게시할 때는 publisher를 사용하면 안 됩니다.

반환 코드 값

0(성공) 또는 1(실패)

주의

sp_addsubscriber는 스냅숏 복제, 트랜잭션 복제 및 병합 복제에 사용합니다.

구독자에 병합 게시에 대한 익명 구독만 있으면 sp_addsubscriber가 필요하지 않습니다.

sp_addsubscriberdistribution 데이터베이스의 MSsubscriber_info 테이블에 작성합니다.

사용 권한

sysadmin 고정 서버 역할의 멤버만 sp_addsubscriber를 실행할 수 있습니다.