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.
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.
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 Microsoft SQL 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.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Esempi
A. Visualizzazione di un elenco di informazioni per un processo
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)