sp_MSchange_snapshot_agent_properties(Transact-SQL)

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

항목 링크 아이콘 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 게시자에 대해 0 값을 지정해야 합니다. 가능하면 Windows 인증을 사용하십시오.

  • [ *@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 이외 게시자에 대해서는 변경할 수 없습니다.

  • [ **@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)