ALTER APPLICATION

설치된 Snowflake Native App 의 속성을 수정합니다. ALTER APPLICATION을 사용하여 앱을 특정 버전이나 패치로 업그레이드합니다. 이 명령은 앱의 다른 속성을 설정하는 데도 사용됩니다.

참고 항목:

CREATE APPLICATION, DESCRIBE APPLICATION, DROP APPLICATION, SHOW APPLICATIONS

구문

ALTER APPLICATION [ IF EXISTS ] <name> SET
  [ COMMENT = '<string-literal>' ]
  [ SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE } ]
  [ DEBUG_MODE = { TRUE | FALSE } ]

ALTER APPLICATION [ IF EXISTS ] <name> UNSET
  [ COMMENT ]
  [ SHARE_EVENTS_WITH_PROVIDER ]
  [ DEBUG_MODE ]

ALTER APPLICATION [ IF EXISTS ] <name> RENAME TO <new_app_name>

ALTER APPLICATION <name> SET FEATURE POLICY <policy_name> [ FORCE ]

ALTER APPLICATION <name> UNSET FEATURE POLICY;

ALTER APPLICATION <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER APPLICATION <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER APPLICATION <name> SET SHARED TELEMETRY EVENTS ('<event_definition' [ , <event_definition>, ...])

ALTER APPLICATION <name> SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }

ALTER APPLICATION <name> UNSET REFERENCES [ ( '<reference_name>' [ , '<reference_alias>' ] ) ]

ALTER APPLICATION <name> UPGRADE

ALTER APPLICATION <name> UPGRADE USING VERSION <version_name> [ PATCH <patch_num> ]

ALTER APPLICATION <name> UPGRADE USING <path_to_stage>
Copy

매개 변수

name

변경할 앱의 식별자를 지정합니다. 식별자에 공백, 특수 문자 또는 대/소문자가 혼합된 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

SET

앱에 설정할 속성을 하나 이상 지정합니다(공백, 쉼표 또는 새 줄로 구분). 설정할 수 있는 속성에 대한 자세한 내용은 CREATE APPLICATION 를 참조하십시오.

COMMENT = '{string}'

설명을 추가하거나 앱에 대한 기존 설명을 덮어씁니다.

DEBUG_MODE = { TRUE | FALSE }

설치된 앱의 디버그 모드를 사용하거나 사용하지 않도록 설정합니다.

  • TRUE 는 설치된 앱의 디버그 모드를 활성화합니다.

  • FALSE 는 설치된 앱의 디버그 모드를 비활성화합니다.

다음 조건을 충족하는 경우에만 앱에서 DEBUG_MODE 를 설정할 수 있습니다.

  • 설치된 앱은 애플리케이션 패키지와 동일한 계정에 있습니다.

  • 설치된 앱은 개발 모드에서 생성된 앱이어야 합니다.

    개발 모드는 명시적 스테이지, 버전 또는 패치와 함께 설치됩니다.

  • 설치된 앱에 대해 OWNERSHIP 권한이 있으며 설치된 앱을 만드는 데 사용된 애플리케이션 패키지에 대해 DEVELOP 권한이 역할에 부여되었습니다.

SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE }

공급자와 로그 및 이벤트 데이터를 공유할지 여부를 지정합니다.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

태그 이름과 태그 문자열 값을 지정합니다.

태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.

문에서 태그를 지정하는 방법에 대한 자세한 내용은 오브젝트에 대한 태그 할당량 섹션을 참조하십시오.

UNSET

앱에 대해 설정 해제할 속성 및/또는 세션 매개 변수를 하나 이상 지정하여 기본값으로 재설정합니다.

단일 ALTER 문으로 여러 속성/매개 변수를 재설정할 수 있지만, 각 속성/매개 변수는 쉼표로 구분해야 합니다. 속성/매개 변수를 재설정할 때는 이름만 지정하십시오. 속성/매개 변수 값을 지정하면 오류가 반환됩니다.

  • COMMENT

  • DEBUG_MODE 는 설치된 앱의 디버그 모드를 비활성화합니다. 이 절은 의미상 DEBUG_MODE = FALSE 를 설정하는 것과 동일합니다.

  • TAG tag_name [ , tag_name ... ]

  • REFERENCES[ ( 'reference_name' [, 'reference_alias' ] ) ]

    앱에 대한 영구 참조를 설정 해제합니다. 인자가 전달되지 않으면 앱에 대해 설정된 모든 영구 참조를 해제합니다.

RENAME TO new_app_name

앱의 새 식별자를 지정합니다. 이 식별자는 계정에 대해 고유해야 합니다.

SET FEATURE POLICY policy_name [ FORCE ]

앱에 적용할 기능 정책을 지정합니다. 앱에 이미 기능 정책이 설정되어 있는 경우 먼저 기능 정책을 해제할 필요 없이 FORCE 를 사용하여 기능 정책을 설정할 수 있습니다.

UNSET FEATURE POLICY

앱에서 기능 정책을 제거합니다. 앱에서 기능 정책이 제거되면 계정 수준 기능 정책이 있는 경우 해당 정책이 적용됩니다.

SET SHARED TELEMETRY EVENTS ( 'event_definition' [ , event_definition, ... ] )

앱에서 활성화할 선택적 이벤트 정의를 지정합니다.

SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }

TRUE로 설정하면 앱에 필요한 모든 이벤트 정의가 활성화됩니다. 그러나 선택적 이벤트 정의는 비활성화된 상태로 유지됩니다. SET SHARED TELEMETRY EVENTS 절을 사용하여 앱에 대한 선택적 이벤트 정의를 설정합니다.

조심

이 값을 TRUE로 설정한 후에는 앱에 필수적인 이벤트 정의가 있는 경우 값을 다시 FALSE로 재설정할 수 없습니다.

UNSET REFERENCES[ ( 'reference_name' [ , 'reference_alias' ] ) ]

앱에서 지정된 참조를 제거합니다.

UPGRADE

공급자가 앱의 새 버전 또는 패치를 게시한 경우 앱을 업그레이드합니다.

공급자가 앱의 릴리스 지시문을 설정하면 앱이 자동으로 업그레이드됩니다. 그러나 이 명령을 사용하면 자동 업그레이드가 수행될 때까지 기다리지 않고 즉시 업그레이드를 시작할 수 있습니다. 이 명령은 개발 모드에서 생성되지 않은 앱에서만 사용할 수 있습니다. 개발 모드의 앱은 목록에서 또는 스테이지나 버전을 지정하지 않고 설치되며, 주로 업그레이드 프로세스를 테스트하기 위한 것입니다.

UPGRADE USING VERSION version_name [ PATCH patch_num ]

앱을 지정된 버전으로 업그레이드합니다. patch_num 을 지정하지 않으면 최신 패치가 사용됩니다. 이 명령은 버전과 패치를 지정하여 설치한 앱에만 유효합니다.

UPGRADE USING path_to_stage

path_to_stage 에서 지정한 경로의 명명된 스테이지에 있는 파일을 사용하여 앱을 업그레이드합니다.

이 절은 명명된 스테이지에서 앱을 설치한 경우에만 적용됩니다.

사용법 노트

  • 선택적 매개 변수의 값을 지정하지 않으면 이러한 매개 변수의 값은 manifest.yml 파일에서 가져옵니다. 매니페스트에 그리고 명령 실행 시에 모두 값을 지정할 경우 명령에 지정된 값이 우선합니다.

  • 메타데이터 관련:

    주의

    고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.