CREATE APPLICATION¶
Native Apps Framework를 사용하여 애플리케이션 패키지 또는 목록을 기반으로 새 애플리케이션을 만듭니다.
구문¶
CREATE APPLICATION <name> FROM APPLICATION PACKAGE <package_name>
[ COMMENT = '<string_literal>' ]
[ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , ... ] ) ]
CREATE APPLICATION <name> FROM APPLICATION PACKAGE <package_name>
USING <path_to_version_directory>
[ DEBUG_MODE = TRUE | FALSE ]
[ COMMENT = '<string_literal>' ]
[ [ WITH ] TAG ( <tag_name> = '<tag_value>' [, ...] ) ]
CREATE APPLICATION <name> FROM APPLICATION PACKAGE <package_name>
USING VERSION <version_identifier> [ PATCH <patch_num> ]
[ DEBUG_MODE = TRUE | FALSE ]
[ COMMENT = '<string_literal>' ]
[ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , ... ] ) ]
CREATE APPLICATION <name> FROM LISTING <listing_name>
[ COMMENT = '<string_literal>' ]
[ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , ... ] ) ]
필수 매개 변수¶
name
애플리케이션의 식별자를 지정합니다. 계정에 고유한 식별자여야 합니다.
또한, 식별자는 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예:
"My object"
)로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.
FROM APPLICATION PACKAGE package_name
애플리케이션을 만드는 데 사용되는 애플리케이션 패키지의 이름을 지정합니다. 이 절을 사용하여 스테이지 또는 버전/패치를 지정하지 않고 애플리케이션 패키지에서 애플리케이션을 생성하려면 애플리케이션 패키지에 기본 릴리스 지시문이 정의되어 있어야 합니다.
이 절은 애플리케이션 패키지와 동일한 계정에서 애플리케이션을 만드는 데만 사용할 수 있습니다. 이 절은 개발 모드에서 애플리케이션을 만드는 데 사용할 수 없습니다.
FROM LISTING listing_name
애플리케이션을 만드는 데 사용되는 애플리케이션 패키지를 포함한 목록의 이름을 지정합니다.
USING path_to_version_directory
애플리케이션의 애플리케이션 파일이 포함된 스테이지의 경로를 지정합니다.
USING version [ PATCH patch_num ]
애플리케이션을 만드는 데 사용되는 애플리케이션 패키지에 정의된 버전을 지정하며 선택적으로 패치도 지정합니다.
선택적 매개 변수¶
COMMENT = 'string_literal'
애플리케이션에 대한 설명을 지정합니다.
기본값: 값 없음
DEBUG_MODE = { TRUE | FALSE }
설치할 애플리케이션의 디버그 모드를 활성화하거나 비활성화합니다.
TRUE
를 설정하면 설치된 애플리케이션의 디버그 모드가 활성화됩니다.FAlSE
를 설정하면 설치된 애플리케이션의 디버그 모드가 비활성화됩니다.
참고
애플리케이션이 다음 요구 사항을 충족하는 경우
DEBUG_MODE
만 설정할 수 있습니다.애플리케이션은 애플리케이션 패키지와 동일한 계정에 있습니다.
애플리케이션이 특정 버전 또는 명명된 스테이지의 파일에서 생성되고 있습니다.
TAG ( tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ] )
태그 이름과 태그 문자열 값을 지정합니다.
태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.
문에서 태그를 지정하는 방법에 대한 자세한 내용은 오브젝트 및 열에 대한 태그 할당량 섹션을 참조하십시오.
액세스 제어 요구 사항¶
이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.
권한 |
오브젝트 |
참고 |
---|---|---|
CREATE APPLICATION |
계정 |
|
DEVELOP |
애플리케이션 패키지 |
|
INSTALL |
애플리케이션 패키지 |
|
IMPORT SHARE CREATE APPLICATION |
계정 |
애플리케이션 패키지가 포함된 계정과는 다른 계정에서 애플리케이션 오브젝트를 생성하려면 이러한 권한이 필요합니다. |
사용법 노트¶
애플리케이션 패키지에서 직접 애플리케이션을 만들려면 애플리케이션 패키지에서 기본 릴리스 지시문을 지정해야 합니다.
애플리케이션 오브젝트는 다음과 같은 점에서 데이터베이스와 다릅니다.
애플리케이션은 일시적이지 않을 수 있습니다.
애플리케이션에 대한 OWNERSHIP 권한이 있는 역할:
데이터베이스를 삭제하거나 COMMENT 속성뿐 아니라 애플리케이션에 특정한 모든 속성도 수정할 수 있습니다.
애플리케이션 역할에 부여된 권한을 통하는 경우를 제외하면 애플리케이션의 내용을 보거나 수정할 수 없습니다. 또한 이 역할은 스키마 또는 데이터베이스 역할과 같은 데이터베이스 수준 오브젝트를 만들 수 없습니다.
예¶
CREATE APPLICATION hello_snowflake_app
FROM APPLICATION PACKAGE hello_snowflake_package
USING VERSION v1;
+---------------------------------------------------------+
| status |
|---------------------------------------------------------|
| Application 'hello_snowflake_app' created successfully. |
+---------------------------------------------------------+
CREATE APPLICATION hello_snowflake_app
FROM APPLICATION PACKAGE hello_snowflake_package
USING '@hello_snowflake_code.core.hello_snowflake_stage';
+---------------------------------------------------------+
| status |
|---------------------------------------------------------|
| Application 'hello_snowflake_app' created successfully. |
+---------------------------------------------------------+