core.sp_create_snapshot (Transact-SQL)
S'applique à : SQL Server
Insère une ligne dans la vue de l’entrepôt core.snapshots
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.
Conventions de la 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 uniqueidentifier sans valeur par défaut. Pour obtenir le GUID, interrogez la vue dbo.syscollector_collection_sets dans la msdb
base de données.
[ @collector_type_uid = ] 'collector_type_uid'
GUID d'un type de collecteur. @collector_type_uid est uniqueidentifier sans valeur par défaut. Pour obtenir le GUID, interrogez la vue dbo.syscollector_collector_types 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.
[ @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 bigint sans valeur par défaut. Pour obtenir la valeur de log_id, interrogez la vue dbo.syscollector_execution_log dans la msdb
base de données.
[ @snapshot_id = ] snapshot_id
Identificateur unique d’une ligne insérée dans la core.snapshots
vue. @snapshot_id est int et est retourné en tant que OUTPUT.
Valeurs des codes de retour
0
(réussite) ou 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_create_snapshot
.
Cette procédure vérifie les points suivants :
Le collection_set_uid correspond à une entrée existante dans la
core.source_info_internal
table.Le collector_type_uid correspond à une entrée existante dans la
core.supported_collector_types
vue.
Si l'une des vérifications précédentes échoue, la procédure échoue et retourne une erreur.
autorisations
Nécessite l’appartenance au rôle de base de données fixe mdw_writer (avec l’autorisation EXECUTE).
Exemples
L'exemple suivant crée un instantané 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 l'instantané. 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;
Contenu connexe
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour