core.sp_update_data_source (Transact-SQL)

  • Articolo

Si applica a:SQL Server

Aggiornamenti una riga esistente o inserisce una nuova riga nella tabella del data warehouse core.source_info_internal di gestione. Questa routine 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.

Convenzioni di 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 set di raccolta. @collection_set_uid è uniqueidentifier, senza alcun valore predefinito. Per ottenere il GUID, eseguire una query sulla vista dbo.syscollector_collection_sets nel msdb database.

[ @machine_name = ] 'machine_name'

Nome del server in cui risiede l'insieme di raccolta. @machine_name è sysname senza alcun valore predefinito.

[ @named_instance = ] 'named_instance'

Nome dell'istanza per l'insieme di raccolta. @named_instance è sysname, senza 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 <computername>\<instancename>.

[ @days_until_expiration = ] days_until_expiration

Numero di giorni rimanenti del periodo di memorizzazione dei dati dello snapshot. @days_until_expiration è smallint.

[ @source_id = ] source_id

Identificatore univoco per l'origine dell'aggiornamento. @source_id è int e viene restituito come OUTPUT.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

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 core.source_info_internal tabella viene aggiornata se si è verificata una delle modifiche seguenti dopo l'ultimo caricamento:

  • È stato aggiunto un nuovo set di raccolta.
  • È stato modificato il valore di days_until_expiration.

Autorizzazioni

Richiede 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;

Vedi anche