Compartir a través de


core.sp_update_data_source (Transact-SQL)

Se aplica a: SQL Server

Actualiza una fila existente o inserta una nueva fila en la tabla de almacenamiento core.source_info_internal de datos de administración. 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.

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 uniqueidentifier, sin ningún valor predeterminado. Para obtener el GUID, consulte la vista dbo.syscollector_collection_sets en la msdb base de datos.

[ @machine_name = ] 'machine_name'

Nombre del servidor en el que reside el conjunto de recopilación. @machine_name es sysname sin ningún valor predeterminado.

[ @named_instance = ] 'named_instance'

Nombre de la instancia del conjunto de recopilación. @named_instance es sysname, sin ningún valor predeterminado.

Nota:

named_instance debe ser el nombre de instancia completo, que consta del nombre del equipo y del nombre de 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 smallint.

[ @source_id = ] source_id

El identificador único del origen de la actualización. @source_id es int y se devuelve como OUTPUT.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

Cada vez que un paquete de carga comienza a cargar datos en el almacenamiento de datos de administración, el componente en tiempo de ejecución del recopilador de datos llama a core.sp_update_data_source. La core.source_info_internal tabla se actualiza si se ha producido uno de los siguientes cambios desde la última carga:

  • 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;