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> ... ]
매개 변수¶
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.';
+-------------------------------------------+
| status |
|-------------------------------------------|
| Statement executed successfully. |
+-------------------------------------------+