Deepnote
在协作笔记本中使用 Python、SQL 和 AI 分析数据。
Deepnote 是结合 Python、SQL 和可视化模块的数据工作区，可连接数据、用 AI 辅助生成查询，在同一笔记本中分析结果并分享仪表盘或数据应用。
可以用来完成：汇总销售指标、清理表格、制作可筛选周报。
Deepnote 能做什么
分析从数据结构与业务口径开始。AI 能使用数据库 schema 和笔记本上下文生成或修改查询，分析者仍要检查关联键、时间范围及分母。
SQL 结果既可完整载入 DataFrame，也可先用 Query preview 读取有限行。先分清预览与完整数据，才能避免把样本结果当成全部统计。
连接数据并执行 SQL
SQL blocks 可查询数据库、数据仓库或表格文件，选择数据源和结果变量后执行，结果可用于后续分析。
用 AI 生成与解释查询
在 SQL block 中描述目标或提出修改，AI 根据可见 schema 与上下文生成查询，也可解释现有查询或辅助修复错误。
组合代码与图表模块
笔记本能组织 Python、SQL、文本和 Chart 等模块，把数据处理、解释和可视化放在一条可重跑流程中。
把分析发布为数据应用
将笔记本整理为仪表盘或数据应用，添加输入让观看者选择条件，并控制分享范围。
打开 Agent 辅助分析
Deepnote Agent 可围绕笔记本执行多步数据任务，创建或修改模块、运行代码并查看结果；发起前应明确数据范围和检查标准。
- 核心用途
- SQL 与 Python、AI 查询辅助、图表和可分享应用。
- 可完成的工作
- 汇总销售指标、清理表格、制作可筛选周报。
- 如何开始
- 连接获准数据源或导入 CSV，再建立 SQL block。
- 使用条件
- 查询生成依赖 schema 访问；预览模式和全量结果须区分。
可以完成哪些工作
按你的目标查看准备资料、操作方法和交付结果。
核对每周销售增长附口径说明的销售周报笔记本。
适合：业务分析师
- 准备什么
- 订单表、退款规则、业务时区与周起止定义。
- 怎么完成
- 连接数据源，在 SQL block 说明口径并生成查询；审阅关联和过滤后运行，以 Python 或图表呈现本周及上周结果。
- 完成后得到什么
- 附口径说明的销售周报笔记本。
- 交付前检查
- 核对退款、重复订单、时区和增长率分母；先用小样本手算再接受自动查询。
清理多个 CSV 后制作汇总可重跑的清洗流程和汇总数据。
适合：运营分析人员
- 准备什么
- 授权导出的 CSV、统一列名、日期与金额格式、去重键。
- 怎么完成
- 导入文件，用 DataFrame SQL 或 Python 统一格式并去重，保留处理前后行数，在图表模块检查异常。
- 完成后得到什么
- 可重跑的清洗流程和汇总数据。
- 交付前检查
- 核对空值、编码、币种和去重损失；预览行数不能代替全量核对。
制作团队可筛选的指标页面可访问的指标应用或待发布评审版本。
适合：数据产品负责人
- 准备什么
- 已确认指标查询、允许观看的人员范围及筛选参数。
- 怎么完成
- 先运行完整笔记本检查依赖，再选择需展示的指标与图表，添加输入并按权限分享应用。
- 完成后得到什么
- 可访问的指标应用或待发布评审版本。
- 交付前检查
- 用不同筛选值核对结果与权限，确认不会通过应用暴露不该共享的数据。
如何使用 Deepnote
- 准备数据与口径
明确问题、数据权限和字段含义，连接数据源或上传可处理的文件。
- 建立 SQL block
选择数据源和结果变量，在 AI 入口说明要查询的表、日期与聚合规则。
- 审阅并运行分析
检查查询后执行，根据需要选择完整 DataFrame 或 Query preview，再用后续代码或图表处理。
- 重跑并整理交付
从上到下运行笔记本，处理错误后分享分析或应用；记录指标口径和适用范围。
界面与操作参考
开始前需要了解
AI 查询需要数据库结构
SQL AI 需要读取 schema；新增表后可能要刷新结构，官方文档还列出部分 federated auth 集成不支持 SQL AI。
Query preview 不是完整结果
预览模式只返回前 100 行并保留查询供后续引用，不能直接用预览表代表完整分布或总数。
模块顺序影响计算结果
整本运行按从上到下执行，遇到错误会停止；分享前需核对变量依赖与最新输出。
账号权限、费用与可用功能请以官方入口的当前说明为准。重要结果应先检查，再用于实际工作。
常见问题
不连接数据库能分析 CSV 吗？
可以。SQL blocks 能读取 CSV 等表格文件，也可查询已有 DataFrame；使用前检查类型与字段。
生成的 SQL 会按数据库方言调整吗？
官方 SQL AI 会结合连接的集成和 schema 生成相应查询，但仍需审阅语法、关联键与业务含义。
为何只看到了 100 行？
可能正在使用 Query preview，它先读取有限行；需要全量处理时确认输出模式和资源需求。
能把笔记本变成给同事看的页面吗？
可以发布为仪表盘或数据应用并添加输入，分享前应检查访问范围与筛选后的数据。
从新手学习与入门角度评估Deepnote
把新手学习与入门需要的条件列清楚，再比较工具。阅读本页的产品用途、步骤与限制，再逐项确认下面的问题；这些是选型方法，不表示每款工具都具备同样能力。
从熟悉任务开始
选择你能判断结果好坏的小任务，便于发现偏差。
输入是否容易准备
文字粘贴即可开始时，不必先学习复杂的连接与部署。
结果是否能检查
要求清晰格式，保留不确定内容和需要你确认的问题。
选择一个小样任务，先检查结果与交付格式，再决定是否用于更多资料。
