使用规范和建议

术语定义

• 规则：使用时必须遵守的约定。
• 建议：使用时必须考虑的约定。

名词解释

• RP：Retention Policy，即数据保留策略，包含数据保留时长，备份个数等信息。
• 数据对象：数据库、RP、MEASUREMENT、TAG、FIELD。

命名

• 规则
  1. 数据库对象的名称需要以小写字母开头，使用字母或者数字组合，长度不能超过32个字节。
  2. 数据库对象的名称长度：<数据库名>.<RP名称>.<MEASUREMENT名称> 总长度不能超过120个字符。
  3. 数据库对象的名称不能使用系统保留关键字。

     系统保留关键字详情如下：ALL,ALTER,ANY,AS,ASC,BEGIN,BY,CREATE,CONTINUOUS,DATABASE,DATABASES,DEFAULT,DELETE,DESC,DESTINATIONS,DIAGNOSTICS,DISTINCT,DROP,DURATION,END,EVERY,EXPLAIN,FIELD,FOR,FROM,GRANT,GRANTS,GROUP,GROUPS,IN,INF,INSERT,INTO,KEY,KEYS,KILL,LIMIT,SHOW,MEASUREMENT,MEASUREMENTS,NAME,OFFSET,ON,ORDER,PASSWORD,POLICY,POLICIES,PRIVILEGES,QUERIES,QUERY,READ,REPLICATION,RESAMPLE,RETENTION,REVOKE,SELECT,SERIES,SET,SHARD,SHARDS,SLIMIT,SOFFSET,STATS,SUBSCRIPTION,SUBSCRIPTIONS,TAG,TO,USER,USERS,VALUES,WHERE,WITH,WRITE,WARM

  4. 数据库对象的名称不能使用中文和特殊字符(["].$,/\0*?~#:|')。
  5. 数据库名称不能使用_internal、_kapacitor、_heimdall、_vision、opentsdb等系统使用的数据库名。
  6. TAG名称不支持更新和重命名。
• 建议
  1. TAG名称越短越好，每个TAG名称都有索引，索引都会在内存中，名字越短，越节省资源。
  2. TAG KEY和FIELD KEY命名不要相同。

TAG

• 规则
  1. 对其使用InfluxQL函数（MAX、MIN、COUNT等）的字段，作为FIELD存储。
  2. TAG只支持字符串类型，如果存储的值不是字符串类型，作为FIELD存储。
• 建议
  1. 使用TAG区分数据比使用MEASUREMENT名称区分性能更好。
  2. 根据需求设计TIME精度，精度越低性能越好。
  3. 经常作为查询条件的字段，作为TAG存储。
  4. 对其使用GROUP BY的字段，作为TAG存储。

FIELD

• 规则：每个FIELD类型必须保持一致。
• 建议：FIELD不宜太多，每个FIELD的计算都会单独计算，太多当执行模糊查询会导致查询失败。

查询

• 规则
  1. 禁止执行SELECT * FROM进行查询。
  2. 查询语句必须带上时间范围限制。
  3. 业务上线前，一定要对数据库进行性能压测，评估业务峰值场景下，对数据库的负载情况。
• 建议
  1. 执行查询时，只选择需要返回的字段，不需要的字段不要返回。
  2. 查询时间范围越小，查询性能越好。
  3. 查询时TAG值越精确查询性能越好。尽量是单时间线查询，即指定所有的TAG值，或者尽量指定越多的TAG值。
  4. 在查询中的group by time intervals后增加fill(none), fill(none)作用为：对于没有数据点的时间间隔，不返回任何时间戳和值。针对稀疏数据场景，能大幅降低查询返回结果数据量。
  5. 在使用嵌套查询时将时间范围的查询条件放在最外层的查询语句中。

删除

建议：禁止使用DELETE方法删除数据，建议根据需求设置合理的RP，通过RP自动删除数据。

其他方面

• 规则：根据业务具体时间线规模、客户端连接数、保留策略数量选择对应的实例规格，规格详情请参考数据库实例规格。

  超规格使用，可能会导致不可预知的问题；严重时有可能导致数据库不可用。

• 建议：使用ELB连接数据库，详情请参见通过负载均衡地址连接实例（推荐）。
• 注意：如果开启了冷存储，冷数据不支持写入。