Compartilhar via


catalog.move_environment (Banco de Dados SSISDB)

Aplica-se a: SQL Server SSIS Integration Runtime no Azure Data Factory

Aplica-se: SQL Server

Move um ambiente de uma pasta para outra no catálogo do Integration Services.

Sintaxe

catalog.move_environment [ @source_folder = ] source_folder  
    , [ @environment_name = ] environment_name  
    , [ @destination_folder = ] destination_folder  

Argumentos

[ @source_folder = ] source_folder
O nome da pasta de origem onde o ambiente reside antes da movimentação. O source_folder é nvarchar(128).

[ @environment_name = ] environment_name
O nome do ambiente que deve ser movido. O environment_name é nvarchar(128) .

[ @destination_folder = ] destination_folder
O nome da pasta de destino onde o ambiente reside após a movimentação. O destination_folder é 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 READ e 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 ambiente não existe na pasta de origem

  • A pasta de destino já tem um ambiente com o mesmo nome

  • O usuário não tem as permissões apropriadas

Comentários

As referências de ambiente de projetos não seguem o ambiente durante a movimentação. 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 pela movimentação de um ambiente. As referências de ambiente devem ser atualizadas depois da conclusão desse procedimento armazenado.

Observação

Um projeto pode ter referências de ambiente relativas ou absolutas. As referências relativas fazem referência ao ambiente pelo nome. Essas referências requerem que o ambiente resida na mesma pasta do projeto. As referências absolutas fazem referência ao ambiente por nome e pasta. Essas referências fazem referência a ambientes que residam em uma pasta diferente da pasta do projeto.