操作步骤
选择菜单栏“作业开发”,选择作业列表中某一作业,点击“编辑”,进入编辑作业页面。
开发
“作业开发”提供一套完整的SQL在线编辑器,主要包括编辑区域、工具栏、版本管理、高级设置。
说明:
- 同一个作业支持多个输入端和一个输出端,输入端和输出端的创建数据表的DDL语句相同,具体请参考DDL语句。
语法检查
用户在编辑SQL过程中,编辑器对当前作业内容进行自动保存,保存时会触发语法检查的功能,如果关键字、数据类型、格式存在错误时,会自动在编辑区域的左侧显示出错误信息,提示用户及时修正。
说明:当作业存在语法错误时,无法进行作业调试、发布。
智能提示
编辑作业过程中,编辑器对数据类型、关键字、数据资源类型等内容进行智能提示,选择提示中的某个内容,点击回车键自动补全提示内容。
快捷键
编辑器提供如下表所示的快捷键,分别包括window和mac系统的快捷键,提高用户的编辑效率。
功能项 | windows | Mac |
---|---|---|
保存当前代码 | Ctrl+S | Command+S |
撤销上一次操作 | Ctrl+Z | Command+Z |
重做上一次操作 | Ctrl+Shift+Z | Command+Shift+Z |
查找字符 | Ctrl+F | Command+F |
复制选中内容 | Ctrl+C | Command+C |
粘贴 | Ctrl+V | Command+V |
剪切选中内容 | Ctrl+X | Command+X |
格式优化 | Alt+Shift+F | Option+Shift+F |
工具栏
工具栏包括保存、另存为、格式优化、语法校验、调试、发布、高级设置。
- 保存:对编辑区域、高级设置的内容进行保存。
- 另存为:将当前已编辑的内容(包括编辑区域、高级设置)作为一个新作业进行保存,点击后出现弹出框,填写内容的要求同创建作业。
- 格式优化:点击后,对编辑区域的SQL语句进行缩进、对齐等变化。
- 语法校验:对SQL语义逻辑进行检查,需要通过语法校验后才可进入到调试环节。
版本管理
用户最多可以保存10个已发布的历史版本。版本管理包括对比、回滚、删除操作。
- 点击工具栏中的“作业版本”,弹出已保存的作业版本列表。
-
选择一个版本,点击“对比”,进入到版本对比页面,默认显示该版本与当前版本对比。
-
点击弹出框底部的“进行回滚”,可以将该版本的作业代码进行回滚,替换掉当前版本的代码。
说明:
- 只能针对“当前版本”进行回滚操作,在左侧切换版本后,回滚操作按钮不可点击。
- 点击弹出框左上角“当前版本”右侧的下拉框,切换作业版本,进行作业内容的对比。
高级设置高级设置主要是提供作业中使用的kafka证书的上传与管理,用户在使用阿里消息服务作为输入端或者输出端时,需要上传kafka的证书文件。
调试
点击工具栏中“调试”按钮,对当前作业进行调试。
-
添加测试数据,添加方式包括上传csv文件、手动录入两种方式。
- 上传csv:csv文件中的字段需要跟输入端数据表中的字段(包括字段顺序)保持一致。
- 手动录入:用户根据输入框中提示的字段类型输入相应类型的测试数据。
- 点击“执行调试”,开始执行作业调试。
-
在页面底部查看调试日志和调试结果。
- 调试日志:动态加载作业在调试过程中的运行日志,用户可以在这里查看报错信息。
- 调试结果:调试运行成功后,展示出作业输出的结果。
发布
- 在弹框中,填写CU资源值。根据实际业务中流式数据量的大小来为该作业分配资源数量。
-
点击“发布”,进行发布该作业。
说明:
- 1CU支持的并发数为1,如需多并发,用户可以增加CU数量,例如并发数为3,分配资源时,CU数量设置成3。
- 发布时,如果当前线上版本处于运行的状态,需要重启作业后,本次发布的作业内容才生效。