如何编写 SQL 连接器函数

如何编写 SQL 连接器函数

使用本指南将你的 Tulip 应用程序连接到 SQL 数据库。

下面举例说明如何使用 Tulip 的连接器功能连接 SQL 数据库。

添加新的 SQL 连接器

1- 将光标放在菜单栏的 "应用程序 "上，从下拉菜单中选择 "连接器"，进入 "连接器 "页面。

2- 点击屏幕右上方的 "添加连接器"，为连接器命名，并选择 "SQL "作为连接器类型。

3- 在新连接器的 "环境 "选项卡上，选择 "添加连接详细信息"。

4- 填写连接到数据库的相应详细信息：

• 运行在（"云连接器主机"，除非您设置了不同的设置）
• 类型
• 服务器
• 端口
• SSL （是或否）
• 数据库
• 用户名
• 密码

5- 单击 "测试 "按钮运行测试信号。如果成功，点击 "保存"。

6- 确保连接器主机可以访问数据库（连接器页面上服务器旁边的绿色 "在线 "标签表示）。

成功设置新连接器后，现在就可以创建连接器函数（Connector Functions），以便从外部数据库发送或检索数据。连接器函数必须使用目标数据库的相关语言编写。

要设置新的 SQL 连接器函数，请执行以下操作

1- 单击功能选项卡上的 "添加新功能 "按钮。

2- 给新函数命名（这样就可以在触发器中选择特定的连接器函数）。

1. 配置函数的输入和输出

在上面的示例中

输入

• 配置（文本）

输出

• 子配置_1
• 子配置 2
• 子配置 3

查询

`SELECT subconfig_1, subconfig_2, subconfig_3 FROM webinar 数据库 WHERE configuration = $configuration$ order by id desc limit 1`````

一个函数可以有多个输入和输出。要从 Tulip 应用程序发送/接收数据，至少需要一个输入或输出。

• 点击添加，添加新的输入或输出
• 给字段起一个可识别的名称
• 选择数据类型（如文本、布尔、整数等）
• 在查询字段中添加有效的 SQL 语句。请注意，输入变量名应以 $ 包装。例如
  $input$.
• 测试函数
• 如果函数有输入变量，请输入有效值
• 点击右上角的 "测试"。
• 在 "测试结果"部分查看测试结果或错误信息

1. 在某些情况下，您可能希望从 SQL 表中返回多条记录。为此，请选中 "返回多行 "旁边的复选框。这将返回一个包含对象的数组，其中每个对象都包含 SQL 表中一行的值。

查询

SELECT name, num from numbers where num > $number$

(在上面的示例中，number是输入值）

然后，添加输入并点击 "测试"，就可以在 "测试结果 "下看到所有预期返回的行。

这些结果可以作为触发器编辑器中的对象数组存储在变量中。

7- 完成后按 "保存"。

:::(Warning) (注意）保存函数后不能更改输入和输出。这是为了防止正在使用连接器功能的应用程序受到干扰。
:::

如果需要添加新的输入/输出，可以复制函数并在新函数中进行更改。

有关如何编写一些常用 SQL 函数的详细信息，请参阅"常用 SQL 连接器函数"。

进一步阅读

• 如何在应用程序中使用连接器函数的输出
• HTTP 连接器概述

找到您想要的了吗？

您还可以前往community.tulip.co发布您的问题，或查看其他人是否遇到过类似问题！