SQL_TVF()¶
使用
SQL_TVF()表函数在 MatrixOne 查询中查询外部 SQL 数据库。结果结构由第二个参数在运行时提供,连接来自sql_tvf_connect()句柄或@sql_tvf_config会话变量。
描述¶
SQL_TVF(sql, schema, conn) 向外部 SQL 数据库发送 SQL 语句,并把结果行作为表返回。连接按会话缓存,相同配置会被复用。
sql:原样发送给数据源的 SQL 文本。schema:描述结果列的 JSON schema 规格,或为NULL表示每行一个无结构单 JSON 数组列。conn:来自sql_tvf_connect(config)的句柄,或为NULL表示使用@sql_tvf_config提供的默认连接。
语法¶
SELECT * FROM sql_tvf(sql, schema, conn) t;
SELECT * FROM sql_tvf(sql, schema, NULL) t; -- default connection
SELECT * FROM sql_tvf(sql, NULL, conn) t; -- schema-less JSON-array mode
参数¶
参数 |
说明 |
|---|---|
|
发送给数据源的 SQL 文本。必须是字符串常量或绑定期可折叠的表达式。 |
|
JSON schema 规格 |
|
来自 |
schema 类型词汇表为 bool、int32、int64、float32、float64、timestamp、string。
连接管理¶
SET @h = sql_tvf_connect('{"driver":"mysql","dsn":"user:pass@tcp(host:port)/db"}');
SELECT sql_tvf_disconnect(@h); -- true; a second disconnect returns false
SET @sql_tvf_config = '{"driver":"mysql","dsn":"user:pass@tcp(host:port)/db"}';
sql_tvf_connect(config) 打开(或复用)连接并返回句柄。句柄按配置确定性生成,因此用相同配置重连会复用同一条目。sql_tvf_disconnect(handle) 分离并关闭连接。当配置省略或为 NULL 时,使用 @sql_tvf_config 提供的默认连接。支持的驱动为 mysql 与 postgres。
示例¶
-- typed schema mode
SELECT * FROM sql_tvf(
'select id, name from t order by id',
'{"cols":[{"name":"id","type":"int64"},{"name":"name","type":"string"}]}',
@h) x;
-- schema-less mode: one JSON-array column per row
SELECT * FROM sql_tvf('select id, name from t order by id', NULL, @h) x;
-- predicates are evaluated by MatrixOne on the returned rows
SELECT count(*) AS c FROM sql_tvf('select id, name from t', '{"cols":[{"name":"id","type":"int64"}]}', @h) x WHERE x.id > 2;
这些示例需要可访问的外部 SQL 数据库,并非可直接粘贴执行的脚本。