关于 jupyter-notebook
jupyter-notebook 是指导使用 Jupyter 命令执行 Notebook 的技能,涵盖本地 Python 和 Databricks 内核。它面向运行 Notebook 的用户,说明命令选项及所需的 Databricks 环境变量。
主要功能
- 01使用 Jupyter 执行 Notebook
- 02选择本地 Python 或 Databricks 内核
- 03设置执行超时
- 04将结果写回原 Notebook
- 05配置 Databricks 环境变量
适用场景
- 01使用本地 Python 内核运行 Notebook
- 02在 Databricks 集群上执行 Notebook
- 03选择超时和错误处理选项
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ i9wa4/ dotfiles --skill jupyter-notebook安装后在 Claude Code 中输入/jupyter-notebook确认已加载。
详细介绍
Jupyter Notebook 专家技能
本技能提供 Jupyter Notebook 执行指南。
1. Databricks Jupyter 内核
https://github.com/i9wa4/jupyter-databricks-kernel
uv pip install jupyter-databricks-kernel
uv run python -m jupyter_databricks_kernel.install
2. 默认执行方法
收到执行整个 Notebook 的指示时,请使用此命令:
uv run jupyter execute <notebook_path> --inplace --timeout=300
3. 使用 Databricks 内核执行
在 Databricks 集群上运行 Notebook 时:
uv run jupyter execute <notebook_path> --inplace --kernel_name=databricks --timeout=300
所需的环境变量:
DATABRICKS_HOST:Databricks 工作区 URLDATABRICKS_TOKEN:个人访问令牌DATABRICKS_CLUSTER_ID:集群 ID
4. 使用示例
# Execute with local Python kernel
uv run jupyter execute /workspace/notebooks/sample.ipynb --inplace --timeout=300
# Execute with Databricks kernel
uv run jupyter execute /workspace/notebooks/databricks-sample.ipynb --inplace --kernel_name=databricks --timeout=300
5. 选项说明
--inplace:使用执行结果覆盖原文件--kernel_name=<name>:指定要使用的内核(databricks、python3 等)--timeout=<seconds>:设置超时时间(秒;-1 表示不限时)--startup_timeout=<seconds>:内核启动超时时间(默认 60 秒)--allow-errors:即使发生错误,也继续执行直至结束
6. 注意事项
- 执行前请确认所需的环境变量已正确设置
- 对于运行时间较长的单元格,请调整
--timeout的值 - 如果在 VS Code 中打开,请确认文件已在执行后更新
- 对于 Databricks 内核,如果集群已停止,启动需要 5-6 分钟
7. 参考链接
- jupyter-databricks-kernel:https://github.com/i9wa4/jupyter-databricks-kernel
- Jupyter nbclient:https://nbclient.readthedocs.io/
评论
支持 Markdown