Share via


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.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

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.