ALTER APPLICATION PACKAGE … VERSION¶
Native Apps Framework에서 기존 애플리케이션 패키지의 버전 관리를 수정합니다.
구문¶
ALTER APPLICATION PACKAGE <name> ADD VERSION [ <version_identifier> ]
USING <path_to_version_directory> [ LABEL = '<display_label>' ]
ALTER APPLICATION PACKAGE <name> DROP VERSION <version_identifier>
ALTER APPLICATION PACKAGE <name> ADD PATCH FOR VERSION [<version_identifier>]
USING <path_to_version_directory> [ LABEL = '<display_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 뷰 뷰를 사용하십시오. 삭제된 버전의 상태를 모니터링하려면 SHOW VERSIONS 명령을 사용하십시오.
ADD PATCH FOR VERSION version_identifier
.USING path_to_version_directory [ LABEL = 'display_label' ]
스테이지 위치에 대해 지정된 경로(
path_to_version_directory
)에 있는 애플리케이션 파일을 사용하여 지정된 버전(version_identifier
)에 대한 패치를 추가합니다.LABEL 절을 사용하여 이 새 패치에 대한 레이블을 지정할 수 있습니다. 이 레이블은 컨슈머에게 표시됩니다. LABEL 절을 생략하면
manifest.yml
파일에 지정된 레이블이 사용됩니다.
사용법 노트¶
버전을 수정하려면 애플리케이션에 대한 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 |
+---------------------------------------------------------------------------------------+---------+-------+