core.sp_create_snapshot (Transact-SQL)
Fügt eine Zeile in die core.snapshots-Sicht des Verwaltungs-Data Warehouse ein. Diese Prozedur wird jedes Mal aufgerufen, wenn Daten durch ein Uploadpaket in das Verwaltungs-Data Warehouse hochgeladen werden.
Transact-SQL-Syntaxkonventionen
Syntax
core.sp_create_snapshot [ @collection_set_uid = ] 'collection_set_uid'
, [ @collector_type_uid = ] 'collector_type_uid'
,[ @machine_name = ] 'machine_name'
, [ @named_instance = ] 'named_instance'
, [ @log_id = ] log_id
, [ @snapshot_id = ] snapshot_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. Um die GUID abzurufen, fragen Sie die dbo.syscollector_collection_sets-Sicht in der msdb-Datenbank ab.[ @collector\_type\_uid = ] 'collector_type_uid'
Die GUID für einen Sammlertyp. collector_type_uid ist vom Datentyp uniqueidentifier und hat keinen Standardwert. Um die GUID abzurufen, fragen Sie die dbo.syscollector_collector_types-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.[ @log\_id = ] log_id
Der eindeutige Bezeichner, der dem Ereignisprotokoll des Sammlungssatzes auf dem Server zugeordnet ist, der die Daten gesammelt hat. log_id ist vom Datentyp bigint und hat keinen Standardwert. Um den Wert für log_id abzurufen, fragen Sie die dbo.syscollector_execution_log-Sicht in der msdb-Datenbank ab.[ @snapshot\_id = ] snapshot_id
Der eindeutige Bezeichner für eine Zeile, die in die core.snapshots-Sicht eingefügt wird. snapshot_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_create_snapshot auf.
Diese Prozedur führt eine Überprüfung auf Folgendes durch:
Die collection_set_uid entspricht einem vorhandenen Eintrag in der core.source_info_internal-Tabelle.
Die collector_type_uid entspricht einem vorhandenen Eintrag in der core.supported_collector_types-Sicht.
Schlägt eine der oben aufgeführten Überprüfungen fehl, so schlägt die Prozedur fehl und gibt einen Fehler zurück.
Berechtigungen
Erfordert die Mitgliedschaft in der festen Datenbankrolle mdw_writer (mit EXECUTE-Berechtigung).
Beispiele
Im folgenden Beispiel wird eine Momentaufnahme für den Sammlungssatz für die Datenträgerverwendung erstellt, dem Verwaltungs-Data Warehouse hinzugefügt und der Momentaufnahmebezeichner zurückgegeben. In diesem Beispiel wird die Standardinstanz verwendet.
USE <management_data_warehouse>;
DECLARE @snapshot_id int;
EXEC core.sp_create_snapshot
@collection_set_uid = '7B191952-8ECF-4E12-AEB2-EF646EF79FEF',
@collector_type_uid = '302E93D1-3424-4BE7-AA8E-84813ECF2419',
@machine_name = '<computername>',
@named_instance = 'MSSQLSERVER',
@log_id = 11, -- ID of the log for the collection set
@snapshot_id = @snapshot_id OUTPUT;
Siehe auch
Verweis
Gespeicherte Systemprozeduren (Transact-SQL)
Gespeicherte Prozeduren für den Datensammler (Transact-SQL)