sp_help_downloadlist (Transact-SQL)

  • Articolo

Si applica a: SQL Server

Elenca tutte le righe nella tabella di sysdownloadlist sistema per il processo fornito o tutte le righe se non viene specificato alcun processo.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_help_downloadlist
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @operation = ] 'operation' ]
    [ , [ @object_type = ] 'object_type' ]
    [ , [ @object_name = ] N'object_name' ]
    [ , [ @target_server = ] N'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 è uniqueidentifier, con un valore predefinito .NULL

È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.

[ @job_name = ] N'job_name'

Il nome del processo. @job_name è sysname, con il valore predefinito NULL.

È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.

[ @operation = ] 'operation'

Operazione valida per il processo specificato. @operation è varchar(64)e può essere uno di questi valori.

valore Descrizione
DEFECT Operazione server che richiede al server di destinazione di difetti dal servizio Master SQL Server Agent.
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 scarica anche i MSXOperator dettagli.
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 e 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 richiesto l'arresto 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 di processo che aggiorna solo le sysjobs informazioni per un processo, non i passaggi o le pianificazioni del processo. Viene chiamato automaticamente da sp_update_job.

[ @object_type = ] 'object_type'

Tipo di oggetto per il processo specificato. @object_type è varchar(64), con un valore predefinito .NULL @object_type può essere JOB o SERVER. Per altre informazioni sui valori di @object_typevalidi, vedere sp_add_category.

[ @object_name = ] N'object_name'

Nome dell'oggetto. @object_name è sysname, con il valore predefinito NULL. Se @object_type è JOB, @object_name è il nome del processo. Se @object_type è SERVER, @object_name è il nome del server.

[ @target_server = ] N'target_server'

Nome del server di destinazione. @target_server è sysname, con il valore predefinito NULL.

[ @has_error = ] has_error

Specifica se il processo deve confermare gli errori. @has_error è tinyint, con un valore predefinito NULL, che indica che non deve essere riconosciuto alcun errore. 1 indica che tutti gli errori devono essere riconosciuti.

[ @status = ] status

Stato per il processo. @status è tinyint, con un 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 è datetime, con il valore predefinito NULL.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

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.
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 interessato dall'istruzione (job_id per un oggetto processo o per un oggetto server) o 0x00 un valore di dati specifico dell'oggetto operation_code.
target_server nvarchar(30) Server di destinazione da cui deve essere scaricata questa 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: tutti i messaggi di errore bloccano tutti gli altri download dal server di destinazione.
date_posted datetime Data di inserimento dell'istruzione nella tabella.
date_downloaded datetime Data in cui il server di destinazione ha scaricato l'istruzione.
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

Contenuto correlato