使用Notebook在线开发和调试代码

本章节详细介绍使用Notebook开发任务的操作指导。

前提条件

已创建Notebook实例并且已启用（状态为运行中）。创建Notebook实例的操作请参见创建Notebook实例。

约束条件

一个用户在当前工作空间最多能创建10个Notebook。
当前仅支持MRS Spark、Fabric SQL两种数据类型。
用户只能使用自己创建的Notebook实例进行Notebook作业开发。

开发Notebook

在数据开发主界面，单击右下角的Notebook实例名称，在页面可以看到所有的Notebook实例名称，单击所需要的Notebook实例名称，在数据开发页面中间栏的作业目录树下方，会显示Notebook环境目录树。

Notebook环境目录仅用户自己可见。
右键单击“我的文件”，单击“新建Notebook”，弹出“新建Notebook”界面。输入文件名称，选择Notebook保存路径。
- 文件名称仅支持中英文、数字、中划线、下划线和点号。Notebook文件名称不能超过64个字符。
- 保存路径默认我的文件。
- 单击或者右键单击“我的文件”，可以创建文件夹，并在文件夹下，右键单击“新建Notebook”。
  - 文件夹名称仅支持中英文、数字、中划线和下划线。文件夹名称的总长度不能超过64个字符。
  - 文件所属路径 + 文件名称的总长度不能超过768个字节。
图1 新建Notebook
单击“确定”，完成Notebook文件创建，同时打开Notebook开发界面。
进入Notebook开发界面后，输入开发代码并进行调试。您可以在右上角选择所需要的计算引擎。
- 系统默认为Python引擎，不依赖计算资源。
- 同时，支持设置以下两种不同类型的计算引擎：Fabric SQL、MRS Spark。单击默认的Python引擎，可以看到已创建的计算引擎的信息，可以选择您所需要的计算引擎。一个Notebook文件当前仅支持一个计算引擎，选择计算引擎以后，该Notebook文件下的所有单元格使用这一个计算引擎。
- 不同的计算引擎，需要绑定所需的计算资源。绑定计算资源请参见绑定计算资源。
- 魔法命令支持如下命令格式：%mrs_spark，%%spark，%aura_frame。
单击“保存”，保存已开发的代码。
单击，选择“运行单元格”，会运行整个单元格的代码，运行完成后，显示运行成功，查看执行结果。如果代码执行失败，可以在执行结果中查看可能失败的原因。
```
%spark info
```
图2 执行结果示例1
```
%%spark
spark.sql("SHOW TABLES").show()
```
图3 执行结果示例2
```
a = "123111" * 2
print(a)
a = "12311" * 3
print(a)
a = "123eee" * 5
print(a)
a = "123aa1122" * 2
print(a)
a = "123absg3wut235456&&&" * 2
print(a)
```
图4 执行结果示例3

图5 执行结果示例4
- 每个开发单元格右上方会显示Python。
- 支持全部运行（运行全部单元格）、保存（保存全部单元格）、提交到项目目录、新建单元格（新建一个单元格）、清除运行结果（清除全部单元格）、更多（重启内核、关闭内核）等操作。右侧开发代码最上方的功能按钮都是针对整个 Notebook文件进行批量操作的。
- 支持复制单元格、粘贴单元格、剪切单元格、在上方添加一个单元格、在下方添加一个单元格、上移、下移、清除运行结果等操作。
- Notebook支持对单元格内的部分代码运行调试。选择部分代码，单击，选择“运行选中文本”，可以运行选中的代码。还支持以下两种方式运行代码。
  - 选择“运行上方所有单元格”，可以运行当前单元格上方所有单元格。
  - 选择“运行此单元格及以下”，可以运行此单元格及以下所有的单元格。
- ：删除单元格，删除当前的单元格。
- ：开发代码窗口最大化。窗口最大化后，仅能看见当前的单元格。
- ：开发代码窗口最小化。窗口最小化后，能看到所有的单元格。
- ，窗口最大化后，单击可以查看上一个单元格。
- ，窗口最大化后，单击可以查看下一个单元格。