该数据库分为六个版本,此版本官网文档链接InfluxDB Cloud Serverless
文章为此版本翻译
当前目录:
管理组织
组织(organization)是用户的一组workspace,所有的仪表盘,任务,buckets,成员等,都属于组织。一个账户可以有多个组织。你可以在一个账户里用组织来区分数据,环境,团队,数据来源和地区等。
管理API tokens
InfluxDB API tokens 可以确保数据库在与外界工具或应用交互时的安全。API token属于指定的用户,用来标识用户在组织里的权限。
学习如何创建、浏览、更新或删除API token
API token 类型
All-Access API token
授权对组织中所有资源的完全读写访问。
Custom API token
自定义权限,授权对组织中特定资源读或写,或二者都有的权限。
管理buckets
创建bucket
你可以使用InfluxDB官网页面,或使用influx命令,还可以使用InfluxDB HTTP API 来创建一个bucket。
bucket命名规则
- 必须包含两个及以上字符
- 不能以下划线_开头
- 不能包含双引号"
命名在组织中必须是唯一的,当你发送查询或写入等操作时,InfluxDB服务会根据你请求中的bucket名称和token安全令牌来找到组织中的对应bucket。
表和列限制
在InfluxDB中,每个bucket中的表和列是有上限的。最大表数量:500 最大列数量:200。每个表里头的一条数据,都由时间、字段、和标签表示。
写入时自动生成bucket
进行以下操作时InfluxDB 可以在你写入时自动创建DBRP映射和bucket:
- 用v1版本/write写入时
- 从InfluxDB 1.x向现版本迁移时
DBRP
保留规则Retention Rules指定bucket的保留期,同时定义了你能写进bucket里的最早时间戳(比如设置保留一天内的数据,你不能写入前天的数据),bucket会拒绝早于保留期的数据,默认保留期是infinite--数据永不过期。
要规定保留期,设置retentionRules.everySeconds属性为一个秒数,0代表infinite,这个值不能为负数或包含空格。
管理显式bucket schemas
不要搁InfluxDB v3里头使用显式schema!
在InfluxDB 2.x,显式schema的buckets可以指定列的数据类型,防止不符合预期的数据被写入。
写入有效schemas
当创建schema列文件时应遵循以下规则:
1.使用有效的数据列名:
- 在schema中唯一
- 长度1到128个字符
- 只包含Unicode字符
- 不能以下划线开头
- 不能以数字开头
- 不能包含单引号和双引号
2.包含一个时间戳列
3.最少有一个字段(field)类型
bucket schema 错误解决
bucket not found
创建和更新bucket schema时需要有对应bucket的写入权限
如果你的token没有写入权限就会报这个错
failed to create measurement
bucket中的每条数据都有一个schema,如果你尝试给一个已经存在的数据创建schema就会报这个错
write错误解决
InfluxDB返回错误还可能因为以下的原因:
- 写入请求没有遵守或定义schema
- 写入请求的bucket不存在schema定义
- 无效语法