core.sp_create_snapshot (Transact-SQL)

Artikel
2025-01-02

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;

Freigeben über