认识沙盒环境

本教程每个示例都可以直接运行：右上角是代码工作区，右下角是运行结果，右侧抽屉是示例数据预览。每个账号都有独立的工作区，互不干扰。

登录即开箱

• 登录后即可使用本教程所需的示例数据（如 book / book_store）；
• 你的运行操作只影响自己的工作区，数据改动后可以随时重置，不会影响其他账号。

工作区文件

工作区默认两个文件：

• infra/sql-client.ts（只读）——提供示例所需的 sqlClient，无需额外配置连接；
• main.ts（可编辑）—— 示例入口，模型、视图、查询都写在这里。每个文档页进入时自动预填当前节的示例 main；你手动改过后，切页不再覆盖。

运行与结果

点右上角「运行」按钮，完成后即可在结果面板查看 console 输出与耗时。

每次运行都会产生 SQL 追踪：ts-grm 生成的每条 SQL 及其参数都会显示出来——这是理解 ORM 行为的窗口，请善用它（例如第一次查询后你会看到 loadAssociation 的追加查询）。

数据库抽屉

右侧「数据库」抽屉展示当前页面示例涉及的表：

• 只读页（如本教程查询页）：表格只读展示，点开才拉数据（懒加载）；
• 写类页（后续「变更 API」一章）：表格可编辑，但只能改声明允许的表；
• 页面允许写；如需把写坏的数据复原，用页面提供的重置数据恢复示例状态。

使用边界

• 示例客户端已经准备好，通常不需要自行创建连接；
• 工作区只用于运行教程示例，请勿把敏感信息写入代码或输出。

下一步

环境讲完了，接下来进入快速上手：安装 → 模型 → 视图 → 查询四步，跑通你的第一个 ts-grm 示例。