influx bucket create
influx bucket create
命令在 InfluxDB 中创建一个桶。
用法
influx bucket create [flags]
标志
标志 | 描述 | 输入类型 | 映射到 ? | |
---|---|---|---|---|
-c | --active-config | 用于命令的 CLI 配置 | 字符串 | |
--configs-path | influx CLI 配置路径(默认 ~/.influxdbv2/configs ) | 字符串 | INFLUX_CONFIGS_PATH | |
-d | --description | 桶描述 | 字符串 | |
-h | --help | 关于 create 命令的帮助 | ||
--hide-headers | 隐藏表头(默认 false ) | INFLUX_HIDE_HEADERS | ||
--host | InfluxDB 的 HTTP 地址(默认 https://127.0.0.1:8086 ) | 字符串 | INFLUX_HOST | |
--http-debug | 检查与 InfluxDB 服务器的通信。 | 字符串 | ||
--json | 以 JSON 格式输出数据(默认 false ) | INFLUX_OUTPUT_JSON | ||
-n | --name | 桶名称 | 字符串 | INFLUX_BUCKET_NAME |
-o | --org | 组织名称(与 --org-id 互斥) | 字符串 | INFLUX_ORG |
--org-id | 组织 ID(与 --org 互斥) | 字符串 | INFLUX_ORG_ID | |
-r | --retention | 桶保留数据的持续时间(0 为无限,默认为 0) | 持续时间 | |
--schema-type | 桶模式类型(explicit ,默认 implicit ) (仅限云服务)。有关更多信息,请参阅 管理桶模式。 | 字符串 | ||
--shard-group-duration | 桶分片组持续时间(仅限 OSS) | 字符串 | ||
--skip-verify | 跳过 TLS 证书验证 | INFLUX_SKIP_VERIFY | ||
-t | --token | API 令牌 | 字符串 | INFLUX_TOKEN |
保留期
最小保留期是 一小时。有效的 --retention
单位
- 纳秒(
ns
) - 微秒(
us
或µs
) - 毫秒(
ms
) - 秒(
s
) - 分钟(
m
) - 小时(
h
) - 天(
d
) - 周(
w
)
示例
身份验证凭证
以下示例假设您的 InfluxDB 主机、组织 和 令牌 由以下方式提供:要么是 活动 influx
CLI 配置,要么是环境变量(INFLUX_HOST
、INFLUX_ORG
和 INFLUX_TOKEN
)。如果您没有设置 CLI 配置或环境变量,请使用以下标志为每个命令包含这些必需的凭证
--host
:InfluxDB 主机-o, --org
或--org-id
:InfluxDB 组织名称或 ID-t, --token
:InfluxDB API 令牌
创建一个无限保留数据的桶
influx bucket create --name example-bucket
创建一个保留数据 30 天的桶
influx bucket create \
--name example-bucket \
--retention 30d
创建一个带有描述的桶
influx bucket create \
--name example-bucket \
--description "Example bucket description"
创建一个具有自定义分片组持续时间的桶
自定义分片组持续时间仅在 InfluxDB OSS 中受支持。分片组持续时间必须短于桶的保留期。有关更多信息,请参阅 InfluxDB 分片和分片组。
influx bucket create \
--name example-bucket \
--retention 30d \
--shard-group-duration 2d
创建一个具有显式模式的桶
influx bucket create \
--name my_schema_bucket \
--schema-type explicit
这个页面有帮助吗?
感谢您的反馈!