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 Criação do arquivo de manifesto para um aplicativo.

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 Publicar um aplicativo usando canais de lançamento.

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

Privilégios necessários para criar um pacote de aplicativo¶

Para criar um pacote de aplicativo, você deve ter o privilégio global CREATE APPLICATION PACKAGE concedido à sua função.

Criação de um pacote de aplicativo¶

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;

Definição da diretriz de versão padrão para um pacote de aplicativo¶

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)

Como permitir que os consumidores instalem várias instâncias de um aplicativo¶

Os provedores podem configurar um pacote de aplicativos para permitir que os consumidores instalem várias instâncias de um aplicativo.

Para habilitar várias instâncias de um aplicativo, use a cláusula MULTIPLE_INSTANCES = TRUE dos comandos CREATE APPLICATION PACKAGE ou ALTER APPLICATION PACKAGE.

Se várias instâncias forem permitidas para um aplicativo, os consumidores poderão instalar um máximo de 10 instâncias do aplicativo em sua conta.

Você não pode definir essa propriedade para um pacote de aplicativos incluído em uma listagem de avaliação ou paga.

Transferência da propriedade de um pacote de aplicativo¶

Depois de criar um pacote de aplicativo, você pode transferir a propriedade do pacote de aplicativo para outra função no nível da conta.

GRANT OWNERSHIP ON APPLICATION PACKAGE hello_snowflake_package TO ROLE native_app_dev;

Como excluir um pacote de aplicativos¶

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;