Foreign Connection Functions

sql_tvf_connect/sql_tvf_disconnect 与 esql_tvf_connect/esql_tvf_disconnect 内置函数管理 sql_tvf、esql_tvf 与 ENGINE = SQL|ESQL 外部表使用的会话级外部连接缓存。单个会话最多缓存 16 个不同的连接。

描述

外部连接按会话缓存,直到显式断开或会话结束才释放。句柄由连接配置推导,因此用相同配置重连会复用缓存条目。会话结束时所有缓存连接都会被关闭。

语法

sql_tvf_connect(config)
sql_tvf_disconnect(handle)
esql_tvf_connect(config)
esql_tvf_disconnect(handle)

参数

参数

说明

config

描述外部数据源的 JSON 字符串。SQL 连接携带 driver(mysql 或 postgres)与 dsn;Elasticsearch 连接携带 addresses 及可选的凭据。

handle

由对应 *_connect 调用返回的连接句柄。它按配置确定性生成;把它传给对应的 *_disconnect 即可分离并关闭该连接。

函数

函数

说明

sql_tvf_connect(config)

打开或复用 SQL 连接并返回句柄。

sql_tvf_disconnect(handle)

分离并关闭 SQL 连接;成功返回 true,对同一句柄再次断开返回 false。

esql_tvf_connect(config)

打开或复用 Elasticsearch 连接并返回句柄。

esql_tvf_disconnect(handle)

分离并关闭 Elasticsearch 连接。

连接上限

一个会话最多缓存 16 个不同的外部连接。第 17 个不同的配置会被拒绝并报错,断开一个句柄会释放一个槽位。完全相同的配置中的空白差异会规范化到同一句柄,不会额外占用槽位。

使用说明

  • 句柄按配置确定性生成;相同配置的两个并发扫描复用第一个条目。

  • 连接绑定在会话所在的 CN 上,不会随连接迁移转移。

  • 断开外部表正在隐式使用的句柄会把它从缓存中移除;下一次扫描会重新连接。

示例

SET @h1 = sql_tvf_connect('{"driver":"mysql","dsn":"user:pass@tcp(host:port)/db"}');
SET @h2 = esql_tvf_connect('{"addresses":["https://es:9200"]}');

SELECT sql_tvf_disconnect(@h1);  -- true
SELECT sql_tvf_disconnect(@h1);  -- false

这些示例需要可访问的外部数据源,并非可直接粘贴执行的脚本。

相关参考