---
source_url: https://docs.dolphindb.cn/zh/funcs/g/getStreamingSQLStatus.html
fetched_at: 2026-05-19T09:26:08Z
category: funcs
title: getStreamingSQLStatus
sha1: 0416b063edb868ab683c8307c7c06e6bf5c6365b
---

# getStreamingSQLStatus

首发版本：3.00.4

## 语法

`getStreamingSQLStatus([queryId])`

## 详情

查看流式 SQL 查询的运行状态。

- 若指定 *queryId*，则返回该查询的状态。
- 若不指定 *queryId*，返回当前用户注册的所有流式 SQL 查询的状态。如果调用者是管理员（admin），则返回所有用户注册的流式 SQL
  查询的状态。

## 参数

**queryId** 可选参数，字符串标量，表示已注册的流式 SQL 查询 ID。

## 返回值

一个表，包含如下字段：

- queryId：流式 SQL 查询的 ID。
- user：注册该查询的用户名。
- registerTime：注册该查询的时间。
- status：当前查询的状态，取值包括：
  - SQL\_REGISTERED：已注册，未运行。
  - SQL\_RUNNING：正常运行中，结果实时更新。
  - SQL\_STOPPED：已暂停。
  - INTERNAL\_ERROR：运行异常。
- sqlQuery：流式 SQL 查询的语句。
- involvedTables：查询涉及的表。
- lastErrorMessage：最近一次错误的信息（如有）。

## 例子

```dolphindb
t=table(1..10 as id,rand(100,10) as val)
share t as st
declareStreamingSQLTable(st)
registerStreamingSQL("select avg(val) from st","sql_avg") 

// 查看流式 SQL 查询的状态
getStreamingSQLStatus("sql_avg")
```

| queryId | user | registerTime | status | sqlQuery | involvedTables | lastErrorMessage |
| --- | --- | --- | --- | --- | --- | --- |
| sql\_avg | admin | 2025.08.09 03:33:40.781 | SQL\_REGISTERED | select avg(val) from st | st |  |

**相关函数：**[declareStreamingSQLTable](../d/declareStreamingSQLTable.html), [registerStreamingSQL](../r/registerStreamingSQL.html)
