Compartir a través de

core.sp_update_data_source (Transact-SQL)

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 temasConvenciones 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 ningún valor predeterminado. Para obtener el GUID, consulte la vista dbo.syscollector_collection_sets en 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.

    [!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 nombreDeEquipo\nombreDeInstancia.

  • [ @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
    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)

Notas

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 a la función de base de datos fija 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;

Historial de cambios

Contenido actualizado

Se ha corregido el nombre de la tabla core.source_info_internal en la primera frase.

Se ha corregido el nombre del argumento named_instance en la sección "Sintaxis".

Se ha corregido el nombre de la tabla core.source_info_internal y el argumento days_until_expiration en la sección "Comentarios".

Se han corregido el GUID, los nombres de los argumentos y la sintaxis del ejemplo.
  • Last updated on