Source: https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/show/show-stats/
Documentation version: v5.3.2

# SHOW STATS

`SHOW STATS`命令显示特定图或临时图的统计信息。

可选择以下任意方法来指定图或临时图：

- 在本命令前添加 [USE 子句](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/dql/clauses/use-graph/)来设定工作图。
- 提前使用 [SESSION SET](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/sessions/set/) 设置当前会话的图或临时图。

若两种方法均使用，则以 USE 子句中的指定为准。若均未使用，则报错。

返回信息如下表：

 | 列 | 描述
 | `entry_name` | 条目的名称，可以是`Edge Total`、`Node Total`或点或边类型的名称。
 | `element_type` | 元素的类型，可以是`Node`或`Edge`。
 | `total_num` | 前两个计数展示指定图或临时图中点和边的总数，其余计数分别是指定类型的点或边的数量。

统计信息包括以下内容：

- 指定图或临时图中的点数量。
- 指定图或临时图中的边数量。
- 每种点类型对应点的数量。
- 每种边类型对应边的数量。

Note

对非默认 Schema 或其中的对象执行操作时，用户既要通过隐式访问规则或显式`USAGE`授权获得该 Schema 的访问权，也要具备目标操作所需的权限。Schema 访问校验和目标操作所需的权限校验相互独立，满足其中一项不能替代另一项。Schema 访问控制不适用于临时图、内置 Procedure 和内置 Function。更多信息，请参见 [Schema 访问控制](https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authorization/schema-access-control/)。

## 前提条件

- 如需获取指定图的统计信息，必须提交一个作业来生成统计信息。
- 如需获取临时图的统计信息，必须先创建临时图。更多信息，请参见 [CREATE TEMPORARY GRAPH](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/ddl/graph-projection/create/)。

## 语法

语法图源码

 show_stats_command  

````
show_stats_command ::=
    'SHOW' 'STATS'  

````

## 示例

以下示例基于[示例数据集](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/overview/example-dataset/)。

### 显示指定图的统计信息

1. 

提交一个作业以生成图`movie`的统计信息。

````
SUBMIT JOB STATS movie

````

返回：

````
+--------+
| job_id |
+--------+
| 1      |
+--------+

````

2. 

查看作业是否完成。

````
SHOW JOB 1

````

返回：

````
    +---------+----------------+------------+-----------------------------+-----------------------------+
    | task_id | state          | service_id | dispatch_time               | end_time                    |
    +---------+----------------+------------+-----------------------------+-----------------------------+
    | 1       | TASK_SUCCEEDED | 2          | 2025-09-15T08:21:10.961000Z | 2025-09-15T08:21:10.968000Z |
    +---------+----------------+------------+-----------------------------+-----------------------------+

````

当状态为`TASK_SUCCEEDED`时，作业完成。更多信息，请参见 [SHOW JOB](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/show/show-jobs/)。

3. 

显示图`movie`的统计信息。

````
USE movie SHOW STATS

````

返回：

````
+------------+--------------+-----------+
| entry_name | element_type | total_num |
+------------+--------------+-----------+
| Node Total | Node         | 4589      |
| Edge Total | Edge         | 10175     |
| Actor      | Node         | 3312      |
| Director   | Node         | 183       |
| User       | Node         | 569       |
| Movie      | Node         | 245       |
| Genre      | Node         | 280       |
| Act        | Edge         | 3732      |
| Direct     | Edge         | 249       |
| Watch      | Edge         | 3910      |
| WithGenre  | Edge         | 2284      |
+------------+--------------+-----------+

````

### 显示临时图的统计信息

````
'''
// 创建临时图
CREATE TEMPORARY GRAPH IF NOT EXISTS #movie_temporary_graph AS COPY OF movie
// 显示临时图的统计信息
USE #movie_temporary_graph SHOW STATS
'''

````

返回：

````
+------------+--------------+-----------+
| entry_name | element_type | total_num |
+------------+--------------+-----------+
| Node Total | Node         | 4589      |
| Edge Total | Edge         | 10175     |
| Actor      | Node         | 3312      |
| Director   | Node         | 183       |
| User       | Node         | 569       |
| Movie      | Node         | 245       |
| Genre      | Node         | 280       |
| Act        | Edge         | 3732      |
| Direct     | Edge         | 249       |
| Watch      | Edge         | 3910      |
| WithGenre  | Edge         | 2284      |
+------------+--------------+-----------+

````