欄位屬性參數

欄位屬性（Attribute）的參數參考手冊。

參數列表

參數	類型	說明
`name`	`string`	欄位名稱（作為 key 時自動設定）

參數	類型	預設值	說明
`type`	`string`	`null`	資料型別：`int`, `float`, `str`, `date`, `datetime`
`description`	`string`	`null`	欄位說明文字
`logical_type`	`string`	`null`	邏輯型別標註（如 `email`, `phone`）

type_attr 是一個字典，包含型別相關的設定：

ℹ️

簡化寫法：type_attr 中的參數可直接寫在屬性層級。例如 nullable: false 等同於 type_attr.nullable: false。

參數	類型	預設值	說明
`na_values`	`list/string`	`null`	自訂缺失值標記（如 `"?"`, `["?", "N/A"]`）
`default_value`	`any`	`null`	預設填充值
`cast_errors`	`string`	`"coerce"`	型別轉換錯誤處理：`"raise"`, `"coerce"`, `"ignore"`
`null_strategy`	`string`	`"keep"`	空值處理策略：`"keep"`, `"drop"`, `"fill"`

參數	類型	預設值	說明
`constraints`	`dict`	`null`	欄位約束條件（`min`, `max`, `pattern`）

參數	類型	預設值	說明
`enable_optimize_type`	`boolean`	`true`	啟用型別優化（選擇最小資料型別）
`enable_stats`	`boolean`	`true`	計算欄位統計資訊

這些參數由系統自動設定，請勿手動設定：

age:
  type: int
  nullable: false
  description: "年齡"

gender:
  type: str
  category: true
  description: "性別"

price:
  type: float
  precision: 2
  description: "價格（兩位小數）"

birth_date:
  type: date
  format: "%Y-%m-%d"
  description: "出生日期"

workclass:
  type: str
  category: true
  na_values: "?"
  description: "就業類型"