{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Composable Audience Studio for Snowflake","description":"Set up Composable Audience Studio on Snowflake using Zero-Copy federated queries to build audience segments without copying data.","siteUrl":"https://docs.treasure.ai","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]},"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"overview","__idx":0},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Composable Audience Studio (CAS) is a deployment mode of Treasure Data's CDP that enables you to build and manage audience segments directly on your Snowflake data warehouse without copying data into Treasure Data. Using Zero-Copy / Federated Query architecture, CAS queries your Snowflake tables in place, keeping data under your existing governance and access controls."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide walks through the end-to-end process of setting up a Composable Parent Segment on Snowflake, from connection configuration to segment creation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-will-set-up","__idx":1},"children":["What You Will Set Up"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Key pair authentication for secure Snowflake access"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Zero-Copy configuration to connect Treasure Data to your Snowflake instance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Parent Segment configuration file defining your customer and behavior tables"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API upload of the configuration to create the Parent Segment in CAS"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin, ensure you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Treasure account with admin-level permissions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Snowflake account with:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A database and schema containing your customer and event data"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A warehouse available for query execution"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A user and role with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SELECT"]}," permissions on the target tables"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["OpenSSL installed on your local machine (for key pair generation)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Treasure API key (Master API key recommended)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"architecture","__idx":3},"children":["Architecture"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Data never leaves your Snowflake environment. Treasure Data sends federated queries and receives results at query time."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"graph LR\n subgraph TD[\"Treasure Data\"]\n CAS[\"Composable Audience Studio - Segment Builder - Activation - Insights\"]\n end\n\n subgraph SF[\"Your Snowflake Instance\"]\n CT[\"Your Table (profiles + attributes)\"]\n BT1[\"Behaviors Table 1\"]\n BT2[\"Behaviors Table 2\"]\n BTN[\"Behaviors Table N ...\"]\n end\n\n CAS <-->|\"Zero Copy / Query\"| CT\n CAS <-->|\"Zero Copy / Query\"| BT1\n CAS <-->|\"Zero Copy / Query\"| BT2\n CAS <-->|\"Zero Copy / Query\"| BTN\n","diagramHtml":"","diagramHtmlDark":""},"children":["graph LR\n subgraph TD[\"Treasure Data\"]\n CAS[\"Composable Audience Studio - Segment Builder - Activation - Insights\"]\n end\n\n subgraph SF[\"Your Snowflake Instance\"]\n CT[\"Your Table (profiles + attributes)\"]\n BT1[\"Behaviors Table 1\"]\n BT2[\"Behaviors Table 2\"]\n BTN[\"Behaviors Table N ...\"]\n end\n\n CAS <-->|\"Zero Copy / Query\"| CT\n CAS <-->|\"Zero Copy / Query\"| BT1\n CAS <-->|\"Zero Copy / Query\"| BT2\n CAS <-->|\"Zero Copy / Query\"| BTN\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"parent-segment-data-model","__idx":4},"children":["Parent Segment Data Model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Composable Parent Segment is composed of a single Customers table and multiple Behaviors tables."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"customers-table","__idx":5},"children":["Customers Table"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Customers table stores unified profile data and attributes, with each record representing a single profile. A unique identifier column is required for each profile."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contains all customer attributes (e.g., email, name, city, membership tier, LTV)",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Each row = one unique customer profile"," ","Unique identifier column serves as the primary key"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"behaviors-tables","__idx":6},"children":["Behaviors Tables"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Behaviors tables contain activity records for specific actions taken by profiles (e.g., website visits, orders).",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Each Behaviors table must include a unique ID column that links the activity record to the corresponding customer profile via the Unique identifier."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each table represents a distinct type of activity (page views, purchases, etc.)",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Multiple behavior records can exist per customer"," ","Must include a time column for temporal queries"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"composable-parent-segment-data-model","__idx":7},"children":["Composable Parent Segment Data Model"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"erDiagram\n Customers ||--o{ \"Behaviors Table 1\" : \"1 to many\"\n Customers ||--o{ \"Behaviors Table 2\" : \"1 to many\"\n Customers ||--o{ \"Behaviors Table 3\" : \"1 to many\"\n\n Customers {\n string unique_id PK\n string email\n string name\n string city\n string membership_tier\n float ltv\n }\n\n \"Behaviors Table 1\" {\n string unique_id FK\n timestamp time\n string action\n }\n\n \"Behaviors Table 2\" {\n string unique_id FK\n timestamp time\n string action\n }\n\n \"Behaviors Table 3\" {\n string unique_id FK\n timestamp time\n string action\n }\n","diagramHtml":"","diagramHtmlDark":""},"children":["erDiagram\n Customers ||--o{ \"Behaviors Table 1\" : \"1 to many\"\n Customers ||--o{ \"Behaviors Table 2\" : \"1 to many\"\n Customers ||--o{ \"Behaviors Table 3\" : \"1 to many\"\n\n Customers {\n string unique_id PK\n string email\n string name\n string city\n string membership_tier\n float ltv\n }\n\n \"Behaviors Table 1\" {\n string unique_id FK\n timestamp time\n string action\n }\n\n \"Behaviors Table 2\" {\n string unique_id FK\n timestamp time\n string action\n }\n\n \"Behaviors Table 3\" {\n string unique_id FK\n timestamp time\n string action\n }\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"data-model-expectation","__idx":8},"children":["Data Model Expectation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Parent Segment uses a data model comprising one"," ","Customers table and multiple Behaviors tables."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Customers table is dedicated to storing unified profile data and attributes, with a unique record and required unique identifier column for each profile."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Behaviors tables record activity data for specific profile actions, such as website visits or orders. Each Behaviors table must contain a unique ID column that links the activity record to the corresponding profile in the Customers table, utilizing the same identifier column."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"data-model-example","__idx":9},"children":["Data Model Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customers Table"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each record represents a profile. Columns are attributes per profile."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"..."},"children":["..."]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"LTV"},"children":["LTV"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"age range"},"children":["age range"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"user_id (unique id)"},"children":["user_id (unique id)"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["..."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["20-30"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["xxx-1"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["..."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["550"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["30-40"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["xxx-2"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["..."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2300"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["40-50"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["xxx-3"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Behaviors Tables"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email activity"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"user_id (unique id)"},"children":["user_id (unique id)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"activity"},"children":["activity"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"date time"},"children":["date time"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"..."},"children":["..."]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["xxx-1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["email open"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2026-03-30 10:30:00"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["..."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yyy-3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["bounce"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2026-03-30 10:31:00"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["..."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["xxx-3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["email click"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2026-03-30 10:32:00"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["..."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Web pageviews"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"user_id (unique id)"},"children":["user_id (unique id)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"datetime"},"children":["datetime"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"urls"},"children":["urls"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"..."},"children":["..."]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["xxx-2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2026-03-30 11:00:00"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["https://www.td-store.com"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["..."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yyy-3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2026-03-30 11:01:00"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["https://www.td-store.com"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["..."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["xxx-3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2026-03-30 11:02:00"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["https://www.td-store.com"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["..."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Customers table's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_id"]}," column links to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_id"]}," column in each Behaviors table, establishing the 1-to-many relationship."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The relationship between Customers and each Behaviors table is 1-to-many: one customer profile can have many behavior records."]}]},"headings":[{"value":"Overview","id":"overview","depth":1},{"value":"What You Will Set Up","id":"what-you-will-set-up","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Architecture","id":"architecture","depth":2},{"value":"Parent Segment Data Model","id":"parent-segment-data-model","depth":2},{"value":"Customers Table","id":"customers-table","depth":3},{"value":"Behaviors Tables","id":"behaviors-tables","depth":3},{"value":"Composable Parent Segment Data Model","id":"composable-parent-segment-data-model","depth":3},{"value":"Data Model Expectation","id":"data-model-expectation","depth":4},{"value":"Data Model Example","id":"data-model-example","depth":4}],"frontmatter":{"seo":{"title":"Composable Audience Studio for Snowflake","description":"Set up Composable Audience Studio on Snowflake using Zero-Copy federated queries to build audience segments without copying data."}},"lastModified":"2026-08-14T22:18:35.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/composable-cdp/audience-studio/snowflake","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}