catalog.create_environment_reference (database SSISDB)

Articolo
05/07/2013

Viene creato un riferimento all'ambiente per un progetto nel catalogo di Integration Services.

Sintassi

create_environment_reference [ @folder_name = ] folder_name
     , [ @project_name = ] project_name
     , [ @environment_name = ] environment_name
     , [ @reference_location = ] reference_location
  [  , [ @environment_folder_name = ] environment_folder_name ]
  [  , [ @reference_id = ] reference_id OUTPUT ]

Argomenti

[ @folder\_name = ] folder_name
Nome della cartella del progetto che fa riferimento all'ambiente. folder_name è di tipo nvarchar(128).
[ @project\_name = ] project_name
Nome del progetto che fa riferimento all'ambiente. project_name è di tipo nvarchar(128).
[ @environment\_name = ] environment_name
Nome dell'ambiente a cui viene fatto riferimento. environment_name è di tipo nvarchar(128).
[ @reference\_location = ] reference_location
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_location è di tipo char(1).
[ @environment\_folder\_name = ] environment_folder_name
Nome della cartella in cui si trova l'ambiente a cui viene fatto riferimento. Questo valore è richiesto per i riferimenti assoluti. environment_folder_name è di tipo nvarchar(128).
[ @reference\_id = ] reference_id
Viene restituito l'identificatore univoco per il nuovo riferimento. Questo parametro è facoltativo. reference_id è di tipo bigint.

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 non valido
Nome del progetto 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.

Condividi tramite