The older customer-managed S3 + Snowpipe setup remains available as a separate
path. See Snowflake via Snowpipe if
you want to own the Snowflake loading pipeline.
Required Inputs
Send Kadoa these Snowflake account details:| Input | Description | Example |
|---|---|---|
| Organization name | Preferred when available | ACMEORG |
| Account name or account ID | The consumer account to receive the share | PROD_ANALYTICS or ALC62998 |
| Region | Your Snowflake account region | US East 1 |
| Cloud | Optional if the region makes it clear | AWS |
Setup Flow
- Kadoa creates a Snowflake connector for your team with your account identifier, region, selected workflows, and optional activity-log export.
- Kadoa verifies the target account with a zero-data share before exposing workflow or activity data.
- After each successful workflow run, Kadoa stages the run into its own Snowflake ingestion bucket, loads provider tables, validates row counts and grants, and then publishes secure views.
- You import the share or private listing in your Snowflake account and query the shared database.
Shared Views
Each connector gets a customer-facing schema with these views:| View | Purpose |
|---|---|
WORKFLOW_RUNS | One row per shared workflow run, including job ID, workflow ID, row count, schema version, and status metadata |
WORKFLOW_SCHEMA_VERSIONS | The schema catalog for every published workflow schema version |
WORKFLOW_SCHEMA_FIELDS | Ordered field metadata, Kadoa type, Snowflake type, and cast policy |
WF_<id>__V<n> | Versioned workflow output view for a specific schema version |
WF_<id>__LATEST | Convenience view pointing at the latest schema version |
ACTIVITY_LOG | Optional activity-log view matching the customer-visible activity log surface |
Schema Changes
Kadoa does not create a new view after every run. New rows append to provider tables, and the existing views continue to work when the workflow schema is unchanged. When the workflow schema descriptor changes, Kadoa creates a new versioned view, preserves older versioned views, and updates__LATEST only after load, grant,
and visibility checks pass. Use versioned views for stable downstream models
and __LATEST for quick exploration.
Freshness And Delivery State
Successful workflow runs are expected to appear in Snowflake within minutes after Kadoa stages the file. Activity-log export is also near real time, but it uses a separate cursor-based sync and should be treated as minutes, not instant. Historical activity-log backfill is not automatic. If delivery cannot complete, Kadoa records an actionable failure stage such asstage, schema, load, share, or verify and retries safe stages. Ops can
inspect delivery history without querying customer accounts.