catalog.rename_environment (Banco de Dados SSISDB)

se aplica 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 do 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 (sucesso)

Conjuntos de resultados

Nenhum

Permissões

Este procedimento armazenado requer uma das seguintes permissões:

• MODIFICAR permissões 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 aviso:

• O nome do 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 ambientais devem ser atualizadas em conformidade. Este procedimento armazenado será bem-sucedido mesmo se as referências de ambiente forem quebradas alterando o nome do ambiente. As referências de ambiente devem ser atualizadas após a conclusão deste procedimento armazenado.

Observação

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