catalog.validate_package (database SSISDB)

  • Articolo

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.