core.sp_update_data_source (Transact-SQL)
Aggiorna una riga esistente o inserisce una nuova riga nella tabella core.source_info_internal del data warehouse di gestione. Questa procedura viene chiamata dal componente di runtime dell'agente di raccolta dati tutte le volte che un pacchetto di caricamento avvia il caricamento dei dati nel data warehouse di gestione.
Sintassi
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
Argomenti
[ @collection_set_uid = ] 'collection_set_uid'
GUID per il tipo di set di raccolta. collection_set_uid è di tipo uniqueidentifier, senza alcun valore predefinito. Per ottenere il GUID, eseguire una query sulla vista dbo.syscollector_collection_sets nel database msdb.[ @machine_name = ] 'machine_name'
Nome del server in cui si trova il set di raccolta. machine_name è di tipo sysname e non prevede alcun valore predefinito.[ @named_instance = ] 'named_instance'
Nome dell'istanza per l'insieme di raccolta. named_instance è di tipo sysname e non prevede alcun valore predefinito.Nota
named_instance deve essere il nome completo dell'istanza costituito dal nome del computer e dal nome dell'istanza nella forma computername\instancename.
[ @days_until_expiration = ] days_until_expiration
Numero di giorni rimanenti del periodo di memorizzazione dei dati snapshot. days_until_expiration è di tipo smallint.[ @source_id = ] source_id
Identificatore univoco per l'origine dell'aggiornamento. source_id è di tipo int e viene restituito come OUTPUT.
Codici restituiti
0 (esito positivo) o 1 (esito negativo)
Osservazioni
Ogni volta che un pacchetto di caricamento inizia a caricare i dati nel data warehouse di gestione, il componente di runtime dell'agente di raccolta dati chiama core.sp_update_data_source. La tabella core.source_info_internal viene aggiornata se dopo l'ultimo caricamento si è verificata una delle modifiche seguenti:
È stato aggiunto un nuovo insieme di raccolta.
È stato modificato il valore di days_until_expiration.
Autorizzazioni
È richiesta l'appartenenza al ruolo predefinito del database mdw_writer (con autorizzazione EXECUTE).
Esempi
Nell'esempio seguente viene aggiornata l'origine dati (in questo caso il set di raccolta Utilizzo disco), viene impostato il numero di giorni che mancano alla scadenza e viene restituito l'identificatore per l'origine. In questo esempio viene utilizzata l'istanza predefinita.
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;
Vedere anche