catalog.validate_package (database SSISDB)

Articolo
05/07/2013

Viene convalidato in modo asincrono un pacchetto nel catalogo di Integration Services.

Sintassi

validate_package [ @folder_name = ] folder_name
    , [ @project_name = ] project_name
    , [ @package_name = ] package_name
    , [ @validation_id = ] validation_id OUTPUT
 [  , [ @use32bitruntime = ] use32bitruntime ]
 [  , [ @target_environment = ] target_environment ]
 [  , [ @reference_id = ] reference_id ]

Argomenti

[ @folder\_name = ] folder_name
Nella della cartella in cui è contenuto il pacchetto. folder_name è di tipo nvarchar(128).
[ @project\_name = ] project_name
Nome del progetto in cui è contenuto il pacchetto. project_name è di tipo nvarchar(128).
[ @package\_name = ] package_name
Nome del pacchetto. package_name è di tipo nvarchar(260).
[ @validation\_id = ] validation_id
Viene restituito l'identificatore (ID) univoco della convalida. validation_id è di tipo bigint.
[ @use32bitruntime = ] use32bitruntime
Viene indicato se il runtime a 32 bit deve essere utilizzato per eseguire il pacchetto in un sistema operativo a 64 bit. Utilizzare il valore pari a 1 per eseguire il pacchetto con il runtime a 32 bit quando in esecuzione in un sistema operativo a 64 bit. Utilizzare il valore pari a 0 per eseguire il pacchetto con il runtime a 64 bit quando in esecuzione in un sistema operativo a 64 bit. Questo parametro è facoltativo. use32bitruntime è di tipo bit.
[ @environment\_scope = ] environment_scope
Vengono indicati i riferimenti all'ambiente considerati dalla convalida. Quando il valore è A, tutti i riferimenti all'ambiente associati al progetto sono inclusi nella convalida. Quando il valore è S, è incluso solo un singolo riferimento all'ambiente. Quando il valore è D, non è incluso alcun riferimento all'ambiente e ogni parametro deve disporre di un valore predefinito letterale per passare la convalida. Questo parametro è facoltativo. Per impostazione predefinita, verrà utilizzato il carattere D. environment_scope è di tipo Char(1).
[ @reference\_id = ] reference_id
ID univoco del riferimento all'ambiente. Questo parametro è richiesto solo quando un singolo riferimento all'ambiente è incluso nella convalida, quando environment_scope è di tipo S. reference_id è di tipo bigint.

Valori di codice restituiti

0 (esito positivo)

Set di risultati

Nessuno

Autorizzazioni

Per questa stored procedure è necessaria una delle autorizzazioni seguenti:

Autorizzazioni READ sul progetto e, se applicabile, autorizzazioni READ su ambienti a cui si fa riferimento
Appartenenza al ruolo del database ssis_admin
Appartenenza al ruolo server sysadmin

Errori e avvisi

Nell'elenco seguente vengono descritte alcune condizioni che possono generare un errore o un avviso:

Nome del progetto o del pacchetto non valido
Utente senza autorizzazioni appropriate
Uno o più ambienti utilizzati come riferimento inclusi nella convalida in cui non sono contenute variabili di riferimento
Convalida del pacchetto non completata
Ambiente a cui viene fatto riferimento non disponibile
Impossibile trovare variabili utilizzate come riferimento negli ambienti a cui viene fatto riferimento inclusi nella convalida
Riferimento alla variabili effettuato nei parametri del pacchetto, ma nessuna inclusione di ambienti di riferimento nella convalida.

Osservazioni

La convalida consente di identificare i problemi che impediscono il completamento dell'esecuzione del pacchetto. Utilizzare la vista catalog.validations o catalog.operations per monitorare lo stato della convalida.

Condividi tramite