catalog.rename_environment (database SSISDB)

Articolo
05/07/2013

Viene rinominato un ambiente nel catalogo di Integration Services.

Sintassi

rename_environment [ @folder_name = ] folder_name
    , [ @environment_name = ] environment_name
    , [ @new_environment_name= ] new_environment_name

Argomenti

[ @folder\_name = ] folder_name
Nome della cartella in cui è contenuto l'ambiente. folder_name è di tipo nvarchar(128).
[ @environment\_name = ] environment_name
Nome originale dell'ambiente. environment_name è di tipo nvarchar(128).
[ @new\_environment\_name = ] new_environment_name
Nuovo nome dell'ambiente. new_environment_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 MODIFY 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 originale dell'ambiente non valido
Nome nuovo già utilizzato in un ambiente esistente

Osservazioni

I riferimenti all'ambiente dai progetti non vengono aggiornati automaticamente quando si rinomina l'ambiente, pertanto è necessario aggiornarli di conseguenza. Questa stored procedure verrà completata anche se i riferimenti all'ambiente vengono interrotti modificando il nome dell'ambiente. I riferimenti all'ambiente devono essere aggiornati dopo il completamento di questa stored procedure.

[!NOTA]

Quando un riferimento all'ambiente non è valido, la convalida e l'esecuzione dei pacchetti corrispondenti in cui vengono utilizzati tali riferimenti non verranno completate.

Condividi tramite