Install an app from a listing

This topic describes how to use Snowsight to install apps created using the Snowflake Native App Framework.

Workflow for installing an app from a listing

To find and install a listing for an app:

  1. Set up the privileges required to install a listing.

  2. Install the listing.

  3. View the installed listing.

  4. See Allow access to a consumer account for information on tasks related to managing an app. See Set up event tracing for an app for information on setting up event sharing.

Set up required privileges

To access a listing, you must use the ACCOUNTADMIN role or another role with the IMPORT SHARE and CREATE DATABASE privileges.

After an app is installed, the app owner can grant access to the app using application roles. See Grant application roles to account roles for details.

Note

To pay for an app, your role must also have the PURCHASE DATA EXCHANGE LISTING privilege and you must meet additional criteria. Refer to Pay for listings.

Install an app from a privately shared listing

Note

As a provider, you can test your app by creating a private listing, sharing it with another account in your organization that you have access to, signing in to that account, and following these steps to install the app.

To install an app from a private listing:

  1. Sign in to Snowsight.

  2. In the navigation menu, select Data Products » Apps.

  3. In Recently shared with you, select the tile for the listing.

  4. View the privileges and logging requests for the app, including:

  5. Select Get, or for a monetized app, select Buy.

    Note

    If the provider includes required event definitions in the app, the consumer must set up an event table before installing the app. Even sharing and the required event definitions are enabled during installation and cannot be disabled later.

  6. Enter a name for the app.

  7. Select the warehouse that you want to use to install the app.

  8. Select Get.

  9. Select Open to view the app or Done to finish.

Install an app from a Snowflake Marketplace listing

To install an app from a Snowflake Marketplace listing:

  1. Sign in to Snowsight.

  2. In the navigation menu, select Data Products » Marketplace.

  3. Search or browse to the listing you want to access.

  4. Select the listing, then view the privileges and logging requests for the app, including:

  5. Select Get to access the listing.

    Note

    If the provider includes required event definitions in the app, the consumer must set up an event table before installing the app. Even sharing and the required event definitions are enabled during installation and cannot be disabled later.

  6. Select the warehouse that you want to use to install the app.

  7. (Optional) Enter a name for Application name.

  8. Select Get.

  9. Select Open to view the app or Done to finish.

Installing multiple instances of an app

Providers can configure an app so that multiple instances of an app can be installed at the same time.

Note

Apps installed from a trial listing or a monetized listings cannot have multiple instances.

If an app is configured to allow multiple installs, consumers can install additional instances after installing the app from a private listing or from the Snowflake Marketplace.

If multiple instances are enabled for an app, you can install a maximum of 10 instances in your account.

To install a new instance of an app, perform the following tasks:

  1. Sign in to Snowsight.

  2. In the navigation menu, select Data Products » Apps.

  3. Select the app of which you want to install another instance.

    If multiple instances of the app are already installed, Snowsight displays a panel showing all of the instances of the app.

  4. Select Add instance

    Caution

    Add instance only appears if the provider has configured the app to allow multiple instances.

  5. Enter a name for the instance, then select the warehouse to use for this instance.

  6. Select Get.

    The app installs and Snowflake sends a notification email to the app admin.

  7. Select Done to complete the installation.

After installing the app instance, you can set up event tracing for an app, configure privileges for the app, and perform other management tasks.