core.sp_update_data_source (Transact-SQL)

Aktualisiert eine vorhandene Zeile oder fügt eine neue Zeile in der core.source_info_internal-Tabelle des Management Data Warehouse ein. Diese Prozedur wird von der Laufzeitkomponente des Datensammlers bei jedem Hochladen von Daten in das Verwaltungs-Data Warehouse durch ein Uploadpaket aufgerufen.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

• [ @collection\_set\_uid = ] 'collection_set_uid'
  Die GUID für den Sammlungssatz. collection_set_uid ist vom Datentyp uniqueidentifier und hat keinen Standardwert. Zum Abrufen der GUID fragen Sie die dbo.syscollector_collection_sets-Sicht in der msdb-Datenbank ab.

• [ @machine\_name = ] 'machine_name'
  Der Name des Servers, auf dem sich der Sammlungssatz befindet. machine_name ist vom Datentyp sysname und hat keinen Standardwert.

• [ @named\_instance = ] 'named_instance'
  Der Name der Instanz für den Sammlungssatz. named_instance ist vom Datentyp sysname und hat keinen Standardwert.

  Hinweis
  named_instance muss der vollqualifizierte Instanzname sein, der aus dem Computernamen und dem Instanznamen im Format computername\instancename besteht.

• [ @days\_until\_expiration = ] days_until_expiration
  Die Anzahl der Tage, die in der Beibehaltungsdauer für Momentaufnahmedaten verbleiben. days_until_expiration ist vom Datentyp smallint.

• [ @source\_id = ] source_id
  Der eindeutige Bezeichner für die Quelle des Updates. source_id ist vom Datentyp int und wird als OUTPUT zurückgegeben.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

Jedes Mal, wenn ein Uploadpaket mit dem Hochladen von Daten in das Verwaltungs-Data Warehouse startet, ruft die Laufzeitkomponente des Datensammlers core.sp_update_data_source auf. Die core.source_info_internal-Tabelle wird aktualisiert, wenn seit dem letzten Upload eine der folgenden Änderungen durchgeführt wurde:

• Ein neuer Sammlungssatz wurde hinzugefügt.

• Der Wert für days_until_expiration wurde geändert.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Datenbankrolle mdw_writer (mit EXECUTE-Berechtigung).

Beispiele

Im folgenden Beispiel wird die Datenquelle aktualisiert (in diesem Fall der Sammlungssatz für die Datenträgerverwendung), die Anzahl der Tage bis zum Ablaufdatum festgelegt und der Bezeichner für die Quelle zurückgegeben. In diesem Beispiel wird die Standardinstanz verwendet.

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;

Siehe auch

Verweis

Gespeicherte Systemprozeduren (Transact-SQL)

Gespeicherte Prozeduren für den Datensammler (Transact-SQL)

Konzepte

Verwaltungs-Data Warehouse