core.sp_update_data_source (Transact-SQL)

  • Article

S'applique à : SQL Server

Met à jour une ligne existante ou insère une nouvelle ligne dans la table de l’entrepôt core.source_info_internal de données de gestion. Cette procédure est appelée par le composant runtime du collecteur de données chaque fois qu'un package de téléchargement commence à télécharger des données dans l'entrepôt de données de gestion.

Conventions de la syntaxe Transact-SQL

Syntaxe

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'

GUID du jeu d'éléments de collecte. @collection_set_uid est uniqueidentifier, sans valeur par défaut. Pour obtenir le GUID, interrogez la vue dbo.syscollector_collection_sets dans la msdb base de données.

[ @machine_name = ] 'machine_name'

Nom du serveur sur lequel réside le jeu d'éléments de collecte. @machine_name est sysname sans valeur par défaut.

[ @named_instance = ] 'named_instance'

Nom de l'instance pour le jeu d'éléments de collecte. @named_instance est sysname, sans valeur par défaut.

Remarque

named_instance doit être le nom complet de l’instance, qui se compose du nom de l’ordinateur et du nom de l’instance dans le formulaire <computername>\<instancename>.

[ @days_until_expiration = ] days_until_expiration

Nombre de jours restants dans la période de rétention des données d'instantanés. @days_until_expiration est petit.

[ @source_id = ] source_id

Identificateur unique de la source de la mise à jour. @source_id est int et est retourné en tant que OUTPUT.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

Chaque fois qu’un package de chargement commence à charger des données dans l’entrepôt de données de gestion, le composant d’exécution du collecteur de données appelle core.sp_update_data_source. La core.source_info_internal table est mise à jour si l’une des modifications suivantes s’est produite depuis le dernier chargement :

  • Un nouveau jeu d'éléments de collecte a été ajouté.
  • La valeur de days_until_expiration a changé.

autorisations

Nécessite l’appartenance au rôle de base de données fixe mdw_writer (avec l’autorisation EXECUTE).

Exemples

L'exemple suivant met à jour la source de données (dans le cas présent, le jeu d'éléments de collecte Utilisation du disque), définit le nombre de jours avant l'expiration et retourne l'identificateur de la source. Dans l'exemple, l'instance par défaut est utilisée.

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;

Contenu connexe