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;