核对日期：2026 年 10 月 14 日。
首批补充三个示例数据集和四个官方学习入口，用来练习 SQL、指标定义、语义模型与 AI 工具接入。Chinook 适合从简单查询开始；Jaffle Shop 适合订单与支付建模；Wide World Importers 可以继续使用已有企业分析案例。
| 资料 | 适合练习 | 语言与形式 | 使用许可与本次状态 |
|---|---|---|---|
| Chinook Database | 账单趋势、客户排名、音乐类型销售额、多表关联与对账 | 英文说明，多数据库示例；本次采用 SQLite | MIT 式许可文本，要求保留版权和许可声明。已保存 v1.4.5 SQLite 文件、完整许可及来源记录 |
| Jaffle Shop DuckDB | 客户、订单、支付关系，金额单位、退款与指标口径，dbt 模型思路 | 英文说明；含虚构业务的客户、订单、支付 CSV | Apache 2.0。本次收录原始链接；未安装 dbt 或导入数据 |
| Wide World Importers | 订单与开票口径、客户与商品分析、OLTP 和分析库的区别 | Microsoft 官方示例；SQL Server / Azure SQL，含 OLTP 和 DW 两种库 | Microsoft 示例许可为 MIT；官方说明另列公共地理数据来源。沿用已有实践素材，未下载大型数据库备份 |
Chinook 的音乐目录源于 iTunes，客户与员工使用虚构信息，销售数据由生成器产生。它是教学样例，不能据此解释真实市场表现。项目说明
Jaffle Shop 选用 jaffle_shop_duckdb，其三个原始数据文件为 raw_customers.csv、raw_orders.csv、raw_payments.csv。数据入口 官方说明这个项目用于测试和自包含演示，其中部分实现不代表生产最佳实践。
| 资料 | 优先阅读的内容 | 怎么配合已有资料 |
|---|---|---|
| PostgreSQL SQL 教程 | 表查询、JOIN、聚合 | 不熟悉 SQL 的读者先补这些基础，再看 DSL；概念可迁移，语法按所用数据库调整 |
| DuckDB SQL Introduction | 关系表和基础 SQL 操作 | 作为另一个简洁的 SQL 入门入口；使用 DuckDB 做独立练习时再按官方说明准备环境 |
| dbt Semantic models | 实体、维度、时间与指标的建模思路 | 与 Foggy TM/QM 做概念对照，帮助读者理解不同语义层方案；两者配置语法分别查各自文档 |
| MCP Architecture overview | AI 应用、客户端、服务器、工具发现与调用 | 接在自己的自然语言到 DSL 案例之后阅读，理解工具接入层；实际请求格式需匹配客户端和服务端协议版本 |
这四项是公开可阅读的官方教程，本次以原文链接和中文导读的形式使用，未复制整章到资料包。代码项目、数据集和网站教程的授权分别核对；网站能公开访问，并不自动表示整篇可改写后再分发。
数据库约 1.02 MiB，包含 11 张表。只读核对结果为 59 个客户、412 张账单、2240 条账单明细和 3503 条曲目。账单日期范围是 2009 年 1 月 1 日至 2013 年 12 月 22 日；账单金额合计与明细金额合计均为 2328.60。
资料中尚未创建该样例的 Foggy TM/QM。直接打开 SQLite 可先做 SQL 练习；通过 Foggy 问数时，再按选定版本接入数据源并建立相应语义模型。
第一轮用 Chinook 讲清筛选、汇总、关联和复核，再回到已有销售下降案例。希望理解业务系统接入的读者，继续读 WWI 系列；希望比较指标建模方法的读者，再看 Jaffle Shop 与 dbt。
每份资料记录来源、适合读者、练习目标和版本。第三方内容保留作者归属；新增中文导读和练习题单独维护，方便后续更新。