Condividi tramite


catalog.set_environment_reference_type (SSISDB Database)

Vengono impostati il tipo di riferimento e il nome dell'ambiente associato a un riferimento all'ambiente esistente per un progetto nel catalogo di Integration Services.

Sintassi

set_environment_reference_location [ @reference_id = reference_id
    , [ @reference_type = ] reference_type
 [  , [ @environment_folder_name = ] environment_folder_name ]

Argomenti

  • [ @reference\_id = ] reference_id
    Identificatore univoco del riferimento all'ambiente che deve essere aggiornato. reference_id è di tipo bigint.

  • [ @reference\_type = ] reference_type
    Viene indicato se l'ambiente può essere individuato nella stessa cartella del progetto (riferimento relativo) o in una cartella diversa (riferimento assoluto). Utilizzare il valore R per indicare un riferimento relativo. Utilizzare il valore A per indicare un riferimento assoluto. reference_type è di tipo char(1).

  • [ @environment\_folder\_name = ] environment_folder_name
    Cartella in cui viene individuato l'ambiente. Questo valore è richiesto per i riferimenti assoluti. environment_folder_name è di tipo nvarchar(128).

Valore del codice restituito

0 (esito positivo)

Set di risultati

Nessuno

Autorizzazioni

Per questa stored procedure è necessaria una delle autorizzazioni seguenti:

  • Autorizzazioni READ e MODIFY sul progetto e autorizzazione READ sull'ambiente

  • 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 della cartella, nome dell'ambiente o ID riferimento non valido

  • Utente senza autorizzazioni appropriate

  • Riferimento assoluto specificato tramite il carattere A nel parametro reference_location, ma nome della cartella non specificato con il parametro environment_folder_name.

Osservazioni

Un progetto può disporre di riferimenti all'ambiente relativi o assoluti. I riferimenti relativi fanno riferimento all'ambiente in base al nome. Per tali riferimenti è necessario che l'ambiente si trovi nella stessa cartella del progetto. I riferimenti assoluti fanno riferimento all'ambiente in base al nome e alla cartella e possono fare riferimento ad ambienti che si trovano in una cartella di destinazione diversa da quella del progetto. Un progetto può fare riferimento a più ambienti.

Nota importanteImportante

Se viene specificato un riferimento relativo, il valore del parametro environment_folder_name non viene utilizzato e il nome della cartella dell'ambiente viene impostato automaticamente su NULL. Se viene specificato un riferimento assoluto, il nome della cartella dell'ambiente deve essere fornito nel parametro environment_folder_name.