更新数据库

使用influxctl database update命令来更新您在InfluxDB Cloud Dedicated集群中的数据库。

1. 如果您还没有，下载并安装 influxctl CLI。

2. 在你的终端中，运行 influxctl database update 命令并提供以下内容:

   • 数据库名称
   • 可选: 数据库 保留期限。默认是无限的 (0)。
   • 可选: 数据库 表（测量）限制。默认为 500。
   • 可选: 数据库 列限制. 默认值是 250.

influxctl database update \
  --retention-period 
30d
 \
  --max-tables 
500 \
  --max-columns 250 \
  
DATABASE_NAME

在您的命令中替换以下内容：

• DATABASE_NAME: 你的 InfluxDB Cloud 专用 数据库

数据库属性

• 保留期语法
• 数据库命名限制
• InfluxQL DBRP 命名约定
• 表和列的限制

保留期限语法（influxctl CLI）

使用 --retention-period 标志来定义 保留期限 对于数据库。 保留期限值是由一个数值 加一个时间单位组成的时间持续值。 例如， 30d 表示30天。 零持续时间（例如， 0s 或 0d）的保留期限是无限的，数据不会过期。 保留期限值不能是负数或包含空格。

1. 在您的终端中，使用 cURL 向以下 InfluxDB Cloud 专用端点发送请求：

   POST https://console.influxdata.com/api/v0/accounts/ACCOUNT_ID/clusters/CLUSTER_ID/databases

   在URL中提供以下凭据：

   • ACCOUNT_ID: 集群所属的账户的ID (查看如何列出集群详情)。
   • CLUSTER_ID: 您要管理的集群的ID(查看如何列出集群详情)。
   • DATABASE_NAME: 您想要删除的数据库的名称(查看如何列出数据库)。

   提供以下请求头：

   • Accept: application/json 以确保响应体是JSON内容
   • Content-Type: application/json 表示请求体是JSON内容
   • Authorization: Bearer 和一个 管理 API 令牌 用于你的集群 (请参阅如何 创建管理令牌 以进行管理 API 请求).

   在请求体中，提供要更新的参数：

   • 可选: 数据库 保留期限（以纳秒为单位）。 默认值为 0（无限制）。
   • 可选: 数据库表（测量）限制。默认为 500。
   • 可选: 数据库列限制。默认是 250。

   指定 PATCH 请求方法。

以下示例展示了如何使用管理API来更新数据库：

curl \
  --location "https://console.influxdata.com/api/v0/accounts/
ACCOUNT_ID
/clusters/
CLUSTER_ID
/databases/
DATABASE_NAME
" \
  --request PATCH \
  --header "Accept: application/json" \
  --header 'Content-Type: application/json' \
  --header "Authorization: Bearer 
MANAGEMENT_TOKEN
" \
  --data '{
    "maxTables": 
500
,
    "maxColumnsPerTable": 
250
,
    "retentionPeriod": 
2592000000000000
  }'

在您的请求中替换以下内容：

• ACCOUNT_ID: 创建数据库的 InfluxDB Cloud Dedicated 账户 的 ID
• CLUSTER_ID: 要为其创建数据库的 InfluxDB Cloud Dedicated cluster 的 ID
• MANAGEMENT TOKEN: 为您的 InfluxDB Cloud Dedicated 集群的 管理令牌
• DATABASE_NAME: 你的 InfluxDB Cloud 专用 数据库

数据库属性

• 保留期语法
• 数据库命名限制
• InfluxQL DBRP 命名约定
• 表和列的限制

保留期语法（管理 API）

使用 retentionPeriod 属性来指定 保留期 用于数据库。 保留期值是一个整数 ()，表示以纳秒为单位的时间。 例如， 2592000000000 表示 30 天。 零 (0) 保留期是无限的，数据将不会过期。 保留期值不能为负数或包含空格。

示例保留期值

• 0: 无限/无
• 259200000000000: 3天
• 2592000000000000: 30天
• 31536000000000000: 1 个标准年 (365 天)