#SQL 操作

#介绍

在一些特殊场景里，上面简单的数据表操作节点可能无法复杂的操作，则可以直接使用 SQL 节点，使数据库直接执行复杂的 SQL 语句进行数据操作。

与在应用外部直接连接数据库进行 SQL 操作的区别是，在工作流内可以使用流程上下文的变量，作为 SQL 语句中的部分参数。

#安装

内置插件，无需安装。

#创建节点

在工作流配置界面中，点击流程中的加号（“+”）按钮，添加“SQL 操作”节点：

#节点配置

#数据源

选择执行 SQL 的数据源。

数据源必须是数据库类型的，例如主数据源、PostgreSQL 类型等基于 Sequelize 兼容的数据源。

#SQL 内容

编辑 SQL 语句。目前仅支持一条 SQL 语句。

SQL 语句中可以使用流程上下文的变量，但需要使用 :variableName 的形式进行占位，例如：

SELECT * FROM users WHERE id = :userId;

#参数列表

在上述 SQL 语句中，:userId 就是一个占位符，占位符的替换需要在“参数列表”中进行配置。变量名称使用占位符中的名称，例如 userId，变量值可以使用变量选择工具选择流程上下文的变量。

#节点执行结果

自 v1.3.15-beta 起，SQL 节点执行的结果为一个纯数据组成的数组，在此之前是 Sequelize 原生返回包含查询元信息的结构（详见：sequelize.query()）。

例如以下查询：

select count(id) from posts;

在 v1.3.15-beta 之前的结果：

[
    [
        { "count": 1 }
    ],
    {
        // meta
    }
]

在 v1.3.15-beta 之后的结果：

[
    { "count": 1 }
]

#常见问题

#SQL 节点的结果如何使用？

如果使用了 SELECT 语句，查询结果会以 Seqeulize 的 JSON 格式保存在节点中，可以通过 JSON-query 插件进行解析并使用。

#SQL 操作是否会触发数据表事件？

不会。SQL 操作是直接将 SQL 语句发送到数据库进行处理，相关的 CREATE / UPDATE / DELETE 操作都发生在数据库中，而数据表事件发生在 Node.js 的应用层（ORM 处理），所以不会触发数据表的事件。