文档

管理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 CLIInfluxDB API 创建DBRP映射。

DBRP组合只能映射到单个桶

每个唯一的DBRP组合只能映射到单个桶。如果您映射了一个已经映射到另一个桶的DBRP组合,它将覆盖现有的DBRP映射。

使用 influx v1 dbrp create 命令 将未映射的桶映射到数据库和保留策略。包括以下内容:

必须提供

  • * orgtoken 进行身份验证。我们建议在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
  • 请求体: 包含以下字段的JSON对象
    必须提供
    • * bucketID: 桶ID
    • * database: 数据库名称
    • default: 将提供的保留策略设置为数据库的默认保留策略
    • * orgorgID: 组织名称或 组织ID
    • * retention_policy: 保留策略名称
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 CLIInfluxDB 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 规范
  • 查询参数
    必须提供
    • * orgID: 组织 ID
    • bucketID: 桶 ID (列出特定桶的 DBRP 映射)
    • database: 数据库名 (列出具有特定数据库名的 DBRP 映射)
    • rp: 保留策略名称 (列出具有特定保留策略名称的 DBRP 映射)
    • id: DBRP 映射 ID (列出特定的 DBRP 映射)
查看所有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 CLIInfluxDB API 更新 DBRP 映射。

虚拟 DBRP 映射不能更新。要覆盖虚拟 DBRP 映射,请创建显式映射

使用 influx v1 dbrp update 命令 更新 DBRP 映射。包括以下内容

必须提供

  • * orgtoken 进行身份验证。我们建议在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 架构
  • 路径参数
    • * id: 要更新的 DBRP 映射 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 CLIInfluxDB API 删除 DBRP 映射。

虚拟 DBRP 映射不能被删除。

使用 influx v1 dbrp delete 命令 删除 DBRP 映射。包括以下内容

必须提供

  • * orgtoken 进行身份验证。我们建议在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}

包括以下内容:

必须提供

  • 请求方法: PATCH
  • 头部
    • * 授权: 使用您的 InfluxDB API 令牌Token 架构
  • 路径参数
    • * id: 要更新的 DBRP 映射 ID
  • 查询参数
curl --request DELETE \
  https://127.0.0.1:8086/api/v2/dbrps/00oxo0X0xx0XXoX0?orgID=00oxo0oXx000x0Xo \
  --header "Authorization: Token YourAuthToken"

这个页面有帮助吗?

感谢您的反馈!


Flux的未来

Flux将进入维护模式。您无需修改代码即可继续像现在一样使用它。

了解更多

InfluxDB v3增强功能和InfluxDB集群版现已全面上市

新增功能,包括更快的查询性能和管理工具,推进了InfluxDB v3产品线。InfluxDB集群版现已全面上市。

InfluxDB v3的性能和功能

InfluxDB v3产品线在查询性能方面取得了显著提升,并提供了新的管理工具。这些增强包括一个操作仪表板来监控您的InfluxDB集群健康状态,InfluxDB云专享版中的单点登录(SSO)支持,以及针对令牌和数据库的新管理API。

了解v3的新增强功能


InfluxDB集群版全面上市

InfluxDB集群版现已全面上市,为您在自管理的堆栈中提供InfluxDB v3的强大功能。

与我们讨论InfluxDB集群版