ESQL_TVF()

使用 ESQL_TVF() 表函数在 MatrixOne 查询中通过 ES|QL 查询 Elasticsearch 集群。结果结构由第二个参数在运行时提供,连接来自 esql_tvf_connect() 句柄或 @esql_tvf_config 会话变量。

描述

ESQL_TVF(esql, schema, conn) 向 Elasticsearch 集群发送 ES|QL 查询,并把结果行作为表返回。

语法

SELECT * FROM esql_tvf(esql, schema, conn) t;

参数

参数

说明

esql

发送给集群的 ES

schema

描述结果列的 JSON schema 规格,或为 NULL 表示每行一个无结构单 JSON 数组列。

conn

来自 esql_tvf_connect(config) 的句柄,或为 NULL 表示使用 @esql_tvf_config 提供的默认连接。

连接管理

SET @h = esql_tvf_connect('{"addresses":["https://es:9200"],"username":"elastic","password":"..."}');
SELECT esql_tvf_disconnect(@h);

SET @esql_tvf_config = '{"addresses":["https://es:9200"]}';

esql_tvf_connect(config) 打开(或复用)连接并返回确定性句柄。esql_tvf_disconnect(handle) 分离并关闭连接。当配置省略或为 NULL 时,使用 @esql_tvf_config 提供的默认连接。

示例

SELECT * FROM esql_tvf('FROM logs-* | WHERE status >= 500 | LIMIT 10', '{"cols":[{"name":"status","type":"int32"}]}', @h) t;

这些示例需要可访问的 Elasticsearch 集群,并非可直接粘贴执行的脚本。

相关参考