Apache Zeppelin动态表单功能详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00939/article/details/148487125

Apache Zeppelin动态表单功能详解

zeppelin Web-based notebook that enables data-driven, interactive data analytics and collaborative documents with SQL, Scala and more. 项目地址: https://gitcode.com/gh_mirrors/zeppelin1/zeppelin

什么是动态表单

Apache Zeppelin提供了一个强大的动态表单功能，允许用户在Notebook中创建交互式输入控件。这些表单可以基于不同的后端语言以两种方式创建：通过模板语法或编程API。动态表单极大地增强了数据分析的交互性和灵活性。

表单作用域

Zeppelin中的动态表单有两种作用域：

段落作用域(Paragraph Scope)：仅在当前段落有效
笔记作用域(Note Scope)：在整个笔记文档的所有段落中都有效

使用模板语法创建表单

这是最简单直观的创建方式，适用于Markdown、Shell、Spark SQL等后端语言。

文本输入框

使用${formName}语法创建文本输入框：

请输入您的姓名：${name}

设置默认值：

请输入您的姓名：${name=John}

密码输入框

使用${password:formName}语法创建密码输入框：

请输入密码：${password:pass}

下拉选择框

基本语法：

选择星期：${day=1,mon|tue|wed|thurs|fri|sat|sun}

设置显示名称与值分离：

选择星期：${day=1,1(星期一)|2(星期二)|3(星期三)...}

复选框

多选语法：

选择水果：${checkbox:fruits=apple|banana,apple|banana|orange}

自定义分隔符：

选择水果：${checkbox(:):fruits=apple:banana,apple:banana:orange}

自动执行控制

默认情况下，修改选择后会立即执行段落。如需禁用此功能：

点击段落右上角的设置图标
取消勾选"Run on selection change"选项
仍可通过按Enter键手动执行

笔记作用域表单

语法与段落作用域相同，但使用双$符号开头：

$${globalInput}

编程方式创建表单

某些后端语言(如Spark)提供了编程API来创建表单。

Scala示例

// 文本输入框
println("Hello "+z.textbox("name"))

// 带默认值的文本输入框
println("Hello "+z.textbox("name", "sun"))

// 密码框
println("Password is "+ z.password("my_password"))

// 下拉框
println("Hello "+z.select("day", Seq(("1","mon"), ("2","tue"), ...)))

// 复选框
val options = Seq(("apple","Apple"), ("banana","Banana"), ("orange","Orange"))
println("Hello "+z.checkbox("fruit", options).mkString(" and "))

Python示例

# 文本输入框
print("Hello "+z.textbox("name"))

# 带默认值的文本输入框
print("Hello "+z.textbox("name", "sun"))

# 密码框
print("Password is "+ z.password("my_password"))

# 下拉框
print("Hello "+z.select("day", [("1","mon"), ("2","tue"), ...]))

# 复选框
options = [("apple","Apple"), ("banana","Banana"), ("orange","Orange")]
print("Hello "+ " and ".join(z.checkbox("fruit", options, ["apple"])))