core.sp_update_data_source (Transact-SQL)

  • Artigo

Aplica-se a:SQL Server

Atualiza uma linha existente ou insere uma nova linha na tabela do data warehouse core.source_info_internal de gerenciamento. Esse procedimento é chamado pelo componente de tempo de execução do coletor de dados sempre que um pacote de carregamento começa a carregar dados no data warehouse de gerenciamento.

Convenções de sintaxe de Transact-SQL

Sintaxe

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'

O GUID do conjunto de coleta. @collection_set_uid é uniqueidentifier, sem valor padrão. Para obter o GUID, consulte o modo de exibição dbo.syscollector_collection_sets no msdb banco de dados.

@machine_name [ = ] 'machine_name'

O nome do servidor no qual o conjunto de coleta reside. @machine_name é sysname sem valor padrão.

@named_instance [ = ] 'named_instance'

O nome da instância do conjunto de coleta. @named_instance é sysname, sem valor padrão.

Observação

named_instance deve ser o nome completo da instância, que consiste no nome do computador e no nome da instância no formato <computername>\<instancename>.

@days_until_expiration [ = ] days_until_expiration

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

@source_id [ = ] source_id

O identificador exclusivo da origem da atualização. @source_id é int e é retornado como OUTPUT.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

Sempre que um pacote de carregamento começa a carregar dados para o data warehouse de gerenciamento, o componente de tempo de execução do coletor de dados chama core.sp_update_data_source. A core.source_info_internal tabela será atualizada se uma das seguintes alterações tiver ocorrido desde o último carregamento:

  • Um novo conjunto de coleta foi adicionado.
  • O valor de days_until_expiration foi alterado.

Permissões

Requer associação à função de banco de dados fixa mdw_writer (com permissão EXECUTE).

Exemplos

O exemplo a seguir atualiza a fonte de dados (nesse caso, o conjunto de coleta Uso do Disco), define o número de dias até a expiração e retorna o identificador da fonte. No exemplo, a instância padrão é usada.

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;

Conteúdo relacionado