Source: https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/ddl/ttl/alter/
Documentation version: v5.3.2

# ALTER TTL

`ALTER TTL`语句根据边类型修改特定图上边的 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 子句中的指定为准。若均未使用，则报错。

Note

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

## 前提条件

- 边必须已经设置了 TTL 时长。更多信息，请参见 [CREATE TTL](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/ddl/ttl/create/)。
- 若要修改 TTL 时长，必须是图的所有者，或具备在图上执行`ALTER`操作的权限，或具备在当前 Schema 执行`ALTER ANY GRAPH`操作的权限。更多信息，请参见[角色与权限](https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authorization/)。

## 语法

语法图源码

 alter_ttl_statement  

````
alter_ttl_statement ::=
    'ALTER' 'TTL' 'ON' 'EDGE' edge_type_name '(' property_name ')'  ttl_duration

````

## 参数

### `edge_type_name`

待修改 TTL 时长的边类型的名称。

### `property_name`

现有 TTL 时长所设置的边类型的属性的名称。

### `ttl_duration`

指定新 TTL 时长的时间段。该时间段取值必须大于 0 并使用函数[`duration()`](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/fe/functions/temporal/#duration)以天、小时、分钟、秒、毫秒或微秒为单位指定。

## 示例

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

### 修改边类型的 TTL 时长

````
USE movie ALTER TTL ON EDGE Watch(ttl_test) duration({seconds:4, milliseconds:5, microseconds:6})

````

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