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

发送给数据源的 SQL 文本。必须是字符串常量或绑定期可折叠的表达式。

schema

JSON schema 规格 {"cols":[{"name":"...","type":"..."}, ...]} 或简化的位置规格。NULL 返回每行一个 JSON 数组列。

conn

来自 sql_tvf_connect(config) 的连接句柄,或为 NULL 表示默认连接。

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 数据库,并非可直接粘贴执行的脚本。

相关参考