core.sp_create_snapshot (Transact-SQL)
Insere uma linha na exibição core.snapshots do data warehouse de gerenciamento. Esse procedimento é chamado sempre que um pacote de carregamento começa a carregar dados no data warehouse de gerenciamento.
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'
A GUID do conjunto de coleta. collection_set_uid é uniqueidentifier sem nenhum valor padrão. Para obter o GUID, consulte a exibição dbo.syscollector_collection_sets no banco de dados msdb.[ @collector_type_uid = ] 'collector_type_uid'
O GUID de um tipo de coletor. collector_type_uid é uniqueidentifier sem nenhum valor padrão. Para obter o GUID, consulte a exibição dbo.syscollector_collector_types no banco de dados msdb.[ @machine_name = ] 'machine_name'
O nome do servidor em que reside o conjunto de coleta. machine_name é sysname sem nenhum valor padrão.[ @named_instance = ] 'named_instance'
O nome da instância do conjunto de coleta. named_instance é sysname sem nenhum valor padrão.[ @log_id = ] log_id
O identificador exclusivo que mapeia para o log de eventos do conjunto de coleta que coletou os dados. log_id é bigint sem nenhum valor padrão. Para obter o valor de log_id, consulte a exibição dbo.syscollector_execution_log no banco de dados msdb.[ @snapshot_id = ] snapshot_id
O identificador exclusivo de uma linha que é inserida na exibição core.snapshots. snapshot_id é int e é retornada como OUTPUT.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
Sempre que um pacote de carregamento começa a carregar dados no 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 uma entrada existente na tabela core.source_info_internal.
O collector_type_uid corresponde a uma entrada existente na exibição core.supported_collector_types.
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;
Consulte também