Compartilhar via


catalog.rename_environment (Banco de Dados SSISDB)

Renomeia um ambiente no catálogo do Integration Services.

Sintaxe

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

Argumentos

  • [ @folder\_name = ] folder_name
    O nome da pasta que contém o ambiente. O folder_name é nvarchar(128).

  • [ @environment\_name = ] environment_name
    O nome original da variável de ambiente. O environment_name é nvarchar(128).

  • [ @new\_environment\_name = ] new_environment_name
    O nome do ambiente. O new_environment_name é nvarchar(128).

Valor de código de retorno

0 (êxito)

Conjuntos de resultados

Nenhum

Permissões

Este procedimento armazenado exige uma das seguintes permissões:

  • Permissões MODIFY no ambiente

  • Associação à função de banco de dados ssis_admin

  • Associação à função de servidor sysadmin

Erros e avisos

A lista a seguir descreve algumas condições que podem gerar erros ou avisos:

  • O nome ambiente original não é válido

  • O novo nome já foi usado em um ambiente existente

Comentários

As referências de ambiente de projetos não são atualizadas automaticamente quando você renomeia o ambiente. As referências de ambiente devem ser atualizadas de forma correspondente. Esse procedimento armazenado terá êxito mesmo que as referências de ambiente sejam desfeitas com a alteração do nome do ambiente. As referências de ambiente devem ser atualizadas depois da conclusão desse procedimento armazenado.

ObservaçãoObservação

Quando uma referência de ambiente não for válida, a validação e a execução dos pacotes correspondentes que usam essas referências falharão.