Partager via

  • Article

core.sp_update_data_source (Transact-SQL)

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 rubriqueConventions de 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 d'instance complet, composé du nom d'ordinateur et du nom d'instance sous la forme nom_ordinateur\nom_instance.

  • [ @days\_until\_expiration = ] days_until_expiration
    Nombre de jours restants dans la période de rétention des données de captures instantanées. 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 que OUTPUT.

Valeurs des codes de retour

0 (succès) 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

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

Historique des modifications

Mise à jour du contenu

Correction du nom de la table core.source_info_internal dans la première phrase.

Correction du nom de l'argument named_instance dans la section « Syntaxe ».

Correction du nom de la table core.source_info_internal et de l'argument days_until_expiration dans la section « Remarques ».

Correction du GUID, des noms d'arguments et de la syntaxe dans l'exemple.