core.sp_create_snapshot (Transact-SQL)

Artículo
06/18/2013

Inserta una fila en una vista core.snapshots del almacén de administración de datos. Se llama a este procedimiento cada vez que un paquete de carga empieza a cargar los datos en el almacén de administración de datos.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

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'
GUID del conjunto de recopilación. collection_set_uid es de tipo uniqueidentifier y no tiene ningún valor predeterminado. Para obtener el GUID, consulte la vista dbo.syscollector_collection_sets de la base de datos msdb.
[ @collector\_type\_uid = ] 'collector_type_uid'
El GUID de un tipo de recopilador. collector_type_uid es de tipo uniqueidentifier y no tiene ningún valor predeterminado. Para obtener el GUID, consulte la vista dbo.syscollector_collector_types de la base de datos msdb.
[ @machine\_name= ] 'machine_name'
Nombre del servidor en el que reside el conjunto de recopilación. machine_name es de tipo sysname y no tiene ningún valor predeterminado.
[ @named\_instance= ] 'named_instance'
Nombre de la instancia del conjunto de recopilación. named_instance es de tipo sysname y no tiene ningún valor predeterminado.
[ @log\_id = ] log_id
Identificador único que se asigna al registro de eventos de conjunto de recopilación en el servidor que recopiló los datos. log_id es de tipo bigint y no tiene ningún valor predeterminado. Para obtener el valor de log_id, consulte la vista de dbo.syscollector_execution_log de la base de datos de msdb.
[ @snapshot\_id = ] snapshot_id
Identificador único de una fila que se inserta en la vista core.snapshots. snapshot_id es de tipo int y se devuelve como OUTPUT.

Valores del código de retorno

0 (correcto) o 1 (error)

Comentarios

Cada vez que un paquete de carga inicia la carga de datos en el almacén de administración de datos, el componente en tiempo de ejecución del recopilador de datos llama a core.sp_create_snapshot.

Este procedimiento comprueba si:

collection_set_uid coincide con una entrada existente de la tabla core.source_info_internal.
collector_type_uid coincide con una entrada existente de la vista core.supported_collector_types.

Si alguna de las comprobaciones anteriores no es correcta, se produce un error en el procedimiento y se devuelve un error.

Permisos

Requiere la pertenencia al rol fijo de base de datos mdw_writer (con permiso EXECUTE).

Ejemplos

En el siguiente ejemplo se crea una instantánea para el conjunto de recopilación Uso de disco, se agrega al almacén de administración de datos y se devuelve al identificador de la instantánea. En este ejemplo se usa la instancia predeterminada.

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;

Vea también

Referencia

Procedimientos almacenados del sistema (Transact-SQL)

Procedimientos almacenados del recopilador de datos (Transact-SQL)

Conceptos

Almacén de datos de administración

Share via