core.sp_create_snapshot (Transact-SQL)
Gilt für: SQL Server
Fügt eine Zeile in die Verwaltungsdatenlageransicht core.snapshots
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 eindeutiger Bezeichner ohne Standardwert. Um die GUID abzurufen, fragen Sie die dbo.syscollector_collection_sets Ansicht in der msdb
Datenbank ab.
[ @collector_type_uid = ] 'collector_type_uid'
Die GUID für einen Sammlertyp. @collector_type_uid ist eindeutiger Bezeichner ohne Standardwert. Um die GUID abzurufen, fragen Sie die dbo.syscollector_collector_types 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.
[ @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 "bigint" ohne Standardwert. Um den Wert für log_id abzurufen, fragen Sie die dbo.syscollector_execution_log Ansicht in der msdb
Datenbank ab.
[ @snapshot_id = ] snapshot_id
Der eindeutige Bezeichner für eine Zeile, die in die core.snapshots
Ansicht eingefügt wird. @snapshot_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_create_snapshot
.
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
Ansicht.
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;