system.stream_status

引入或更新: v1.2.225

提供有关指定流状态的信息，生成单列结果 (has_data)，其值可以是 true 或 false：

• true: 表示流可能包含变更数据捕获记录。
• false: 表示流当前不包含任何变更数据捕获记录。

备注

结果中出现 true (has_data) 并不保证变更数据捕获记录的确定存在。其他操作，例如执行表压缩操作，也可能导致在没有实际变更数据捕获记录的情况下出现 true 值。

语法

SELECT * FROM STREAM_STATUS('<stream_name>');

示例

-- 创建一个包含列 'c' 的表 't'
CREATE TABLE t (c int);

-- 在表 't' 上创建流 's'
CREATE STREAM s ON TABLE t;

-- 检查流 's' 的初始状态
SELECT * FROM STREAM_STATUS('s');

-- 结果应为 'false'，表示初始没有变更数据捕获记录
┌──────────┐
│ has_data │
├──────────┤
│ false    │
└──────────┘

-- 向表 't' 插入一个值
INSERT INTO t VALUES (1);

-- 插入后检查流 's' 的更新状态
SELECT * FROM STREAM_STATUS('s');

-- 结果现在应为 'true'，表示存在变更数据捕获记录
┌──────────┐
│ has_data │
├──────────┤
│ true     │
└──────────┘