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.
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 Auflistsatz. 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 Auflistertyp. 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 Auflistsatz befindet. machine_name ist sysname und verfügt über keinen Standardwert.[ @named\_instance = ] 'named_instance'
Der Name der Instanz für den Auflistsatz. named_instance ist sysname und verfügt über keinen Standardwert.[ @log\_id = ] log_id
Der eindeutige Bezeichner, der dem Ereignisprotokoll des Auflistsatzes 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 Management Data Warehouse beginnt, ruft die Laufzeitkomponente des Datenauflisters 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 ein Snapshot für den Auflistsatz für die Datenträgerverwendung erstellt, dem Verwaltungs-Data Warehouse hinzugefügt und der Snapshotbezeichner 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;
Änderungsverlauf
Aktualisierter Inhalt |
---|
Der Name des collection_set_uid-Arguments und die core.source_info_internal-Tabelle wurden im Abschnitt mit den Hinweisen korrigiert. |
Die Argumentnamen, die GUIDs und die Syntax wurden im Beispiel korrigiert. |