创建数据库

使用influxctl database create命令在您的InfluxDB Cloud Dedicated集群中创建数据库。

1. 如果您还没有，下载并安装 influxctl CLI，然后为您的集群 influxctl 配置连接配置文件。

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

   • 可选: 数据库 保留期限 默认是 无限 (0).
   • 可选: 数据库表（测量）限制。默认为 500。
   • 可选: 数据库列限制。默认是 250。
   • 可选: InfluxDB 标签用于分区模板。限制为总共 7 个标签或标签桶。
   • 可选: InfluxDB 标签桶 用于分区模板。限制为总共 7 个标签或标签桶。
   • 可选: 一个Rust strftime日期和时间字符串 用于指定分区模板中的时间格式，并确定 按时间分区的时间间隔。默认为%Y-%m-%d。
   • 数据库名称 (请参见 数据库命名限制)

influxctl database create \
  --retention-period 
30d
 \
  --max-tables 
500 \
  --max-columns 250 \
  --template-tag 
TAG_KEY_1
 \
  --template-tag 
TAG_KEY_2
 \
  --template-tag-bucket 
TAG_KEY_3
,
100
 \
  --template-tag-bucket 
TAG_KEY_4
,
300
 \
  --template-timeformat '%Y-%m-%d' \
  
DATABASE_NAME

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

• DATABASE_NAME: 你的 InfluxDB Cloud 专用 数据库
• TAG_KEY_1, TAG_KEY_2, TAG_KEY_3, 和 TAG_KEY_4: tag 键来自您的数据

数据库属性

• 数据库属性
  • 保留期语法（influxctl CLI）
  • 自定义分区（influxctl CLI）
• 数据库属性
  • 保留期语法 (管理API)
  • 自定义分区 (管理API)
  • 数据库命名限制
  • InfluxQL DBRP 命名约定
  • 表和列的限制

保留期限语法（influxctl CLI）

使用 --retention-period 标志来定义 保留期 用于数据库。 保留期值是由数字值和时间单位组成的时间持续值。 例如， 30d 意味着 30 天。 零持续时间 (0d) 的保留期是无限的，数据不会过期。 保留期值不能是负数或包含空格。

自定义分区（influxctl CLI）

InfluxDB Cloud Dedicated 允许您为每个数据库定义自定义分区策略。分区是存储在Apache Parquet格式中的数据的逻辑分组，在 InfluxDB 3 存储引擎中。默认情况下，数据按天分区，但根据您的架构和工作负载，自定义分区策略可以提高查询性能。

使用 --template-tag、--template-tag-bucket 和 --template-timeformat 标志来定义用于生成数据库分区键的分区模板部分。

获取更多信息，请参见 Manage data partitioning.

此示例使用 cURL 发送管理 HTTP API 请求，但您可以使用任何 HTTP 客户端。

1. 如果您还没有，请按照说明 安装 cURL 到您的系统。

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

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

   在URL中提供以下凭据：

   • ACCOUNT_ID: 集群所属的账户的ID (查看如何列出集群详情).
   • CLUSTER_ID: 您想要管理的集群的ID (查看如何列出集群详情).

   提供以下请求头：

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

   在请求体中提供以下参数：

   • 可选: 数据库 保留期限（以纳秒为单位）。 默认值为 0（无限制）。
   • 可选: 数据库表（测量）限制。默认为 500。
   • 可选: 数据库列限制。默认是 250。
   • 可选: InfluxDB 标签用于分区模板中。限制为最多 7 个标签或标签桶。
   • 可选: InfluxDB 标签桶用于分区模板。总限制为7个标签或标签桶。
   • 可选：一个支持的 Rust strftime 日期和时间字符串，用于指定分区模板中的时间格式，并确定按时间间隔进行分区。默认值是 %Y-%m-%d。
   • 数据库名称 (见 数据库命名限制).

以下示例演示如何使用管理 API 创建具有自定义分区的数据库：

curl \
   --location "https://console.influxdata.com/api/v0/accounts/
ACCOUNT_ID
/clusters/
CLUSTER_ID
/databases" \
   --request POST \
   --header "Accept: application/json" \
   --header 'Content-Type: application/json' \
   --header "Authorization: Bearer 
MANAGEMENT_TOKEN
" \
   --data '{
     "name": "'
DATABASE_NAME
'",
     "maxTables": 
500
,
     "maxColumnsPerTable": 
250
,
     "retentionPeriod": 
2592000000000
,
     "partitionTemplate": [
       {
         "type": "tag",
         "value": "
TAG_KEY_1
"
       },
       {
         "type": "tag",
         "value": "
TAG_KEY_2
"
       },
       {
         "type": "bucket",
         "value": {
           "tagName": "
TAG_KEY_3
",
           "numberOfBuckets": 
100
         }
       },
       {
         "type": "bucket",
         "value": {
           "tagName": "
TAG_KEY_4
",
           "numberOfBuckets": 
300
         }
       },
       {
         "type": "time",
         "value": "%Y-%m-%d"
       }
     ]
   }'

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

• ACCOUNT_ID: 创建数据库的 InfluxDB Cloud Dedicated 账户 的 ID
• CLUSTER_ID: 要为其创建数据库的 InfluxDB Cloud Dedicated cluster 的 ID
• MANAGEMENT TOKEN: 为您的 InfluxDB Cloud Dedicated 集群的 管理令牌
• DATABASE_NAME: 你的 InfluxDB Cloud 专用 数据库
• TAG_KEY_1, TAG_KEY_2, TAG_KEY_3, 和 TAG_KEY_4: tag 键来自您的数据

数据库属性

• 数据库属性
  • 保留期语法（influxctl CLI）
  • 自定义分区（influxctl CLI）
• 数据库属性
  • 保留期限语法（管理API）
  • 自定义分区（管理API）
  • 数据库命名限制
  • InfluxQL DBRP 命名约定
  • 表和列的限制

保留期语法（管理 API）

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

示例保留期值

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

自定义分区（管理 API）

InfluxDB Cloud Dedicated 让您为每个数据库定义自定义分区策略。 一个 分区 是在 InfluxDB 3 存储引擎中以 Apache Parquet 格式存储的数据的逻辑分组。默认情况下，数据按天进行分区， 但是，根据您的架构和工作负载，自定义分区策略可以提高查询性能。

使用 partitionTemplate 属性定义一个用于生成数据库分区键的分区模板部分数组。

获取更多信息，请参见 Manage data partitioning.