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:
Install the listing.
If you are installing a privately shared listing, refer to Install an app from a privately shared listing
If you are installing a listing shared on the Snowflake Marketplace, refer to Working with Snowflake Marketplace listings for an app.
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 Snowflake Marketplace listing¶
To install an app from a Snowflake Marketplace listing:
Sign in to Snowsight.
In the navigation menu, select Data Products » Marketplace.
Search or browse to the listing you want to access.
Select the listing, then view the privileges and logging requests for the app, including:
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.
Select the warehouse that you want to use to install the app.
(Optional) Enter a name for Application name.
Select Get.
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:
Sign in to Snowsight.
In the navigation menu, select Data Products » Apps.
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.
Select Add instance
Caution
Add instance only appears if the provider has configured the app to allow multiple instances.
Enter a name for the instance, then select the warehouse to use for this instance.
Select Get.
The app installs and Snowflake sends a notification email to the app admin.
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.