{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Treasure Code","product_name":"Treasure Code","type":"markdown"},"seo":{"title":"tdx parent-segment - Audience Management | Treasure Data","description":"Manage CDP parent segments with YAML configuration. Pull, push, validate, and preview audience definitions.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"image":"/assets/og-image.ba836864a30434f560a4f7720f8a09019ad30ff828b20c5052ae933ba7121524.d7ef4821.png"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"parent-segment-commands","__idx":0},"children":["Parent Segment Commands"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Manage CDP parent segments (audiences) with YAML-based configuration files."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx parent-segment # Full command\ntdx ps # Shorthand alias\n","lang":"bash"},"children":[]},{"$$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":"Command"},"children":["Command"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#list"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List all parent segments"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#use"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["use"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set parent segment context for subsequent commands"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pull"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pull"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Download configuration from CDP API to YAML file"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#push"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["push"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Upload YAML configuration to CDP API (create/update)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#validate"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validate"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query database tables to check schema and join statistics"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#preview"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preview"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query database tables for sample data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#run"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["run"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Push changes (if any) and trigger workflow"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#fields"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fields"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List available fields for segmentation"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#view"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["view"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show parent segment details (or open in browser with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-w"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#desc"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["desc"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show parent segment schema (column types)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#sql"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sql"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get SQL query for parent segment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#show"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["show"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Execute SQL query and show results"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#rt-2-0-commands"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rt"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RT 2.0 configuration management (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validate"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#personalization-commands"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Personalization service management (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["init"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"typical-usage","__idx":1},"children":["Typical Usage"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# 1. Pull config (auto-sets context for subsequent commands)\ntdx ps pull \"Customer 360\"\n# Creates: parent_segments/customer-360.yml\n\n# 2. Edit YAML file locally (add attributes, behaviors, etc.)\n# Open parent_segments/customer-360.yml in your text editor\n\n# 3. Validate configuration (name omitted - uses context)\ntdx ps validate\n\n# 4. Preview sample data\ntdx ps preview --master\ntdx ps preview --attribute \"User Profile\"\ntdx ps preview --behavior \"Purchases\"\n\n# 5. Push changes and run workflow\ntdx ps run\n\n# Or just push to trigger scheduled run\ntdx ps push\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Behavior Statistics Time Range"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The default interval ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--interval -1d"]}," only counts behavior events from the last 24 hours. For behaviors with lower activity or weekly/monthly patterns, use a longer interval:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps validate --interval -7d # Last 7 days\ntdx ps validate --interval -30d # Last 30 days\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":2},"children":["How It Works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["parent segment"]}," defines the master customer table and its related data sources (attributes and behaviors) for CDP audience building. The YAML configuration specifies:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Master table"]},": The primary customer/user table with unique identifiers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Attributes"]},": Dimension tables joined to enrich customer profiles"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Behaviors"]},": Event/transaction tables for behavioral segmentation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx parent-segment"]}," commands help you manage these configurations as local YAML files. You can ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pull"]}," existing configurations from Treasure AI, edit them locally, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validate"]}," against source tables, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preview"]}," sample data, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["push"]}," changes back. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["run"]}," command triggers the workflow execution."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the workflow runs, it creates an output database (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdp_audience_xxx"]},") containing the enriched ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customers"]}," table and behavior tables that child segments query for audience creation. Once created, you can explore this data using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps desc"]}," (schema), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps sql"]}," (query), and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps show"]}," (sample data)."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TB\n subgraph LOCAL[\"Local\"]\n YAML[\"parent_segments/*.yml\"]\n end\n\n subgraph TD[\"Treasure AI\"]\n API[\"CDP API\"]\n DB[(\"Source Tables\")]\n WF[\"Treasure Workflow\"]\n subgraph CDP[\"cdp_audience_xxx database\"]\n TABLES[(\"customers
behavior tables\")]\n end\n CHILD[\"Child Segments\"]\n end\n\n YAML <-->|\"pull / push\"| API\n YAML -.->|\"validate / preview\"| DB\n API -->|\"run / scheduled\"| WF\n DB -->|\"input\"| WF\n WF -->|\"creates\"| TABLES\n CHILD -.->|\"queries\"| TABLES\n","diagramHtml":"

Treasure AI

Local

cdp_audience_xxx database

pull / push

validate / preview

run / scheduled

input

creates

queries

parent_segments/*.yml

CDP API

Source Tables

Treasure Workflow

customers
behavior tables

Child Segments

","diagramHtmlDark":"

Treasure AI

Local

cdp_audience_xxx database

pull / push

validate / preview

run / scheduled

input

creates

queries

parent_segments/*.yml

CDP API

Source Tables

Treasure Workflow

customers
behavior tables

Child Segments

"},"children":["flowchart TB\n subgraph LOCAL[\"Local\"]\n YAML[\"parent_segments/*.yml\"]\n end\n\n subgraph TD[\"Treasure AI\"]\n API[\"CDP API\"]\n DB[(\"Source Tables\")]\n WF[\"Treasure Workflow\"]\n subgraph CDP[\"cdp_audience_xxx database\"]\n TABLES[(\"customers
behavior tables\")]\n end\n CHILD[\"Child Segments\"]\n end\n\n YAML <-->|\"pull / push\"| API\n YAML -.->|\"validate / preview\"| DB\n API -->|\"run / scheduled\"| WF\n DB -->|\"input\"| WF\n WF -->|\"creates\"| TABLES\n CHILD -.->|\"queries\"| TABLES\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"folder-structure","__idx":3},"children":["Folder Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Parent segment YAML files are stored in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parent_segments/"]}," directory by convention:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"parent_segments/\n├── customer-360.yml\n├── demo-audience.yml\n└── sales-leads.yml\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All commands accept ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[""]}," without the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".yml"]}," suffix:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps validate customer-360"]}," looks for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parent_segments/customer-360.yml"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Explicit paths still work: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps validate ./other/path/file.yml"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"commands","__idx":4},"children":["Commands"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list","__idx":5},"children":["list"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List all parent segments."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps list [pattern]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# List all parent segments (alphabetically sorted)\ntdx ps list\n\n# Filter by wildcard pattern\ntdx ps list \"Customer*\"\ntdx ps list \"*Demo\"\n\n# Case-insensitive matching\ntdx ps list \"*test*\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Found 3 parent segments\n👥 customer-360 (2.5M)\n👥 customer-demo (50K)\n👥 sales-leads (12.5K)\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"use","__idx":6},"children":["use"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set or show parent segment context. When a name is provided, sets the context. Without arguments, shows the current context."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps use [name]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is equivalent to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx use parent_segment [name]"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Show current context\ntdx ps use\n\n# Set context to a parent segment\ntdx ps use \"Customer 360\"\n\n# Now these commands work without specifying the name\ntdx ps pull\ntdx ps push\ntdx ps fields\ntdx ps view\ntdx ps desc\ntdx ps sql\ntdx ps show\n\n# Clear context\ntdx use --clear parent_segment\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output (show context):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Session Context\n parent_segment: Customer 360\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output (set context):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Context set: parent_segment = Customer 360\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pull","__idx":7},"children":["pull"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pull a parent segment configuration from Treasure AI to a local YAML file."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pull [name] [options]\n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-o, --output "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Output file path (default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parent_segments/.yml"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-y, --yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Skip confirmation prompt"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pull automatically sets the context to the pulled parent segment."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Pull to default location (normalizes name to lowercase with hyphens)\ntdx ps pull \"Customer 360\"\n# Creates: parent_segments/customer-360.yml\n\n# Pull to specific file\ntdx ps pull \"Customer 360\" -o custom-name.yml\n\n# Skip confirmation\ntdx ps pull \"Customer 360\" -y\n\n# With context set (tdx ps use \"Customer 360\")\ntdx ps pull\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"push","__idx":8},"children":["push"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Push a local YAML configuration to Treasure AI (creates new or updates existing)."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps push [name] [options]\n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-y, --yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Skip confirmation prompt"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Push configuration (looks for parent_segments/customer360.yml)\ntdx ps push customer360\n\n# Explicit path\ntdx ps push ./configs/customer360.yml\n\n# Skip confirmation\ntdx ps push customer360 -y\n\n# With context set (tdx ps use \"customer360\")\ntdx ps push\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example diff output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Changes to apply to 'Customer 360':\n────────────────────────────────────────────────────────────\n 6 6 - name: User Profile\n 7 7 columns:\n 8 - - column: age\n 9 - type: number\n 8 + - column: age\n 9 + label: \"Customer Age\"\n 10 + type: number\n 11 + - column: income\n 12 + label: \"Annual Income\"\n 13 + type: number\n────────────────────────────────────────────────────────────\nApply changes to 'Customer 360'? [y/N]\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"validate","__idx":9},"children":["validate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Validate a parent segment YAML configuration by executing schema queries and showing join statistics."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps validate [options]\n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--master"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate only master table"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--attribute [name]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate attributes (optionally filter by name)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--behavior [name]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate behaviors (optionally filter by name)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--enriched"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate enriched master schema"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--interval "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Time range for behavior stats (default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-1d"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Validate all components\ntdx ps validate customer360\n\n# Validate only master table\ntdx ps validate customer360 --master\n\n# Validate only attributes\ntdx ps validate customer360 --attribute\n\n# Validate a specific attribute\ntdx ps validate customer360 --attribute \"User Profile\"\n\n# Validate only behaviors\ntdx ps validate customer360 --behavior\n\n# Validate a specific behavior\ntdx ps validate customer360 --behavior \"Purchases\"\n\n# Validate enriched master schema\ntdx ps validate customer360 --enriched\n\n# Custom time range for behavior stats\ntdx ps validate customer360 --interval -7d\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Validate: Customer 360\n\nMaster Table\n cdp_db.customers (2.5M rows)\n\nAttributes\n User Profile — Coverage: 95.2% (2.38M rows)\n Contact Info — Coverage: 78.5% (1.96M rows)\n\nBehaviors (-1d)\n Purchases — 1.2M customers (48.0%), 8.5M events\n\n────────────────────────────────────────────────────────────\nConfiguration is valid\n\nTo view sample data:\n tdx ps preview customer360 --attribute \"User Profile\"\n tdx ps preview customer360 --behavior \"Purchases\"\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"preview","__idx":10},"children":["preview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Show sample data from a parent segment YAML configuration."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps preview [options]\n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--master"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show master table sample"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--attribute "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show attribute sample data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--behavior "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show behavior sample data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--enriched"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show enriched master sample"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--interval "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Time range for behavior queries (default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-1d"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--master"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--attribute"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--behavior"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--enriched"]}," is required."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Show master table sample\ntdx ps preview customer360 --master\n\n# Show attribute sample data\ntdx ps preview customer360 --attribute \"User Profile\"\n\n# Show behavior sample data\ntdx ps preview customer360 --behavior \"Purchases\"\n\n# Show enriched master sample\ntdx ps preview customer360 --enriched\n\n# Custom time range\ntdx ps preview customer360 --behavior \"Page Views\" --interval -7d\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Attribute: User Profile — Coverage: 95.2% (2.38M rows)\n┌─────────────┬─────┬────────┬────────┐\n│ customer_id │ age │ gender │ income │\n├─────────────┼─────┼────────┼────────┤\n│ C001 │ 35 │ M │ 75000 │\n│ C002 │ 28 │ F │ 62000 │\n│ C003 │ 42 │ M │ 95000 │\n└─────────────┴─────┴────────┴────────┘\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"run","__idx":11},"children":["run"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run the parent segment workflow to (re)generate the audience."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps run [options]\n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-y, --yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Skip confirmation prompt"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a local YAML file exists for the segment, it will be pushed first before running the workflow."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Run workflow (pushes YAML if exists locally)\ntdx ps run customer360\n\n# Skip confirmation\ntdx ps run customer360 -y\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Workflow started\n Audience ID: 12345\n Status: running\n Session: 306281053\n Attempt: 987654321\n https://console.us01.treasuredata.com/app/workflows/44073028/sessions/306281053/attempt/987654321\n\nTo cancel: tdx wf attempt 987654321 kill\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fields","__idx":12},"children":["fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List available fields for segmentation from a parent segment."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps fields [name]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# List all available fields\ntdx ps fields \"Customer 360\"\n\n# JSON output\ntdx ps fields \"Customer 360\" --json\n\n# With context set (tdx ps use \"Customer 360\")\ntdx ps fields\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Fields for Customer 360\n────────────────────────────────────────────────────────────\n Name Type Source\n customer_id string master\n email string master\n age number User Profile (attribute)\n gender string User Profile (attribute)\n purchase_amount number Purchases (behavior)\n purchased_at timestamp Purchases (behavior)\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"view","__idx":13},"children":["view"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Show parent segment details or open in web browser."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps view [name] [options]\n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-w, --web"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Open parent segment in web browser"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Show segment details\ntdx ps view \"Customer 360\"\n\n# Open in web browser\ntdx ps view \"Customer 360\" -w\n\n# JSON output for programmatic access\ntdx ps view \"Customer 360\" --json\n\n# With context set (tdx ps use \"Customer 360\")\ntdx ps view\ntdx ps view -w\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"┌──────────────────┬────────────────────────────────────────┐\n│ id │ 12345 │\n│ name │ Customer 360 │\n│ description │ Complete customer view │\n│ populationCount │ 2500000 │\n│ audienceDatabaseName │ cdp_audience_12345 │\n│ createdAt │ 2024-01-15T10:30:00Z │\n│ updatedAt │ 2024-03-20T14:45:00Z │\n└──────────────────┴────────────────────────────────────────┘\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output (with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-w"]},"):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Opening https://console-next.us01.treasuredata.com/app/dw/parentSegments/12345\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"desc","__idx":14},"children":["desc"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Show parent segment output database schema (column types) for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customers"]}," table and behavior tables."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps desc [name] [options]\n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-o, --output "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Output file path"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Show all tables to stdout\ntdx ps desc \"Customer 360\"\n\n# JSON output\ntdx ps desc \"Customer 360\" --json\n\n# Save to file\ntdx ps desc \"Customer 360\" -o schema.json\n\n# With context set (tdx ps use \"Customer 360\")\ntdx ps desc\ntdx ps desc -o schema.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output (stdout):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Output Database: cdp_audience_12345\n\ncustomers (cdp_audience_12345.customers)\n┌─────────────┬─────────┐\n│ Column │ Type │\n├─────────────┼─────────┤\n│ customer_id │ varchar │\n│ email │ varchar │\n│ age │ integer │\n│ gender │ varchar │\n└─────────────┴─────────┘\n\nPurchases (cdp_audience_12345.behavior_purchases)\n┌──────────────┬───────────┐\n│ Column │ Type │\n├──────────────┼───────────┤\n│ customer_id │ varchar │\n│ amount │ double │\n│ purchased_at │ timestamp │\n│ time │ bigint │\n└──────────────┴───────────┘\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output (--output):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Schema saved to schema.json\n Database: cdp_audience_12345\n Tables: 1 customers + 5 behaviors\n Columns: 42 total\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["JSON file structure (one column per line for grep):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"database\": \"cdp_audience_12345\",\n \"parent_segment\": \"Customer 360\",\n \"parent_id\": \"12345\",\n \"customers\": {\n \"table\": \"customers\",\n \"columns\": [\n { \"name\": \"customer_id\", \"type\": \"varchar\" },\n { \"name\": \"email\", \"type\": \"varchar\" },\n { \"name\": \"age\", \"type\": \"bigint\" }\n ]\n },\n \"behaviors\": [\n {\n \"table\": \"behavior_purchases\",\n \"columns\": [\n { \"name\": \"customer_id\", \"type\": \"varchar\" },\n { \"name\": \"amount\", \"type\": \"double\" },\n { \"name\": \"time\", \"type\": \"bigint\" }\n ]\n }\n ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sql","__idx":15},"children":["sql"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get the SQL query that defines a parent segment."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps sql [name]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Get SQL query\ntdx ps sql \"Customer 360\"\n\n# JSON output\ntdx ps sql \"Customer 360\" --json\n\n# With context set (tdx ps use \"Customer 360\")\ntdx ps sql\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"SELECT\n customer_id,\n email,\n age,\n gender\nFROM cdp_audience_12345.customers\n","lang":"sql"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"show","__idx":16},"children":["show"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Execute the parent segment SQL query and display results."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps show [name] [options]\n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--limit "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Limit number of rows (default: 100)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Show sample data\ntdx ps show \"Customer 360\"\n\n# Limit results\ntdx ps show \"Customer 360\" --limit 10\n\n# JSON output\ntdx ps show \"Customer 360\" --json\n\n# With context set (tdx ps use \"Customer 360\")\ntdx ps show\ntdx ps show --limit 10\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Query: 0.8s (100 rows)\n┌─────────────┬─────────────────────┬─────┬────────┐\n│ customer_id │ email │ age │ gender │\n├─────────────┼─────────────────────┼─────┼────────┤\n│ C001 │ alice@example.com │ 35 │ F │\n│ C002 │ bob@example.com │ 28 │ M │\n│ C003 │ carol@example.com │ 42 │ F │\n└─────────────┴─────────────────────┴─────┴────────┘\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"yaml-format","__idx":17},"children":["YAML Format"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"name: \"Customer 360\"\ndescription: \"Complete customer view\"\n\nmaster:\n database: cdp_db\n table: customers\n filters: # Optional: max 2 filters\n - column: status\n values: [\"active\"]\n\nschedule:\n type: daily # none, hourly, daily, weekly, monthly, cron\n time: \"03:00\"\n timezone: \"America/Los_Angeles\"\n\nengine:\n hive_only: false # false = Trino + Hive (default)\n trino_pool: null # Optional: Trino resource pool\n hive_pool: null # Optional: Hive resource pool\n\nattributes:\n - name: \"User Profile\" # Logical grouping name\n source:\n database: cdp_db\n table: user_profiles\n join:\n parent_key: user_id # Key in master table\n child_key: customer_id # Key in source table\n columns:\n - column: age # Source column name\n label: \"Age\" # Display name (optional)\n type: number\n - column: gender\n type: string\n\nbehaviors:\n - name: \"Purchases\"\n source:\n database: cdp_db\n table: purchase_events\n join:\n parent_key: user_id\n child_key: customer_id\n columns:\n - column: amount\n label: \"Purchase Amount\"\n type: number\n - column: purchased_at\n type: timestamp\n\n - name: \"Page Views\"\n source:\n database: cdp_db\n table: pageview_events\n join:\n parent_key: visitor_id\n child_key: customer_id\n all_columns: true # Include all columns from table\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rt-20-commands","__idx":18},"children":["RT 2.0 Commands"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Manage RT (Real-Time) 2.0 configuration for parent segments. RT enables real-time event processing and attribute updates for personalization use cases."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps rt \n","lang":"bash"},"children":[]},{"$$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":"Command"},"children":["Command"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#rt-list"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rt list"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List RT-enabled parent segments"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#rt-validate"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rt validate"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate RT 2.0 configuration from YAML"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#rt-configuration_versions"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rt configuration_versions"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show RT configuration version status"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#rt-jn-list"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rt jn list"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List RT journeys (triggers)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#rt-jn-pause_activations"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rt jn pause_activations"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pause all activations in an RT journey"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#rt-jn-resume_activations"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rt jn resume_activations"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Resume activations in a paused RT journey"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Pushing RT configuration"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps push"]}," to push the full parent segment configuration including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["realtime:"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personalization_services:"]}," sections. The diff will show exactly which sections changed."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps push customer-360 # Shows diff of all changes (including RT/PZ)\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rt-list","__idx":19},"children":["rt list"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List parent segments that have RT 2.0 enabled. Only shows RT-enabled segments (not all parent segments)."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps rt list [pattern]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# List all RT-enabled parent segments\ntdx ps rt list\n\n# Filter by pattern\ntdx ps rt list \"Customer*\"\n\n# JSON output\ntdx ps rt list --json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Found 2 RT-enabled parent segments\n⚡ customer-360 (2.5M)\n⚡ realtime-users (120K)\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rt-validate","__idx":20},"children":["rt validate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Validate RT 2.0 configuration from a parent segment YAML file. Checks events, attributes, ID stitching, and personalization services."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps rt validate [name]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Validate RT config\ntdx ps rt validate customer-360\n\n# With context set\ntdx ps rt validate\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"RT 2.0 Validate: Customer 360\n════════════════════════════════════════════════════════════\n\nRT 2.0: ⚡ Enabled\n Events: 2 configured\n ✔ page_view\n ✔ purchase\n Attributes: 3 configured\n ✔ last_page_viewed (single)\n ✔ total_purchases (counter)\n ✔ last_purchase_date (single)\n ID Stitching: td_client_id + [email, phone]\n Personalization: 1 service\n - My Service\n────────────────────────────────────────────────────────────\n\n✔ RT configuration is valid\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rt-configuration_versions","__idx":21},"children":["rt configuration_versions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Show the current RT 2.0 configuration version status for a parent segment. Useful for checking whether a recently pushed RT configuration has been applied."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps rt configuration_versions [name]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps rt configuration_versions customer-360\n\n# With context set\ntdx ps rt configuration_versions\n\n# JSON output\ntdx ps rt configuration_versions --json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"id: 112\naudienceId: 407586\nidentifier: realtime_setting\neventKind: update\nstatus: completed\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rt-jn-list","__idx":22},"children":["rt jn list"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List RT journeys (real-time triggers) configured for a parent segment."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps rt jn list [name]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps rt jn list customer-360\n\n# With context set\ntdx ps rt jn list\n\n# JSON output\ntdx ps rt jn list --json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Found 2 RT journeys\n🚀 Welcome Flow (id: 88) — launched (3 stages)\n📝 Re-engagement Draft (id: 91) — draft (1 stage)\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rt-jn-pause_activations","__idx":23},"children":["rt jn pause_activations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pause all activations in an RT journey. While paused, the journey continues to process events but does not deliver activations to external systems."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps rt jn pause_activations \n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps rt jn pause_activations 88\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Paused activations for journey 'Welcome Flow' (id: 88)\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rt-jn-resume_activations","__idx":24},"children":["rt jn resume_activations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Resume activations in a paused RT journey."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps rt jn resume_activations \n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps rt jn resume_activations 88\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Resumed activations for journey 'Welcome Flow' (id: 88)\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"personalization-commands","__idx":25},"children":["Personalization Commands"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Manage real-time personalizations for parent segments. There are two distinct concepts:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Personalization entities"]}," — API-callable endpoints (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/entities/realtime_personalizations"]},") that return real-time personalized data based on entry criteria and payloads. Managed with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps pz"]}," commands."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Personalization services"]}," — The underlying service configuration (authentication tokens, public/private access). Managed with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps pz service"]}," commands."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz \n","lang":"bash"},"children":[]},{"$$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":"Command"},"children":["Command"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-list"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz list"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List personalization entities"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-show"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz show"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show personalization entity details"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-create"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz create"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a personalization entity"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-patch"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz patch"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update a personalization entity"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-delete"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz delete"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete a personalization entity"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-init"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz init"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add template personalization section to YAML"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-service-list"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz service list"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List personalization services"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-service-create"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz service create"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a personalization service"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-service-show"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz service show"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show service details"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-service-update"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz service update"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update a service name/description"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-service-delete"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz service delete"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete a personalization service"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-service-token-create"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz service token create"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create an access token"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pz-service-token-delete"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pz service token delete"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete an access token"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-list","__idx":26},"children":["pz list"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List real-time personalization entities for a parent segment."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz list [name]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz list customer-360\n\n# With context set\ntdx ps pz list\n\n# JSON output\ntdx ps pz list --json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Found 2 personalizations\npoints (id: 391)\n show my points\n sections: 1\n - check points\nproduct-recs (id: 395)\n sections: 2\n - high value\n - default\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-show","__idx":27},"children":["pz show"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Show full details of a personalization entity including all sections, entry criteria, and payloads."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz show \n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz show 391\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"points (id: 391)\n show my points\n audienceId: 407586\n created: 2025-10-15T18:41:10.423Z\n updated: 2026-02-25T23:42:08.414Z\n sections: 1\n check points (id: 1099)\n entryCriteria: enter points check\n keyEventId: 4516\n payload: {\"75d5f232...\": {\"type\": \"ResponseNode\", ...}}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-create","__idx":28},"children":["pz create"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a new real-time personalization entity."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz create --name --description --folder-id [options]\ntdx ps pz create --file \n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--name "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Personalization name (required without ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--file"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--description "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Description (required without ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--file"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--folder-id "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Parent folder ID (required; use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," for root folder)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--audience-id "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Audience (parent segment) ID — inferred from context if set"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--sections "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sections as an inline JSON array"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--file "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full request body from a JSON file (overrides other flags)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To find the folder ID for the audience, list folders via the API:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx api --type cdp /audiences//folders\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Create with flags (audience from context)\ntdx ps use customer-360\ntdx ps pz create --name \"Product Recs\" --description \"Homepage recommendations\" --folder-id 1046566\n\n# Create with explicit audience ID\ntdx ps pz create \\\n --name \"Product Recs\" \\\n --description \"Homepage recommendations\" \\\n --audience-id 407586 \\\n --folder-id 1046566\n\n# Create with sections inline\ntdx ps pz create \\\n --name \"Product Recs\" \\\n --description \"Homepage recommendations\" \\\n --audience-id 407586 \\\n --folder-id 1046566 \\\n --sections '[{\"name\":\"default\",\"entryCriteria\":null,\"payload\":null}]'\n\n# Create from a full JSON file\ntdx ps pz create --file personalization.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--file"]},", the JSON must include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["relationships.parentFolder"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"attributes\": {\n \"name\": \"Product Recs\",\n \"description\": \"Homepage recommendations\",\n \"audienceId\": \"407586\",\n \"sections\": [\n {\n \"name\": \"default\",\n \"entryCriteria\": null,\n \"payload\": null\n }\n ]\n },\n \"relationships\": {\n \"parentFolder\": {\n \"data\": { \"id\": \"1046566\", \"type\": \"folder-segment\" }\n }\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Created personalization 'Product Recs' with ID: 538\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-patch","__idx":29},"children":["pz patch"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Update an existing personalization entity's name, description, and/or sections."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz patch --name --description [options]\ntdx ps pz patch --file \n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--name "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New name (required without ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--file"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--description "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New description (required without ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--file"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--sections "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Replacement sections as an inline JSON array"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--file "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full request body from a JSON file (overrides other flags)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--sections"]}," replaces all sections — it is not a partial update. Omitting ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--sections"]}," clears all sections on the entity."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Update name and description only\ntdx ps pz patch 391 --name \"points-v2\" --description \"Updated description\"\n\n# Update with new sections\ntdx ps pz patch 391 \\\n --name \"points-v2\" \\\n --description \"Updated\" \\\n --sections '[{\"name\":\"check points\",\"entryCriteria\":{\"name\":\"entry\",\"keyEventCriteria\":{\"keyEventId\":\"4516\",\"keyEventFilters\":null},\"profileCriteria\":null},\"payload\":null}]'\n\n# Update from a full JSON file\ntdx ps pz patch 391 --file patch.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--file"]},", the JSON must include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attributes"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]},", and optionally ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sections"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"attributes\": {\n \"name\": \"points-v2\",\n \"description\": \"Updated description\",\n \"sections\": []\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Updated personalization 'points-v2' (id: 391)\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-delete","__idx":30},"children":["pz delete"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Delete a personalization entity."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz delete \n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz delete 391\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Deleted personalization '391'\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-init","__idx":31},"children":["pz init"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add a template ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["realtime:"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personalization_services:"]}," section to an existing parent segment YAML file."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz init [name]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz init customer-360\n\n# With context set\ntdx ps pz init\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Added personalization template to parent_segments/customer-360.yml\n✔ Added RT 2.0 template section\n\nNext steps:\n 1. Edit parent_segments/customer-360.yml to configure your personalization service\n 2. Run tdx ps push customer-360 to push the configuration\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The generated template adds these sections to your YAML:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"realtime:\n events:\n - name: page_view\n source_table: .\n attributes:\n - name: last_page_viewed\n type: single\n id_stitching:\n primary_key: td_client_id\n\npersonalization_services:\n - name: My Service\n description: Personalization service description\n trigger_event: page_view\n sections:\n - name: Default\n criteria: \"true\"\n attributes:\n - last_page_viewed\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-service-list","__idx":32},"children":["pz service list"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List personalization services for a parent segment. Services provide authentication tokens and access control for personalization API calls."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service list [name]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," argument is optional if you have set a parent segment context with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps use"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service list customer-360\n\n# With context set\ntdx ps pz service list\n\n# JSON output\ntdx ps pz service list --json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Found 1 personalization service\nMy Service (id: svc_123)\n Personalized homepage content\n Tokens:\n prod-token (id: tok_456) — IPs: any\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-service-create","__idx":33},"children":["pz service create"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a new personalization service for a parent segment."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service create [parent_segment]\n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--description "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Service description"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--public"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Make service public (default: private)"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service create \"My Service\" customer-360 --description \"Homepage personalizations\"\n\n# With context set\ntdx ps pz service create \"My Service\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Created personalization service 'My Service' with ID: svc_123\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-service-show","__idx":34},"children":["pz service show"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Show details of a personalization service including tokens and IP restrictions."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service show [parent_segment]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service show svc_123 customer-360\n\n# With context set\ntdx ps pz service show svc_123\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-service-update","__idx":35},"children":["pz service update"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Update the name and/or description of a personalization service."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service update [parent_segment]\n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--name "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New service name (required)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--description "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New description"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service update svc_123 --name \"My Service v2\" --description \"Updated description\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-service-delete","__idx":36},"children":["pz service delete"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Delete a personalization service and all its tokens."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service delete [parent_segment]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service delete svc_123\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-service-token-create","__idx":37},"children":["pz service token create"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create an access token for a personalization service. The token value is shown ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["once"]}," at creation time — save it immediately."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service token create [parent_segment]\n","lang":"bash"},"children":[]},{"$$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":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--allowed-ips "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Comma-separated list of allowed IP addresses"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--description "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token description"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service token create \"prod-token\" svc_123 customer-360\n\n# With IP restrictions\ntdx ps pz service token create \"prod-token\" svc_123 --allowed-ips \"10.0.0.1,10.0.0.2\"\n\n# With context set\ntdx ps pz service token create \"prod-token\" svc_123\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The token value is only displayed once on creation. Store it securely — it cannot be retrieved again."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Created token 'prod-token' with ID: tok_456\n\n⚠ Save this token value — it will not be shown again:\n eyJhbGci...\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pz-service-token-delete","__idx":38},"children":["pz service token delete"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Delete a token from a personalization service."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service token delete [parent_segment]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx ps pz service token delete tok_456\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rt-20-yaml-format","__idx":39},"children":["RT 2.0 YAML Format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["realtime:"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personalization_services:"]}," sections are added to the parent segment YAML alongside the existing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["master:"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attributes:"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["behaviors:"]}," sections."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"name: \"Customer 360\"\n\nmaster:\n database: cdp_db\n table: customers\n\n# ... attributes, behaviors, schedule ...\n\nrealtime:\n events:\n - name: page_view # Event name (required)\n source_table: web_db.pageviews # Source table reference\n - name: purchase\n source_table: sales_db.transactions\n filter_pattern: \"status=completed\" # Optional filter\n\n attributes:\n - name: last_page_viewed # Attribute name (required)\n type: single # single, counter, set, ordered_set, list, imported_batch\n source_event: page_view # Source event\n source_field: page_url # Field from source event\n - name: total_purchases\n type: counter\n - name: recent_categories\n type: set\n\n id_stitching:\n primary_key: td_client_id # Primary key (required)\n stitching_keys: # Additional keys for identity resolution\n - email\n - phone\n exclusion_patterns: # Patterns to exclude\n - \"bot_*\"\n\npersonalization_services:\n - name: Product Recommendations # Service name (required)\n description: Personalized products # Description\n trigger_event: page_view # Event that triggers the service\n sections:\n - name: High Value # Section name\n criteria: \"total_purchases > 10\" # Criteria expression\n attributes: # Attributes to serve\n - last_page_viewed\n - recent_categories\n batch_segments: # Batch segment names to include\n - VIP Customers\n - name: Default\n criteria: \"true\" # Catch-all section\n attributes:\n - last_page_viewed\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rt-attribute-types","__idx":40},"children":["RT attribute types"]},{"$$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":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["single"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Latest value (overwrites on each event)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["counter"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Incrementing count"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["set"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unordered set of unique values"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ordered_set"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ordered set of unique values"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API alias for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["set"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["imported_batch"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Batch-imported attribute from parent segment"]}]}]}]}]}]},"headings":[{"value":"Parent Segment Commands","id":"parent-segment-commands","depth":1},{"value":"Typical Usage","id":"typical-usage","depth":2},{"value":"How It Works","id":"how-it-works","depth":2},{"value":"Folder Structure","id":"folder-structure","depth":2},{"value":"Commands","id":"commands","depth":2},{"value":"list","id":"list","depth":3},{"value":"use","id":"use","depth":3},{"value":"pull","id":"pull","depth":3},{"value":"push","id":"push","depth":3},{"value":"validate","id":"validate","depth":3},{"value":"preview","id":"preview","depth":3},{"value":"run","id":"run","depth":3},{"value":"fields","id":"fields","depth":3},{"value":"view","id":"view","depth":3},{"value":"desc","id":"desc","depth":3},{"value":"sql","id":"sql","depth":3},{"value":"show","id":"show","depth":3},{"value":"YAML Format","id":"yaml-format","depth":2},{"value":"RT 2.0 Commands","id":"rt-20-commands","depth":2},{"value":"rt list","id":"rt-list","depth":3},{"value":"rt validate","id":"rt-validate","depth":3},{"value":"rt configuration_versions","id":"rt-configuration_versions","depth":3},{"value":"rt jn list","id":"rt-jn-list","depth":3},{"value":"rt jn pause_activations","id":"rt-jn-pause_activations","depth":3},{"value":"rt jn resume_activations","id":"rt-jn-resume_activations","depth":3},{"value":"Personalization Commands","id":"personalization-commands","depth":2},{"value":"pz list","id":"pz-list","depth":3},{"value":"pz show","id":"pz-show","depth":3},{"value":"pz create","id":"pz-create","depth":3},{"value":"pz patch","id":"pz-patch","depth":3},{"value":"pz delete","id":"pz-delete","depth":3},{"value":"pz init","id":"pz-init","depth":3},{"value":"pz service list","id":"pz-service-list","depth":3},{"value":"pz service create","id":"pz-service-create","depth":3},{"value":"pz service show","id":"pz-service-show","depth":3},{"value":"pz service update","id":"pz-service-update","depth":3},{"value":"pz service delete","id":"pz-service-delete","depth":3},{"value":"pz service token create","id":"pz-service-token-create","depth":3},{"value":"pz service token delete","id":"pz-service-token-delete","depth":3},{"value":"RT 2.0 YAML Format","id":"rt-20-yaml-format","depth":2},{"value":"RT attribute types","id":"rt-attribute-types","depth":3}],"frontmatter":{"seo":{"title":"tdx parent-segment - Audience Management | Treasure Data","description":"Manage CDP parent segments with YAML configuration. Pull, push, validate, and preview audience definitions.","image":"/assets/og-image.ba836864a30434f560a4f7720f8a09019ad30ff828b20c5052ae933ba7121524.d7ef4821.png"}},"lastModified":"2026-05-18T01:25:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/treasure-code/commands/parent-segment","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}