【分享】SQL 查询生成器及使用说明（quicker 动作）

0 动作下载

思源 SQL 生成器 - 动作信息 - Quicker (getquicker.net)

1 主要功能

• 通过选项设置，自定义 SQL 查询语句
• 收藏 SQL 查询语句，通过收藏列表快速调用
• 收藏列表的编辑功能

2 查询示例

　　查询 5 个随机、未完成任务：

　　查询当前文档相关的未完成任务：

　　‍

　　查询日记中提到“思源笔记”的块：

　　查询标签为“测试”的文档：

　　查询笔记中所有未下载的网络图片：

3 自定义 SQL 查询语句

　　目前主要有四组配置，都是选填，如果没有填写任何选项直接点确定，会查询 3 条随机记录。

　　配置完成后，点击确定按钮在当前光标处嵌入一个 SQL 块。需要让光标在一个空白块内。

3.1 查询范围

　　查询范围设置采用下拉选择方式，目前可查询如下范围：

• 反链
• 日记
• 文档
• 文档及其反链
• 笔记本

3.1.1 反链

　　在指定块的反链中查询指定内容，通过定义块 ID 进行指定，可以直接填写“当前文档”。

　　思源的文档与块的粒度是统一的，所以也可以填写块 ID。

　　若果仅填写一个定义块 ID，相当于在这个块的反链面板中进行查询。

　　如果定义块 ID 数量大于 1，则可以设置多个定义块之间的关系：

• 交集
  在所有指定定义块的共同反链中查询。比如定义块 ID 是主题 A 和主题 B，则查询范围是块 1
• 并集
  在所有指定定义块的各自的反链中查询。比如定义块 ID 是主题 A 和主题 B，则查询范围是块 1、块 2、块 3、块 4、块 5、块 6（块 6 是块 5 的子块）
• 父子
  仅能填写两个 ID，前一个 ID 为父块，后一个 ID 为子块。比如定义块 ID 是主题 A 和主题 B，则查询范围是块 5、块 6（块 6 是块 5 的子块）；块 4 是父块，块 5 是子块，查询范围是子块。

3.1.2 笔记本

　　在指定笔记本中查询指定内容，通过填写笔记本 ID 指定，可以直接填写“当前笔记本”。

3.1.3 日记

　　在指定笔记本的日记中查询指定内容，通过填写笔记本 ID 指定，可以直接填写“当前笔记本”。

3.1.4 文档

　　在指定文档中查询指定内容，通过填写文档 ID 指定，可以直接填写“当前文档”。

　　勾选“及其子文档”后会查询指定文档及其子文档。

　　若填写多个 ID，是查询多个 ID 的并集。

　　思源的文档与块的粒度是统一的，所以也可以填写块 ID。若填写的是块 ID，则子文档是该块所在文档的子文档。

3.1.5 文档及其反链

　　在指定文档中及其反链中查询指定内容，通过填写文档 ID 指定，可以直接填写“当前文档”。

　　效果相当于同时查询文档内容及其反链面板内容。

　　填写多个 ID 的话，是各 ID 查询结果的并集。

3.2 查询内容

3.2.1 块类型

　　指定查询的块类型，如标题块、列表块、文档块、公式块等。

　　列表块、列表项块可指定列表类型：有序、无序、任务：

　　标题块可指定标题级别：一到六级

3.2.2 标签

　　会自动获取思源所有的标签，下拉选择。

　　注意，文档标签和块标签的查询语句不同。文档标签是通过文档顶部的“添加标签”设置的，需要设置块类型为“文档块”；块标签是直接在块中输入两个#设置的，不需要设置块类型。

3.3 查询结果

• 数量限制：用于限制结果数量

• 排序字段

  • 随机
  • 创建时间
  • 更新时间
  • 文档路径

• 排序方式

  • 升序
  • 降序

4 收藏列表

　　进行过一次查询后，会提示是否显示收藏列表。

　　收藏列表有如下选项：

• 自定义：进入自定义 SQL 查询功能
• 上次查询：使用上次查询的语句，“当前文档”、“当前笔记本”会自动根据本次运行情况进行更新。
• 其他：收藏的语句

　　在自定义 SQL 查询功能界面，点击“收藏当前配置”按钮，会将配置加入收藏列表，方便下次使用。

5 右键菜单

　　目前有 4 个菜单：

• 修改默认操作

  • 收藏列表模式：运行动作后显示收藏列表
  • 自定义模式：运行动作后直接进入自定义界面，不显示收藏列表

• 修改使用偏好

  • 标题模式：如果偏好使用标题进行层次划分，使用这个模式。在该模式下，查询反链时，会直接显示最外层的列表块，避免一炮三响问题。用标题划分层级的话，列表层级应该不会太多，直接显示最外层列表块应该影响不大。
  • 列表模式：如果偏好多级列表进行层次划分，使用这个模式。在该模式下，查询反链时，会显示最小层级的列表匹配项，但会存在一炮三响问题。

• 修改收藏列表
  可以对收藏列表项进行删除、编辑标题、手动排序等。
  

• 修改思源 API Token

6 使用 query 挂件　　‍

通过调用 query 挂件，将结果以表格方式呈现。

注意：

1. 需要先从集市安装 query 挂件
   
2. 复制块超链接的快捷键需要用默认的 ctrl+shift+h
   
3. 使用本动作在文档中插入 query 挂件后，需要手动点击 query 挂件按钮执行查询
   

6.1 从收藏列表使用 query 挂件

在收藏列表的选项上点击右键就可以使用 query 挂件进行查询

6.2 从自定义界面使用 query 挂件

点击自定义界面的“使用 query 挂件”按钮就可以使用 query 挂件进行查询