ALTER TAGGraph
ALTER TAG
语句可以修改Tag的结构。例如增删属性、修改数据类型,也可以为属性设置、修改Graph(Time-To-Live)。
前提条件Graph
- 登录的用户必须拥有对应权限才能执行
ALTER TAG
语句。详情请参见Graph。
- 确保要修改的属性不包含索引,否则
ALTER TAG
时会报冲突错误[ERROR (-8)]: Conflict!
。删除索引请参见Graph。
语法Graph
ALTER TAG <tag_name>
<alter_definition> [[, alter_definition] ...]
[ttl_definition [, ttl_definition] ... ]
[COMMENT = '<comment>'];
alter_definition:
| ADD (prop_name data_type)
| DROP (prop_name)
| CHANGE (prop_name data_type)
ttl_definition:
TTL_DURATION = ttl_duration, TTL_COL = prop_name
tag_name
:指定要修改的Tag名称。一次只能修改一个Tag。请确保要修改的Tag在当前工作空间中存在,否则会报错。
- 可以在一个
ALTER TAG
语句中使用多个ADD
、DROP
和CHANGE
子句,子句之间用英文逗号(,)分隔。
示例Graph
nebula> CREATE TAG t1 (p1 string, p2 int);
nebula> ALTER TAG t1 ADD (p3 int, p4 string);
nebula> ALTER TAG t1 TTL_DURATION = 2, TTL_COL = "p2";
nebula> ALTER TAG t1 COMMENT = 'test1';
修改Tag说明Graph
尝试使用刚修改的Tag可能会失败,因为修改是异步实现的。
NebulaGraph将在下一个心跳周期内完成Tag的修改,为了确保修改成功,可以使用如下方法之一:
- 在Graph语句的结果中查看Tag信息,确认修改成功。如果没有修改成功,请等待几秒重试。
- 等待两个心跳周期,例如20秒。
如果需要修改心跳间隔,请为Graph修改参数heartbeat_interval_secs
。
最后更新: October 22, 2021