sp_syscollector_update_collection_set (Transact-SQL)

Se usa para modificar las propiedades o el nombre de un conjunto de recopilación definido por el usuario.

Advertencia

En los casos en que la cuenta de Windows configurada como proxy pertenezca a un usuario no interactivo o interactivo que aún no se ha conectado, el directorio del perfil no existirá y se producirá un error al crear el directorio de almacenamiento temporal. Por tanto, si utiliza una cuenta de proxy en un controlador de dominio, debe especificar una cuenta interactiva que se haya utilizado al menos una vez para asegurarse de que se ha creado el directorio del perfil.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_syscollector_update_collection_set 
    [ [ @collection_set_id = ] collection_set_id ]
    , [ [ @name = ] 'name' ]
    , [ [ @new_name = ] 'new_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_uid' ]
    , [ [ @logging_level = ] logging_level ]
    , [ [ @description = ] 'description' ]

Argumentos

• [ @collection\_set\_id = ] collection_set_id
  Es el identificador único local del conjunto de recopilaciones. collection_set_id es de tipo int y debe tener un valor si name es NULL.

• [ @name = ] 'name'
  Es el nombre del conjunto de recopilación. name es de tipo sysname y debe tener un valor si collection_set_id es NULL.

• [ @new\_name = ] 'new_name'
  Es el nuevo nombre del conjunto de recopilación. new_name es de tipo sysname y, si se utiliza, no puede ser una cadena vacía. new_name debe ser único. Para obtener una lista de los nombres de conjuntos de recopilación actuales, consulte la vista del sistema syscollector_collection_sets.

• [ @target = ] 'target'
  Reservado para uso futuro.

• [ @collection\_mode = ] collection_mode
  Es el tipo de recopilación de datos que se va a utilizar. collection_mode es de tipo smallint y puede tener uno de los siguientes valores:

  0 - Modo de almacenamiento en caché. La recopilación de datos y la carga están en programaciones independientes. Especifique el modo de almacenamiento en caché para la recopilación continua.

  1 - Modo sin almacenamiento en caché. La recopilación y la carga de datos están en la misma programación. Establezca el modo sin almacenamiento en caché para la recopilación ad hoc o la recopilación de instantáneas.

  Si se pasa del modo sin almacenamiento en caché al modo de almacenamiento en caché (0), también es necesario especificar schedule_uid o schedule_name.

• [ @days\_until\_expiration= ] days_until_expiration
  Es el número de días que los datos recopilados se guardan en el almacén de administración de datos. days_until_expiration es de tipo smallint. days_until_expiration debe ser 0 o un entero positivo.

• [ @proxy\_id = ] proxy_id
  Es el identificador único para una cuenta proxy del Agente SQL Server. proxy_id es de tipo int.

• [ @proxy\_name = ] 'proxy_name'
  Es el nombre del proxy. proxy_name es de tipo sysname y acepta valores NULL.

• [ @schedule\_uid = ] 'schedule_uid'
  Es el GUID que apunta a una programación. schedule_uid es de tipo uniqueidentifier.

  Para obtener schedule_uid, consulte la tabla del sistema sysschedules.

  Cuando collection_mode se establece en 0, debe especificarse schedule_uid o schedule_name. Cuando collection_mode se establece en 1, schedule_uid o schedule_name se omite si se especifica.

• [ @schedule\_name = ] 'schedule_name'
  Es el nombre de la programación. schedule_name es de tipo sysname y acepta valores NULL. Si se especifica, schedule_uid debe ser NULL. Para obtener schedule_name, consulte la tabla del sistema sysschedules.

• [ @logging\_level = ] logging_level
  Es el nivel de registro. logging_level es de tipo smallint con uno de los siguientes valores:

  0 - registrar la información de ejecución y los eventos SSIS que realizan el seguimiento:

  • Iniciar/detener los conjuntos de recopilación

  • Iniciar/detener los paquetes

  • Información de error

  1 - nivel de registro 0 y:

  • Estadísticas de ejecución

  • Progreso de recopilaciones que se ejecutan continuamente

  • Eventos de advertencia de SSIS

  2 - nivel de registro 1 e información detallada de eventos de SSIS.

  El valor predeterminado de logging_level es 1.

• [ @description = ] 'description'
  Es la descripción del conjunto de recopilación. description es de tipo nvarchar(4000).

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

Se debe ejecutar sp_syscollector_update_collection_set en el contexto de la base de datos del sistema msdb .

collection_set_id o name debe tener un valor; no pueden ser NULL los dos. Para obtener estos valores, consulte la vista del sistema syscollector_collection_sets.

Si el conjunto de recopilación se está ejecutando, solo se pueden actualizar schedule_uid y description. Para detener el conjunto de recopilación, utilice sp_syscollector_stop_collection_set.

Permisos

Se debe pertenecer al rol fijo de base de datos dc_admin o dc_operator (con permiso EXECUTE) para ejecutar este procedimiento. Aunque dc_operator puede ejecutar este procedimiento almacenado, los miembros de este rol tienen limitaciones en cuanto a las propiedades que pueden cambiar. Las propiedades siguientes solo puede cambiarlas dc_admin:

• @new\_name

• @target

• @proxy\_id

• @description

• @collection\_mode

• @days\_until\_expiration

Ejemplos

A.Cambiar el nombre de un conjunto de recopilación

En el ejemplo siguiente se cambia el nombre de un conjunto de recopilación definido por el usuario.

USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 1',
@new_name = N'Collection set test 1 in cached mode';
GO

B.Cambiar el modo de recopilación de sin almacenamiento en caché al modo de almacenamiento en caché

En el ejemplo siguiente se cambia el modo de recopilación de sin almacenamiento en caché al modo de almacenamiento en caché. Este cambio requiere que se especifique un identificador o un nombre para la programación.

USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Collection set test 1 in cached mode',
@collection_mode = 0,
@schedule_uid = 'C7022AF3-51B8-4011-B159-64C47C88FF70';
-- alternatively, use @schedule_name.
-- @schedule_name = N'CollectorSchedule_Every_15min;
GO

C.Cambiar otros parámetros del conjunto de recopilación

En el ejemplo siguiente se actualizan varias propiedades del conjunto de recopilación denominado "Simple collection set test 2'.

USE msdb;
GO
EXEC dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 2',
@collection_mode = 1,
@days_until_expiration = 5,
@description = N'This is a test collection set that runs in noncached mode.',
@logging_level = 0;
GO

Vea también

Referencia

Procedimientos almacenados del sistema (Transact-SQL)

syscollector_collection_sets (Transact-SQL)

dbo.sysschedules (Transact-SQL)

Conceptos

Recopilación de datos