Skip to main content

Installation

Metatate can be installed from the Snowflake Marketplace or deployed manually as a Snowflake Native App.

From Snowflake Marketplace

  1. Navigate to the Snowflake Marketplace in Snowsight
  2. Search for Metatate
  3. Click Get to install the application
  4. Grant the required privileges when prompted:
    • BIND SERVICE ENDPOINT — for public ingress URLs
    • CREATE COMPUTE POOL — for container services
    • IMPORTED PRIVILEGES ON SNOWFLAKE DB — for Snowflake Cortex AI

Initial Setup

After installation, open the app from the Apps section in Snowsight. The Metatate Launcher (Streamlit) will guide you through initial setup:

1. Grant Privileges

The app requests three privileges that are auto-granted:

PrivilegePurpose
BIND SERVICE ENDPOINTCreate public ingress URLs for the web UI
CREATE COMPUTE POOLCreate compute pools for container services
IMPORTED PRIVILEGES ON SNOWFLAKE DBEnable Cortex AI features

2. Configure References

The app uses Snowflake's reference system for controlled access:

ReferenceTypePurposeRequired
DATABASE_CATALOGTABLE (multi-valued)Tables you want to governRecommended
APP_WAREHOUSEWAREHOUSEQuery execution and MCP serverRecommended
tip

You can add table references at any time. Start with a few tables and expand as needed.

3. Start Services

The launcher creates two compute pools and starts the container services:

  • Frontend compute poolCPU_X64_XS, runs the React UI + nginx router
  • Backend compute poolCPU_X64_XS, runs the Flask API server

Services typically start within 2-3 minutes.

4. Configure Tenant

Enter your organization name and optional details. This is stored in app_data.tenant_config within your account.

Accessing the App

Once setup is complete, access Metatate through:

  • Snowsight — Apps → Metatate → Click the app URL
  • Direct URL — The ingress URL shown in the launcher (https://<id>-<account>.snowflakecomputing.app)

Granting Access to Users

Grant application roles to users who need access:

-- Full admin access (setup, configuration, all features)
GRANT APPLICATION ROLE app_admin TO ROLE <your_role>;

-- Standard user access (policies, catalog, governance)
GRANT APPLICATION ROLE app_user TO ROLE <your_role>;

Next Steps

  • Quick Start — Create your first policy in 5 minutes