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.

Nota importanteImportante

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.