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.

Observação importanteImportante

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.