core.sp_create_snapshot (Transact-SQL)

Gäller för:SQL Server

Infogar en rad i hanteringsdatalagervyn core.snapshots . Denna procedur anropas varje gång ett uppladdningspaket börjar ladda upp data till hanteringsdatalagret.

Transact-SQL syntaxkonventioner

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'

GUID för samlingssetet. @collection_set_uid är unik identifierare utan standardvärde. För att hämta GUID:en, sök i dbo.syscollector_collection_sets vy i databasen msdb .

[ @collector_type_uid = ] 'collector_type_uid'

GUID för en samlartyp. @collector_type_uid är en unik identifierare utan standardvärde. För att få GUID, sök i dbo.syscollector_collector_types vyn i databasen msdb .

[ @machine_name = ] 'machine_name'

Namnet på servern som samlingssetet finns på. @machine_name är sysname, utan standardvärde.

[ @named_instance = ] 'named_instance'

Namnet på instansen för samlingsmängden. @named_instance är sysname, utan standardvärde.

[ @log_id = ] log_id

Den unika identifieraren som kopplas till samlingens händelselogg på servern som samlade in datan. @log_id är bigint utan standardvärde. För att få värdet för log_id, sök i dbo.syscollector_execution_log vy i databasen msdb .

[ @snapshot_id = ] snapshot_id

Den unika identifieraren för en rad som infogas i vyn core.snapshots . @snapshot_id är int och returneras som OUTPUT.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Remarks

Varje gång ett uppladdningspaket börjar ladda upp data till hanteringsdatalagret, anropar core.sp_create_snapshotdatainsamlarens körtidskomponent .

Denna procedur kontrollerar om:

  • Den collection_set_uid matchar en befintlig post i core.source_info_internal tabellen.

  • collector_type_uid matchar en befintlig post i vyn core.supported_collector_types .

Om någon av de föregående kontrollerna misslyckas, misslyckas proceduren och ett fel returneras.

Permissions

Kräver medlemskap i mdw_writer (med EXECUT-behörighet ) fast databasroll.

Exempel

Följande exempel skapar en snapshot för samlingssetet Disk Usage, lägger till det i hanteringsdatalagret och returnerar snapshotidentifieraren. I exemplet används standardinstansen.

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;