sp_MSchange_snapshot_agent_properties(Transact-SQL)

Microsoft SQL Server 2005 배포자에서 실행되는 스냅숏 에이전트 작업의 속성을 변경합니다. 이 저장 프로시저는 Microsoft SQL Server 2000 인스턴스에서 게시자가 실행될 때 SQL Server 2005 속성을 변경하는 데 사용됩니다. 이 저장 프로시저는 배포 데이터베이스의 배포자에서 실행됩니다.

Transact-SQL 구문 표기 규칙

구문

sp_MSchange_snapshot_agent_properties [ @publisher = ] 'publisher'
        , [ @publisher_db = ] 'publisher_db'
        , [ @publication = ] 'publication' 
        , [ @frequency_type= ] frequency_type
        , [ @frequency_interval= ] frequency_interval
        , [ @frequency_subday= ] frequency_subday
        , [ @frequency_subday_interval= ] frequency_subday_interval
        , [ @frequency_relative_interval= ] frequency_relative_interval
        , [ @frequency_recurrence_factor= ] frequency_recurrence_factor
        , [ @active_start_date= ] active_start_date
        , [ @active_end_date= ] active_end_date
        , [ @active_start_time_of_day= ] active_start_time_of_day
        , [ @active_end_time_of_day= ] active_end_time_of_day
        , [ @snapshot_job_name = ] 'snapshot_agent_name'
        , [ @publisher_security_mode = ] publisher_security_mode
        , [ @publisher_login = ] 'publisher_login'
        , [ @publisher_password = ] 'publisher_password' 
        , [ @job_login = ] 'job_login'
        , [ @job_password = ] 'job_password'
        , [ @publisher_type = ] 'publisher_type'

인수

• [ @publisher = ] 'publisher'
  게시자의 이름입니다. publisher는 sysname이며 기본값은 없습니다.

• [ @publisher_db= ] 'publisher_db'
  게시 데이터베이스의 이름입니다. publisher_db는 sysname이며 기본값은 없습니다.

• [ @publication = ] 'publication'
  게시의 이름입니다. publication은 sysname이며 기본값은 없습니다.

• [ @frequency_type = ] frequency_type
  스냅숏 에이전트가 실행되는 빈도입니다. frequency_type은 int이며 다음 값 중 하나일 수 있습니다.

  값	설명
  1	한 번
  2	요청 시
  4	매일
  8	매주
  10	매월
  20	매월(frequency_interval에 따라 달라짐)
  40	SQL Server 에이전트가 시작될 때

• [ @frequency_interval = ] frequency_interval
  frequency_type으로 설정한 빈도에 적용할 값입니다. frequency_interval은 int이며 기본값은 없습니다.

• [ @frequency_subday = ]frequency_subday
  freq_subday_interval의 단위입니다. frequency_subday는 int이며 다음 값 중 하나일 수 있습니다.

  값	설명
  1	한 번
  2	초
  4	분
  8	시간

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

• [ @frequency_relative_interval = ]frequency_relative_interval
  스냅숏 에이전트가 실행되는 날짜입니다. frequency_relative_interval은 int이며 기본값은 없습니다.

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

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

• [ @active_end_date = ] active_end_date
  스냅숏 에이전트가 마지막으로 실행되도록 예약된 날짜이며 YYYYMMDD 형식으로 표시됩니다. active_end_date는 int이며 기본값은 없습니다.

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

• [ @active_end_time_of_day = ] active_end_time_of_day
  하루 중에서 스냅숏 에이전트가 마지막으로 실행되도록 예약된 시간이며 HHMMSS 형식으로 표시됩니다. active_end_time_of_day는 int이며 기본값은 없습니다.

• [ @snapshot_job_name = ] 'snapshot_agent_name'
  기존 작업이 사용되고 있을 때 기존 스냅숏 에이전트 작업의 이름입니다. snapshot_agent_name은 **nvarchar(100)**이며 기본값은 없습니다.

• [ @publisher_security_mode= ] publisher_security_mode
  게시자에 연결할 때 에이전트가 사용하는 보안 모드입니다. publisher_security_mode는 int이며 기본값은 없습니다. 0은 SQL Server 인증을 지정하고 1은 Windows 인증을 지정합니다. 비-SQL Server(Non-SQL Server) 게시자에 대해서는 값 0을 지정해야 합니다.

• [ @publisher_login= ] 'publisher_login'
  게시자에 연결할 때 사용되는 로그인입니다. publisher_login은 sysname이며 기본값은 없습니다. publisher_security_mode가 0일 때는 publisher_login을 지정해야 합니다. publisher_login이 NULL이고 publisher*_security_mode*가 1이면 게시자에 연결할 때 job_login에 지정된 Windows 계정이 사용됩니다.

• [ @publisher_password= ] 'publisher_password'
  게시자에 연결할 때 사용되는 암호입니다. publisher_password는 **nvarchar(524)**이며 기본값은 없습니다.

  보안 정보:
  스크립트 파일에 인증 정보를 저장하지 않도록 합니다. 최상의 보안을 위해서는 런타임에 로그인 이름과 암호를 제공해야 합니다.

• [ @job_login= ] 'job_login'
  에이전트가 실행되는 Windows 계정의 로그인입니다. job_login은 **nvarchar(257)이며 기본값은 없습니다. 이 Windows 계정은 에이전트가 배포자에 연결할 때 항상 사용됩니다. 새 스냅숏 에이전트 작업을 만들 때는 이 매개 변수를 제공해야 합니다. 비-SQL Server(Non-SQL Server) 게시자에 대해서는 변경할 수 없습니다.

• [ @job_password= ] 'job_password'
  에이전트가 실행되는 Windows 계정의 암호입니다. job_password는 sysname이며 기본값은 없습니다. 새 스냅숏 에이전트 작업을 만들 때는 이 매개 변수를 제공해야 합니다.

  보안 정보:
  스크립트 파일에 인증 정보를 저장하지 않도록 합니다. 최상의 보안을 위해서는 런타임에 로그인 이름과 암호를 제공해야 합니다.

• [ @publisher_type= ] 'publisher_type'
  SQL Server 인스턴스에서 게시자가 실행되고 있지 않을 때 게시자 유형을 지정합니다. publisher_type은 sysname이며 다음 값 중 하나일 수 있습니다.

  값	설명
  MSSQLSERVER	SQL Server 게시자를 지정합니다.
  ORACLE	표준 Oracle 게시자를 지정합니다.
  ORACLE GATEWAY	Oracle Gateway 게시자를 지정합니다.

  Oracle 게시자와 Oracle Gateway 게시자의 차이점에 대한 자세한 내용은 Oracle 게시 개요를 참조하십시오.

반환 코드 값

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

주의

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

sp_MSchange_snapshot_agent_properties를 실행할 때는 모든 매개 변수를 지정해야 합니다. 스냅숏 에이전트 작업의 현재 속성을 반환하려면 sp_helppublication_snapshot을 실행합니다.

게시자가 SQL Server 2005 인스턴스에서 실행될 때 스냅숏 에이전트 작업의 속성을 변경하려면 sp_changepublication_snapshot을 사용해야 합니다.

사용 권한

배포자에서 sysadmin 고정 서버 역할의 멤버만 sp_MSchange_snapshot_agent_properties를 실행할 수 있습니다.

참고 항목

참조

sp_addpublication_snapshot(Transact-SQL)

관련 자료

복제 토폴로지에 SQL Server의 여러 버전 사용

도움말 및 정보

SQL Server 2005 지원 받기