Microsoft Fabric中Jupyter Notebook的%run条件执行方案问询

问题核心 #

在Fabric环境中，通过%run NOTEBOOK_1让多个笔记本共享add函数，但由于执行顺序不固定，需要确保函数可访问的同时，避免重复执行NOTEBOOK_1的内容。现有方案存在中断调用笔记本、操作繁琐或命名空间不共享的问题，寻求比.whl打包更轻量的替代方案。

优化方案 #

方案1：在共享笔记本内检查函数定义并跳过后续单元格 #

无需修改调用端逻辑，仅在NOTEBOOK_1的CELL_0添加判断，通过JavaScript魔术命令跳过剩余单元格执行（而非退出整个笔记本）：

# 检查目标函数是否已存在于全局命名空间
if 'add' in globals():
    print("函数add已定义，跳过NOTEBOOK_1后续单元格执行")
    # 用JavaScript命令跳过当前笔记本剩余单元格
    get_ipython().run_cell_magic('javascript', '', '''
        // 获取当前单元格索引，跳过所有后续单元格
        const currentIdx = Jupyter.notebook.get_selected_index();
        Jupyter.notebook.execute_cells([currentIdx + 1], 1);
        Jupyter.notebook.stop();
    ''')
else:
    print("函数未定义，执行NOTEBOOK_1后续单元格")

这样当add函数已存在时，NOTEBOOK_1仅执行CELL_0就停止后续单元格，不会中断调用它的笔记本。

方案2：调用端主动判断+参数传递控制执行 #

修改所有调用NOTEBOOK_1的笔记本（如NOTEBOOK_2），先检查函数是否存在，仅在不存在时带参数执行NOTEBOOK_1：

# 调用端先判断函数是否存在
if 'add' not in globals():
    %run NOTEBOOK_1 -e "run=True"

然后在NOTEBOOK_1的CELL_0添加参数解析和判断逻辑：

import sys

# 解析传递的参数，默认需要执行
run_required = True
for arg in sys.argv:
    if arg.startswith("-e"):
        # 执行参数中的赋值语句
        exec(arg.split("=")[1])

# 结合函数存在性判断，决定是否跳过后续单元格
if not run_required or 'add' in globals():
    print("无需执行，跳过NOTEBOOK_1后续内容")
    get_ipython().run_cell_magic('javascript', '', '''
        const currentIdx = Jupyter.notebook.get_selected_index();
        Jupyter.notebook.execute_cells([currentIdx + 1], 1);
        Jupyter.notebook.stop();
    ''')

此方案减少了不必要的%run调用，逻辑更清晰，但需要同步修改所有调用端。

方案3：将函数封装为Lakehouse脚本文件（推荐） #

利用Fabric Lakehouse的文件存储功能，将共享函数单独保存为.py文件，通过Python原生import复用：

1. 在Fabric Lakehouse的Files目录下创建utils.py文件，写入函数定义：

def add(a, b):
    return a + b

2. 在需要调用函数的笔记本（如NOTEBOOK_2）中导入该模块：

import sys
# 将Lakehouse Files目录添加到Python路径
sys.path.append("/lakehouse/default/Files/")
from utils import add

Python的模块缓存机制会确保模块仅被导入一次，后续导入不会重复执行文件内容，完全避免了%run带来的重复执行问题，且符合Python模块化开发规范，复用性更强。

方案对比 #

内容的提问来源于stack exchange，提问作者1zftqITss0