애플리케이션 패키지 수정하기

애플리케이션 패키지 수정하기 (ALTER APPLICATION PACKAGE)

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

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

• About the Snowflake Native App Framework

기존 애플리케이션 패키지의 속성을 수정해요.

참조:

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

출처: 문서

본문

구문

ALTER APPLICATION PACKAGE [ IF EXISTS ]  SET
  [ DATA_RETENTION_TIME_IN_DAYS =  ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS =  ]
  [ DEFAULT_DDL_COLLATION = '' ]
  [ COMMENT =  ]
  [ DISTRIBUTION = { INTERNAL | EXTERNAL } ]
  [ MULTIPLE_INSTANCES = TRUE ]
  [ ENABLE_RELEASE_CHANNELS = TRUE ]
  [ LISTING_AUTO_REFRESH = { TRUE | FALSE } ]
  [ AUTOMATIC_APPLICATION_MAINTENANCE = { TRUE | FALSE } ]

ALTER APPLICATION PACKAGE [ IF EXISTS ]  UNSET
  [ DATA_RETENTION_TIME_IN_DAYS ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS ]
  [ DEFAULT_DDL_COLLATION ]
  [ COMMENT  =  ]
  [ DISTRIBUTION = { INTERNAL | EXTERNAL } ]

ALTER APPLICATION PACKAGE  SET TAG  = '' [ ,  = '' ... ]

ALTER APPLICATION PACKAGE  UNSET TAG  [ ,  ... ]

매개변수

name

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

SET ...

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

DATA_RETENTION_TIME_IN_DAYS = num

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

지정할 수 있는 값은 사용 중인 Snowflake 에디션에 따라 다릅니다.

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

MAX_DATA_EXTENSION_TIME_IN_DAYS = integer

데이터베이스의 테이블에 대한 데이터 보존 기간을 Snowflake가 연장할 수 있는 최대 일 수를 지정하는 객체 매개변수로, 테이블의 스트림이 오래되어(stale) 만료되지 않도록 방지합니다.

이 매개변수에 대한 자세한 설명은 를 참조하세요.

DEFAULT_DDL_COLLATION = 'collation_specification'

다음에 대한 기본 콜레이션 사양을 지정합니다.

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

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

매개변수에 대한 자세한 내용은 을 참조하세요.

COMMENT = 'string_literal'

데이터베이스에 주석을 추가하거나 기존 주석을 덮어씁니다.

DISTRIBUTION = { INTERNAL | EXTERNAL }

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

• INTERNAL은 공급자가 애플리케이션 패키지가 생성된 동일한 조직 내에서만 비공개 리스팅을 만들 수 있음을 나타냅니다. DISTRIBUTION 속성이 INTERNAL로 설정된 경우 자동 보안 검사가 수행되지 않습니다.
• EXTERNAL은 공급자가 애플리케이션 패키지가 생성된 조직 외부에서 리스팅을 만들 수 있음을 나타냅니다.

DISTRIBUTION 속성 설정 및 자동 보안 검사에 대한 자세한 내용은 자동 보안 검사 실행을 참조하세요.

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

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

• 버전 또는 패치에 대한 릴리스 지시문을 설정할 수 없습니다.
• 애플리케이션 패키지에 대한 리스팅을 게시할 수 없습니다.

LISTING_AUTO_REFRESH = { TRUE | FALSE}

TRUE로 설정하면 애플리케이션 패키지의 릴리스 지시문이 변경될 때 모든 원격 리전으로 복제가 시작됩니다. 릴리스 지시문이 변경되면 애플리케이션 패키지는 Cross-Cloud Auto-Fulfillment 일정을 기다리지 않습니다.

MULTIPLE_INSTANCES = TRUE

소비자가 애플리케이션 패키지에서 앱의 여러 인스턴스를 설치할 수 있도록 합니다. 이 속성은 평가판 또는 유료 리스팅에 포함된 애플리케이션 패키지에는 설정할 수 없습니다.

여러 인스턴스가 허용되면 소비자는 자신의 계정에 앱을 최대 30개까지 설치할 수 있습니다.

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

ENABLE_RELEASE_CHANNELS = TRUE

애플리케이션 패키지에 릴리스 채널을 활성화합니다.

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

AUTOMATIC_APPLICATION_MAINTENANCE = { TRUE | FALSE }

TRUE로 설정하면 %spcs% 컴퓨트 풀 노드 소프트웨어 업그레이드가 소비자의 유지 관리 기간에 맞춰 조정됩니다. 애플리케이션이 먼저 업그레이드된 다음 동일한 유지 관리 기간 내에 컴퓨트 풀 노드 유지 관리가 이어집니다.

자세한 내용은 소비자 제어 유지 관리 정책: 공급자 가이드를 참조하세요.

UNSET ...

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

• DATA_RETENTION_TIME_IN_DAYS
• MAX_DATA_EXTENSION_TIME_IN_DAYS
• DEFAULT_DDL_COLLATION
• TAG tag_name [ , tag_name ... ]
• COMMENT
• LISTING_AUTO_REFRESH
• AUTOMATIC_APPLICATION_MAINTENANCE

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

사용 참고 사항

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

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

• 두 버전이 활성 상태인 경우(예: 현재 버전의 롤아웃이 아직 완료되지 않은 경우) 새 버전을 추가하면 오류가 발생합니다.

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

• 메타데이터 관련:

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

예제

ALTER APPLICATION PACKAGE hello_snowflake_package SET
  COMMENT = 'Altered the Hello Snowflake app.';

+-------------------------------------------+
| status                                    |
|-------------------------------------------|
| Statement executed successfully.          |
+-------------------------------------------+

더 알아보기 (Learn more)

• CREATE APPLICATION PACKAGE
• DROP APPLICATION PACKAGE
• SHOW APPLICATION PACKAGES
• SHOW VERSIONS IN APPLICATION PACKAGE
• SHOW RELEASE DIRECTIVES