validate-segment
根据TD CDP API规范验证CDP段YAML配置。在审查段规则的正确性,检查操作符类型和值,或在推送到Treasure Data前排查段配置错误时使用。
📖 中文导读:根据TD CDP API规范验证CDP段YAML配置。在审查段规则的正确性,检查操作符类型和值,或在推送到Treasure Data前排查段配置错误时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: validate-segment description: Validates CDP segment YAML configurations against the TD CDP API specification. Use when reviewing segment rules for correctness, checking operator types and values, or troubleshooting segment configuration errors before pushing to Treasure Data.
Segment YAML Validation
tdx sg validate # Validate all YAML files locally
tdx sg validate path/to/segment.yml # Validate specific file
tdx sg push --dry-run # Preview changes before push
Required Structure
name: string
kind: batch # batch | realtime | funnel_stage
rule:
type: And # And | Or
conditions:
- type: Value
attribute: field_name
operator:
type: OperatorType
value: ...
Operators Quick Reference
| Type | Value | Notes |
|---|---|---|
Equal, NotEqual |
single value | |
Greater, GreaterEqual, Less, LessEqual |
number | |
In, NotIn |
array | ["US", "CA"] |
Contain, StartWith, EndWith |
array | ["@gmail.com"] |
Regexp |
string | regex pattern |
IsNull |
(none) | |
TimeWithinPast, TimeWithinNext |
number + unit | value: 30, unit: day |
include, exclude |
segment name | reuse existing segment |
Time Units (Singular Form Only)
year | quarter | month | week | day | hour | minute | second
Common mistake: days → day, months → month
Behavior Aggregation Structure
# Behavior condition with aggregation
- type: Value
attribute: field_name # Or "" for pure count
operator:
type: GreaterEqual
value: 1
aggregation:
type: Count # Count | Sum | Avg | Min | Max
source: behavior_name # Behavior from parent segment
Required fields: aggregation.type and source must both be present
Related Skills
- segment - Full segment management