Overview
The Snowflake Native App installs as a customer-hosted data plane within your Snowflake environment. It runs the operator component that bridges Narrative’s control plane with your Snowflake data—polling for jobs, executing NQL queries, and returning results, all without your data leaving your Snowflake account.Capabilities
- Register Snowflake tables and views as Narrative datasets
- Register one or more Snowflake warehouses as compute pools
- Execute NQL queries directly in your Snowflake environment
- Participate in cross-data-plane data collaboration
- Keep data within your Snowflake security perimeter
Requirements
Privileges
The app requires the following Snowflake privileges:Registering warehouses as compute pools
To register a Snowflake warehouse as a compute pool, grant the app usage on the warehouse:API token permissions
Your Narrative API token must include the following permissions:
See API Keys for instructions on creating and managing tokens.
Dataset naming conventions
When registering a Snowflake table or view as a Narrative dataset, the dataset name must follow these rules:- Uppercase letters only (A–Z)
- Numbers (0–9)
- Underscores (
_)
MY_DATASET_NAME, CUSTOMER_EVENTS_2024.
Installation
For step-by-step installation instructions, see Install the Snowflake Native App.Related content
Installation Guide
Step-by-step setup instructions
Data Planes
Understand how data planes and operators work
Execution Context
Learn how queries are executed across data planes
API Keys
Manage API tokens and permissions