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
- Execute NQL queries directly in your Snowflake environment
- Participate in cross-data-plane data collaboration
- Keep data within your Snowflake security perimeter
Requirements
| Requirement | Details |
|---|---|
| Snowflake role | ACCOUNTADMIN or equivalent |
| Narrative account | Required (create account) |
| API token | With specific permissions (see below) |
| Snowflake warehouse | For query execution |
| Marketplace access | Access to the Narrative listing on the Snowflake Marketplace |
Privileges
The app requires the following Snowflake privileges:| Privilege | Purpose |
|---|---|
EXECUTE TASK | Schedule and run jobs on behalf of Narrative’s control plane |
CREATE COMPUTE POOL | Provision compute resources for query execution |
BIND SERVICE ENDPOINT | Communicate with Narrative’s control plane API |
API token permissions
Your Narrative API token must include the following permissions:| Permission | Access level |
|---|---|
| Data Planes | Read and Write |
| Data Plane Logs | Read and Write |
| Datasets | Read and Write |
| Jobs | Read and Write |
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