core.sp_create_snapshot (Transact-SQL)

Aplica-se a: SQL Server

Insere uma linha na vista do armazém core.snapshots de dados de gestão. Este procedimento é chamado sempre que um pacote de upload começa a carregar dados para o armazém de dados de gestão.

Transact-SQL convenções de sintaxe

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'

O GUID para o conjunto da coleção. @collection_set_uid é um identificador único sem valor predefinido. Para obter o GUID, consulte a vista dbo.syscollector_collection_sets na msdb base de dados.

[ @collector_type_uid = ] 'collector_type_uid'

O GUID para um tipo colecionador. @collector_type_uid é um identificador único sem valor predefinido. Para obter o GUID, consulte a vista dbo.syscollector_collector_types na msdb base de dados.

[ @machine_name = ] 'machine_name'

O nome do servidor onde reside o conjunto de coleções. @machine_name é sysname, sem valor predefinido.

[ @named_instance = ] 'named_instance'

O nome da instância para o conjunto de coleções. @named_instance é sysname, sem valor padrão.

[ @log_id = ] log_id

O identificador único que corresponde ao registo de eventos da coleção no servidor que recolheu os dados. @log_id é bigint sem valor padrão. Para obter o valor de log_id, consulte a vista dbo.syscollector_execution_log na msdb base de dados.

[ @snapshot_id = ] snapshot_id

O identificador único de uma linha que é inserida na core.snapshots vista. @snapshot_id é int e é devolvido como OUTPUT.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

Sempre que um pacote de upload começa a carregar dados para o armazém de dados de gestão, o componente de tempo de execução do recolhedor de dados chama core.sp_create_snapshot.

Este procedimento verifica se:

  • O collection_set_uid corresponde a uma entrada já existente na core.source_info_internal tabela.

  • A collector_type_uid corresponde a uma entrada existente na core.supported_collector_types vista.

Se qualquer uma das verificações anteriores falhar, o procedimento falha e devolve um erro.

Permissions

Requer a pertença ao papel fixo de base de dados mdw_writer (com permissão EXECUTAR).

Examples

O exemplo seguinte cria um snapshot para o conjunto de Coleção de Utilização de Disco, adiciona-o ao armazém de dados de gestão e devolve o identificador do snapshot. No exemplo, é usada a instância padrão.

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;

Conteúdo relacionado

  • Last updated on