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

    每月,相對於頻率間隔

    40

    當 SQL Server Agent 啟動時

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