Declarative Native App 명령 참조¶
다음 명령에는 애플리케이션 패키지 생성 및 게시를 지원하는 새 매개 변수가 포함됩니다.
CREATE APPLICATION PACKAGE¶
:doc:` CREATE APPLICATION PACKAGE</sql-reference/sql/create-application-package>` 명령은 앱이 |declarative-app-short|임을 지정하는 새로운 선택적 매개 변수인 ``TYPE = DATA``를 지원합니다.
구문¶
CREATE APPLICATION PACKAGE [ IF NOT EXISTS ] <name> TYPE = DATA
새로운 선택적 매개 변수:
TYPE = [ DATA | NATIVE ]생성할 애플리케이션 패키지의 유형을 지정합니다.
DATA: 애플리케이션 패키지에 |declarative-app-short|이 포함됨을 나타냅니다.NATIVE: 애플리케이션 패키지에 |native-app|이 포함됨을 나타냅니다. 이것이 기본값입니다.
애플리케이션 패키지 유형을 지정한 후에는 ALTER APPLICATION PACKAGE를 사용하여 나중에 유형을 변경할 수 없습니다.
``TYPE = DATA``가 지정된 경우, 이 명령의 다른 매개 변수(예: DATA_RETENTION_TIME_IN_DAYS 및 COMMENT)는 지원되지 않습니다.
이 매개 변수에는 CREATE APPLICATION PACKAGE 및 CREATE DATABASE :ref:`권한<label-access_control_overview_privileges>`이 있는 :ref:`역할<label-access_control_overview_roles>`이 필요합니다.
애플리케이션 패키지 작성자에게 해당 애플리케이션 패키지에 대한 OWNERSHIP 권한이 자동으로 부여됩니다.
ALTER APPLICATION PACKAGE¶
ALTER APPLICATION PACKAGE 명령은 Declarative Native Apps 생성 및 게시를 지원하기 위해 다음과 같은 새로운 선택적 매개 변수를 지원합니다. 이러한 새 매개 변수는 |native-apps|에 대해 지원되지 않습니다.
구문¶
ALTER APPLICATION PACKAGE <name>
[ ADD LIVE VERSION
| ADD VERSION FROM @STAGE/path
| BUILD
| COMMIT
| RELEASE [LIVE VERSION]
| ABORT LIVE VERSION ]
[COMMENT = 'string_literal']
새 선택적 매개 변수¶
ADD LIVE VERSION편집할 수 있는 애플리케이션 패키지의 라이브 버전을 만듭니다. 이 라이브 버전은 매니페스트 파일 및 노트북 파일과 같은 파일을 추가하거나 업데이트하는 데 사용됩니다.
ADD VERSION FROM @<STAGE>/<path>:doc:`스테이징</user-guide/data-load-local-file-system-stage>`의 파일을 기반으로 애플리케이션 패키지의 라이브 버전을 만듭니다. 이 메서드는 애플리케이션 패키지에 포함하려는 파일 세트가 있고 한 번에 모두 추가하려는 경우에 유용합니다.
참고
라이브 버전을 생성한 후 파일을 반복하는 경우 향후 버전의 일관성을 유지하려면 스테이징의 파일을 동일하게 변경해야 합니다.
BUILD앱을 빌드하지만 커밋하지는 않습니다. 이 명령을 사용하여 매니페스트 파일의 유효성을 검사하고 애플리케이션 패키지 작업을 계속합니다.
COMMIT앱을 빌드하고 게시를 위해 커밋하지만 릴리스하지는 않습니다.
커밋 프로세스에서는 내부 버전 번호를 추가하여 게시할 애플리케이션 패키지를 준비하고 애플리케이션 패키지를 변경할 수 없도록 만듭니다.
RELEASE커밋된 버전의 앱을 |sf-marketplace|에 릴리스합니다.
RELEASE LIVE VERSION앱을 빌드하고 게시를 위해 커밋한 후 |sf-marketplace|에 릴리스합니다.
BUILD, COMMIT, RELEASE 명령을 순서대로 실행하는 것과 같습니다.
ABORT LIVE VERSION애플리케이션 패키지의 LIVE 버전을 제거합니다. 애플리케이션 패키지를 마지막으로 커밋된 버전으로 복원합니다.
기존 매개 변수¶
이러한 매개 변수는 Declarative Native Apps 및 Snowflake Native Apps 모두에 대해 지원됩니다.
<name>애플리케이션 패키지의 식별자를 지정합니다.
식별자에 공백, 특수 문자 또는 대/소문자가 혼합된 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.
COMMENT = 'string_literal'
선택 사항: 앱 버전에 대한 설명을 추가하거나 기존 설명을 덮어씁니다. 이 설명은 SHOW APPLICATION PACKAGES에 표시됩니다.
액세스 제어 요구 사항¶
이 명령에는 애플리케이션 패키지에 대한 OWNERSHIP 권한이 있는 역할이 필요합니다.
예¶
새 애플리케이션 패키지를 만듭니다.
CREATE APPLICATION PACKAGE market_data_app TYPE = DATA;
편집할 수 있는 애플리케이션 패키지의 라이브 버전을 만듭니다.
ALTER APPLICATION PACKAGE market_data_app ADD LIVE VERSION COMMENT = 'Market views for Northern region';
스테이징된 기존 애플리케이션 패키지에서 애플리케이션 패키지의 새 버전을 만듭니다.
ALTER APPLICATION PACKAGE market_data_app ADD VERSION FROM @my_stage/market_data_app_v1;
애플리케이션 패키지를 빌드하지만 커밋하지는 않습니다.
ALTER APPLICATION PACKAGE market_data_app BUILD;
게시할 애플리케이션 패키지를 빌드하고 커밋하지만 릴리스하지는 않습니다.
ALTER APPLICATION PACKAGE market_data_app COMMIT COMMENT = 'Market views for North and East regions';
애플리케이션 패키지를 |sf-marketplace|에 릴리스합니다.
ALTER APPLICATION PACKAGE market_data_app RELEASE;
애플리케이션 패키지의 라이브 버전을 |sf-marketplace|에 빌드, 커밋, 릴리스합니다.
ALTER APPLICATION PACKAGE market_data_app RELEASE LIVE VERSION COMMENT = 'Market views for North, East, and West regions';
앱의 라이브 버전을 추가하고 편집한 후 편집을 중지하고 마지막으로 커밋된 버전으로 복원합니다.
ALTER APPLICATION PACKAGE market_data_app ABORT LIVE VERSION
GRANT IMPORTED PRIVILEGES ON APPLICATION¶
GRANT IMPORTEDPRIVILEGES 명령은 새로운 선택적 매개 변수인 ``ON APPLICATION <name>``을 지원합니다.
이 명령을 사용하면 컨슈머가 |declarative-app-short|의 모든 데이터와 뷰에 대한 액세스 권한을 조직의 다른 구성원에게 부여할 수 있습니다.
이 명령은 모든 |declarative-app-short|에서 사용할 수 있으며, 애플리케이션 패키지에 대해 앱 역할을 정의할 필요가 없습니다.
액세스 제어 요구 사항¶
이 명령에는 설치된 앱에 대한 OWNER 권한이 있는 역할이 필요합니다.
구문¶
GRANT IMPORTED PRIVILEGES ON APPLICATION <name> TO ROLE <role_name>;
예¶
GRANT IMPORTED PRIVILEGES ON APPLICATION market_data_app TO ROLE marketing_team_east;