EventsEvent Warehouse

Event Warehouse

Write collected events to your data warehouse for long-term storage and analysis.

Overview

The event warehouse writer automatically writes incoming events to a dedicated table in your data warehouse. This gives you a queryable event history alongside your other customer data.

Configuration

  1. Navigate to Events > Warehouse
  2. Select a source (warehouse connection)
  3. Configure the target schema and table name
  4. Click Save

Table Schema

Events are written with the following columns:

ColumnTypeDescription
event_idstringUnique event identifier
typestringEvent type (track, identify, page, group)
eventstringEvent name (for track events)
user_idstringUser identifier
anonymous_idstringAnonymous identifier
propertiesJSONEvent properties
traitsJSONUser traits (for identify events)
contextJSONEvent context (IP, user agent, etc.)
timestamptimestampEvent timestamp
received_attimestampWhen SignalSmith received the event
write_key_idstringWhich write key sent the event

Schema Evolution

When new event types or properties appear:

  • New columns are not automatically added (schema is fixed)
  • New properties are stored in the properties JSON column
  • Query JSON columns using your warehouse’s JSON functions

Partitioning

Events are partitioned by date for efficient querying:

  • BigQuery — Partitioned by received_at date
  • Snowflake — Clustered by received_at
  • Databricks — Partitioned by received_at date

API Reference

See Events API for warehouse configuration endpoints.