core.sp_update_data_source (T-SQL)
Berlaku untuk: SQL Server
Memperbarui baris yang sudah ada atau menyisipkan baris baru dalam tabel gudang core.source_info_internal
data manajemen. Prosedur ini dipanggil oleh komponen run-time pengumpul data setiap kali paket unggahan mulai mengunggah data ke gudang data manajemen.
Sintaks
core.sp_update_data_source [ @collection_set_uid = ] 'collection_set_uid'
, [ @machine_name = ] 'machine_name'
, [ @named_instance = ] 'named_instance'
, [ @days_until_expiration = ] days_until_expiration
, [ @source_id = ] source_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.
[ @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.
Catatan
named_instance harus merupakan nama instans yang sepenuhnya memenuhi syarat, yang terdiri dari nama komputer dan nama instans dalam formulir <computername>\<instancename>
.
[ @days_until_expiration = ] days_until_expiration
Jumlah hari tersisa dalam periode retensi data rekam jepret. @days_until_expiration kecil.
[ @source_id = ] source_id
Pengidentifikasi unik untuk sumber pembaruan. @source_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_update_data_source
. Tabel core.source_info_internal
diperbarui jika salah satu perubahan berikut telah terjadi sejak unggahan terakhir:
- Kumpulan koleksi baru ditambahkan.
- Nilai untuk days_until_expiration telah berubah.
Izin
Memerlukan keanggotaan dalam peran database tetap mdw_writer (dengan izin EXECUTE).
Contoh
Contoh berikut memperbarui sumber data (dalam hal ini kumpulan Kumpulan Penggunaan Disk), mengatur jumlah hari hingga kedaluwarsa, dan mengembalikan pengidentifikasi untuk sumber. Dalam contoh, instans default digunakan.
USE <management_data_warehouse>;
GO
DECLARE @source_id INT;
EXEC core.sp_update_data_source @collection_set_uid = '7B191952-8ECF-4E12-AEB2-EF646EF79FEF',
@machine_name = '<computername>',
@named_instance = 'MSSQLSERVER',
@days_until_expiration = 10,
@source_id = @source_id OUTPUT;