sp_syscollector_update_collection_set (Transact-SQL)

  • Articolo

Si applica a:SQL Server

Consente di rinominare un set di raccolta definito dall'utente o di modificarne le proprietà.

Avviso

Nei casi in cui l'account di Windows configurato come proxy è un utente interattivo o non interattivo non ancora connesso, la directory di profilo non sarà presente e la creazione della directory di gestione temporanea non riuscirà. Se pertanto si utilizza un account proxy in un controller di dominio, è necessario specificare un account interattivo utilizzato almeno una volta in modo da assicurare la creazione della directory di profilo.

Convenzioni di sintassi Transact-SQL

Sintassi

sp_syscollector_update_collection_set
    [ [ @collection_set_id = ] collection_set_id ]
    [ , [ @name = ] N'name' ]
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @target = ] N'target' ]
    [ , [ @collection_mode = ] collection_mode ]
    [ , [ @days_until_expiration = ] days_until_expiration ]
    [ , [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @schedule_uid = ] 'schedule_uid' ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @logging_level = ] logging_level ]
    [ , [ @description = ] N'description' ]
[ ; ]

Argomenti

[ @collection_set_id = ] collection_set_id

Identificatore locale univoco per il set di raccolta. @collection_set_id è int e deve avere un valore se @name è NULL.

[ @name = ] N'name'

Nome del set di raccolta. @name è sysname e deve avere un valore se @collection_set_id è NULL.

[ @new_name = ] N'new_name'

Nuovo nome per il set di raccolta. @new_name è sysname, con un valore predefinito NULL, e se usato, non può essere una stringa vuota. @new_name deve essere univoco. Per un elenco dei nomi dei set di raccolta correnti, eseguire una query sulla syscollector_collection_sets visualizzazione di sistema.

[ @target = ] N'target'

Riservato a un uso futuro. @target è nvarchar(128), con il valore predefinito NULL.

[ @collection_mode = ] collection_mode

Tipo di raccolta dati da utilizzare. @collection_mode è smallint e può avere uno dei valori seguenti:

  • 0: modalità memorizzata nella cache. La raccolta e il caricamento dei dati seguono una pianificazione differente. Specificare la modalità cache per la raccolta continua.

  • 1: modalità non memorizzata nella cache. La raccolta e il caricamento dei dati seguono la stessa pianificazione. Specificare la modalità non in cache per la raccolta ad hoc o snapshot.

Se si passa dalla modalità non memorizzata nella cache alla modalità memorizzata nella cache (0), è necessario specificare anche @schedule_uid o @schedule_name.

[ @days_until_expiration = ] days_until_expiration

Numero di giorni durante i quali i dati raccolti vengono salvati nel data warehouse di gestione. @days_until_expiration è smallint e deve essere 0 o un numero intero positivo.

[ @proxy_id = ] proxy_id

Identificatore univoco per un account proxy di SQL Server Agent. @proxy_id è int.

[ @proxy_name = ] N'proxy_name'

Nome del proxy. @proxy_name è sysname, con il valore predefinito NULL.

[ @schedule_uid = ] 'schedule_uid'

GUID che punta a una pianificazione. @schedule_uid è uniqueidentifier, con un valore predefinito .NULL

Per ottenere @schedule_uid, eseguire una query sulla tabella di sysschedules sistema.

Quando @collection_mode è impostato su 0, è necessario specificare @schedule_uid o @schedule_name . Quando @collection_mode è impostato su 1, @schedule_uid o @schedule_name viene ignorato se specificato.

[ @schedule_name = ] N'schedule_name'

Nome della pianificazione. @schedule_name è sysname, con un valore predefinito .NULL Se specificato, @schedule_uid deve essere NULL. Per ottenere @schedule_name, eseguire una query sulla tabella di sysschedules sistema.

[ @logging_level = ] logging_level

Livello di registrazione. @logging_level è smallint, con un valore predefinito , 1con uno dei valori seguenti:

  • 0: registra le informazioni sull'esecuzione e gli eventi SSIS che tengono traccia:

    • Avvio/arresto dei set di raccolta
    • Avvio/arresto dei pacchetti
    • Informazioni sugli errori

  • 1: registrazione di livello 0 e:

    • Statistiche di esecuzione
    • Stato di avanzamento della raccolta in esecuzione continua
    • Eventi di avviso da SSIS

  • 2: registrazione di livello 1 e informazioni dettagliate sugli eventi da SSIS.

[ @description = ] N'description'

Descrizione del set di raccolta. @description è nvarchar(4000), con un valore predefinito .NULL

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_syscollector_update_collection_set deve essere eseguito nel contesto del msdb database di sistema.

Sia collection_set_id che il nome deve avere un valore, entrambi non possono essere NULL. Per ottenere questi valori, eseguire una query sulla syscollector_collection_sets visualizzazione di sistema.

Se il set di raccolta è in esecuzione, è possibile aggiornare solo schedule_uid e descrizione. Per arrestare il set di raccolta, usare sp_syscollector_stop_collection_set.

Autorizzazioni

Per eseguire questa procedura, è richiesta l'appartenenza al ruolo predefinito del database dc_admin o dc_operator (con autorizzazione EXECUTE). Sebbene dc_operator possibile eseguire questa stored procedure, i membri di questo ruolo sono limitati nelle proprietà che possono modificare. Le proprietà seguenti possono essere modificate solo da dc_admin:

  • @new_name
  • @target
  • @proxy_id
  • @description
  • @collection_mode
  • @days_until_expiration

Esempi

R. Rinominare un set di raccolta

Nell'esempio seguente viene rinominato un set di raccolta definito dall'utente.

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. Modificare la modalità raccolta da non memorizzata nella cache a memorizzata nella cache

Nell'esempio seguente la modalità di raccolta viene modificata da non in cache a cache. Per eseguire questa modifica, è necessario specificare un ID oppure un nome della pianificazione.

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. Modificare altri parametri del set di raccolta

Nell'esempio seguente vengono aggiornate varie proprietà del set di raccolta denominato 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

Contenuto correlato