sp_syscollector_create_collection_set (Transact-SQL)
Cria um novo conjunto de coleta. Use este procedimento armazenado para criar um conjunto de coleta personalizado para a coleta de dados.
.gif "Ícone de vínculo de tópico")
Sintaxe
sp_syscollector_create_collection_set
[ @name = ] 'name'
, [ [ @target = ] 'target' ]
, [ [ @collection_mode = ] collection_mode ]
, [ [ @days_until_expiration = ] days_until_expiration ]
, [ [ @proxy_id = ] proxy_id ]
, [ [ @proxy_name = ] 'proxy_name' ]
, [ [ @schedule_uid = ] 'schedule_uid' ]
, [ [ @schedule_name = ] 'schedule_name' ]
, [ [ @logging_level = ] logging_level ]
, [ [ @description = ] 'description' ]
, [ @collection_set_id = ] collection_set_id OUTPUT
, [ [ @collection_set_uid = ] 'collection_set_uid' OUTPUT ]
Argumentos
[ @name = ] 'name'
É o nome do conjunto de coleta. name é sysname e não pode ser uma cadeia de caracteres vazia ou NULL.name deve ser exclusivo. Para obter uma lista dos nomes dos conjuntos de coleta atuais, consulte a exibição de sistema syscollector_collection_sets.
[ @target = ] 'target'
Reservado para uso futuro. name é nvarchar(128) com um valor padrão de NULL.[ @collection\_mode = ] collection_mode
Especifica a maneira na qual os dados são coletados e armazenados. collection_mode é smallint e pode ter um dos seguintes valores:0 - Modo de cache. A coleta e o carregamento de dados estão em agendas separadas. Especifique o modo cache para a coleta contínua.
1 - Modo não armazenado em cache. A coleta e o carregamento de dados estão na mesma agenda. Especifique o modo não armazenado em cache para a coleta ad hoc ou de instantâneo.
O valor padrão de collection_mode é 0. Quando collection_mode é 0, schedule_uid ou schedule_name deve ser especificado.
[ @days\_until\_expiration = ] days_until_expiration
É o número de dias que os dados coletados são salvos no data warehouse de gerenciamento. days_until_expiration é smallint com um valor padrão de 730 (dois anos). days_until_expiration deve ser 0 ou um inteiro positivo.[ @proxy\_id = ] proxy_id
É o identificador exclusivo de uma conta proxy do SQL Server Agent. proxy_id é int com um valor padrão de NULL. Se especificado, proxy_name deve ser NULL. Para obter proxy_id, consulte a tabela de sistema sysproxies. A função de banco de dados fixa dc_admin deve ter permissão para acessar o proxy. Para obter mais informações, consulte Criando proxies do SQL Server Agent.[ @proxy\_name = ] 'proxy_name'
É o nome da conta proxy. proxy_name is sysname com um valor padrão de NULL. Se especificado, proxy_id deve ser NULL. Para obter proxy_name, consulte a tabela de sistema sysproxies.[ @schedule\_uid = ] 'schedule_uid'
É a GUID que aponta para uma agenda. schedule_uid é uniqueidentifier com um valor padrão de NULL. Se especificado, schedule_name deve ser NULL. Para obter schedule_uid, consulte a tabela de sistema sysschedules.Quando collection_mode estiver definido para 0, schedule_uid ou schedule_name deve ser especificado. Quando collection_mode estiver definido como 1, schedule_uid ou schedule_name será ignorado se especificado.
[ @schedule\_name = ] 'schedule_name'
É o nome da agenda. schedule_name é sysname com um valor padrão de NULL. Se especificado, schedule_uid deve ser NULL. Para obter schedule_name, consulte a tabela de sistema sysschedules.[ @logging\_level = ] logging_level
É o nível de log. logging_level é smallint com um destes valores:0 - informações de execução de log e eventos SSIS que monitoram:
Iniciando/interrompendo conjuntos de coleta
Iniciando/interrompendo pacotes
Informações de erro
1 - log de nível 0 e:
Estatísticas de execução
Progresso da coleta em execução contínua
Eventos de advertência do SSIS
2 - log de nível 1 e informações de evento detalhadas do SSIS
O valor padrão de logging_level é 1.
[ @description = ] 'description'
É a descrição do conjunto de coleta. description é nvarchar(4000) com um valor padrão de NULL.[ @collection\_set\_id = ] collection_set_id
É o identificador de local exclusivo do conjunto de coleta. collection_set_id é int com OUTPUT e é necessário.[ @collection\_set\_uid = ] 'collection_set_uid'
É a GUID do conjunto de coleta. collection_set_uid é uniqueidentifier com OUTPUT com um valor padrão de NULL.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
sp_syscollector_create_collection_set deve ser executado no contexto do banco de dados de sistema msdb.
Permissões
Requer associação na função de banco de dados fixa dc_admin (com a permissão EXECUTE) para executar esse procedimento.
Exemplos
A. Criando um conjunto de coleta com o uso de valores padrão
O exemplo a seguir cria um conjunto de coleta com a especificação dos parâmetros necessários apenas. @collection\_mode não é necessário, mas o modo de coleta padrão (cache) requer a especificação de uma ID ou nome de agenda.
USE msdb;
GO
DECLARE @collection_set_id int;
EXECUTE dbo.sp_syscollector_create_collection_set
@name = N'Simple collection set test 1',
@description = N'This is a test collection set that runs in non-cached mode.',
@collection_mode = 1,
@collection_set_id = @collection_set_id OUTPUT;
GO
B. Criando um conjunto de coleta usando os valores especificados
O exemplo a seguir cria um conjunto de coleta especificando valores para muitos dos parâmetros.
USE msdb;
GO
DECLARE @collection_set_id int;
DECLARE @collection_set_uid uniqueidentifier;
SET @collection_set_uid = NEWID();
EXEC dbo.sp_syscollector_create_collection_set
@name = N'Simple collection set test 2',
@collection_mode = 0,
@days_until_expiration = 365,
@description = N'This is a test collection set that runs in cached mode.',
@logging_level = 2,
@schedule_name = N'CollectorSchedule_Every_30min',
@collection_set_id = @collection_set_id OUTPUT,
@collection_set_uid = @collection_set_uid OUTPUT;