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)
参数¶
参数 |
说明 |
|---|---|
|
描述外部数据源的 JSON 字符串。SQL 连接携带 |
|
由对应 |
函数¶
函数 |
说明 |
|---|---|
|
打开或复用 SQL 连接并返回句柄。 |
|
分离并关闭 SQL 连接;成功返回 |
|
打开或复用 Elasticsearch 连接并返回句柄。 |
|
分离并关闭 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
这些示例需要可访问的外部数据源,并非可直接粘贴执行的脚本。