catalog.rename_environment (Banco de Dados SSISDB)
Aplica-se a:SQL Server
SSIS Integration Runtime no Azure Data Factory
Aplica-se a:SQL Server
Renomeia um ambiente no catálogo do Integration Services.
Sintaxe
catalog.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 novo nome do ambiente. O new_environment_name é nvarchar(128).
Valor do 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 um erro ou um aviso:
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çã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.