sp_changesub상태(Transact-SQL)

적용 대상:SQL ServerAzure SQL Managed Instance

기존 구독자의 상태를 변경합니다. 이 저장 프로시저는 게시 데이터베이스의 게시자에서 실행됩니다.

Transact-SQL 구문 표기 규칙

구문

  
sp_changesubstatus [ [ @publication = ] 'publication' ]  
    [ , [ @article = ] 'article' ]  
    [ , [ @subscriber = ] 'subscriber' ]  
        , [ @status = ] 'status'  
    [ , [ @previous_status = ] 'previous_status' ]  
    [ , [ @destination_db = ] 'destination_db' ]  
    [ , [ @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' ]  
    [ , [ @distribution_jobid = ] distribution_jobid ]  
    [ , [ @from_auto_sync = ] from_auto_sync ]  
    [ , [ @ignore_distributor = ] ignore_distributor ]  
    [ , [ @offloadagent= ] remote_agent_activation ]  
    [ , [ @offloadserver= ] 'remote_agent_server_name' ]  
    [ , [ @dts_package_name= ] 'dts_package_name' ]  
    [ , [ @dts_package_password= ] 'dts_package_password' ]  
    [ , [ @dts_package_location= ] dts_package_location ]  
    [ , [ @skipobjectactivation = ] skipobjectactivation  
  [ , [ @distribution_job_name= ] 'distribution_job_name' ]  
    [ , [ @publisher = ] 'publisher' ]  

인수

[ @publication = ] 'publication' 게시의 이름입니다. 게시는 sysname이며 기본값은 .입니다%. 게시를 지정하지 않으면 모든 게시가 영향을 받습니다.

[ @article = ] 'article' 아티클의 이름입니다. 게시에 고유해야 합니다. 아티클은 sysname이며 기본값은 .입니다%. 아티클을 지정하지 않으면 모든 아티클이 영향을 받습니다.

[ @subscriber = ] 'subscriber'상태 변경할 구독자의 이름입니다. 구독자는 sysname이며 기본값은 .입니다%. 구독자를 지정하지 않으면 모든 구독자에 대한 상태 지정된 아티클로 변경됩니다.

[ @status = ] 'status'syssubscriptions 테이블의 구독 상태. 상태 기본값이 없는 sysname이며 이러한 값 중 하나일 수 있습니다.

값	설명
active	구독자가 동기화되고 데이터를 수신하고 있습니다.
inactive	구독자 항목은 구독 없이 존재합니다.
가입	구독자가 데이터를 요청하지만 아직 동기화되지 않았습니다.

[ @previous_status = ] 'previous_status'구독에 대한 이전 상태. previous_상태 sysname이며 기본값은 NULL입니다. 이 매개 변수를 사용하면 현재 해당 상태 있는 모든 구독을 변경할 수 있으므로 특정 구독 집합에서 그룹 함수를 허용합니다(예: 모든 활성 구독을 다시 구독으로 설정).

[ @destination_db = ] 'destination_db' 대상 데이터베이스의 이름입니다. destination_db sysname이며 기본값은 .입니다%.

[ @frequency_type = ] frequency_type 배포 작업을 예약할 빈도입니다. frequency_type 기본값이 NULL인 int입니다.

[ @frequency_interval = ] frequency_intervalfrequency_type 설정된 빈도에 적용할 값입니다. frequency_interval 기본값이 NULL인 int입니다.

[ @frequency_relative_interval = ] frequency_relative_interval 배포 작업의 날짜입니다. 이 매개 변수는 frequency_type 32(월별 상대)로 설정된 경우에 사용됩니다. frequency_relative_interval int이며 이러한 값 중 하나일 수 있습니다.

값	Description
1	First
2	Second
4	세 번째
8	네 번째
16	마지막
NULL(기본값)

[ @frequency_recurrence_factor = ] frequency_recurrence_factorfrequency_type 사용되는 되풀이 요소입니다. frequency_recurrence_factor 기본값이 NULL인 int입니다.

[ @frequency_subday = ] frequency_subday 정의된 기간 동안 일정이 변경되는 빈도(분)입니다. frequency_subday int이며 이러한 값 중 하나일 수 있습니다.

값	Description
1	한 번
2	Second
4	Minute
8	Hour
NULL(기본값)

[ @frequency_subday_interval = ] frequency_subday_intervalfrequency_subday 간격입니다. frequency_subday_interval 기본값이 NULL인 int입니다.

[ @active_start_time_of_day = ] active_start_time_of_day 배포 작업이 처음 예약되고 형식 HHmmss이 지정된 시간입니다. active_start_time_of_day 기본값이 NULL인 int입니다.

[ @active_end_time_of_day = ] active_end_time_of_day 배포 작업이 예약되지 않고 형식 HHmmss이 지정된 하루 중 시간입니다. active_end_time_of_day 기본값이 NULL인 int입니다.

[ @active_start_date = ] active_start_date 배포 작업이 처음 예약되고 형식 yyyyMMdd이 지정된 날짜입니다. active_start_date 기본값이 NULL인 int입니다.

[ @active_end_date = ] active_end_date 배포 태스크의 예약이 중지되고 형식이 지정된 날짜입니다 yyyyMMdd. active_end_date 기본값이 NULL인 int입니다.

[ @optional_command_line = ] 'optional_command_line' 선택적 명령 프롬프트입니다. optional_command_line nvarchar(4000)이며 기본값은 NULL입니다.

[ @distribution_jobid = ] distribution_jobid구독 상태 비활성에서 활성으로 변경할 때 구독 배포자에서 배포 에이전트 작업 ID입니다. 다른 경우에는 정의되지 않습니다. 이 저장 프로시저에 대한 단일 호출에 둘 이상의 배포 에이전트 관련된 경우 결과가 정의되지 않습니다. distribution_jobid 이진(16)이며 기본값은 NULL입니다.

[ @from_auto_sync = ] from_auto_sync

정보를 제공하기 위해서만 확인됩니다. 지원 안 됨 향후 호환성은 보장되지 않습니다.

[ @ignore_distributor = ] ignore_distributor

정보를 제공하기 위해서만 확인됩니다. 지원 안 됨 향후 호환성은 보장되지 않습니다.

[ @offloadagent = ] remote_agent_activation

참고 항목

원격 에이전트 활성화는 더 이상 사용되지 않으며 더 이상 지원되지 않습니다. 이 매개 변수는 이전 버전 스크립트와의 호환성을 유지하기 위한 목적으로만 지원됩니다. remote_agent_activation 0이 아닌 값으로 설정하면 오류가 발생합니다.

[ @offloadserver = ] 'remote_agent_server_name'

참고 항목

원격 에이전트 활성화는 더 이상 사용되지 않으며 더 이상 지원되지 않습니다. 이 매개 변수는 이전 버전 스크립트와의 호환성을 유지하기 위한 목적으로만 지원됩니다. remote_agent_server_name NULL이 아닌 값으로 설정하면 오류가 발생합니다.

[ @dts_package_name = ] 'dts_package_name' DTS(데이터 변환 서비스) 패키지의 이름을 지정합니다. dts_package_name 기본값이 NULL인 sysname입니다. 예를 들어 DTSPub_Package 패키지에 대해 지정@dts_package_name = N'DTSPub_Package'합니다.

[ @dts_package_password = ] 'dts_package_password' 패키지의 암호를 지정합니다. dts_package_password 기본값이 NULL인 sysname이며 암호 속성은 변경되지 않은 상태로 유지되도록 지정합니다.

참고 항목

DTS 패키지에는 암호가 있어야 합니다.

[ @dts_package_location = ] dts_package_location 패키지 위치를 지정합니다. dts_package_location 기본값이 0인 int입니다. 0이면 패키지 위치가 배포자에 있습니다. 1이면 패키지 위치가 구독자에 있습니다. 패키지의 위치는 배포자 또는 구독자일 수 있습니다.

[ @skipobjectactivation = ] skipobjectactivation

정보를 제공하기 위해서만 확인됩니다. 지원 안 됨 향후 호환성은 보장되지 않습니다.

[ @distribution_job_name = ] 'distribution_job_name' 배포 작업의 이름입니다. distribution_job_name sysname이며 기본값은 NULL입니다.

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

참고 항목

SQL Server 게시자의 아티클 속성을 변경할 때는 게시 자를 사용하면 안 됩니다.

반환 코드 값

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

설명

sp_changesub상태 스냅샷 복제본(replica) 및 트랜잭션 복제본(replica) 사용됩니다.

sp_changesub상태 변경된 상태 syssubscriptions 테이블에서 구독자의 상태 변경합니다. 필요한 경우 sysarticles 테이블의 아티클 상태 업데이트하여 활성 또는 비활성 상태를 나타냅니다. 필요한 경우 복제본(replica)ted 테이블에 대한 sysobjects 테이블에서 복제본(replica)tion 플래그를 설정하거나 해제합니다.

사용 권한

sysadmin 고정 서버 역할의 멤버, db_owner 고정 데이터베이스 역할 또는 구독 작성자만 sp_changesub상태 실행할 수 있습니다.

참고 항목

sp_addsubscription(Transact-SQL)
sp_dropsubscription(Transact-SQL)
sp_helpdistributor(Transact-SQL)
sp_helpsubscription(Transact-SQL)
시스템 저장 프로시저(Transact-SQL)