treasure-data avatar

parent-segment

Manages CDP parent segments using `tdx ps` commands with YAML configs. Covers master tables, attribu

作者 treasure-data|オープンソース

tdx Parent-Segment - CDP Parent Segment Management

Core Commands

tdx ps list                                  # List parent segments
tdx ps pull "Customer 360"                   # Pull to YAML (sets context)
tdx ps push                                  # Push changes
tdx ps validate                              # Validate all
tdx ps validate --attribute "User Profile"   # Validate specific attribute
tdx ps preview --enriched                    # Preview joined data
tdx ps run                                   # Push and run workflow
tdx ps fields                                # List segmentation fields

YAML Configuration

name: "Customer 360"

master:
  database: cdp_db
  table: customers
  filters:                          # Optional: max 2 filters
    - column: status
      values: ["active"]

schedule:
  type: daily                       # none | hourly | daily | weekly | cron
  time: "03:00:00"
  timezone: "America/Los_Angeles"

attributes:
  - name: "User Profile"
    source:
      database: cdp_db
      table: user_profiles
    join:
      parent_key: user_id
      child_key: customer_id
    columns:
      - column: age
        type: number

behaviors:
  - name: "Purchases"
    source:
      database: cdp_db
      table: purchase_events
    join:
      parent_key: user_id
      child_key: customer_id
    columns:
      - column: amount
        type: number

Common Issues

IssueSolution
Low join match ratetdx ps preview --master and --attribute to compare keys
Workflow failstdx ps validate --master, --attribute, --behavior

Related Skills

  • segment - Child segments using parent segment data
  • tdx-basic - Core CLI operations

Resources