core.sp_update_data_source (Transact-SQL)

  • Article

Met à jour une ligne existante ou insère une nouvelle ligne dans la table core.source_info_internal de l'entrepôt 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.

Icône Lien de rubrique 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 de type uniqueidentifier sans valeur par défaut. Pour obtenir le GUID, interrogez la vue dbo.syscollector_collection_sets dans la base de données msdb.

  • [ @machine\_name = ] 'machine_name'
    Nom du serveur sur lequel réside le jeu d'éléments de collecte. machine_name est de type 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 de type sysname sans valeur par défaut.

    [!REMARQUE]

    named_instance doit être le nom de l'instance complet, constitué du nom d'ordinateur et du nom de l'instance sous la forme 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 de type smallint.

  • [ @source\_id = ] source_id
    Identificateur unique de la source de la mise à jour. source_id est de type int et est retourné en tant qu'OUTPUT.

Valeurs des codes de retour

0 (réussite) ou 1 (échec)

Notes

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, le composant runtime du collecteur de données appelle core.sp_update_data_source. La table core.source_info_internal est mise à jour si l'une des modifications suivantes a été apportée depuis le dernier télé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;

Voir aussi

Référence

Procédures stockées système (Transact-SQL)

Procédures stockées du collecteur de données (Transact-SQL)

Concepts

Entrepôt de données de gestion