다음을 통해 공유


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

적용 대상: Azure Data Factory의 SQL Server SSIS Integration Runtime

적용 대상: SQL Server

Integration Services 카탈로그에서 패키지의 유효성을 비동기적으로 검사합니다.

구문

catalog.validate_package [ @folder_name = ] folder_name  
    , [ @project_name = ] project_name  
    , [ @package_name = ] package_name  
    , [ @validation_id = ] validation_id OUTPUT  
 [  , [ @use32bitruntime = ] use32bitruntime ]  
 [  , [ @environment_scope = ] environment_scope ]  
 [  , [ @reference_id = ] reference_id ]  

인수

[ @folder_name = ] folder_name
패키지가 있는 폴더의 이름입니다. folder_namenvarchar(128)입니다.

[ @project_name = ] project_name
패키지를 포함하는 프로젝트의 이름입니다. project_name nvarchar(128)입니다.

[ @package_name = ] package_name
패키지 이름 package_name nvarchar(260)입니다.

[ @validation_id = ] validation_id
유효성 검사의 고유 식별자(ID)를 반환합니다. validation_id 대단합니다.

[ @use32bitruntime = ] use32bitruntime
32비트 런타임을 사용하여 64비트 운영 체제에서 패키지를 실행해야 하는지를 나타냅니다. 64비트 운영 체제에서 실행할 때 32비트 런타임에서 패키지를 실행하려면 이 값을 1 사용합니다. 64비트 운영 체제에서 실행할 때 64비트 런타임으로 패키지를 실행하려면 값 0을 사용합니다. 이 매개 변수는 선택 사항입니다. use32bitruntimebit입니다.

[ @environment_scope = ] environment_scope
유효성 검사에서 고려되는 환경 참조를 나타냅니다. 값이 A이면 프로젝트와 연결된 모든 환경 참조가 유효성 검사에 포함되고, 값이면 S단일 환경 참조만 포함됩니다. 값이면 D환경 참조가 포함되지 않으며 유효성 검사를 통과하려면 각 매개 변수에 리터럴 기본값이 있어야 합니다. 이 매개 변수는 선택 사항입니다. 문자 D 는 기본적으로 사용됩니다. environment_scopechar(1)입니다.

[ @reference_id = ] reference_id
환경 참조의 고유 ID입니다. 이 매개 변수는 단일 환경 참조가 유효성 검사에 포함되어 있는 경우, 즉 environment_scopeS인 경우에만 필요합니다. reference_id 대단합니다.

반환 코드 값

0(성공)

결과 집합

None

사용 권한

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

  • 프로젝트에 대한 READ 권한 및 해당하는 경우 참조된 환경에 대한 READ 권한

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

  • sysadmin 서버 역할에 대한 멤버 자격

오류 및 경고

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

  • 프로젝트 이름 또는 패키지 이름이 잘못되었습니다.

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

  • 유효성 검사에 포함된 참조된 환경 중 하나 이상이 참조된 변수를 포함하지 않음

  • 패키지 유효성 검사 실패

  • 참조되는 환경이 없습니다.

  • 유효성 검사에 포함된 참조된 환경에서 참조된 변수를 찾을 수 없는 경우

  • 변수는 패키지 매개 변수에서 참조되지만 참조된 환경은 유효성 검사에 포함되지 않았습니다.

설명

유효성 검사를 통해 패키지가 성공적으로 실행되지 않을 수 있는 문제를 식별할 수 있습니다. catalog.validations 또는 catalog.operations 뷰를 사용하여 유효성 검사 상태를 모니터링합니다.