五分钟了解 DynoTable
DynoTable 是一款面向 AWS DynamoDB 的桌面工作台 —— 为每天查看和编辑 Dynamo 数据的工程师打造。它快速、键盘优先且本地化：你的凭证以及驱动自动补全的索引绝不会离开你的机器。
应用的整体结构
DynoTable 是一个包含三个区域的单一窗口。没有浮动面板，也没有模态层层叠加 —— 一切都有它唯一的归处。
- 侧边栏 —— 你打开的标签页和保存的文件夹，当前的 Profile 固定在底部。
- 标签页内容 —— 每个标签页一个打开的表，处于 Visual 或 PartiQL 模式。
- 标签页 —— 像浏览器一样打开表；用 ⌘⇧T 重新打开最近关闭的那个。
核心概念
- Profile —— 一组命名的 AWS 凭证。一个 Profile，多个区域，多张表。
- 标签页 —— 一个打开的表视图。筛选、选择和视图模式都是按标签页区分的。
- 查询模式 —— 你正在查询的索引：
PRIMARY，或某个命名的 GSI/LSI。 - 操作 —— 设置了哈希键筛选时是一次廉价的
query，否则是一次scan。
功能地图
DynoTable 按照本手册的组织方式来归类它的功能。
快速开始
处理数据
- 表与标签页 — 在 DynoTable 中浏览 DynamoDB —— 多标签页工作区、Visual 与 PartiQL 标签页模式、虚拟化的表格网格、页大小、列可见性，以及逐行的 Quick View。
- 编辑条目 — 在 DynoTable 中编辑 DynamoDB 条目 —— JSON 条目编辑器、Plain 与 DynamoDB-JSON 模式、只读的 Flow 图视图、schema 校验，以及通过暂存保存。
- 暂存与提交 — DynoTable 暂存区 —— 在每一次 DynamoDB 写入发出之前，将其作为逐属性的 diff 审阅，以安全的事务批次提交，并用乐观锁解决写入冲突。
- 导出 — 从 DynoTable 导出 DynamoDB 数据 —— CSV、JSON 和 NDJSON 格式，从当前页到完整匹配的范围、重命名列别名，以及能在标签页关闭和重新加载后继续的后台导出。
查询
- 筛选与查询模式 — DynoTable 中的筛选与查询模式 —— 每个标签页的筛选状态如何映射为 DynamoDB 的 query 与 scan、应通过哪个索引读取，以及可视化筛选胶囊如何构建键条件与扫描条件。
- PartiQL — DynoTable 中的 PartiQL 编辑器 —— 针对单张 DynamoDB 表编写 SQL 风格的查询和写入，配有模板、内联诊断、快速修复和流式结果。
- SQL Workbench — DynoTable 中的 SQL Workbench —— 跨 DynamoDB 表运行真正的 JOIN、GROUP BY 和聚合查询，配有一个让每条查询都保持在 DynamoDB 访问模式规则之内的编译器。
- Smart Table — DynoTable 中的 Smart Table —— 在可视化的 ER 画布上构建并保存的多表联接视图，配有 Configure 和 Data 模式、关系编辑和逐列重命名。
AI
- AI 聊天 — DynoTable AI 聊天 —— 一个智能助手，它读取你的 DynamoDB schema、编写 PartiQL 与 Workbench SQL，并将编辑暂存供你审阅。它运行在你自己的 AWS Bedrock 凭据上；内容涵盖聊天侧边栏、提升为标签页，以及 AI 设置（提供方、模型、知识、权限、隐私）。
- AI 工具 — DynoTable AI 助手能做什么，以及每项能力是如何受控的 —— 读取你的 schema 和数据、对整张表精确计算聚合、打开视图、通过审阅暂存写入，以及导出 —— 还包括哪些操作静默运行、哪些会先征求你的许可。
- MCP 服务器 — 通过一个本地 MCP 服务器，把 DynoTable 的工具暴露给 Claude Code、Codex 等外部 AI 智能体 —— 如何启用它、连接一个客户端、按连接设定的同意与作用域，以及安全模型。默认关闭；每个连接都需要你的批准，而你的 AWS 凭据绝不离开你的机器。
账户与许可
- 激活 DynoTable — 激活 DynoTable —— 一键 dynotable://activate 深链、粘贴令牌的备用方式，以及各种授权状态（试用中、已激活、只读）各自允许的操作。
- 设备 — DynoTable 的两台机器限制 —— Device ID 的工作原理、何时自动释放最旧的机器，以及如何从账户的设备页面停用一台机器。
参考
- 键盘快捷键 — 每一个 DynoTable 键盘快捷键，按用途分组 —— 导航、标签页、查询、条目编辑器、选区和行导航。显示的是 macOS 按键；在 Windows 和 Linux 上 ⌘ 变为 Ctrl。
- 设置 — DynoTable 设置的全景图 —— 全局的 Account、Appearance、Privacy 和 About 区域，加上按配置文件的侧栏（Connection、Personalization、AI binding、Models、Permissions、Knowledge、Activity、Danger zone），以及每一项控制什么。
- 故障排查 — 常见 DynoTable 问题的修复方法 —— 凭据与 SSO、空表与陈旧结果、只读写入、AI 未配置 —— 以及应用在 macOS、Windows 和 Linux 上如何自动更新。
- 术语表 — 用通俗易懂的语言定义文档中通篇使用的 DynamoDB 和 DynoTable 术语 —— 分区键、排序键、GSI、scan、PartiQL、暂存区等。