catalog.rename_environment (database SSISDB)

  • Articolo

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

Si applica a:SQL Server

Rinomina un ambiente nel catalogo di Integration Services.

Sintassi

catalog.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 del 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

Commenti

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.