catalog.rename_environment(SSISDB 데이터베이스)

Integration Services 카탈로그에 있는 환경의 이름을 변경합니다.

구문

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

인수

• [ @folder\_name = ] folder_name
  환경이 있는 폴더의 이름입니다. folder_name은 nvarchar(128)입니다.

• [ @environment\_name = ] environment_name
  환경의 원래 이름입니다. environment_name은 nvarchar(128)입니다.

• [ @new\_environment\_name = ] new_environment_name
  환경의 새 이름입니다. new_environment_name은 nvarchar(128)입니다.

반환 코드 값

0(성공)

결과 집합

없음

사용 권한

이 저장 프로시저를 실행하려면 다음 권한 중 하나가 필요합니다.

• 환경에 대한 MODIFY 권한

• ssis_admin 데이터베이스 역할의 멤버 자격

• sysadmin 서버 역할의 멤버 자격

오류 및 경고

다음 목록에서는 오류나 경고가 발생하는 몇 가지 조건을 설명합니다.

• 원래 환경 이름이 잘못된 경우

• 새 이름을 기존 환경에서 이미 사용하고 있는 경우

주의

환경 이름을 바꾼 경우 프로젝트의 환경 참조는 자동으로 업데이트되지 않습니다. 따라서 수동으로 업데이트해야 합니다. 이 저장 프로시저는 환경 이름 변경으로 인해 환경 참조가 끊어진 경우에도 성공합니다. 이 저장 프로시저가 완료된 후에 환경 참조를 업데이트해야 합니다.

[!참고]

환경 참조가 유효하지 않으면 이러한 참조를 사용하는 해당 패키지의 유효성 검사 및 실행이 실패합니다.