core.sp_update_data_source (Transact-SQL)

Aplica-se a: SQL Server

Atualiza uma linha existente ou insere uma nova linha na tabela do armazém core.source_info_internal de dados de gestão. Este procedimento é chamado pelo componente de execução do coletor de dados sempre que um pacote de upload começa a carregar dados para o armazém de dados de gestão.

Transact-SQL convenções de sintaxe

Syntax

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
[ ; ]

Arguments

[ @collection_set_uid = ] 'collection_set_uid'

O GUID para o conjunto da coleção. @collection_set_uid é identificador único, sem valor padrão. Para obter o GUID, consulte a vista dbo.syscollector_collection_sets na msdb base de dados.

[ @machine_name = ] 'machine_name'

O nome do servidor onde reside o conjunto de coleções. @machine_name é nome de sistema sem valor predefinido.

[ @named_instance = ] 'named_instance'

O nome da instância para o conjunto de coleções. @named_instance é sysname, sem valor padrão.

Note

named_instance deve ser o nome da instância totalmente qualificado, que consiste no nome do computador e no nome da instância na forma <computername>\<instancename>.

[ @days_until_expiration = ] days_until_expiration

O número de dias restantes no período de retenção de dados snapshot. @days_until_expiration é pequeno.

[ @source_id = ] source_id

O identificador único da origem da atualização. @source_id é int e é devolvido como OUTPUT.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

Sempre que um pacote de upload começa a carregar dados para o armazém de dados de gestão, o componente de tempo de execução do recolhedor de dados chama core.sp_update_data_source. A core.source_info_internal tabela é atualizada se uma das seguintes alterações tiver ocorrido desde o último carregamento:

  • Foi adicionado um novo conjunto de coleções.
  • O valor da days_until_expiration mudou.

Permissões

Requer a pertença ao papel fixo de base de dados mdw_writer (com permissão EXECUTAR).

Examples

O exemplo seguinte atualiza a fonte de dados (neste caso, o conjunto de recolha de Utilização de Disco), define o número de dias até à expiração e devolve o identificador da fonte. No exemplo, é usada a instância padrão.

USE <management_data_warehouse>;
GO
DECLARE @source_id INT;

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