Create and manage an application package¶

About the application package¶

An application package is a container that encapsulates the data content and application logic used by a Snowflake Native App. An application package also contains information about versions and patches defined for an app.

Each version of an app requires its own version of the manifest and setup script:

manifest file:

The manifest file contains information that the application package requires to create and manage a Snowflake Native App. This includes the location of the setup script, version definitions, and configuration information for the app.

For more information, see 为应用程序创建清单文件.

setup script:

The setup script contains SQL statements that are run when the app is installed, either in the consumer account or locally during development and testing.

For more information, see Create the setup script.

About release channels¶

Release channels manage the release lifecycle of Snowflake Native Apps. They allow providers to create and manage versions of an app and to publish the app at different stages of development to all consumers or specific groups of consumers.

For more information on using release channels to manage the release lifecycle of an app, see 使用版本渠道发布应用程序.

To use the previous process for managing versions and patches you must explicitly disable release channels when creating the application package. However, for new app development Snowflake recommends using release channels to manage the release lifecycle of your apps.

For information on using the older features for managing versions and patches, see Develop a new version of an app (Legacy).

创建应用程序包时所需的权限¶

要创建应用程序包，您的角色必须获授全局 CREATE APPLICATION PACKAGE 权限。

创建应用程序包¶

You can create an application package using one of the following methods:

• Snowsight

• The CREATE APPLICATION PACKAGE command.

• The Snowflake CLI

CREATE APPLICATION PACKAGE my_application_package;

Grant the required privileges on an application package¶

Some tasks related to creating or using an application package require specific privileges on the application package. The following table describes the privileges required to perform these tasks:

GRANT MANAGE RELEASES ON APPLICATION PACKAGE hello_snowflake_package TO ROLE app_release_mgr;

设置应用程序包的默认发布指令¶

A release directive determines the version and patch of an app that is available to a consumer when they install the app or when an installed app is automatically upgraded. For information on setting the release directive, see Set the release directive for an app (Legacy)

允许使用者安装一个应用程序的多个实例¶

提供商可以配置应用程序包，允许使用者安装一个应用程序的多个实例。

要启用应用程序的多个实例，请使用 CREATE APPLICATION PACKAGE 的 MULTIPLE_INSTANCES = TRUE 子句或 ALTER APPLICATION PACKAGE 命令。

如果允许安装一个应用程序的多个实例，使用者最多可在其账户中安装 10 个实例。

无法为试用版或付费列表中所含的应用程序包设置此属性。

转移应用程序包的所有权¶

创建应用程序包后，可以将该应用程序包的所有权转移给另一个账户级角色。

GRANT OWNERSHIP ON APPLICATION PACKAGE hello_snowflake_package TO ROLE native_app_dev;

删除应用程序包¶

Providers with the OWNERSHIP privilege on an application package can remove it from an account. However, providers cannot remove an application package that is currently associated with a listing.

After removing an application package, it is no longer available in the provider account.

DROP APPLICATION PACKAGE hello_snowflake_package;