TiDB Markdown Plugin - 在你的Markdown文档中运行一个真实的数据库示例

imiskolee · · 1186 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

TiDB Markdown Plugin

Repo: https://github.com/imiskolee/tidb-wasm-markdown
一款可以让TiDB运行在Markdown中的插件。

背景

周三看到朋友圈在疯狂的刷 TiDB - Wasm 这个有意思的东西(让数据库运行在浏览器里?TiDB + WebAssembly 告诉你答案)。
这的确是一件让人兴奋的工作成果,为WASM的应用提供了不错的思路。就这个项目本身而言也是有很大的价值。

我们在编程语言学习的时候,有诸如JSFiddleGo Playground等很多不同的交互性环境可以使用,并且可以将这些环境内嵌到教学文章之中,形成了交互性的教学资料。但是在
数据库的文章之中,只能是纯粹的纸上谈兵,读者很难进行直观的感受与实操。

相比较而言,纯粹的编程语言的交互环境对于服务端资源消耗是可控的,成本也是可以承担得起的。数据库不一样,一个简单的索引优化的示例数据可能就需要GB级别的内存占用以及更大的CPU消耗,成本上难以承受。而TiDB WASM版本的出现,解决了这一个问题 --
因为是在客户端构建环境,环境成本由对应的读者承担。基于这个前提,我想到的就是可以把TiDB WASM版本作为数据库的Play Ground环境嵌入到Markdown中进行交互。

实施过程

  • 直接从 http://play.pingcap.com 中把相关资源下载,分析了程序的处理流程(稍后将介绍插件的工作原理)。这个过程有个有意思的发现,在部署的时候,WASM程序被伪装成了main.css这个名字,这个让我花费了几分钟。我觉得这个伪装的目的仅仅是为了复用Nginx的压缩缓存策略。
  • 寻找一款Markdown解析器可以方便的内嵌自定义标签。 最终通过半小时的搜索与学习,定位到了markdown-it以及markdown-it-container这两项工作。

    • 这款解析器必须是前端可以工作的。
    • 这款解析器必须支持插件系统。
  • 花费了1个小时学习了markdown-it的API与markdown-it-container的源码与工作原理。
  • 开始进行Demo验证阶段。
  • 进行了简单的代码重构,进行了简陋的封装。
  • 开发了Example程序
  • 感谢来自社区的朋友JinSong对Example进行了基本重构,稍微好看了一点。

工作原理

tidb-markdown.png

使用方法


::: tisql        SELECT * FROM USERS;
| 固定tag内容     | sql 内容 |

详情见demo程序。

问题

  1. 目前已知在Chrome环境容易崩溃。
  2. WASM程序体积较大,需要进行tiny处理。
  3. 目前仅支持一个文档单个数据库实例(基于性能考量)
  4. 还需要定义好的Markdown定义方法来描述数据库的交互行为。

有疑问加站长微信联系(非本文作者)

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

1186 次点击  
加入收藏 微博
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传