ALTER APPLICATION PACKAGE … VERSION¶

Native Apps Framework에서 기존 애플리케이션 패키지의 버전 관리를 수정합니다.

참고 항목:: ALTER APPLICATION PACKAGE , ALTER APPLICATION PACKAGE … RELEASE DIRECTIVE

구문¶

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>' ]

Copy

매개 변수¶

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 파일에 지정된 레이블이 사용됩니다.

사용법 노트¶

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

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

예¶

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

Copy

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