管理DBRP映射
InfluxQL 需要数据库和保留策略(DBRP)组合才能查询数据。在 InfluxDB 2.7 中,数据库和保留策略已合并,并由 InfluxDB 存储桶 替代。要使用 InfluxQL 查询 InfluxDB 2.7,必须将指定的 DBRP 组合映射到存储桶。
自动 DBRP 映射
InfluxDB 2.7 会在以下操作期间自动为您创建DBRP映射:
有关更多信息,请参阅 数据库和保留策略映射。
虚拟 DBRP 映射
InfluxDB 2.7 为任何没有与它关联显式DBRP映射的桶提供“虚拟”DBRP映射。虚拟DBRP映射使用桶名称提供DBRP映射,可以不进行显式定义即可使用。
虚拟DBRP映射是只读的。要覆盖虚拟DBRP映射,请 创建显式映射。
有关虚拟DBRP映射如何创建的信息,请参阅 数据库和保留策略映射 – 创建桶时。
创建 DBRP 映射
使用 influx
CLI 或 InfluxDB API 创建DBRP映射。
DBRP组合只能映射到单个桶
每个唯一的DBRP组合只能映射到单个桶。如果您映射了一个已经映射到另一个桶的DBRP组合,它将覆盖现有的DBRP映射。
使用 influx v1 dbrp create
命令 将未映射的桶映射到数据库和保留策略。包括以下内容:
必须提供
- * org 和 token 进行身份验证。我们建议在influx CLI中将您的组织和令牌设置为您的活动InfluxDB连接配置,这样您就不必在每个命令中添加这些参数。要设置您的活动InfluxDB配置,请参阅
influx config set
。 - * 要映射的数据库名称
- * 要映射的保留策略名称
- * 桶ID 要映射到
- 默认标志 将提供的保留策略设置为数据库的默认保留策略
influx v1 dbrp create \
--db example-db \
--rp example-rp \
--bucket-id 00oxo0oXx000x0Xo \
--default
使用 /api/v2/dbrps
API端点 创建新的DBRP映射。
POST https://127.0.0.1:8086/api/v2/dbrps
包括以下内容:
- 请求方法:
POST
- 头部
- 授权: 使用您的InfluxDB API令牌 的
Token
规范 - 内容类型:
application/json
- 授权: 使用您的InfluxDB API令牌 的
- 请求体: 包含以下字段的JSON对象
必须提供
curl --request POST https://127.0.0.1:8086/api/v2/dbrps \
--header "Authorization: Token YourAuthToken" \
--header 'Content-type: application/json' \
--data '{
"bucketID": "00oxo0oXx000x0Xo",
"database": "example-db",
"default": true,
"orgID": "00oxo0oXx000x0Xo",
"retention_policy": "example-rp"
}'
列出 DBRP 映射
使用 influx
CLI 或 InfluxDB API 列出所有DBRP映射并验证您想要查询的桶是否已映射到数据库和保留策略。
使用 influx v1 dbrp list
命令 列出DBRP映射。
以下示例假设您的组织和API令牌由活动 InfluxDB连接配置 在 influx
CLI中提供。如果不是,请在每个命令中包含您的组织(--org
)和API令牌(--token
)。
查看所有DBRP映射
influx v1 dbrp list
按数据库筛选DBRP映射
influx v1 dbrp list --db example-db
按桶ID筛选DBRP映射
influx v1 dbrp list --bucket-id 00oxo0oXx000x0Xo
使用 /api/v2/dbrps
API 接口 列出 DBRP 映射。
GET https://127.0.0.1:8086/api/v2/dbrps
包括以下内容:
- 请求方法:
GET
- 头部
- 授权: 使用您的InfluxDB API令牌 的
Token
规范
- 授权: 使用您的InfluxDB API令牌 的
- 查询参数
必须提供
查看所有DBRP映射
curl --request GET \
https://127.0.0.1:8086/api/v2/dbrps?orgID=00oxo0oXx000x0Xo \
--header "Authorization: Token YourAuthToken"
按数据库筛选DBRP映射
curl --request GET \
https://127.0.0.1:8086/api/v2/dbrps?orgID=00oxo0oXx000x0Xo&db=example-db \
--header "Authorization: Token YourAuthToken"
按桶ID筛选DBRP映射
curl --request GET \
https://cloud2.influxdata.com/api/v2/dbrps?organization_id=00oxo0oXx000x0Xo&bucketID=00oxo0oXx000x0Xo \
--header "Authorization: Token YourAuthToken"
更新 DBRP 映射
使用 influx
CLI 或 InfluxDB API 更新 DBRP 映射。
虚拟 DBRP 映射不能更新。要覆盖虚拟 DBRP 映射,请创建显式映射。
使用 influx v1 dbrp update
命令 更新 DBRP 映射。包括以下内容
必须提供
- * org 和 token 进行身份验证。我们建议在influx CLI中将您的组织和令牌设置为您的活动InfluxDB连接配置,这样您就不必在每个命令中添加这些参数。要设置您的活动InfluxDB配置,请参阅
influx config set
。 - * 要更新的 DBRP 映射 ID
- 保留策略 名称要更新为
- 默认标志 将保留策略设置为数据库的默认保留策略
更新默认保留策略
influx v1 dbrp update \
--id 00oxo0X0xx0XXoX0
--rp example-rp \
--default
使用 /api/v2/dbrps/{dbrpID}
API 接口 更新 DBRP 映射。
PATCH https://127.0.0.1:8086/api/v2/dbrps/{dbrpID}
包括以下内容:
必须提供
- 请求方法:
PATCH
- 头部
- * 授权: 使用您的 InfluxDB API 令牌 的
Token
架构
- * 授权: 使用您的 InfluxDB API 令牌 的
- 路径参数
- * id: 要更新的 DBRP 映射 ID
- 查询参数
- * orgID: 组织 ID
- 请求正文(JSON)
- rp: 要更新的保留策略名称
- default: 将保留策略设置为数据库的默认保留策略
更新默认保留策略
curl --request PATCH \
https://127.0.0.1:8086/api/v2/dbrps/00oxo0X0xx0XXoX0?orgID=00oxo0oXx000x0Xo \
--header "Authorization: Token YourAuthToken"
--data '{
"rp": "example-rp",
"default": true
}'
删除DBRP映射
使用 influx
CLI 或 InfluxDB API 删除 DBRP 映射。
虚拟 DBRP 映射不能被删除。
使用 influx v1 dbrp delete
命令 删除 DBRP 映射。包括以下内容
必须提供
- * org 和 token 进行身份验证。我们建议在influx CLI中将您的组织和令牌设置为您的活动InfluxDB连接配置,这样您就不必在每个命令中添加这些参数。要设置您的活动InfluxDB配置,请参阅
influx config set
。 - * 要删除的 DBRP 映射 ID
influx v1 dbrp delete --id 00oxo0X0xx0XXoX0
使用 /api/v2/dbrps/{dbrpID}
API 接口 删除 DBRP 映射。
DELETE https://127.0.0.1:8086/api/v2/dbrps/{dbrpID}
包括以下内容:
必须提供
curl --request DELETE \
https://127.0.0.1:8086/api/v2/dbrps/00oxo0X0xx0XXoX0?orgID=00oxo0oXx000x0Xo \
--header "Authorization: Token YourAuthToken"
这个页面有帮助吗?
感谢您的反馈!