Schema 架構說明

class Metadata:
    id: str                      # 資料集識別碼
    name: str                    # 資料集名稱（選填）
    description: str             # 資料集描述（選填）
    schemas: dict[str, Schema]   # 表格結構字典 {table_name: Schema}

# 單表格資料集
id: user_dataset
name: 使用者資料集
schemas:
  users:              # 單一表格
    id: users
    fields: {...}

# 多表格資料集
id: ecommerce_dataset
name: 電商資料集
schemas:
  users:              # 第一個表格
    id: users
    fields: {...}
  orders:             # 第二個表格
    id: orders
    fields: {...}
  products:           # 第三個表格
    id: products
    fields: {...}

class Schema:
    id: str                          # 表格識別碼
    name: str                        # 表格名稱（選填）
    description: str                 # 表格描述（選填）
    attributes: dict[str, Attribute] # 欄位屬性字典 {field_name: Attribute}
    stats: dict                      # 表格統計資料（選填，自動產生）

# 完整的 Schema 定義
id: users                  # 表格識別碼
name: 使用者表             # 表格顯示名稱
description: 系統使用者資料 # 表格說明

fields:                    # 欄位定義（Attributes）
  user_id:
    type: int64
    nullable: false
  
  username:
    type: object
    nullable: false
  
  email:
    type: object
    nullable: true
    logical_type: email

stats:                     # 表格統計（自動產生）
  row_count: 1000
  column_count: 3

class Attribute:
    name: str           # 欄位名稱
    type: str           # 資料型別
    nullable: bool      # 是否允許空值
    logical_type: str   # 邏輯型別（選填）
    description: str    # 欄位描述（選填）
    na_values: list     # 自訂空值表示（選填）
    stats: dict         # 欄位統計資料（選填，自動產生）

# 單一欄位的完整定義
user_id:                    # 欄位名稱（key）
  type: int64               # 資料型別
  nullable: false           # 不允許空值
  description: 使用者唯一識別碼

email:
  type: object              # 字串型別
  nullable: true            # 允許空值
  logical_type: email       # 標記為電子郵件
  description: 電子郵件地址

age:
  type: int64
  nullable: true
  description: 年齡
  stats:                    # 欄位統計（自動產生）
    count: 950              # 非空值數量
    null_count: 50          # 空值數量
    min: 18                 # 最小值
    max: 95                 # 最大值
    mean: 35.5              # 平均值