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.
.gif "Themenlink (Symbol)")
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'
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.[ @collector_type_uid = ] 'collector_type_uid'
GUID für den einen Sammlertyp. collector_type_uid ist uniqueidentifier und verfügt über keinen Standardwert. Um die GUID zu erhalten, 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 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.[ @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 verfügt über keinen Standardwert. Um den Wert für log_id zu erhalten, fragen Sie die dbo.syscollector_execution_log-Sicht in der MSDB-Datenbank ab.[ @snapshot_id = ] snapshot_id
Der eindeutige Bezeichner einer Zeile, die in die core.snapshots-Sicht eingefügt wurde. 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:
collection_set_uid stimmt mit einem vorhandenen Eintrag in der core.source_info_internal-Tabelle überein.
collector_type_uid stimmt mit einem vorhandenen Eintrag in der core.supported_collector_types-Sicht überein.
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;