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.
.gif "Icona di collegamento a un argomento")
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 insieme 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 l'insieme 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 nel formato nomecomputer\nomeistanza.
[ @days\_until\_expiration = ] days_until_expiration
Numero di giorni rimanenti del periodo di memorizzazione dei dati dello 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.
Valori 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 l'insieme 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;
Cronologia modifiche
Aggiornamento del contenuto |
|---|
Correzione del nome della tabella core.source_info_internal nella prima frase. |
Correzione del nome dell'argomento named_instance nella sezione "Sintassi". |
Correzione del nome della tabella core.source_info_internal e dell'argomento days_until_expiration nella sezione "Osservazioni". |
Correzione di GUID, nomi degli argomenti e sintassi nell'esempio. |
Vedere anche