Compartilhar via


core.sp_create_snapshot (Transact-SQL)

Aplica-se: SQL Server

Insere uma linha na exibição do data warehouse core.snapshots de gerenciamento. Esse procedimento é chamado sempre que um pacote de carregamento começa a carregar dados no data warehouse de gerenciamento.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@collection_set_uid [ = ] 'collection_set_uid'

O GUID do conjunto de coleta. @collection_set_uid é uniqueidentifier sem valor padrão. Para obter o GUID, consulte a exibição dbo.syscollector_collection_sets no msdb banco de dados.

@collector_type_uid [ = ] 'collector_type_uid'

O GUID de um tipo de coletor. @collector_type_uid é uniqueidentifier sem valor padrão. Para obter o GUID, consulte a exibição dbo.syscollector_collector_types no msdb banco de dados.

@machine_name [ = ] 'machine_name'

O nome do servidor no qual o conjunto de coleta reside. @machine_name é sysname, sem valor padrão.

@named_instance [ = ] 'named_instance'

O nome da instância do conjunto de coleta. @named_instance é sysname, sem valor padrão.

@log_id [ = ] log_id

O identificador exclusivo que é mapeado para o log de eventos do conjunto de coleta que coletou os dados. @log_id é bigint sem valor padrão. Para obter o valor de log_id, consulte a exibição dbo.syscollector_execution_log no msdb banco de dados.

@snapshot_id [ = ] snapshot_id

O identificador exclusivo de uma linha inserida na core.snapshots exibição. @snapshot_id é int e é retornado como OUTPUT.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

Sempre que um pacote de upload começa a carregar dados para o data warehouse de gerenciamento, o componente de tempo de execução do coletor de dados chama core.sp_create_snapshot.

Esse procedimento verifica se:

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

  • O collector_type_uid corresponde a core.supported_collector_types uma entrada existente na exibição.

Se alguma das verificações acima falhar, o procedimento falhará e retornará um erro.

Permissões

Requer associação na função de banco de dados fixa mdw_writer (com permissão EXECUTE).

Exemplos

O exemplo a seguir cria um instantâneo do conjunto de coleta Uso do Disco, adiciona-o ao data warehouse de gerenciamento e retorna o identificador do instantâneo. No exemplo, a instância padrão é usada.

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;