core.sp_create_snapshot (Transact-SQL)

Şunlar için geçerlidir: SQL Server

Yönetim veri deposu core.snapshots görünümünde bir satır ekler. Bu prosedür, bir yükleme paketi yönetim veri deposuna veri yüklemeye başladığında her çağrılır.

Transact-SQL söz dizimi kuralları

Syntax

core.sp_create_snapshot [ @collection_set_uid = ] 'collection_set_uid'
    , [ @collector_type_uid = ] 'collector_type_uid'
    , [ @machine_name = ] 'machine_name'
    , [ @named_instance = ] 'named_instance'
    , [ @log_id = ] log_id
    , [ @snapshot_id = ] snapshot_id OUTPUT
[ ; ]

Arguments

[ @collection_set_uid = ] 'collection_set_uid'

Koleksiyon seti için GUID. @collection_set_uid , varsayılan değeri olmayan uniqueidentifier'dır . GUID elde etmek için veritabanındaki dbo.syscollector_collection_sets görünümünü msdb sorgulayın.

[ @collector_type_uid = ] 'collector_type_uid'

Koleksiyoncu tipi için GUID. @collector_type_uid , varsayılan değeri olmayan uniqueidentifier'dır . GUID'i almak için veritabanında dbo.syscollector_collector_types görünümünü msdb sorgulayın.

[ @machine_name = ] 'machine_name'

Koleksiyonun bulunduğu sunucunun adı. @machine_namesysname'dir ve varsayılan değeri yoktur.

[ @named_instance = ] 'named_instance'

Koleksiyon seti için örnek adı. @named_instancesysname'dir ve varsayılan değeri yoktur.

[ @log_id = ] log_id

Verileri toplayan sunucudaki koleksiyon setine eşlenen benzersiz tanımlayıcı, olay kaydı. @log_idbigint ve varsayılan değeri yok. log_id değerini elde etmek için veritabanındaki dbo.syscollector_execution_log görünümünü msdb sorgulayın.

[ @snapshot_id = ] snapshot_id

Görünüme core.snapshots eklenen bir satır için benzersiz tanımlayıcı. @snapshot_idint'dir ve geri olarak döner OUTPUT.

Dönüş kodu değerleri

0 (başarı) veya 1 (başarısızlık).

Remarks

Her yükleme paketi yönetim veri deposuna veri yüklemeye başladığında, veri toplayıcı çalışma zamanı bileşeni core.sp_create_snapshot.

Bu prosedür, aşağıdaki durumlarda kontrol edilir:

  • collection_set_uid, tablodaki core.source_info_internal mevcut bir girişle eşleşiyor.

  • collector_type_uid, görünümdeki core.supported_collector_types mevcut bir girişle eşleşiyor.

Önceki kontrollerden biri başarısız olursa, prosedür başarısız olur ve hata döndürür.

Permissions

mdw_writer (EXECUTE izniyle) sabit veritabanı rolünde üyelik gerektirir.

Examples

Aşağıdaki örnek, Disk Kullanımı koleksiyon seti için bir anlık görüntü oluşturur, bunu yönetim veri deposuna ekler ve anlık fotoğraf tanımlayıcısını döndürür. Örnekte, varsayılan örnek kullanılmıştır.

USE <management_data_warehouse>;
DECLARE @snapshot_id int;
EXECUTE core.sp_create_snapshot
    @collection_set_uid = '7B191952-8ECF-4E12-AEB2-EF646EF79FEF',
    @collector_type_uid = '302E93D1-3424-4BE7-AA8E-84813ECF2419',
    @machine_name = '<computername>',
    @named_instance = 'MSSQLSERVER',
    @log_id = 11, -- ID of the log for the collection set
    @snapshot_id = @snapshot_id OUTPUT;