Freigeben über


core.sp_update_data_source (Transact-SQL)

Gilt für: SQL Server

Aktualisiert eine vorhandene Zeile oder fügt eine neue Zeile in die Verwaltungsdatenlagertabelle core.source_info_internal 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 eindeutiger Bezeichner, ohne Standardwert. Um die GUID abzurufen, fragen Sie die dbo.syscollector_collection_sets Ansicht in der msdb Datenbank ab.

[ @machine_name = ] 'machine_name'

Der Name des Servers, auf dem sich der Sammlungssatz befindet. @machine_name ist "sysname" ohne Standardwert.

[ @named_instance = ] 'named_instance'

Der Name der Instanz für den Sammlungssatz. @named_instance ist "sysname" ohne Standardwert.

Hinweis

named_instance muss der vollqualifizierte Instanzname sein, der aus dem Computernamen und dem Instanznamen im Formular <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 klein.

[ @source_id = ] source_id

Der eindeutige Bezeichner für die Quelle des Updates. @source_id ist int und wird als AUSGABE zurückgegeben.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

Jedes Mal, wenn ein Uploadpaket mit dem Hochladen von Daten in das Management Data Warehouse beginnt, ruft die Laufzeitkomponente des Datensammlers auf core.sp_update_data_source. Die core.source_info_internal Tabelle wird aktualisiert, wenn seit dem letzten Upload eine der folgenden Änderungen vorgenommen 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;