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 Datenauflisters 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'
    Die GUID für den Auflistsatz. collection_set_uid ist vom Datentyp 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 Auflistsatz befindet. machine_name ist sysname und verfügt über keinen Standardwert.

  • [ @named\_instance = ] 'named_instance'
    Der Name der Instanz für den Auflistsatz. 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 Snapshotdaten 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 Management Data Warehouse beginnt, ruft die Laufzeitkomponente des Datenauflisters 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 Auflistsatz 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 Auflistsatz 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;

Änderungsverlauf

Aktualisierter Inhalt

Im ersten Satz wurde der Name der core.source_info_internal-Tabelle korrigiert.

Im Abschnitt zur Syntax wurde der Name des named_instance-Arguments korrigiert.

Im Abschnitt mit den Hinweisen wurde der Name der core.source_info_internal-Tabelle und des days_until_expiration-Arguments korrigiert.

Die GUID, Argumentnamen und Syntax wurden im Beispiel korrigiert.