CREATE APPLICATION¶

구문¶

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 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

사용법 노트¶

• 애플리케이션 패키지에서 직접 애플리케이션을 만들려면 애플리케이션 패키지에서 기본 릴리스 지시문을 지정해야 합니다.

• 애플리케이션 오브젝트는 다음과 같은 점에서 데이터베이스와 다릅니다.

  • 애플리케이션은 일시적이지 않을 수 있습니다.

  • 애플리케이션에 대한 OWNERSHIP 권한이 있는 역할:

    • 데이터베이스를 삭제하거나 COMMENT 속성뿐 아니라 애플리케이션에 특정한 모든 속성도 수정할 수 있습니다.

    • 애플리케이션 역할에 부여된 권한을 통하는 경우를 제외하면 애플리케이션의 내용을 보거나 수정할 수 없습니다. 또한 이 역할은 스키마 또는 데이터베이스 역할과 같은 데이터베이스 수준 오브젝트를 만들 수 없습니다.

• Regarding metadata:

  주의

  Customers should ensure that no personal data (other than for a User object), sensitive data, export-controlled data, or other regulated data is entered as metadata when using the Snowflake service. For more information, see Snowflake의 메타데이터 필드.

• CREATE OR REPLACE <object> statements are atomic. That is, when an object is replaced, the old object is deleted and the new object is created in a single transaction.

예¶

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. |
+---------------------------------------------------------+