core.sp_update_data_source (Transact-SQL)
Atualiza uma linha existente ou insere uma nova linha na tabela core.source_info_internal do data warehouse 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.
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'
A GUID do conjunto de coleta. collection_set_uid é uniqueidentifier, sem nenhum valor padrão. Para obter o GUID, consulte a exibição de dbo.syscollector_collection_sets no banco de dados msdb.[ @machine\_name = ] 'machine_name'
O nome do servidor em que reside o conjunto de coleta. machine_name é sysname sem nenhum valor padrão.[ @named\_instance = ] 'named_instance'
O nome da instância do conjunto de coleta. named_instance é sysname sem nenhum valor padrão.Observação named_instance deve ser o nome de instância totalmente qualificado, consistindo no nome do computador e no nome da instância, na forma nome_do_computador\nome_da_instância.
[ @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 é smallint.[ @source\_id = ] source_id
O identificador exclusivo da origem da atualização. source_id é int e é retornado como OUTPUT.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
Toda vez que um pacote de carregamento inicia o carregamento de dados no data warehouse de gerenciamento, o componente de tempo de execução do coletor de dados chama core.sp_update_data_source. A tabela core.source_info_internal 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 na 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;
Histórico de alterações
Conteúdo atualizado |
---|
Corrigido o nome da tabela core.source_info_internal na primeira sentença. |
Corrigido o nome do argumento named_instance na seção "Sintaxe". |
Corrigido o nome da tabela core.source_info_internal e o argumento days_until_expiration na seção "Comentários". |
Corrigido o GUID, os nomes de argumentos e a sintaxe do exemplo. |
Consulte também