애

애

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

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

• About the Snowflake Native App Framework

기존 애플리케이션 패키지의 속성을 수정해요. 이 명령을 사용하여 릴리스 지시문을 새 버전이나 패치로 수정할 수 있어요.

이 항목에서 설명하는 대부분의 구문은 릴리스 채널을 사용하지 않는 애플리케이션 패키지에 적용돼요. 특정 릴리스 채널의 릴리스 지시문에서 계정을 추가하거나 제거하려면 선택적 MODIFY RELEASE CHANNEL 절을 포함하세요. 생략하면 명령은 기본 릴리스 채널의 릴리스 지시문에만 적용돼요. 릴리스 채널을 사용하는 애플리케이션 패키지의 릴리스 지시문을 수정하려면 ALTER APPLICATION PACKAGE ... MODIFY RELEASE CHANNEL을 참조하세요.

참조:

ALTER APPLICATION PACKAGE , ALTER APPLICATION PACKAGE ... VERSION

출처: 문서

본문

구문

ALTER APPLICATION PACKAGE 
  MODIFY RELEASE DIRECTIVE 
  VERSION = 
  PATCH = 
  [ UPGRADE_AFTER = '' ]
  [ UPGRADE_IN_MAINTENANCE_WINDOW = { TRUE | FALSE } ]
  [ UPGRADE_DEADLINE = '' ]

ALTER APPLICATION PACKAGE 
  [ MODIFY RELEASE CHANNEL  ]
  MODIFY RELEASE DIRECTIVE 
  ADD ACCOUNTS = ( . [ , . , ... ] )
  [ VERSION =  PATCH =  ]
  [ FORCE ]

ALTER APPLICATION PACKAGE 
  [ MODIFY RELEASE CHANNEL  ]
  MODIFY RELEASE DIRECTIVE 
  REMOVE ACCOUNTS = ( . [ , . , ... ] )
  [ VERSION =  PATCH =  ]

ALTER APPLICATION PACKAGE 
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = 
  PATCH = 
  [ UPGRADE_AFTER = '' ]
  [ UPGRADE_IN_MAINTENANCE_WINDOW = { TRUE | FALSE } ]
  [ UPGRADE_DEADLINE = '' ]

ALTER APPLICATION PACKAGE 
  SET RELEASE DIRECTIVE 
  ACCOUNTS = ( . [ , . , ... ] )
  VERSION = 
  PATCH = 
  [ UPGRADE_AFTER = '' ]
  [ UPGRADE_IN_MAINTENANCE_WINDOW = { TRUE | FALSE } ]
  [ UPGRADE_DEADLINE = '' ]
  [ FORCE ]

ALTER APPLICATION PACKAGE  UNSET RELEASE DIRECTIVE 

매개변수

name

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

MODIFY RELEASE DIRECTIVE release_directive VERSION = version_identifier PATCH = patch_num

지정된 사용자 지정 릴리스 지시문의 버전 및 패치 수준을 수정합니다.

[ MODIFY RELEASE CHANNEL release_channel_name ] MODIFY RELEASE DIRECTIVE release_directive ADD ACCOUNTS = ( organization_name.account_name [ , organization_name.account_name , ... ] ) [ VERSION = version_identifier PATCH = patch_num ] [ FORCE ]

지정된 사용자 지정 릴리스 지시문에 계정을 추가합니다.

특정 릴리스 채널의 릴리스 지시문에 계정을 추가하려면 MODIFY RELEASE CHANNEL을 지정하세요.

VERSION과 PATCH를 지정하면 해당 릴리스 지시문에 이미 포함된 계정을 포함하여 모든 계정의 버전과 패치가 업데이트됩니다. 두 값을 모두 지정하거나 둘 다 지정하지 않아야 합니다.

FORCE를 사용하면 이미 다른 릴리스 지시문에 할당된 계정을 원자적으로 이동할 수 있습니다. FORCE 없이 지정된 계정 중 하나라도 이미 다른 릴리스 지시문에 있으면 명령이 실패합니다.

[ MODIFY RELEASE CHANNEL release_channel_name ] MODIFY RELEASE DIRECTIVE release_directive REMOVE ACCOUNTS = ( organization_name.account_name [ , organization_name.account_name , ... ] ) [ VERSION = version_identifier PATCH = patch_num ]

지정된 사용자 지정 릴리스 지시문에서 계정을 제거합니다.

특정 릴리스 채널의 릴리스 지시문에서 계정을 제거하려면 MODIFY RELEASE CHANNEL을 지정하세요.

VERSION과 PATCH를 지정하면 제거 후 릴리스 지시문에 남아 있는 모든 계정의 버전과 패치가 업데이트됩니다. 두 값을 모두 지정하거나 둘 다 지정하지 않아야 합니다.

SET

애플리케이션 패키지에 설정할 하나 이상의 속성을 지정합니다(공백, 쉼표, 또는 새 줄로 구분). 설정할 수 있는 속성에 대한 자세한 내용은 CREATE APPLICATION을 참조하세요.

DEFAULT RELEASE DIRECTIVE VERSION = version_identifier PATCH = patch_num

소비자에게 기본적으로 설치되어야 하는 애플리케이션 패키지의 버전 및 패치 수준을 설정합니다.

RELEASE DIRECTIVE release_directive ACCOUNTS = ( organization_name.account_name [ , organization_name.account_name , ... ] ) VERSION = version_identifier PATCH = patch_num [ FORCE ]

지정된 계정에 대한 사용자 지정 릴리스 지시문을 생성합니다.

ACCOUNTS 절을 사용하여 이 릴리스 지시문이 적용되는 계정 목록을 지정하세요.

VERSION 및 PATCH 절을 사용하여 이 계정들에 설치할 버전 식별자와 패치 번호를 지정하세요.

FORCE를 사용하면 이미 다른 릴리스 지시문에 할당된 계정을 원자적으로 이동할 수 있습니다. FORCE 없이 지정된 계정 중 하나라도 이미 다른 릴리스 지시문에 있으면 명령이 실패합니다.

UPGRADE_AFTER = 'timestamp'

자동 업그레이드 프로세스가 시작되는 날짜와 시간을 지정합니다. 소비자는 이 날짜 이전에 앱을 새 버전이나 패치로 수동 업그레이드할 수 있습니다.

이 값은 유효한 날짜 및 시간 형식이면 무엇이든 가능합니다.

UPGRADE_IN_MAINTENANCE_WINDOW = { TRUE | FALSE }

TRUE로 설정하면 업그레이드가 소비자의 유지 관리 정책을 존중합니다. 즉시 업그레이드하는 대신 소비자의 다음 유지 관리 창이나 업그레이드 기한에 도달할 때까지 업그레이드가 지연됩니다. 둘 중 먼저 도래하는 시점에 수행됩니다.

이 매개변수를 TRUE로 설정하면 UPGRADE_DEADLINE 매개변수가 필수입니다.

UPGRADE_AFTER와 UPGRADE_IN_MAINTENANCE_WINDOW 매개변수를 동시에 설정할 수 없습니다. 둘 다 설정하려고 하면 명령이 오류와 함께 실패합니다.

자세한 내용은 Consumer-controlled maintenance policies: Provider guide를 참조하세요.

UPGRADE_DEADLINE = 'timestamp'

UPGRADE_IN_MAINTENANCE_WINDOW가 TRUE로 설정된 경우 필수입니다. 업그레이드가 완료되어야 하는 기한을 지정합니다. 이 시간이 지나면 소비자의 유지 관리 정책과 관계없이 시스템이 애플리케이션을 자동으로 업그레이드합니다.

소비자가 유지 관리 창 내에서 업그레이드를 완료할 수 있도록 충분한 시간을 허용하는 날짜와 시간으로 기한을 설정하세요.

UNSET

애플리케이션 패키지에 대해 설정 해제할 하나 이상의 속성 및/또는 세션 매개변수를 지정합니다. 기본값으로 재설정됩니다.

UNSET RELEASE DIRECTIVE release_directive

애플리케이션 패키지에서 지정된 사용자 지정 릴리스 지시문을 제거합니다.

액세스 제어 요구 사항

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 합니다:

권한	개체	참고
OWNERSHIP	애플리케이션 패키지	릴리스 지시문을 수정하는 데 필요합니다.
MANAGE VERSIONS	계정	모든 애플리케이션 패키지에서 릴리스 지시문을 수정할 수 있는 전역 권한입니다.

지정된 권한 집합을 가진 사용자 지정 역할을 만드는 방법은 을 참조하세요.

보호 개체에 대해 SQL 작업을 수행하기 위한 역할 및 권한 부여에 대한 일반적인 정보는 액세스 제어 개요를 참조하세요.

사용 참고 사항

• 릴리스 지시문을 수정하려면 애플리케이션에 대한 OWNERSHIP 권한 또는 전역 MANAGE VERSIONS 권한이 필요합니다.
• 선택적 속성에 대한 값을 지정하지 않으면 명령은 애플리케이션 매니페스트 파일에 지정된 값을 사용합니다.

---

명령과 애플리케이션 매니페스트 파일에서 속성 값을 지정하는 경우, 명령에서 지정한 값이 우선해요.

예제

다음 예제는 사용자 지정 릴리스 지시문 my_directive에 계정을 추가해요:

ALTER APPLICATION PACKAGE my_app_package
  MODIFY RELEASE DIRECTIVE my_directive
  ADD ACCOUNTS = (myorg.myaccount)
  VERSION = V1
  PATCH = 0;

다음 예제는 사용자 지정 릴리스 지시문 my_directive에서 계정을 제거해요:

ALTER APPLICATION PACKAGE my_app_package
  MODIFY RELEASE DIRECTIVE my_directive
  REMOVE ACCOUNTS = (myorg.myaccount)
  VERSION = V1
  PATCH = 0;

다음 예제는 릴리스 채널 my_channel의 사용자 지정 릴리스 지시문 my_directive에 계정을 추가하고, 해당 계정이 속한 다른 릴리스 지시문에서 그 계정을 이동해요:

ALTER APPLICATION PACKAGE my_app_package
  MODIFY RELEASE CHANNEL my_channel
  MODIFY RELEASE DIRECTIVE my_directive
  ADD ACCOUNTS = (myorg.myaccount)
  VERSION = V1
  PATCH = 0
  FORCE;

더 알아보기 (Learn more)

• ALTER APPLICATION PACKAGE
• ALTER APPLICATION PACKAGE ... VERSION