sp_syscollector_create_collection_set (Transact-SQL)
建立新的收集組。 您可以使用這個預存程序來建立用於資料收集的自訂收集組。
.gif "警告注意事項") 注意 |
|---|
如果設定為 Proxy 的 Windows 帳戶為非互動使用者或是尚未登入的互動使用者，則設定檔目錄不會存在，而且暫存目錄的建立將會失敗。 因此，如果您在網域控制站上使用 Proxy 帳戶，則必須指定已至少使用一次的互動帳戶，以確保設定檔目錄已經建立。 |
.gif "主題連結圖示")
語法
sp_syscollector_create_collection_set
[ @name = ] 'name'
, [ [ @target = ] 'target' ]
, [ [ @collection_mode = ] collection_mode ]
, [ [ @days_until_expiration = ] days_until_expiration ]
, [ [ @proxy_id = ] proxy_id ]
, [ [ @proxy_name = ] 'proxy_name' ]
, [ [ @schedule_uid = ] 'schedule_uid' ]
, [ [ @schedule_name = ] 'schedule_name' ]
, [ [ @logging_level = ] logging_level ]
, [ [ @description = ] 'description' ]
, [ @collection_set_id = ] collection_set_id OUTPUT
, [ [ @collection_set_uid = ] 'collection_set_uid' OUTPUT ]
引數
[ @name = ] 'name'
這是收集組的名稱。 name 是 sysname，而且不可以是空字串或 NULL。name 必須是唯一的。 如需目前的收集組名稱清單，請查詢 syscollector_collection_sets 系統檢視表。
[ @target = ] 'target'
保留供日後使用。 name 是 nvarchar(128)，預設值為 NULL。[ @collection\_mode = ] collection_mode
指定收集資料和儲存資料的方式。 collection_mode 是 smallint，而且可以擁有下列其中一個值：0 - 快取模式。 資料收集和上傳位於不同的排程上。 指定連續收集的快取模式。
1 - 非快取模式。 資料收集和上傳位於相同的排程上。 針對特定收集或快照集收集指定非快取模式。
collection_mode 的預設值為 0。 當 collection_mode 為 0 時，必須指定 schedule_uid 或 schedule_name。
[ @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 = ] '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 = ] 'schedule_name'
這是排程的名稱。 schedule_name 是 sysname ，預設值為 NULL。 如果指定的話，schedule_uid 必須為 NULL。 若要取得 schedule_name，請查詢 sysschedules 系統資料表。[ @logging\_level = ] logging_level
這是記錄層級。 logging_level 是 smallint，包含下列其中一個值：0 – 記錄執行資訊和追蹤的 SSIS 事件：
開始/停止收集組
開始/停止封裝
錯誤資訊
1 - 層級 0 記錄和：
執行統計資料
持續執行的收集進度
SSIS 的警告事件
2 - 層級 1 記錄和 SSIS 的詳細事件資訊
logging_level 的預設值為 1。
[ @description = ] 'description'
這是收集組的描述。 description 是 nvarchar(4000) ，預設值為 NULL。[ @collection\_set\_id = ] collection_set_id
這是收集組的唯一本機識別碼。 collection_set_id 是 int (包含 OUTPUT)，而且為必要項。[ @collection\_set\_uid = ] 'collection_set_uid'
這是收集組的 GUID。 collection_set_uid 是 uniqueidentifier (包含 OUTPUT)，而且預設值為 NULL。
傳回碼值
0 (成功) 或 1 (失敗)
備註
sp_syscollector_create_collection_set 必須在 msdb 系統資料庫的內容中執行。
權限
需要 dc_admin (具有 EXECUTE 權限) 固定資料庫角色中的成員資格，才能執行此程序。
範例
A.使用預設值建立收集組
下列範例藉由只指定必要參數來建立收集組。 @collection\_mode 不是必要項，但是預設收集模式 (快取) 需要指定排程識別碼或排程名稱。
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;
請參閱
工作
建立使用一般 T-SQL 查詢收集器型別的自訂收集組 (Transact-SQL)
參考
syscollector_collection_sets (Transact-SQL)