core.sp_create_snapshot (Transact-SQL)

Van toepassing op:SQL Server

Voegt een rij in in de management data warehouse-weergave core.snapshots . Deze procedure wordt aangeroepen telkens wanneer een uploadpakket begint met het uploaden van data naar het management data warehouse.

Transact-SQL syntaxis-conventies

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
[ ; ]

Arguments

[ @collection_set_uid = ] 'collection_set_uid'

De GUID voor de collectieset. @collection_set_uid is uniqueidentifier zonder standaardwaarde. Om de GUID te verkrijgen, raadpleeg de dbo.syscollector_collection_sets weergave in de msdb database.

[ @collector_type_uid = ] 'collector_type_uid'

De GUID voor een verzamelaartype. @collector_type_uid is uniqueidentifier zonder standaardwaarde. Om de GUID te verkrijgen, raadpleeg de dbo.syscollector_collector_types view in de msdb database.

[ @machine_name = ] 'machine_name'

De naam van de server waarop de verzameling zich bevindt. @machine_name is een systeemnaam, zonder standaardwaarde.

[ @named_instance = ] 'named_instance'

De naam van de instantie voor de verzameling. @named_instance is een systeemnaam, zonder standaardwaarde.

[ @log_id = ] log_id

De unieke identificatie die overeenkomt met de collectie zet eventlog op de server die de data verzamelde. @log_id is bigint zonder standaardwaarde. Om de waarde voor log_id te verkrijgen, raadpleeg de dbo.syscollector_execution_log weergave in de msdb database.

[ @snapshot_id = ] snapshot_id

De unieke identificatie voor een rij die in de core.snapshots weergave wordt ingevoegd. @snapshot_id is int en wordt geretourneerd als OUTPUT.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Remarks

Elke keer dat een uploadpakket begint met het uploaden van data warehouse, roept core.sp_create_snapshotde runtime-component van de dataverzamelaar .

Deze procedure controleert of:

  • De collection_set_uid komt overeen met een bestaande vermelding in de core.source_info_internal tabel.

  • De collector_type_uid komt overeen met een bestaande vermelding in de core.supported_collector_types view.

Als een van de voorgaande controles faalt, faalt de procedure en geeft een foutmelding terug.

Permissions

Vereist lidmaatschap van de vaste databaserol mdw_writer (met uitvoeren) vaste database.

Examples

Het volgende voorbeeld maakt een snapshot aan voor de Disk Usage collection set, voegt deze toe aan het management data warehouse en geeft de snapshot-identificatie terug. In het voorbeeld wordt de standaardinstantie gebruikt.

USE <management_data_warehouse>;
DECLARE @snapshot_id int;
EXECUTE 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;