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
Copy

새로운 선택적 매개 변수:

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']
Copy

새 선택적 매개 변수

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;
    
    Copy
  • 편집할 수 있는 애플리케이션 패키지의 라이브 버전을 만듭니다.

    ALTER APPLICATION PACKAGE market_data_app
      ADD LIVE VERSION
      COMMENT = 'Market views for Northern region';
    
    Copy
  • 스테이징된 기존 애플리케이션 패키지에서 애플리케이션 패키지의 새 버전을 만듭니다.

    ALTER APPLICATION PACKAGE market_data_app
      ADD VERSION FROM @my_stage/market_data_app_v1;
    
    Copy
  • 애플리케이션 패키지를 빌드하지만 커밋하지는 않습니다.

    ALTER APPLICATION PACKAGE market_data_app BUILD;
    
    Copy
  • 게시할 애플리케이션 패키지를 빌드하고 커밋하지만 릴리스하지는 않습니다.

    ALTER APPLICATION PACKAGE market_data_app
      COMMIT
      COMMENT = 'Market views for North and East regions';
    
    Copy
  • 애플리케이션 패키지를 |sf-marketplace|에 릴리스합니다.

    ALTER APPLICATION PACKAGE market_data_app RELEASE;
    
    Copy
  • 애플리케이션 패키지의 라이브 버전을 |sf-marketplace|에 빌드, 커밋, 릴리스합니다.

    ALTER APPLICATION PACKAGE market_data_app RELEASE LIVE VERSION
      COMMENT = 'Market views for North, East, and West regions';
    
    Copy
  • 앱의 라이브 버전을 추가하고 편집한 후 편집을 중지하고 마지막으로 커밋된 버전으로 복원합니다.

    ALTER APPLICATION PACKAGE market_data_app ABORT LIVE VERSION
    
    Copy

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>;
Copy

GRANT IMPORTED PRIVILEGES ON APPLICATION market_data_app TO ROLE marketing_team_east;
Copy