애플리케이션 패키지 버전 변경하기

애플리케이션 패키지 버전 변경하기 (ALTER APPLICATION PACKAGE ... VERSION)

이 기능은 중화인민공화국에서는 사용할 수 없어요.

%naf%는 지원되는 클라우드 플랫폼에서 일반적으로 사용할 수 있어요. 자세한 내용은 Support for private connectivity, VPS, and government regions를 참조하세요.

About the Snowflake Native App Framework

%naf%에서 기존 애플리케이션 패키지의 버전 관리를 수정해요.

참조:

ALTER APPLICATION PACKAGE , ALTER APPLICATION PACKAGE ... RELEASE DIRECTIVE (Legacy)

출처: 문서

본문

구문

ALTER APPLICATION PACKAGE  ADD VERSION [  ]
  USING  [ LABEL = '' ]

ALTER APPLICATION PACKAGE  DROP VERSION 

ALTER APPLICATION PACKAGE  ADD PATCH [] FOR VERSION []
  USING  [ LABEL = '' ]

매개변수

name

수정할 애플리케이션 패키지의 식별자를 지정합니다. 식별자에 공백, 특수 문자, 또는 대소문자가 섞인 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자는 대소문자를 구분합니다.

ADD VERSION [ version_identifier ] USING path_to_version_directory

path_to_version_directory로 지정된 스테이지 위치의 경로에 있는 애플리케이션 파일을 사용하여 버전 또는 패치를 추가합니다.

version_identifier를 사용하여 이 버전의 식별자를 지정할 수 있습니다. 매니페스트 파일에 version_identifier를 지정하지 않으면 이 명령의 일부로 version_identifier를 지정해야 합니다. 이 명령의 일부로 version_identifier를 지정하면 매니페스트 파일에 지정된 version_identifier보다 우선합니다.

[ LABEL = 'display_label' ]

LABEL 절을 사용하여 이 새 버전의 레이블을 지정할 수 있습니다. 이 레이블은 소비자에게 표시됩니다. LABEL 절을 생략하면 manifest.yml 파일에 지정된 레이블이 사용됩니다.

DROP VERSION version_identifier

지정된 버전 식별자를 가진 버전을 삭제합니다. 버전은 해당 버전을 참조하는 릴리스 지시문이 없고 해당 버전을 사용하는 애플리케이션이 없는 경우에만 삭제할 수 있습니다.

애플리케이션이 버전을 사용하는 것으로 간주되는 경우는 해당 버전이 애플리케이션의 현재 버전이거나, 이전 버전이면서 업그레이드가 아직 완료되지 않은 경우입니다(이전 버전에서 작업이 계속 실행 중인 경우). 비활성화된 애플리케이션은 버전 삭제를 차단하지 않습니다.

APPLICATION_STATE view 뷰를 사용하여 애플리케이션 인스턴스의 상태를 모니터링합니다. SHOW VERSIONS IN APPLICATION PACKAGE 명령을 사용하여 삭제된 버전의 상태를 모니터링합니다.

ADD PATCH patch_number FOR VERSION version_identifier USING path_to_version_directory [ LABEL = 'display_label' ]

지정된 경로(path_to_version_directory)의 스테이지 위치에 있는 애플리케이션 파일을 사용하여 지정된 버전(version_identifier)에 대한 패치를 추가합니다.

LABEL 절을 사용하여 이 새 패치의 레이블을 지정할 수 있습니다. 이 레이블은 소비자에게 표시됩니다. LABEL 절을 생략하면 manifest.yml 파일에 지정된 레이블이 사용됩니다.

사용 참고 사항

버전 식별자는 최대 30자로 제한됩니다.
단일 버전에는 최대 130개의 패치를 추가할 수 있습니다.
버전을 수정하려면 애플리케이션에 대한 OWNERSHIP 권한 또는 전역 MANAGE VERSIONS 권한이 있는 역할이 필요합니다.
선택적 속성에 대한 값을 지정하지 않으면 명령은 애플리케이션 매니페스트 파일에 지정된 값을 사용합니다.

명령과 애플리케이션 매니페스트 파일 모두에서 속성 값을 지정하면 명령에 지정된 값이 우선합니다.
두 버전이 활성 상태인 경우(예: 현재 버전의 롤아웃이 아직 완료되지 않은 경우) 새 버전을 추가하면 오류가 발생합니다.

예제

ALTER APPLICATION PACKAGE hello_snowflake_package
  ADD VERSION v1_1
  USING '@hello_snowflake_code.core.hello_snowflake_stage';

+---------------------------------------------------------------------------------------+---------+-------+
| status                                                                                | version | patch |
|---------------------------------------------------------------------------------------+---------+-------|
| Version 'v1_1' of application package 'hello_snowflake_package' created successfully. | v1_1    |     0 |
+---------------------------------------------------------------------------------------+---------+-------+

애플리케이션 패키지 버전 변경하기