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

Integration Services 카탈로그의 프로젝트에 대한 환경 참조를 만듭니다.

구문

create_environment_reference [ @folder_name = ] folder_name
     , [ @project_name = ] project_name
     , [ @environment_name = ] environment_name
     , [ @reference_location = ] reference_location
  [  , [ @environment_folder_name = ] environment_folder_name ]
  [  , [ @reference_id = ] reference_id OUTPUT ]

인수

• [ @folder\_name = ] folder_name
  환경을 참조하는 프로젝트의 폴더 이름입니다. folder_name은 nvarchar(128)입니다.

• [ @project\_name = ] project_name
  환경을 참조하는 프로젝트의 이름입니다. project_name은 nvarchar(128)입니다.

• [ @environment\_name = ] environment_name
  참조되는 환경의 이름입니다. environment_name은 nvarchar(128)입니다.

• [ @reference\_location = ] reference_location
  환경을 프로젝트와 같은 폴더(상대 참조)에서 찾을 수 있는지, 아니면 다른 폴더(절대 참조)에서 찾을 수 있는지를 나타냅니다. 상대 참조를 나타내려면 값 R을 사용하고, 절대 참조를 나타내려면 값 A를 사용합니다. reference_location은 char(1)입니다.

• [ @environment\_folder\_name = ] environment_folder_name
  참조되는 환경이 있는 폴더의 이름입니다. 이 값은 절대 참조에 필요합니다. environment_folder_name은 nvarchar(128)입니다.

• [ @reference\_id = ] reference_id
  새 참조에 대한 고유 식별자를 반환합니다. 이 매개 변수는 선택 사항입니다. reference_id는 bigint입니다.

반환 코드 값

0(성공)

결과 집합

없음

사용 권한

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

• 프로젝트에 대한 READ 및 MODIFY 권한과 환경에 대한 READ 권한

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

• sysadmin 서버 역할의 멤버 자격

오류 및 경고

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

• 폴더 이름이 잘못된 경우

• 프로젝트 이름이 잘못된 경우

• 사용자에게 적절한 권한이 없는 경우

• 절대 참조는 reference_location 매개 변수에서 A 문자를 사용하여 지정했지만 폴더 이름이 environment_folder_name 매개 변수로 지정되지 않은 경우

주의

프로젝트에는 상대 환경 참조 또는 절대 환경 참조가 있을 수 있습니다. 상대 참조는 환경을 이름으로 참조하며 환경이 프로젝트와 같은 폴더에 있어야 합니다. 절대 참조는 환경을 이름과 폴더로 참조하며 프로젝트와 다른 폴더에 있는 환경을 참조할 수도 있습니다. 하나의 프로젝트에서 여러 환경을 참조할 수 있습니다.