Gestione della raccolta dati mediante Transact-SQL

L'agente di raccolta dati fornisce un vasto insieme di stored procedure che è possibile utilizzare per eseguire qualsiasi attività di raccolta dati. Sono inoltre disponibili funzioni e viste che è possibile utilizzare per ottenere dati di configurazione per i database msdb e del data warehouse di gestione, dati del log di esecuzione e dati archiviati nel data warehouse di gestione.

È possibile utilizzare le stored procedure, le funzioni e le viste fornite per creare i propri scenari di raccolta dati end-to-end.

Importante
A differenza delle normali stored procedure, le stored procedure dell'agente di raccolta dati utilizzano parametri fortemente tipizzati e non supportano la conversione automatica del tipo di dati. Se tali parametri non vengono chiamati con i tipi di dati corretti per i parametri di input, come indicato nella descrizione dell'argomento, la stored procedure restituisce un errore.

È possibile utilizzare SQL Server Management Studio per creare ed eseguire gli esempi di codice forniti. Per ulteriori informazioni, vedere Utilizzo di Esplora oggetti. In alternativa, è possibile creare la query con un editor qualsiasi e salvarla in un file di testo con estensione sql. È possibile eseguire la query dal prompt dei comandi di Windows mediante l'utilità sqlcmd. Per ulteriori informazioni, vedere Utilizzo dell'utilità sqlcmd.

Stored procedure e viste

Utilizzo dell'agente di raccolta dati

Nella tabella seguente vengono descritte le stored procedure che è possibile eseguire per utilizzare l'agente di raccolta dati.

Nome della stored procedure	Descrizione
sp_syscollector_enable_collector	Abilitare l'agente di raccolta dati
sp_syscollector_disable_collector	Disabilitare l'agente di raccolta dati.

Utilizzo degli insiemi di raccolta

Nella tabella seguente vengono descritte le stored procedure che è possibile eseguire per utilizzare gli insiemi di raccolta.

Nome della stored procedure	Descrizione
sp_syscollector_run_collection_set (Transact-SQL)	Eseguire un insieme di raccolta su richiesta.
sp_syscollector_start_collection_set (Transact-SQL)	Avviare un insieme di raccolta.
sp_syscollector_stop_collection_set (Transact-SQL)	Interruzione di un insieme di raccolta.
sp_syscollector_create_collection_set (Transact-SQL)	Creare un insieme di raccolta.
sp_syscollector_delete_collection_set (Transact-SQL)	Eliminare un insieme di raccolta.
sp_syscollector_update_collection_set (Transact-SQL)	Modificare la configurazione di un insieme di raccolta.
sp_syscollector_upload_collection_set (Transact-SQL)	Caricare i dati relativi a un insieme di raccolta nel data warehouse di gestione. Si tratta infatti di un caricamento su richiesta.

Utilizzo di elementi della raccolta

Nella tabella seguente vengono descritte le stored procedure che è possibile eseguire per utilizzare gli elementi della raccolta.

Nome della stored procedure	Descrizione
sp_syscollector_create_collection_item (Transact-SQL)	Creare un elemento della raccolta.
sp_syscollector_delete_collection_item (Transact-SQL)	Eliminare un elemento della raccolta.
sp_syscollector_update_collection_item (Transact-SQL)	Caricare un elemento della raccolta.

Utilizzo dei tipi di agente di raccolta

Nella tabella seguente vengono descritte le stored procedure che è possibile eseguire per utilizzare i tipi di agente di raccolta.

Nome della stored procedure	Descrizione
sp_syscollector_create_collector_type (Transact-SQL)	Creare un tipo di agente di raccolta.
sp_syscollector_update_collector_type (Transact-SQL)	Aggiornare un tipo di agente di raccolta.
sp_syscollector_delete_collector_type (Transact-SQL)	Eliminare un tipo di agente di raccolta.

Come ottenere informazioni sulla configurazione

Nella tabella seguente vengono descritte le viste che è possibile utilizzare per ottenere informazioni di configurazione e dati del log di esecuzione.

Nome della vista	Descrizione
syscollector_config_store (Transact-SQL)	Ottenere la configurazione dell'agente di raccolta dati.
syscollector_collection_items (Transact-SQL)	Ottenere informazioni su un elemento della raccolta.
syscollector_collection_sets (Transact-SQL)	Ottenere informazioni su un insieme di raccolta.
syscollector_collector_types (Transact-SQL)	Ottenere informazioni sul tipo di agente di raccolta.
syscollector_execution_log (Transact-SQL)	Ottenere informazioni su insieme di raccolta ed esecuzione del pacchetto.
syscollector_execution_stats (Transact-SQL)	Ottenere informazioni sull'esecuzione dell'attività.
syscollector_execution_log_full (Transact-SQL)	Ottenere informazioni quando il log di esecuzione è pieno.

Configurazione dell'accesso al data warehouse di gestione.

Nella tabella seguente vengono descritte le stored procedure che è possibile eseguire per configurare l'accesso al data warehouse di gestione.

Nome della stored procedure	Descrizione
sp_syscollector_set_warehouse_database_name (Transact-SQL)	Specificare il nome del database definito nella stringa di connessione per il data warehouse di gestione.
sp_syscollector_set_warehouse_instance_name (Transact-SQL)	Specificare l'istanza definita nella stringa di connessione per il data warehouse di gestione.

Configurazione del data warehouse di gestione.

Nella tabella seguente vengono descritte le stored procedure che è possibile eseguire per utilizzare la configurazione del data warehouse di gestione.

Nome della stored procedure	Descrizione
core.sp_create_snapshot (Transact-SQL)	Creare uno snapshot di raccolta nel data warehouse di gestione.
core.sp_update_data_source (Transact-SQL)	Aggiornare l'origine dati per la raccolta dati.
core.sp_add_collector_type (Transact-SQL)	Aggiungere un tipo di agente di raccolta al data warehouse di gestione.
core.sp_remove_collector_type (Transact-SQL)	Rimuovere un tipo di agente di raccolta dal data warehouse di gestione.
core.sp_purge_data (Transact-SQL)	Eliminare dati dal data warehouse di gestione.

Utilizzo dei pacchetti di caricamento

Nella tabella seguente vengono descritte le stored procedure che è possibile eseguire per utilizzare i pacchetti di caricamento.

Nome della stored procedure	Descrizione
sp_syscollector_set_cache_window (Transact-SQL)	Configurare il numero di tentativi di caricamento dei dati.
sp_syscollector_set_cache_directory (Transact-SQL)	Specificare l'archiviazione temporanea dei dati tra i tentativi di caricamento.

Utilizzo del log di esecuzione della raccolta dati

Nella tabella seguente vengono descritte le stored procedure che è possibile eseguire per utilizzare il log di esecuzione della raccolta dati.

Nome della stored procedure	Descrizione
sp_syscollector_delete_execution_log_tree (Transact-SQL)	Eliminare voci relative a insieme di raccolta dal log di esecuzione.

Funzioni

Nella tabella seguente vengono descritte le funzioni che è possibile utilizzare per ottenere informazioni di esecuzione e di traccia.

Nome funzione	Descrizione
fn_syscollector_get_execution_details (Transact-SQL)	Ottenere dati del log di esecuzione SSIS relativi a un pacchetto specifico.
fn_syscollector_get_execution_stats (Transact-SQL)	Ottenere statistiche di esecuzione relative a un insieme di raccolta o un pacchetto. Tali informazioni comprendono gli errori registrati.
snapshots.fn_trace_gettable (Transact-SQL)	Ottenere gli eventi registrati quando viene utilizzato il tipo di agente di raccolta Traccia SQL generico per raccogliere dati.

Contenuto della sezione

Procedura: Configurazione dei parametri per la raccolta dati	Procedura: Creazione di un insieme di raccolta personalizzato che utilizza il tipo di agente di raccolta Query T-SQL generico
Procedura: Aggiunta di un elemento della raccolta a un insieme di raccolta

Vedere anche

Concetti

Gestione della raccolta dati mediante SQL Server Management Studio

Esecuzione di stored procedure (Motore di database)

Altre risorse

Utilizzo di SQL Server Management Studio