Bagikan melalui

core.sp_create_snapshot (T-SQL)

  • Artikel

Berlaku untuk: SQL Server

Menyisipkan baris dalam tampilan gudang core.snapshots data manajemen. Prosedur ini dipanggil setiap kali paket unggahan mulai mengunggah data ke gudang data manajemen.

Konvensi sintaks transact-SQL

Sintaks

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
[ ; ]

Argumen

[ @collection_set_uid = ] 'collection_set_uid'

GUID untuk kumpulan koleksi. @collection_set_uid adalah uniqueidentifier tanpa nilai default. Untuk mendapatkan GUID, kueri tampilan dbo.syscollector_collection_sets dalam msdb database.

[ @collector_type_uid = ] 'collector_type_uid'

GUID untuk jenis kolektor. @collector_type_uid pengidentifikasi unik tanpa nilai default. Untuk mendapatkan GUID, kueri tampilan dbo.syscollector_collector_types dalam msdb database.

[ @machine_name = ] 'machine_name'

Nama server tempat kumpulan disetel berada. @machine_name adalah sysname, tanpa nilai default.

[ @named_instance = ] 'named_instance'

Nama instans untuk kumpulan koleksi. @named_instance adalah sysname, tanpa nilai default.

[ @log_id = ] log_id

Pengidentifikasi unik yang memetakan ke kumpulan kumpulan log peristiwa di server yang mengumpulkan data. @log_id besar tanpa nilai default. Untuk mendapatkan nilai untuk log_id, kueri tampilan dbo.syscollector_execution_log dalam msdb database.

[ @snapshot_id = ] snapshot_id

Pengidentifikasi unik untuk baris yang disisipkan ke core.snapshots dalam tampilan. @snapshot_id int dan dikembalikan sebagai OUTPUT.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Setiap kali paket unggahan mulai mengunggah data ke gudang data manajemen, komponen run-time pengumpul data memanggil core.sp_create_snapshot.

Prosedur ini memeriksa untuk melihat apakah:

  • collection_set_uid cocok dengan entri yang ada dalam core.source_info_internal tabel.

  • collector_type_uid cocok dengan entri yang ada dalam core.supported_collector_types tampilan.

Jika salah satu pemeriksaan sebelumnya gagal, prosedur gagal dan mengembalikan kesalahan.

Izin

Memerlukan keanggotaan dalam peran database tetap mdw_writer (dengan izin EXECUTE).

Contoh

Contoh berikut membuat rekam jepret untuk kumpulan kumpulan Penggunaan Disk, menambahkannya ke gudang data manajemen, dan mengembalikan pengidentifikasi rekam jepret. Dalam contoh, instans default digunakan.

USE <management_data_warehouse>;
DECLARE @snapshot_id int;
EXEC 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;

Konten terkait