Excel Python插件EFunction，六个魔法函数

EFunction插件，支持将Python jupyter嵌入Excel环境，为便于Python和Excel之间数据互动，EFunction插件提供6个魔法函数。

1. %ef_get 读取Excel表格数据入Python环境
2. %ef_set 将Python环境下数据导入到Excel表格之中
3. %ef_clear 清空Excel指定表格区域数据
4. %ef_conn 设置数据库链接
5. %%ef_sql SQL查询脚本
6. %ef_vba Python自定义函数，VBA注入

%ef_get

例如下图，希望将Excel表格数据载入到jupyter环境内，可以使用%ef_get函数。函数结果为一个dataframe（如果是一列数据，函数结果为series数据）

函数结果为dataframe，可以将结果赋给一个变量。

%ef_get函数只有两个参数：

• 1）、获取数据的表格名称，默认情况下提取活动表格
• 2）、提取数据选区，默认情况下，提取可选数据区域

上图案例，即提取当前活动表格，整个表格选区数据。

如果想获取指定表格，指定选区数据。可以指定参数。

-s 表名称，案例将提取Sheet8表格内数据

-a 选区区域，使用Excel引用地址方式，案例A1:C10，表示提取10行，3列数据，选区第一行为标题行

%ef_set

该函数功能和%ef_get函数完全相反，该函数可以将Python环境内dataframe、list、series三种数据类型数据导入到Excel表格之中。例如上文最后获取到的data数据，使用该魔法函数后，函数将data数据导出到Excel或动Sheet表格之中。

%ef_set 函数总共三个参数：

• 1）、待导出的数据变量名称
• 2）、导出数据表格名称，如果不设置该参数，数据会导出到当前活动Sheet表格之中
• 3）、导出数据区域，默认情况下位表格A1单元格开始

上图案例，将脚本更改为%ef_set -s Sheet10 -a b5 data

-s 表个名称，表示结果将存入Sheet10表格

-a 选区区域，表示结果将存入b5单元格开始位置

*注意：%ef_set函数为宏函数，执行完成后，将覆盖Excel表格原有数据，请谨慎操作。

%ef_clear

上图案例数据，如果想将选区内指定区域数据删除，可以使用该函数。

上图之中Sheet10表格，B5至D14选区内数据删除，完整脚本为：

%ef_clear -s Sheet10 -a b5:d14

%ef_clear函数只有两个参数：

• 1）、清除数据的表格名称，-s为命令标记，缺省时，表示活动表格
• 2）、清除数据选区，-a 为命令标记，缺省时表示整个选区

%ef_conn 和%%ef_sql

这两个魔法函数，通常成对使用。

%ef_conn 应用于数据库连接，例如下图案例，设置连接本地sqlite数据库。大家可以根据自己实际需求设置自己的数据库。

%%ef_sql魔法函数，后面跟着查询结果dataframe，如果查询有结果，会将结果存入其后方参数之中。

该函数为cell级别函数，只能够位于cell第一行，这点需要注意。

从第二行开始均为SQL查询脚本。

该函数只支持查询操作，不支持其他操作。

%ef_vba

当使用EFunction jupyter开发自己的自定义函数时，使用该模仿命令，生成调用com服务vba脚本。

关于如何利用EFunction jupyter开发自己的自定义函数，后续将安排详细案例介绍如何开发和定义。

注意了：

这些函数默认情况下，能够正常使用，如果提示jupyter没有这些魔法函数。可以到Excel内右键：my jupyter-》刷新环境。

刷新环境后，再使用该函数