Articolo
09/28/2010

sp_help_downloadlist (Transact-SQL)

Visualizza un elenco delle righe della tabella di sistema sysdownloadlist relative al processo specificato oppure un elenco di tutte le righe se non viene specificato alcun processo.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

sp_help_downloadlist { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } 
     [ , [ @operation = ] 'operation' ] 
     [ , [ @object_type = ] 'object_type' ] 
     [ , [ @object_name = ] 'object_name' ] 
     [ , [ @target_server = ] 'target_server' ] 
     [ , [ @has_error = ] has_error ] 
     [ , [ @status = ] status ] 
     [ , [ @date_posted = ] date_posted ]

Argomenti

[ @job_id= ] job_id
ID del processo per il quale devono essere restituite informazioni. job_id è di tipo uniqueidentifier e il valore predefinito è NULL.
[ @job_name= ] 'job_name'
Nome del processo. job_name è di tipo sysname e il valore predefinito è NULL.

[!NOTA]

È necessario specificare l'argomento job_id oppure l'argomento job_name, ma non è possibile specificarli entrambi.

[ @operation= ] 'operation'
Operazione valida per il processo specificato. operation è di tipo varchar(64) e il valore predefinito è NULL. I possibili valori sono i seguenti.

Valore	Descrizione
DEFECT	Operazione del server che richiede l'esclusione del server di destinazione dal servizio SQLServerAgent master.
DELETE	Operazione del processo che rimuove un intero processo.
INSERT	Operazione del processo che inserisce un intero processo o ne aggiorna uno esistente. Include tutti i passaggi e le pianificazioni del processo, se applicabile.
RE-ENLIST	Operazione del server con cui viene attivato il rinvio delle informazioni di integrazione del server di destinazione, tra cui l'intervallo di polling e il fuso orario per il dominio multiserver. Il server di destinazione riesegue inoltre il download dei dettagli di MSXOperator.
SET-POLL	Operazione del server con cui viene impostato l'intervallo di tempo in secondi per il polling del dominio multiserver eseguito dai server di destinazione. Se specificato, value viene interpretato come valore di intervallo obbligatorio. Può essere un valore compreso tra 10 e 28.800.
START	Operazione del processo con cui viene richiesto l'avvio dell'esecuzione del processo.
STOP	Operazione del processo con cui viene richiesta l'interruzione dell'esecuzione del processo.
SYNC-TIME	Operazione del server con cui viene attivata la sincronizzazione del clock di sistema dei server di destinazione con il clock di sistema del dominio multiserver. Si tratta di un'operazione onerosa ed è pertanto consigliabile non eseguirla di frequente.
UPDATE	Operazione del processo con cui vengono aggiornate solo le informazioni sysjobs relative a un processo e non i passaggi o le pianificazioni. L'operazione viene chiamata automaticamente da sp_update_job.

[ @object_type= ] 'object_type'
Tipo di oggetto per il processo specificato. object_type è di tipo varchar(64) e il valore predefinito è NULL. I possibili valori di object_type sono JOB e SERVER. Per ulteriori informazioni sui valori validi di object_type, vedere sp_add_category (Transact-SQL).
[ @object_name= ] 'object_name'
Nome dell'oggetto. object_name è di tipo sysname e il valore predefinito è NULL. Se il valore di object_type è JOB, object_namecorrisponde al nome del processo. Se il valore di object_typeè SERVER, object_namecorrisponde al nome del server.
[ @target_server= ] 'target_server'
Nome del server di destinazione. target_server è di tipo nvarchar(128) e il valore predefinito è NULL.
[ @has_error= ] has_error
Specifica se il processo deve segnalare o meno gli errori. has_error è di tipo tinyint e il valore predefinito è NULL, che indica che gli errori non devono essere segnalati. 1 indica che tutti gli errori devono essere segnalati.
[ @status= ] status
Stato del processo. status è di tipo tinyint e il valore predefinito è NULL.
[ @date_posted= ] date_posted
Valore di data e ora. Nel set di risultati verranno incluse tutte le voci create a partire dalla data e ora specificate. date_posted è di tipo datetime e il valore predefinito è NULL.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nome colonna	Tipo di dati	Descrizione
instance_id	int	Numero di identificazione univoco integer dell'istruzione.
source_server	nvarchar(30)	Nome di computer del server da cui viene inviata l'istruzione. In MicrosoftSQL Server 7.0 è sempre il nome di computer del server master.
operation_code	nvarchar(4000)	Codice di operazione dell'istruzione.
object_name	sysname	Oggetto su cui viene eseguita l'istruzione.
object_id	uniqueidentifier	Numero di identificazione dell'oggetto su cui viene eseguita l'istruzione (job_id per un oggetto processo e 0x00 per un oggetto server) oppure valore specifico di operation_code
target_server	nvarchar(30)	Server di destinazione in cui deve essere eseguito il download dell'istruzione.
error_message	nvarchar(1024)	Eventuale messaggio di errore inviato dal server di destinazione se si verifica un problema durante l'elaborazione dell'istruzione. Nota I messaggi di errore impediscono l'esecuzione di ulteriori operazioni di download nel server di destinazione.
date_posted	datetime	Data di inserimento dell'istruzione nella tabella.
date_downloaded	datetime	Data di download dell'istruzione nel server di destinazione.
status	tinyint	Stato del processo: 0 = non ancora scaricato 1 = scaricato correttamente.

Autorizzazioni

Le autorizzazioni di esecuzione per questa procedura vengono assegnate per impostazione predefinita ai membri del ruolo predefinito del server sysadmin.

Esempi

Nell'esempio seguente viene visualizzato un elenco di righe in sysdownloadlist per il processo NightlyBackups.

USE msdb ;
GO

EXEC dbo.sp_help_downloadlist
    @job_name = N'NightlyBackups',
    @operation = N'UPDATE', 
    @object_type = N'JOB', 
    @object_name = N'NightlyBackups',
    @target_server = N'SEATTLE2', 
    @has_error = 1, 
    @status = NULL, 
    @date_posted = NULL ;
GO

Vedere anche

Riferimento

Stored procedure di sistema (Transact-SQL)

Condividi tramite