Skip to main content
The Snowflake Native App installs a customer-hosted data plane directly in your Snowflake environment. Once installed, it operates as a data plane operator—polling Narrative’s control plane for jobs and executing queries against your Snowflake data without it ever leaving your account.

​
Prerequisites

  • Snowflake ACCOUNTADMIN role or equivalent privileges
  • A Narrative account (create one here)
  • A Narrative API token with the following permissions (manage API keys):
    PermissionAccess level
    Data PlanesRead and Write
    Data Plane LogsRead and Write
    DatasetsRead and Write
    JobsRead and Write
  • A Snowflake virtual warehouse
  • Access to the Narrative listing on the Snowflake Marketplace
  • At least one Snowflake table or view to register as a dataset

​
Installation steps

1

Grant privileges

Click Grant Privileges to grant the app the following privileges:
  • EXECUTE TASK
  • CREATE COMPUTE POOL
  • BIND SERVICE ENDPOINT
These allow the app to schedule jobs, provision compute resources, and communicate with Narrative’s control plane.
2

Set up compute warehouse

Select a Snowflake warehouse for the app to use when executing queries.
Start with a smaller warehouse and scale up based on your data volume and query complexity. You can change the warehouse later.
3

Configure external access integration

  1. Click Setup External Access Integration.
  2. Click Next.
  3. Paste your Narrative API token under Secret value.
This allows the app to authenticate with Narrative’s control plane.
4

Select a source table or view

Select the Snowflake table or view you want to register as a dataset in Narrative.
Narrative is granted read-only access to the selected object. You can change or add additional tables later.
5

Name your dataset

Set the DATASET UNIQUE NAME for your registered dataset.
Dataset names must use uppercase alphanumeric characters and underscores only (e.g., MY_DATASET_NAME).
6

Upload sample data (optional)

Upload a sample of your data for display in the Narrative UI. This helps collaborators understand the structure and content of your dataset. You can skip this step and upload sample data later from within the platform.
7

Upload statistics (optional)

Upload dataset statistics for display in the Narrative UI. Statistics help collaborators evaluate your dataset. You can skip this step and upload statistics later from within the platform.

​
What happens next

The app now operates as a data plane operator—it continuously polls Narrative’s control plane for pending jobs and executes NQL queries directly in your Snowflake environment. Your data stays within your Snowflake security perimeter throughout this process.

​
Related content

Snowflake Native App Reference

Capabilities, requirements, and configuration details

Data Planes

Understand how data planes and operators work

API Keys

Manage API tokens and permissions

Execution Context

Learn how queries are executed across data planes