胶囊:查询表格数据
SemDB中的胶囊机制可以用来创建定制化的外部API,并通过HTTP接口接受外部请求。本教程展示一个胶囊的最基础应用:查询表格数据。
在这一教程中,我们接续 《数据操作基础教程(一)》 ,从一个已经完成数据导入的快照开始操作,如下所示。
点击左侧导航栏第六个按钮,进入胶囊编辑页面。
直接点击上方第二个栏目进入微型表格栏。
点击加号按钮,创建新的微型表格并填写名称。
然后调整表格的基础信息和结构,我们这里选择作为胶囊输入,然后表格结构如下所示。
保存后,再创建一个新的微型表格作为输出,其表格结构如下所示,编辑后再次保存。
接下来,切换到操作栏(上方第四个栏目)。
添加一个胶囊操作,填写名称并选择类型为对微型表格进行赋值。
选择该胶囊操作,然后设置其赋值目标为MiniTableA。
点击右侧的铅笔按钮,然后填写操作的查询语句,最后保存。
点击下方加号按钮,将我们刚编写的操作添加入胶囊操作列表里。
切换到部署栏,首先点击对钩按钮对胶囊进行编译,然后我们对胶囊进行测试,在左侧输入一个合法的胶囊输入,然后点击试运行,应该可以在右侧看到预期的输出。
点击右侧上方对胶囊进行部署,填写胶囊名称,然后提交。
最后我们在外部尝试调用胶囊API。我们首先进行一些用户权限的设置,点击左侧导航栏倒数第二个按钮,进入设置页面,选择权限管理,添加 guest 用户组。
在 guest 用户组内创建一个 guest 用户,密码为空即可,设置其为外部可见。
最后前往访问权限管理,设置 Dir 目录可被 guest 用户组访问。
在完成这些设置之后,我们即可在外部尝试调用胶囊API,这里使用Python语言作为示例。
可以看到API被成功调用。胶囊访问权限的详细介绍参见 《胶囊:权限设置》