共用方式為

sp_syscollector_create_collection_set (Transact-SQL)

  • 發行項

適用於：SQL Server

建立新的收集組。 您可以使用這個預存程式來建立資料收集的自訂收集組。

警告

如果設定為 Proxy 的 Windows 帳戶是尚未登入的非互動式或互動式使用者，配置檔目錄將不會存在，而且建立預備目錄將會失敗。 因此，如果您在域控制器上使用 Proxy 帳戶，您必須指定至少使用過一次的互動式帳戶，以確保已建立設定文件目錄。

Transact-SQL 語法慣例

語法

sp_syscollector_create_collection_set
    [ @name = ] N'name'
    [ , [ @target = ] N'target' ]
    [ , [ @collection_mode = ] collection_mode ]
    [ , [ @days_until_expiration = ] days_until_expiration ]
    [ , [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @schedule_uid = ] 'schedule_uid' ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @logging_level = ] logging_level ]
    [ , [ @description = ] N'description' ]
    , [ @collection_set_id = ] collection_set_id OUTPUT
    [ , [ @collection_set_uid = ] 'collection_set_uid' OUTPUT ]
[ ; ]

引數

[ @name = ] N'name'

收集組的名稱。 @name是 sysname，不能是空字串或 NULL。

@name必須是唯一的。 如需目前收集組名稱的清單，請查詢 syscollector_collection_sets 系統檢視。

[ @target = ] N'target'

保留供未來使用。 @target為 nvarchar（128），預設值為 NULL。

[ @collection_mode = ] collection_mode

@collection_mode為 smallint，預設值為 0。

指定收集數據和儲存的方式。 @collection_mode為 smallint，預設值0為 ，而且可以具有下列其中一個值：

  • 0：快取模式。 數據收集和上傳會依個別排程進行。 指定連續收集的快取模式。

  • 1：非快取模式。 數據收集和上傳的排程相同。 為臨機操作集合或快照集集合指定非快取模式。

當@collection_mode為 時，必須指定@schedule_uid或@schedule_name。0

[ @days_until_expiration = ] days_until_expiration

收集的數據儲存在管理數據倉儲中的天數。 @days_until_expiration是smallint，預設值730為 （兩年）。 @days_until_expiration必須是 0 或正整數。

[ @proxy_id = ] proxy_id

SQL Server Agent Proxy 帳戶的唯一標識碼。 @proxy_id為 int，預設值為 NULL。 如果指定， @proxy_name 必須是 NULL。 若要取得 @proxy_id，請查詢 sysproxies 系統數據表。 dc_admin固定資料庫角色必須具有存取 Proxy 的許可權。 如需詳細資訊，請參閱 建立 SQL Server Agent Proxy。

[ @proxy_name = ] N'proxy_name'

Proxy 帳戶的名稱。 @proxy_name為 sysname，預設值為 NULL。 如果指定， @proxy_id 必須是 NULL。 若要取得 @proxy_name，請查詢 sysproxies 系統數據表。

[ @schedule_uid = ] 'schedule_uid'

指向排程的 GUID。 @schedule_uid為 uniqueidentifier，預設值為 NULL。 如果指定， @schedule_name 必須是 NULL。 若要取得 @schedule_uid，請 sysschedules 查詢系統數據表。

當@collection_mode設定為 0時，必須指定@schedule_uid或@schedule_name。 當@collection_mode設定為 1時，如果指定，則會忽略@schedule_uid或@schedule_name。

[ @schedule_name = ] N'schedule_name'

排程的名稱。 @schedule_name為 sysname，預設值為 NULL。 如果指定， @schedule_uid 必須是 NULL。 若要取得 @schedule_name，請 sysschedules 查詢系統數據表。

[ @logging_level = ] logging_level

記錄層級。 @logging_level為 smallint，預設值1為 ，具有下列其中一個值：

  • 0：追蹤下列記錄執行資訊和 SSIS 事件：

    • 啟動/停止收集組
    • 啟動/停止套件
    • 錯誤資訊

  • 1：層級 0 記錄和：

    • 執行統計資料
    • 持續執行收集進度
    • 來自 SSIS 的警告事件

  • 2：來自 SSIS 的層級 1 記錄和詳細的事件資訊。

[ @description = ] N'description'

收集組的描述。 @description為 nvarchar（4000），預設值為 NULL。

[ @collection_set_id = ] collection_set_id OUTPUT

收集組的唯一本機標識碼。 @collection_set_id是 int 類型的 OUTPUT 參數。

[ @collection_set_uid = ] 'collection_set_uid' OUTPUT

收集組的 GUID。 @collection_set_uid是 uniqueidentifier 類型的 OUTPUT 參數。

傳回碼值

0 (成功) 或 1 (失敗)。

備註

sp_syscollector_create_collection_set 必須在系統資料庫的內容 msdb 中執行。

權限

需要dc_admin的成員資格（具有 EXECUTE 許可權）固定資料庫角色才能執行此程式。

範例

A. 使用預設值建立收集組

下列範例只會指定必要的參數來建立收集組。 @collection_mode並非必要，但預設收集模式 （cached） 需要指定排程標識碼或排程名稱。

USE msdb;
GO

DECLARE @collection_set_id INT;

EXECUTE dbo.sp_syscollector_create_collection_set
    @name = N'Simple collection set test 1',
    @description = N'This is a test collection set that runs in non-cached mode.',
    @collection_mode = 1,
    @collection_set_id = @collection_set_id OUTPUT;
GO

B. 使用指定的值建立收集組

下列範例會藉由指定許多參數的值來建立集合集。

USE msdb;
GO

DECLARE @collection_set_id INT;
DECLARE @collection_set_uid UNIQUEIDENTIFIER;

SET @collection_set_uid = NEWID();

EXEC dbo.sp_syscollector_create_collection_set
    @name = N'Simple collection set test 2',
    @collection_mode = 0,
    @days_until_expiration = 365,
    @description = N'This is a test collection set that runs in cached mode.',
    @logging_level = 2,
    @schedule_name = N'CollectorSchedule_Every_30min',
    @collection_set_id = @collection_set_id OUTPUT,
    @collection_set_uid = @collection_set_uid OUTPUT;
GO

相關內容