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

# SHOW TTLS

`SHOW TTLS`命令返回特定图的 TTL（存活时间，全称为 Time-to-live）设置信息。

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

- 在本命令前添加 [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 子句中的指定为准。若均未使用，则报错。

下表展示了返回的信息：

 | 列 | 描述
 | `type` | 设置了 TTL 时长的图元素的类型。目前，仅支持边类型。
 | `name` | 设置了 TTL 时长的边类型的名称。
 | `ttl_property` | 基于其设置了 TTL 时长的边类型的属性。
 | `ttl_duration` | 边的 TTL 时长。

Note

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

## 语法

语法图源码

 show_ttls_command  

````
show_ttls_command ::=
    'SHOW' 'TTLS'

````

## 示例

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

### 显示图的 TTL 设置

````
USE movie SHOW TTLS

````

上述示例返回了在 [CREATE TTL](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/ddl/ttl/create/) 中设置的 TTL 信息。

返回：

````
+------+-------+--------------+----------------------+
| type | name  | ttl_property | ttl_duration         |
+------+-------+--------------+----------------------+
| Edge | Watch | ttl_test     | P16DT18H12M4.005006S |
+------+-------+--------------+----------------------+

````