Partager via


Gestion de la collecte de données à l'aide de Transact-SQL

Le collecteur de données fournit une collection complète de procédures stockées qui vous permettent d'effectuer n'importe quelle tâche de collecte de données. De plus, vous disposez de fonctions et de vues qui vous permettent d'obtenir des données de configuration pour les bases de données msdb et l'entrepôt de données de gestion, des données du journal des exécutions et des données stockées dans l'entrepôt de données de gestion.

Vous pouvez utiliser les procédures stockées, les fonctions et les vues fournies pour créer vos propres scénarios de collecte de données de bout en bout.

Important

Contrairement aux procédures stockées standard, les procédures stockées du collecteur de données utilisent des paramètres de type strict et elles ne prennent pas en charge la conversion automatique de type de données. Si ces paramètres ne sont pas appelés à l'aide des types de données appropriés pour les paramètres d'entrée tels qu'ils sont spécifiés dans la description de l'argument, la procédure stockée retourne une erreur.

Vous pouvez utiliser SQL Server Management Studio pour créer et exécuter les exemples de code qui sont fournis. Pour plus d'informations, consultez Utilisation de l'Explorateur d'objets. Vous pouvez également créer la requête dans n'importe quel éditeur et l'enregistrer dans un fichier texte avec une extension de nom de fichier .sql. Vous pouvez exécuter la requête à partir de l'invite de commandes Windows, à l'aide de l'utilitaire sqlcmd. Pour plus d'informations, voir Utilisation de l'utilitaire sqlcmd.

Procédures stockées et vues

Utilisation du collecteur de données

Le tableau suivant décrit les procédures stockées que vous pouvez utiliser avec le collecteur de données.

Nom de la procédure

Description

sp_syscollector_enable_collector

Active le collecteur de données.

sp_syscollector_disable_collector

Désactive le collecteur de données.

Utilisation de jeux d'éléments de collecte

Le tableau suivant décrit les procédures stockées que vous pouvez utiliser avec les jeux d'éléments de collecte.

Nom de la procédure

Description

sp_syscollector_run_collection_set (Transact-SQL)

Exécute un jeu d'éléments de collecte à la demande.

sp_syscollector_start_collection_set (Transact-SQL)

Démarrer un jeu d'éléments de collecte.

sp_syscollector_stop_collection_set (Transact-SQL)

Arrêter un jeu d'éléments de collecte.

sp_syscollector_create_collection_set (Transact-SQL)

Créer un jeu d'éléments de collecte.

sp_syscollector_delete_collection_set (Transact-SQL)

Supprimer un jeu de collections.

sp_syscollector_update_collection_set (Transact-SQL)

Modifie la configuration d'un jeu de collections.

sp_syscollector_upload_collection_set (Transact-SQL)

Télécharger les données d'un jeu d'éléments de collecte dans l'entrepôt de données de gestion. Il s'agit effectivement d'un téléchargement à la demande.

Utilisation d'éléments de collecte

Le tableau suivant décrit les procédures stockées que vous pouvez utiliser avec les éléments de collecte.

Nom de la procédure

Description

sp_syscollector_create_collection_item (Transact-SQL)

Créer un élément de collecte.

sp_syscollector_delete_collection_item (Transact-SQL)

Supprimer un élément de collecte.

sp_syscollector_update_collection_item (Transact-SQL)

Mettre à jour un élément de collecte.

Utilisation de types de collecteurs

Le tableau suivant décrit les procédures stockées que vous pouvez utiliser avec les types de collecteurs.

Nom de la procédure

Description

sp_syscollector_create_collector_type (Transact-SQL)

Créer un type de collecteur.

sp_syscollector_update_collector_type (Transact-SQL)

Mettre à jour un type de collecteur.

sp_syscollector_delete_collector_type (Transact-SQL)

Supprimer un type de collecteur.

Obtention d'informations de configuration

Le tableau suivant décrit les vues que vous pouvez utiliser pour obtenir des informations de configuration et des données du journal des exécutions.

Nom de la vue

Description

syscollector_config_store (Transact-SQL)

Obtenir la configuration du collecteur de données.

syscollector_collection_items (Transact-SQL)

Obtenir des informations sur des éléments de collecte.

syscollector_collection_sets (Transact-SQL)

Obtenir des informations sur des jeux d'éléments de collecte.

syscollector_collector_types (Transact-SQL)

Obtenir des informations sur des types de collecteurs.

syscollector_execution_log (Transact-SQL)

Obtenir des informations sur l'exécution des jeux de collections et des packages.

syscollector_execution_stats (Transact-SQL)

Obtenir des informations sur l'exécution des tâches.

syscollector_execution_log_full (Transact-SQL)

Obtenir des informations lorsque le journal des exécutions est plein.

Configuration de l'accès à l'entrepôt de données de gestion

Le tableau suivant décrit les procédures stockées que vous pouvez utiliser pour configurer l'accès à l'entrepôt de données de gestion.

Nom de la procédure

Description

sp_syscollector_set_warehouse_database_name (Transact-SQL)

Spécifier le nom de base de données défini dans la chaîne de connexion pour l'entrepôt de données de gestion.

sp_syscollector_set_warehouse_instance_name (Transact-SQL)

Spécifier l'instance définie dans la chaîne de connexion pour l'entrepôt de données de gestion.

Configuration de l'entrepôt de données de gestion

Le tableau suivant décrit les procédures stockées que vous pouvez utiliser avec la configuration de l'entrepôt de données de gestion.

Nom de la procédure

Description

core.sp_create_snapshot (Transact-SQL)

Créer une capture instantanée de collection dans l'entrepôt de données de gestion.

core.sp_update_data_source (Transact-SQL)

Mettre à jour la source de données pour la collecte de données.

core.sp_add_collector_type (Transact-SQL)

Ajouter un type de collecteur à l'entrepôt de données de gestion.

core.sp_remove_collector_type (Transact-SQL)

Supprimer un type de collecteur de l'entrepôt de données de gestion.

core.sp_purge_data (Transact-SQL)

Supprimer des données de l'entrepôt de données de gestion.

Utilisation de packages de téléchargement

Le tableau suivant décrit les procédures stockées que vous pouvez utiliser avec les packages de téléchargement.

Nom de la procédure

Description

sp_syscollector_set_cache_window (Transact-SQL)

Configurer le nombre de tentatives de téléchargement de données.

sp_syscollector_set_cache_directory (Transact-SQL)

Spécifier le stockage temporaire des données entre les tentatives de téléchargement.

Utilisation du journal des exécutions de la collecte de données

Le tableau suivant décrit les procédures stockées que vous pouvez utiliser avec le journal des exécutions de la collecte de données.

Nom de la procédure

Description

sp_syscollector_delete_execution_log_tree (Transact-SQL)

Supprimer des entrées de jeu de collections du journal des exécutions.

Fonctions

Le tableau suivant décrit les fonctions que vous pouvez utiliser pour obtenir des informations d'exécution et de trace.

Nom de la fonction

Description

fn_syscollector_get_execution_details (Transact-SQL)

Obtenir les données du journal des exécutions SSIS pour un package spécifique.

fn_syscollector_get_execution_stats (Transact-SQL)

Obtenir les statistiques d'exécution d'un jeu d'éléments de collecte ou d'un package. Ces informations incluent les erreurs enregistrées.

snapshots.fn_trace_gettable (Transact-SQL)

Obtenir les événements enregistrés lorsque le type de collecteur SQL Trace générique est utilisé pour collecter des données.