Partager via

  • Article

core.sp_create_snapshot (Transact-SQL)

Insère une ligne dans la vue core.snapshots de l'entrepôt de données de gestion. Cette procédure est appelée 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_create_snapshot [ @collection_set_uid = ] 'collection_set_uid'
        , [ @collector_type_uid = ] 'collector_type_uid'
        ,[ @machine_name = ] 'machine_name'
        , [ @named_instance = ] 'named_instance'
        , [ @log_id = ] log_id
        , [ @snapshot_id = ] snapshot_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.

  • [ @collector\_type\_uid = ] 'collector_type_uid'
    GUID d'un type de collecteur. collector_type_uid est de type uniqueidentifier, sans valeur par défaut. Pour obtenir le GUID, interrogez la vue dbo.syscollector_collector_types 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.

  • [ @log\_id = ] log_id
    Identificateur unique mappé au journal des événements de jeu d'éléments de collecte sur le serveur qui a collecté les données. log_id est de type bigint, sans valeur par défaut. Pour obtenir la valeur de log_id, interrogez la vue dbo.syscollector_execution_log dans la base de données msdb.

  • [ @snapshot\_id = ] snapshot_id
    Identificateur unique d'une ligne qui est insérée dans la vue core.snapshots. snapshot_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_create_snapshot.

Cette procédure vérifie les points suivants :

  • collection_set_uid correspond à une entrée existante dans la table core.source_info_internal.

  • collector_type_uid correspond à une entrée existante dans la vue core.supported_collector_types.

Si l'une des vérifications précédentes échoue, la procédure échoue et retourne une erreur.

Autorisations

Requiert l'appartenance au rôle de base de données fixe mdw_writer (avec l'autorisation EXECUTE).

Exemples

L'exemple suivant crée une capture instantanée pour le jeu d'éléments de collecte Utilisation du disque, l'ajoute à l'entrepôt de données de gestion, puis retourne l'identificateur de la capture instantanée. Dans l'exemple, l'instance par défaut est utilisée.

USE <management_data_warehouse>;
DECLARE @snapshot_id int;
EXEC core.sp_create_snapshot 
    @collection_set_uid = '7B191952-8ECF-4E12-AEB2-EF646EF79FEF', 
    @collector_type_uid = '302E93D1-3424-4BE7-AA8E-84813ECF2419',
    @machine_name = '<computername>',
    @named_instance = 'MSSQLSERVER',
    @log_id = 11, -- ID of the log for the collection set
    @snapshot_id = @snapshot_id OUTPUT;

Historique des modifications

Mise à jour du contenu

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

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