catalog.validate_project (database SSISDB)

  • Articolo

Si applica a:SQL Server Integration Runtime SSIS in Azure Data Factory

Si applica a:SQL Server

Convalida in modo asincrono un progetto nel catalogo di Integration Services.

Sintassi

catalog.validate_project [ @folder_name = ] folder_name  
    , [ @project_name = ] project_name  
    , [ @validate_type = ] validate_type  
    , [ @validation_id = ] validation_id OUTPUT  
 [  , [ @use32bitruntime = ] use32bitruntime ]  
 [  , [ @environment_scope = ] environment_scope ]  
 [  , [ @reference_id = ] reference_id ]

Argomenti

[ @folder_name = ] folder_name
Nome di una cartella in cui è contenuto il progetto. folder_name è di tipo nvarchar(128) .

[ @project_name = ] project_name
Nome del progetto. project_name è di tipo nvarchar(128) .

[ @validate_type = ] validate_type
Viene indicato il tipo di convalida da eseguire. Utilizzare il carattere F per eseguire una convalida completa. Questo parametro è facoltativo. Per impostazione predefinita, verrà utilizzato il carattere F. validate_type è di tipo char(1).

[ @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. Usare il valore 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 e, 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 del codice restituito

0 (esito positivo)

Set di risultati

L'output dei passaggi di convalida viene restituito sotto forma di sezioni diverse del set di risultati.

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 del server sysadmin

Errori e avvisi

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

  • Convalida non riuscita per uno o più pacchetti nel progetto

  • Convalida non riuscita se in uno o più ambienti utilizzati come riferimento inclusi nella convalida non sono contenute variabili di riferimento

  • Tipo di convalida specificato non valido

  • Nome del progetto o ID di riferimento all'ambiente non valido

  • Utente senza autorizzazioni appropriate.

Commenti

La convalida consente di identificare i problemi che impediscono il completamento dell'esecuzione dei pacchetti nel progetto. Usare la vista catalog.validations o catalog.operations per monitorare lo stato della convalida.

Solo ambienti che sono accessibili dall'utente possono essere utilizzati nella convalida. L'output della convalida viene inviato al client come set di risultati.

In questa versione la convalida del progetto non supporta la convalida della dipendenza.

Tramite la convalida completa viene confermato che tutte le variabili di ambiente a cui si fa riferimento si trovano all'interno degli ambienti di riferimento inclusi nella convalida. Tramite la convalida completa viene generato un elenco di riferimenti all'ambiente che non sono validi e variabili di ambiente a cui si fa riferimento che non sono state trovate in alcun ambiente di riferimento incluso nella convalida.