Snowflake Native App 업데이트 및 업그레이드하기¶

버전과 패치의 차이점¶

공급자가 새 버전의 앱을 게시할 때 Snowflake Native App Framework 는 이전 버전의 앱만 활성화되도록 보장합니다. 예를 들어 공급자가 앱의 V1 및 V2를 게시한 경우 Snowflake Native App Framework 는 현재 V2만 컨슈머 계정에 설치되어 있는지 확인한 후 V3으로 업그레이드합니다. 이를 통해 설정 스크립트가 V2와 V3 간의 차이점만 처리하면 되도록 합니다. 즉, 설정 스크립트는 최신 버전의 앱에서만 이전 버전과 호환됩니다. 예컨대 새 테이블 생성 또는 테이블에 열 추가와 같이, 공급자가 앱의 상태를 변경할 경우 버전 간 호환성 문제가 없습니다.

반면, 공급자가 앱 버전에 대해 새 패치를 게시하면 Snowflake Native App Framework 에서는 실행 중인 활성 패치 수에 아무런 제한도 적용되지 않습니다. 공급자는 패치에서 앱 상태 변경을 방지해야 합니다.

리전 간 업그레이드 정보¶

여러 리전에 걸쳐 설치된 앱을 업그레이드하는 방법에 대한 자세한 내용은 여러 리전에 걸쳐 설치된 앱 업그레이드하기 섹션을 참조하십시오.

버전 및 패치를 추가하거나 제거하는 데 필요한 권한¶

애플리케이션 패키지의 버전이나 패치를 지정하려면 애플리케이션 패키지에 대해 다음 권한 중 하나를 자신의 역할에 부여해야 합니다.

• OWNERSHIP

• MANAGE VERSIONS

예를 들어 애플리케이션 패키지에 대한 MANAGE VERSION 권한을 release_mgr 역할에 부여하려면 다음 예와 같이 GRANT <권한> 명령을 사용하십시오.

GRANT MANAGE VERSIONS ON APPLICATION PACKAGE hello_snowflake_package
  TO ROLE release_mgr;

SQL을 사용하여 애플리케이션 패키지에 버전 추가하기¶

다음 예에서는 ALTER APPLICATION PACKAGE 명령을 사용하여 애플리케이션 패키지에 버전을 추가하는 방법을 보여줍니다.

ALTER APPLICATION PACKAGE MyAppPackage
  ADD VERSION v1_0
  USING '@dev_stage/v1_0'
  LABEL = 'MyApp Version 1.0';

이 예에서 v1_0 은 애플리케이션을 설치할 때 컨슈머에게 표시되지 않는 버전의 식별자입니다. 컨슈머에게는 LABEL 절에 정의된 대로 버전 정보가 표시됩니다.

한 애플리케이션에 대해 동시에 존재할 수 있는 버전 수는 2개뿐입니다. 예를 들어 애플리케이션에서 v1_0 및 v1_1을 정의한 경우 v1_2를 만들려면 v1_0을 삭제해야 합니다. 하지만 패치는 단일 버전에 대해 여러 개 있을 수 있습니다.

manifest.yml 파일에서 버전 이름과 레이블을 정의하거나 ALTER APPLICATION PACKAGE 명령으로 이들을 직접 지정할 수 있습니다. manifest.yml 파일에서 버전 이름과 레이블을 정의할 뿐 아니라 SQL 명령으로도 정의하는 경우 SQL 명령에 지정된 값이 manifest.yml 파일에 지정된 값보다 우선합니다.

SQL을 사용하여 애플리케이션 패키지에 패치 추가하기¶

앱의 버전을 만드는 것 외에 특정 버전에 대한 패치를 만들 수도 있습니다. 버전과 마찬가지로, 앱 패치에도 자체 애플리케이션 파일이 있습니다.

애플리케이션 패키지에 대한 새 패치를 만들려면 다음 예와 같이 ALTER APPLICATION PACKAGE … VERSION 명령의 ADD PATCH FOR VERSION 절을 사용하십시오.

ALTER APPLICATION PACKAGE MyAppPackage
 ADD PATCH FOR VERSION V1_0
 USING '@dev_stage/v1_0_p1;

이 예제에서는 ADD PATCH FOR VERSION V1_0 절에 패치 번호가 제공되지 않습니다. 이 경우 Snowflake는 자동으로 패치 번호를 1씩 증가시킵니다.

사용자 지정 패치 번호로 애플리케이션 패키지에 대한 새 패치를 만들려면 다음 예와 같이 ALTER APPLICATION PACKAGE … VERSION 명령의 ADD PATCH FOR VERSION 절에 패치 번호를 지정하십시오.

ALTER APPLICATION PACKAGE MyAppPackage
 ADD PATCH 3
 FOR VERSION V1_0
 USING '@dev_stage/v1_0_p1;

애플리케이션 패키지의 버전 및 패치 보기¶

공급자로서 애플리케이션 패키지에서 SHOW VERSIONS 명령을 실행하여 애플리케이션에 대해 정의된 버전과 패치를 볼 수 있습니다.

다음 명령으로 hello_snowflake_package 라는 애플리케이션 패키지에 대해 정의된 버전과 패치를 표시합니다.

SHOW VERSIONS IN APPLICATION PACKAGE hello_snowflake_package;

애플리케이션 패키지에서 버전 제거하기¶

애플리케이션 패키지에서 버전을 제거하려면 현재 제거하려는 버전을 가리키는 릴리스 지시문이 없는지 확인해야 합니다.

애플리케이션 패키지에 지정된 릴리스 지시문을 보려면 다음 예에 표시된 것과 같이 SHOW RELEASE DIRECTIVES 명령을 실행하십시오.

SHOW RELEASE DIRECTIVES IN APPLICATION PACKAGE hello_snowflake_package;

애플리케이션 패키지에서 버전을 제거하려면 다음 예와 같이 ALTER APPLICATION PACKAGE 명령의 DROP VERSION 절을 사용하십시오.

ALTER APPLICATION PACKAGE hello_snowflake_package
  DROP VERSION v1_0;

이 명령을 실행한 후에는 설치된 앱 인스턴스가 모두 삭제될 때까지 버전이 삭제되지 않습니다. drop 명령의 상태를 확인하려면 다음 예제와 같이 SHOW VERSIONS 를 사용하십시오.

SHOW VERSIONS IN APPLICATION PACKAGE hello_snowflake_package;

dropped_on 열에는 drop이 시작되었을 때의 타임스탬프가 나열됩니다.

버전이 삭제되면 컨슈머가 더 이상 해당 앱 버전의 새 인스턴스를 설치할 수 없습니다.

애플리케이션이 컨슈머에게 게시되는 방식에 따라 버전이 삭제되는 데 걸리는 시간이 다를 수 있습니다.

• 애플리케이션 패키지가 컨슈머에게 게시되지 않은 경우 버전은 즉시 삭제됩니다.

• 애플리케이션 패키지가 단일 리전 내에서 공개 또는 비공개 목록으로 게시된 경우 해당 버전은 즉시 삭제됩니다.

• 애플리케이션 패키지가 애플리케이션 패키지와 동일한 리전 내에서 공유되는 목록의 데이터 제품으로 게시된 경우 해당 버전은 몇 시간 내에 삭제됩니다.

• 애플리케이션 패키지가 클라우드 간 자동 복제 를 사용하여 목록의 데이터 제품으로 게시된 경우 버전이 모든 리전에서 삭제되는 데 시간이 더 오래 걸릴 수 있습니다.

릴리스 지시문 설정에 필요한 권한¶

릴리스 지시문을 설정하려면 공급자에게 애플리케이션 패키지에 대한 MANAGE RELEASES 권한이나 소유권이 있어야 합니다.

GRANT MANAGE RELEASES ON APPLICATION PACKAGE hello_snowflake_package
  TO ROLE release_mgr;

애플리케이션 패키지에 대한 기본 릴리스 지시문 설정하기¶

다음 예와 같이 SET DEFAULT RELEASE DIRECTIVE와 함께 ALTER APPLICATION PACKAGE 명령을 사용하여 기본 릴리스 지시문을 설정합니다.

ALTER APPLICATION PACKAGE hello_snowflake_package
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = v1_0
  PATCH = 2;

애플리케이션 패키지에 대한 기본 릴리스 지시문을 업데이트하려면 VERSION 또는 PATCH에 새 값을 적절히 지정하여 SET DEFAULT RELEASE DIRECTIVE와 함께 ALTER APPLICATION PACKAGE 명령을 다시 실행하십시오.

애플리케이션 패키지에 대한 사용자 지정 릴리스 지시문 설정하기¶

사용자 지정 릴리스 지시문을 추가하려면 SET RELEASE DIRECTIVE와 함께 ALTER APPLICATION PACKAGE 명령을 사용하십시오. ACCOUNTS 절을 사용하여 이 릴리스 지시문이 적용되는 계정을 지정합니다. 예:

ALTER APPLICATION PACKAGE hello_snowflake_package
  SET RELEASE DIRECTIVE hello_snowflake_package_custom
  ACCOUNTS = (CONSUMER_ORG.CONSUMER_ACCOUNT)
  VERSION = v1_0
  PATCH = 0;

사용자 지정 릴리스 지시문 업데이트하기¶

사용자 지정 릴리스 지시문에 대해 버전 또는 패치를 업데이트하려면 다음 예와 같이 MODIFY RELEASE DIRECTIVE 명령과 함께 ALTER APPLICATION PACKAGE 명령을 사용하십시오.

ALTER APPLICATION PACKAGE hello_snowflake_package
  MODIFY RELEASE DIRECTIVE hello_snowflake_package_custom
  VERSION = v1_0
  PATCH = 0;

하지만 릴리스 지시문과 연결된 계정은 수정할 수 없습니다. 릴리스 지시문과 연결된 조직과 계정을 변경하려면 다음을 수행하십시오.

1. UNSET RELEASE DIRECTIVE와 함께 ALTER APPLICATION PACKAGE 명령을 실행하여 애플리케이션 패키지에서 릴리스 지시문을 제거합니다.

2. SET RELEASE DIRECTIVE와 함께 ALTER APPLICATION PACKAGE 명령을 실행하고 ACCOUNTS 절로 계정 목록을 지정하여 릴리스 지시문을 애플리케이션 패키지에 다시 추가합니다.

사용자 지정 릴리스 지시문 제거하기¶

애플리케이션 패키지에서 사용자 지정 릴리스 지시문을 제거하려면 다음 예와 같이 UNSET RELEASE DIRECTIVE와 함께 ALTER APPLICATION PACKAGE 명령을 사용하십시오.

ALTER APPLICATION PACKAGE hello_snowflake_package
  UNSET RELEASE DIRECTIVE hello_snowflake_package_custom;

릴리스 지시문을 사용하여 버전 및 패치 테스트하기¶

개발 모드의 애플리케이션 패키지에서 애플리케이션을 설치할 때 버전과 패치가 명시적으로 지정됩니다. 그러나 다음 명령을 사용하여 애플리케이션을 설치하는 경우

CREATE APPLICATION hello_snowflake
  FROM APPLICATION PACKAGE hello_snowflake_package

릴리스 지시문에 따라 이 명령을 실행할 때 설치되는 버전이 결정됩니다.

Snowflake Native App 업그레이드를 위한 워크플로¶

공급자는 다음 워크플로를 사용하여 설치된 앱을 업그레이드합니다.

1. 애플리케이션 패키지의 애플리케이션 논리 및 설정 스크립트를 업데이트합니다.

2. 현재 두 가지 버전이 정의되어 있는 경우 애플리케이션 패키지에서 버전을 제거합니다.

3. 애플리케이션 패키지의 변경 사항에 대한 새 버전이나 패치를 만듭니다.

   애플리케이션의 DISTRIBUTION 속성이 EXTERNAL 로 설정된 경우 자동 보안 검사 가 시작됩니다. 업그레이드하려면 먼저 보안 검사를 통과해야 합니다.

4. 공급자의 테스트 계정에 APPLICATION 오브젝트를 생성하여 새 버전을 테스트합니다.

5. 버전이나 패치에 대한 릴리스 지시문을 업데이트합니다.

   그러면 이전 버전의 설치된 모든 인스턴스를 업데이트하는 자동 업그레이드가 시작됩니다. 공급자는 업그레이드가 제공됨을 컨슈머에게 알리고 수동 업그레이드 를 수동으로 수행하도록 요청할 수 있습니다.

여러 리전에 걸쳐 설치된 앱 업그레이드하기¶

공급자가 클라우드 간 자동 복제 를 사용하여 Snowflake Native App 을 게시하는 경우 다음 요소에 따라 자동 업그레이드를 수행하는 데 시간이 다소 걸릴 수 있습니다.

• 새로 고침 일정의 값.

• 설치된 앱 인스턴스 수.

• 앱이 배포되는 리전의 수.

업그레이드에 원격 리전에서 업그레이드해야 하는 긴급 수정 사항이 포함된 경우 공급자는 업그레이드를 더 빠르게 수행하기 위해 다음 방법을 고려할 수 있습니다.

• 목록의 새로 고침 빈도를 더 작은 값으로 줄입니다.

  참고

  새로 고침 빈도를 줄이면 복제와 관련된 비용이 증가할 수 있습니다. 자세한 내용은 클라우드 간 자동 복제 구성하기 를 참조하십시오.

• 컨슈머에게 수동 업그레이드를 수행 하도록 요청합니다.

설치된 앱에 대해 수동 업그레이드 수행하기¶

컨슈머는 수동 업그레이드를 통해 애플리케이션 패키지에 지정된 릴리스 지시문을 사용하여 설치된 앱 버전이나 패치의 업그레이드를 시작할 수 있습니다.

컨슈머가 설치된 Snowflake Native App 을 사용 가능한 최신 버전으로 업그레이드하려면 ALTER APPLICATION 명령의 UPGRADE 절을 사용하여 애플리케이션 오브젝트를 수정하면 됩니다.

ALTER APPLICATION <name> UPGRADE

업그레이드 상태 보기¶

앱의 업그레이드 상태를 보려면 다음 예제와 같이 APPLICATION_STATE 뷰 시스템 뷰를 사용하십시오.

SELECT * FROM snowflake.data_sharing_usage.APPLICATION_STATE

이 뷰에는 업그레이드 상태 및 앱이 배포된 리전을 비롯하여 업그레이드와 관련된 열이 포함되어 있습니다.