core.sp_update_data_source (Transact-SQL)

Artículo
06/18/2013

Actualiza una fila existente o inserta una fila nueva en la tabla core.source_info_internal del almacén de administración de datos. El componente en tiempo de ejecución del recopilador de datos llama a este procedimiento cada vez que un paquete de carga comienza 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_update_data_source [ @collection_set_uid = ] 'collection_set_uid' 
    ,[ @machine_name = ] 'machine_name'
    , [ @named_instance = ] 'named_instance'
    , [ @days_until_expiration = ] days_until_expiration 
    , [ @source_id = ] source_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 valor predeterminado. Para obtener el GUID, vea la vista dbo.syscollector_collection_sets 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 valor predeterminado.
[ @named\_instance = ] 'named_instance'
Nombre de la instancia del conjunto de recopilación. named_instance es de tipo sysname y no tiene valor predeterminado.

[!NOTA]

named_instance debe ser un nombre de instancia completo y se compone del nombre del equipo y del nombre de la instancia con el formato computername\instancename.
[ @days\_until\_expiration = ] days_until_expiration
Número de días restantes en el período de retención de datos de la instantánea. days_until_expiration es de tipo smallint.
[ @source\_id = ] source_id
El identificador único del origen de la actualización. source_id es de tipo int y se devuelve como OUTPUT.

Valores de 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_update_data_source. La tabla core.source_info_internal se actualiza si se produjo alguno de los cambios siguientes desde la última actualización:

Se agregó un nuevo conjunto de recopilación.
El valor de days_until_expiration ha cambiado.

Permisos

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

Ejemplos

En el ejemplo siguiente se actualiza el origen de datos (en este caso el conjunto de recopilación Uso de disco), establece el número de días hasta la expiración y devuelve el identificador del origen. En este ejemplo se usa la instancia predeterminada.

USE <management_data_warehouse>;
GO
DECLARE @source_id int;
EXEC core.sp_update_data_source 
@collection_set_uid = '7B191952-8ECF-4E12-AEB2-EF646EF79FEF', 
@machine_name = '<computername>',
@named_instance = 'MSSQLSERVER',
@days_until_expiration = 10,
@source_id = @source_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