Gerenciando a coleta de dados usando Transact-SQL

O coletor de dados fornece uma extensa coleção de procedimentos armazenados que você pode usar para executar qualquer tarefa de coleta de dados. Além disso, existem funções e exibições que podem ser utilizadas para obter dados de configuração dos bancos de dados msdb e do data warehouse de gerenciamento, dados do log de execução e dados armazenados no data warehouse de gerenciamento.

Você pode usar os procedimentos armazenados, funções e exibições fornecidos para criar seus próprios cenários de coleta de dados completos.

Importante
Diferentemente de procedimentos armazenados regulares, os procedimentos armazenados do coletor de dados usam apenas parâmetros digitados e não oferecem suporte a conversão de tipo de dados automática. Se esses parâmetros não forem chamados pelos tipos de dados com parâmetro de entrada corretos, como especificado na descrição do argumento, o procedimento armazenado retornará um erro.

Você pode usar o SQL Server Management Studio para criar e executar os códigos de amostra fornecidos. Para obter mais informações, consulte Usando o Pesquisador de Objetos. Como alternativa, você pode criar a consulta em qualquer editor e salvá-la em um arquivo de texto com uma extensão de nome de arquivo .sql. Você pode executar a consulta no prompt de comando do Windows usando o utilitário sqlcmd. Para obter mais informações, consulte Usando o utilitário sqlcmd.

Exibições e procedimentos armazenados

Trabalhando com o coletor de dados

A tabela a seguir descreve os procedimentos armazenados que podem ser usados para funcionar com o coletor de dados.

Nome do procedimento	Descrição
sp_syscollector_enable_collector	Habilita o coletor de dados.
sp_syscollector_disable_collector	Desabilita o coletor de dados.

Trabalhando com conjuntos de coleta

A tabela a seguir descreve os procedimentos armazenados que podem ser usados para funcionar com os conjuntos de coleta.

Nome do procedimento	Descrição
sp_syscollector_run_collection_set (Transact-SQL)	Executar um conjunto de coleta sob demanda.
sp_syscollector_start_collection_set (Transact-SQL)	Iniciar um conjunto de coleta.
sp_syscollector_stop_collection_set (Transact-SQL)	Parar um conjunto de coleta.
sp_syscollector_create_collection_set (Transact-SQL)	Criar um conjunto de coleta.
sp_syscollector_delete_collection_set (Transact-SQL)	Excluir um conjunto de coleta.
sp_syscollector_update_collection_set (Transact-SQL)	Alterar a configuração de um conjunto de coleta.
sp_syscollector_upload_collection_set (Transact-SQL)	Carregar dados de um conjunto de coleta no data warehouse de gerenciamento. Isso é efetivamente um carregamento sob demanda.

Trabalhando com itens de coleta

A tabela a seguir descreve os procedimentos armazenados que podem ser usados para funcionar com os itens de coleta.

Nome do procedimento	Descrição
sp_syscollector_create_collection_item (Transact-SQL)	Criar um item de coleta.
sp_syscollector_delete_collection_item (Transact-SQL)	Excluir um item de coleta.
sp_syscollector_update_collection_item (Transact-SQL)	Atualizar um item de coleta.

Trabalhando com tipos de coletor

A tabela a seguir descreve os procedimentos armazenados que podem ser usados para funcionar com os tipos de coletor.

Nome do procedimento	Descrição
sp_syscollector_create_collector_type (Transact-SQL)	Criar um tipo de coletor.
sp_syscollector_update_collector_type (Transact-SQL)	Atualizar um tipo de coletor.
sp_syscollector_delete_collector_type (Transact-SQL)	Excluir um tipo de coletor.

Obtendo informações de configuração

A tabela a seguir descreve as exibições que podem ser usadas para se obter informações de configuração e dados do log de execução.

Nome da exibição	Descrição
syscollector_config_store (Transact-SQL)	Obter configuração do coletor de dados.
syscollector_collection_items (Transact-SQL)	Obter informações sobre o item de coleta.
syscollector_collection_sets (Transact-SQL)	Obter informações sobre o conjunto de coleta.
syscollector_collector_types (Transact-SQL)	Obter informações sobre o tipo de coletor.
syscollector_execution_log (Transact-SQL)	Obter informações sobre o conjunto de coleta e a execução do pacote.
syscollector_execution_stats (Transact-SQL)	Obter informações sobre a execução de tarefa.
syscollector_execution_log_full (Transact-SQL)	Obter informações quando o log de execução estiver completo.

Configurando o acesso ao data warehouse de gerenciamento

A tabela a seguir descreve os procedimentos armazenados que podem ser usados para configurar o acesso ao data warehouse de gerenciamento.

Nome do procedimento	Descrição
sp_syscollector_set_warehouse_database_name (Transact-SQL)	Especificar o nome de banco de dados definido na cadeia de caracteres de conexão para o data warehouse de gerenciamento.
sp_syscollector_set_warehouse_instance_name (Transact-SQL)	Especificar a instância definida na cadeia de caracteres de conexão para o data warehouse de gerenciamento.

Configurando o data warehouse de gerenciamento

A tabela a seguir descreve os procedimentos armazenados que podem ser usados para funcionar com a configuração do data warehouse de gerenciamento.

Nome do procedimento	Descrição
core.sp_create_snapshot (Transact-SQL)	Criar um instantâneo de coleta no data warehouse de gerenciamento.
core.sp_update_data_source (Transact-SQL)	Atualizar a fonte de dados para coleta de dados.
core.sp_add_collector_type (Transact-SQL)	Adicionar um tipo de coletor ao data warehouse de gerenciamento.
core.sp_remove_collector_type (Transact-SQL)	Remover um tipo de coletor do data warehouse de gerenciamento.
core.sp_purge_data (Transact-SQL)	Excluir dados do data warehouse de gerenciamento.

Trabalhando com pacotes de carregamento

A tabela a seguir descreve os procedimentos armazenados que podem ser usados para funcionar com pacotes de carregamento.

Nome do procedimento	Descrição
sp_syscollector_set_cache_window (Transact-SQL)	Configurar o número de repetições do carregamento de dados.
sp_syscollector_set_cache_directory (Transact-SQL)	Especificar o armazenamento temporário entre as repetições de carregamento.

Trabalhando com o log de execução de coleta de dados

A tabela a seguir descreve os procedimentos armazenados que podem ser usados para funcionar com o log de execução de coleta de dados.

Nome do procedimento	Descrição
sp_syscollector_delete_execution_log_tree (Transact-SQL)	Excluir entradas do conjunto de coleta do log de execução.

Funções

A tabela a seguir descreve as funções que podem ser usadas para obter informações de execução e rastreamento.

Nome da função	Descrição
fn_syscollector_get_execution_details (Transact-SQL)	Obter os dados de log de execução do SSIS para um pacote específico.
fn_syscollector_get_execution_stats (Transact-SQL)	Obter estatísticas de execução para um pacote ou conjunto de coleta. Estas informações incluem erros que estão registrados.
snapshots.fn_trace_gettable (Transact-SQL)	Obter os eventos que são registrados quando o tipo de coletor de Rastreamento SQL Genérico é usado para coletar dados.

Nesta seção

Como configurar parâmetros de coleta de dados	Como criar um conjunto de coleta personalizado que usa o tipo de coletor de Consultas T-SQL genérico
Como adicionar um item de coleta a um conjunto de coletas

Consulte também

Conceitos

Gerenciando coleta de dados usando o SQL Server Management Studio

Executando procedimentos armazenados (Mecanismo de Banco de Dados)

Outros recursos

Usando o SQL Server Management Studio