Reference

Settings

Dory 设置分为两层:每个用户的本地工作流偏好,以及团队共享的操作规范。搭建 Dory SQL 工作区或编写 onboarding 文档时,可以参考本页。

SQL 编辑器设置

设置可选项默认值影响
Editor themeAutoGitHub LightGitHub DarkVS LightVS DarkAutoMonaco 编辑器的颜色和对比度。
Font familyMonacoMenloConsolasJetBrains MonoFira CodeSource Code ProCustomMonacoSQL 可读性和对齐效果。
Font size122412编辑器字号。
Line height1.12.21.5SQL 行间距。
Line numbersOnOffOn是否显示行号。
MinimapOnOffOff是否显示 Monaco minimap。
Word wrapOnOffOn长 SQL 是否自动换行。
FoldingOnOffOn是否允许折叠 SQL 代码块。
Query limit100200500100020005000200查询预览和分析工作流的默认返回行数。

应用主题设置

Dory 还提供应用级颜色主题:

分组主题
DefaultDefault、Blue、Green、Amber、Liquid
ScaledDefault Scaled、Blue Scaled、Liquid Scaled
MonospacedMono Scaled

团队演示、共享屏幕或培训时,建议选择克制、对比清晰的主题。主要工作流是密集 SQL 和表格扫描时,可以选择 Monospaced 变体。

Query limit 建议

场景建议限制
Schema 探索100200
Dashboard 原型200500
数据质量检查5001000
类导出检查确实需要时再用 20005000

较低的限制能让 Dory 响应更快,也能减少意外大扫描。做聚合分析时,优先在 SQL 里 GROUP BY,不要只靠提高结果行数。

Connection 设置

不同数据库驱动的连接表单会有差异,但团队通常应该统一以下规则:

范围建议
命名名称里体现环境和用途,例如 prod-analytics-readonly
凭据分析连接使用只读数据库账号。
Host 访问Docker 部署时,确认容器内部可以访问数据库 Host。
本地文件SQLite 和 DuckDB 使用绝对路径;Docker 中挂载包含文件的目录。
SSL按数据库提供商要求配置 SSL,不要为了方便关闭校验。

AI 设置

AI 行为由部署时选择的提供商和模型控制。详细说明见 AI Providers

团队使用时建议明确:

  • 已批准的提供商和模型。
  • 哪些环境允许使用 AI 功能。
  • Prompt 中是否允许出现生产 Schema 名称。
  • 执行 AI 生成 SQL 前的审核要求。

Saved Query 设置

Saved Queries 最适合配合团队命名和目录规范使用。

约定示例
按业务域加前缀billing - monthly revenue
写清统计粒度orders - daily count
有歧义时包含数据库对象warehouse.users - active users
单独放置草稿drafts / migration checks

推荐团队默认值

  • 新用户默认 Query limit 保持 200
  • Onboarding 和演示时保持 Word wrap 开启。
  • 共享连接使用只读凭据。
  • 可复用 SQL 保存成 Saved Query,不要只分享截图。
  • 执行 AI 生成 SQL 前先审查,尤其是 Join 和 Filter 条件。

这篇文档有帮助吗?