ALTER APPLICATION PACKAGE

Native Apps Framework에서 기존 애플리케이션 패키지의 속성을 수정합니다.

참고 항목:

CREATE APPLICATION PACKAGE, DROP APPLICATION PACKAGE, SHOW APPLICATION PACKAGES, SHOW VERSIONS, SHOW RELEASE DIRECTIVES

구문

ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> SET
  [ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
  [ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
  [ COMMENT = <string-literal> ]
  [ DISTRIBUTION = { INTERNAL | EXTERNAL } ]
  [ MULTIPLE_INSTANCES = TRUE ]

ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> UNSET
  [ DATA_RETENTION_TIME_IN_DAYS ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS ]
  [ DEFAULT_DDL_COLLATION ]
  [ COMMENT ]
  [ DISTRIBUTION ]

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

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

매개 변수

name

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

SET ...

애플리케이션 패키지를 위해 설정할 하나 이상의 속성을 지정합니다(공백, 쉼표 또는 줄 바꿈으로 구분됨).

DATA_RETENTION_TIME_IN_DAYS = num

데이터베이스에서 Time Travel 작업(CLONE 및 UNDROP)을 수행할 수 있는 일수뿐 아니라, 데이터베이스에서 생성된 모든 스키마의 기본 Time Travel 보존 시간도 지정합니다.

지정할 수 있는 값은 다음과 같이 사용 중인 Snowflake Edition에 따라 다릅니다.

  • Standard Edition: 0 또는 1

  • Enterprise Edition(또는 그 이상): 0 ~ 90

MAX_DATA_EXTENSION_TIME_IN_DAYS = integer

Snowflake가 테이블의 스트림이 부실해지는 것을 방지하기 위해 데이터베이스에 있는 테이블의 데이터 보존 기간을 연장할 수 있는 최대 일수를 지정하는 오브젝트 매개 변수입니다.

이 매개 변수에 대한 자세한 설명은 MAX_DATA_EXTENSION_TIME_IN_DAYS 섹션을 참조하십시오.

DEFAULT_DDL_COLLATION = 'collation_specification'

다음에 대한 기본 데이터 정렬 사양 을 지정합니다.

  • 데이터베이스의 기존 테이블에 추가된 모든 새 열.

  • 새 테이블의 모든 열이 데이터베이스에 추가됩니다.

이 매개 변수를 설정해도 기존 열의 데이터 정렬 사양은 변경되지 않습니다.

매개 변수에 대한 자세한 내용은 DEFAULT_DDL_COLLATION 섹션을 참조하십시오.

DEFAULT_DDL_COLLATION = 'collation_specification'

다음에 대한 기본 데이터 정렬 사양 을 지정합니다.

  • 데이터베이스의 기존 테이블에 추가된 모든 새 열.

  • 새 테이블의 모든 열이 데이터베이스에 추가됩니다.

이 매개 변수를 설정해도 기존 열의 데이터 정렬 사양은 변경되지 않습니다.

매개 변수에 대한 자세한 내용은 DEFAULT_DDL_COLLATION 섹션을 참조하십시오.

COMMENT = 'string_literal'

데이터베이스에 대한 설명을 추가하거나 기존 설명을 덮어씁니다.

DISTRIBUTION = { INTERNAL | EXTERNAL }

애플리케이션 패키지를 목록의 데이터 제품으로 사용할 때 공급자가 만들 수 있는 목록의 유형을 지정합니다.

  • INTERNAL 은 공급자가 애플리케이션 패키지가 생성된 동일한 조직 내에서만 비공개 목록을 생성할 수 있음을 나타냅니다. DISTRIBUTION 속성이 INTERNAL 로 설정되어 있으면 자동 보안 검사가 수행되지 않습니다.

  • EXTERNAL 은 공급자가 애플리케이션 패키지가 생성된 동일한 조직 외부에서 목록을 생성할 수 있음을 나타냅니다.

DISTRIBUTION 속성 설정 및 자동 보안 검사에 대한 자세한 내용은 자동 보안 검사 실행하기 섹션을 참조하십시오.

참고

DISTRIBUTION 매개 변수를 EXTERNAL 로 설정하면 애플리케이션 패키지에 정의된 각 활성 버전 및 패치에 대해 자동화된 보안 검토가 트리거됩니다.

자동화된 보안 검토가 APPROVED 상태가 될 때까지 다음 제한 사항이 적용됩니다.

  • 버전 또는 패치에 대한 릴리스 지시문을 설정할 수 없습니다.

  • 애플리케이션 패키지 목록을 게시할 수 없습니다.

MULTIPLE_INSTANCES = TRUE

컨슈머는 애플리케이션 패키지에서 앱의 여러 인스턴스를 설치할 수 있습니다. 평가판 또는 수익 창출 목록에 포함된 애플리케이션 패키지에는 이 속성을 설정할 수 없습니다.

다중 인스턴스가 허용되는 경우 컨슈머는 계정에 최대 10개까지 앱 인스턴스를 설치할 수 있습니다.

조심

이 속성을 true로 설정한 후에는 FALSE 로 설정하거나 나중에 설정 해제할 수 없습니다.

UNSET ...

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

  • DATA_RETENTION_TIME_IN_DAYS

  • MAX_DATA_EXTENSION_TIME_IN_DAYS

  • EXTERNAL_VOLUME

  • CATALOG

  • DEFAULT_DDL_COLLATION

  • TAG tag_name [ , tag_name ... ]

  • COMMENT

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

사용법 노트

  • 선택적 속성에 대한 값을 지정하지 않으면 명령은 앱의 매니페스트 파일에 지정된 값을 사용합니다.

    명령과 앱의 매니페스트 파일에 속성에 대한 값을 지정하면 명령에 지정된 값이 우선합니다.

  • 두 버전이 활성 상태인 경우(예: 현재 버전의 출시가 마무리되지 않은 경우) 새 버전을 추가하면 오류가 발생합니다.

  • 새 버전은 0을 기본 패치 번호로 하여 추가됩니다.

  • 메타데이터 관련:

    주의

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

ALTER APPLICATION PACKAGE hello_snowflake_package SET
  COMMENT = 'Altered the Hello Snowflake app.';
Copy
+-------------------------------------------+
| status                                    |
|-------------------------------------------|
| Statement executed successfully.          |
+-------------------------------------------+