ALTER APPLICATION

Native Apps Framework에서 설치된 애플리케이션의 속성을 수정합니다. 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 <name> UPGRADE

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

 ALTER APPLICATION <name> UPGRADE USING <path_to_stage>

 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> UNSET REFERENCES[ ( '<reference_name>' [ , '<reference_alias>' ] ) ]
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자입니다.

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

UPGRADE

애플리케이션 공급자가 인스턴스를 업그레이드해야 한다고 표시한 경우 애플리케이션 업그레이드를 수행합니다.

공급자가 그렇게 해야 한다고 표시했을 때는 애플리케이션이 자동으로 업그레이드되겠지만, 이 명령을 사용하면 자동으로 업그레이드될 때까지 기다리지 않고 즉시 업그레이드가 이루어질 수 있습니다. 이 명령은 목록에서 설치되거나 스테이지 또는 버전을 지정하지 않고 설치되는 비개발 모드 애플리케이션에서만 사용할 수 있으며, 애플리케이션 업그레이드 프로세스의 테스트를 지원하는 것이 주목적입니다.

UPGRADE USING VERSION version_name [ PATCH patch_num ]

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

UPGRADE USING <path_to_version_directory>

path_to_stage 로 지정된 경로의 명명된 스테이지에 있는 파일을 사용하여 애플리케이션을 업그레이드합니다.

이 절은 명명된 스테이지에서 애플리케이션을 설치한 경우에만 적용됩니다.

UNSET

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

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

  • COMMENT

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

  • TAG tag_name [ , tag_name ... ]

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

    애플리케이션에 대한 영구 참조를 설정 해제합니다. 인자가 전달되지 않으면 애플리케이션에 설정된 모든 영구 참조의 설정이 해제됩니다.

사용법 노트

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

  • 메타데이터 관련:

    주의

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