Freigeben über

  • Artikel

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 Verwaltungs-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.

Themenlink (Symbol)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'
    GUID für den Sammlungssatz. collection_set_uid ist uniqueidentifier und verfügt über keinen Standardwert. Um die GUID zu erhalten, 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 sysname und verfügt über keinen Standardwert.

  • [ @named_instance = ] 'named_instance'
    Der Name der Instanz für den Sammlungssatz. named_instance ist sysname und verfügt über keinen Standardwert.

    HinweisHinweis

    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 der Aktualisierung. 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 beginnt, ruft die Laufzeitkomponente des Datensammler core.sp_update_data_source auf. Die core.source_info_internal-Tabelle wird aktualisiert, wenn nach dem letzten Hochladen 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;