动态与公告

产品动态

公告

产品简介

产品概述

系统架构

应用场景

关键概念

实例类型与规格

购买指南

产品定价

购买实例

续费说明

欠费说明

退费说明

快速入门

连接并写入数据

操作指南

访问管理

管理实例

自动备份

系统监控

库管理

账号管理

管理安全组

外网访问

InfluxQL 兼容性

数据库管理

Schema 查询

数据类型

数据查询

InfluxQL 函数

客户端

SDK 参考

influx CLI 客户端

API 文档

History

Introduction

API Category

Making API Requests

Instance APIs

Database APIs

Data Types

Error Codes

实践教程

数据表定义推荐

接入 Grafana 服务

接入 Telegraf 服务

性能白皮书

测试环境

测试工具

写入性能测试

查询性能测试

常见问题

词汇表

CTSDB 政策

隐私政策

数据处理和安全协议

联系我们

数据库管理

PDF

聚焦模式

字号

最后更新时间： 2025-04-29 23:05:44

时序数据库 CTSDB 3.0版默认兼容 开源 InfluxDB v1.7 版本。本章将说明时序数据库 CTSDB 3.0版创建数据库、下载数据并将数据写入数据库，对开源 InfluxDB V1.7 的兼容情况。
数据库管理
全新购买的时序数据库 CTSDB 3.0版实例没有数据库，需手动创建数据库。数据库的创建与删除相关命令使用语义请参见下表。其中，✅表示兼容 InfluxDB，❌表示不兼容。更多信息，请参见 Sample data。
命令
作用
兼容性
语义
CREATE DATABASE
创建一个新的数据库
✅
当前 CREATE DATABASE 仅支持配置如下参数，其它参数暂不支持。语义格式如下所示：
CREATE DATABASE <database_name> [WITH [DURATION <duration[默认无限制]>]]
database_name：指数据库库名。
DURATION：数据过期删除时间（TTL , Time To Live），单位：天，取值为非零整数，选填参数。如果不启用数据过期，不配置该参数，如需启用数据过期，该数据库中的数据达到过期时间后将被自动删除清理，请谨慎配置！例如 DURATION 180d，表示该数据库中的数据达到180天即过期自动删除。
创建一个名为 test_tsdb1 的数据库，该数据库的数据永久保留：CREATE DATABASE test_tsdb1。
创建一个名为 test_tsdb2 的数据库，该数据库启用数据过期，设置数据被保留30天：CREATE DATABASE test_tsdb2 WITH DURATION 30d 。
DROP DATABASE
删除数据库
✅
执行语义如下所示：
DROP DATABASE <database_name>

DROP SERIES

删除数据库时间序列数据
❌
-

DROP MEASUREMENT
删除测量值
✅
执行语义：
DROP MEASUREMENT <measurement_name>
DROP SHARD
删除数据分片
❌
-
DELETE

删除数据点，可以根据时间范围和查询条件来删除一个或多个数据点

✅
执行语义：
DELETE FROM <measurement_name> WHERE [<tag_key>='<tag_value>'] | [<time interval>]
如下以删除名为 cpu_load 的测量类型中时间戳在某个时间范围内的所有数据点为例，演示其执行方式。
DELETE FROM cpu_load WHERE time >= '2023-05-20T00:00:00Z' AND time < '2023-05-21T00:00:00Z'
CREATE RETENTION POLICY
创建数据保留策略的命令
❌
-
ALTER RETENTION POLICY
修改保留策略
❌
-
DROP RETENTION POLICY
删除保留策略
❌
-
写入协议
InfluxDB Line Protocol 是 InfluxDB 数据库使用的一种数据格式，用于将数据以文本形式写入 InfluxDB 数据库。该协议使用逗号分隔值（CSV）格式，其中包含时间戳、测量标识符、标签和字段。您可以使用该协议将数据写入 InfluxDB 数据库，并从中检索和查询数据。
协议
协议说明
是否兼容
格式
InfluxDB Line Protocol 
InfluxDB Line Protocol 是一种基于文本的数据格式，用于将数据点写入 InfluxDB 数据库。每个数据点都由一个单独的行表示，行中包含时间戳和测量值名称、标签集和字段集的值。
✅
每个数据点都由一个单独的行表示，行中包含时间戳和测量值名称、标签集和字段集的值。
<measurement>[,<tag_key>=<tag_value>[,<tag_key>=<tag_value>]] <field_key>=<field_value>[,<field_key>=<field_value>] [<timestamp>]
更多信息，请参见官网 InfluxDB line protocol reference。
Prometheus
Prometheus 是一种开源的监控系统和时间序列数据库，用于收集、存储和查询各种类型的指标数据。
InfluxDB 提供了一个兼容 Prometheus 的 HTTP API 端点，使得 Prometheus 可以将其数据写入InfluxDB 中。
✅
启用 Prometheus 远程读写 API 与 InfluxDB：
1. 创建目标数据库
在 InfluxDB 实例中，通过 库管理 或参照 数据库管理，创建一个数据库来存储从 Prometheus 发送的数据。
在下面提供的示例中以 prometheus_test 举例，用作数据库名称CREATE DATABASE "prometheus_test"。
2. 请将 URL 值添加到 Prometheus 配置文件中的以下设置：
username、password：分别为实例的访问账号与密码。
influxdb_ip：指实例内网 IP 地址。
db：指数据库库名，举例如 prometheus_test。
remote_write:
  - url: "http://influxdb_ip:8086/api/v1/prom/write?db=prometheus_test&u=username&p=password"
﻿
remote_read:
  - url: "http://influxdb_ip:8086/api/v1/prom/read?db=prometheus_test&u=username&p=password"
具体如何配置文件以及如何解析 Prometheus 指标，请参见 Prometheus endpoints support in InfluxDB。
下载并写入数据
下载并写入符合 InfluxDB Line Protocol 协议的时序数据，请参见 连接并写入数据。更多信息，请参见 Download and write the data to InfluxDB。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

命令	作用	兼容性	语义
CREATE DATABASE	创建一个新的数据库	✅	当前 CREATE DATABASE 仅支持配置如下参数，其它参数暂不支持。语义格式如下所示： `CREATE DATABASE <database_name> [WITH [DURATION <duration[默认无限制]>]]` database_name：指数据库库名。 DURATION：数据过期删除时间（TTL , Time To Live），单位：天，取值为非零整数，选填参数。如果不启用数据过期，不配置该参数，如需启用数据过期，该数据库中的数据达到过期时间后将被自动删除清理，请谨慎配置！例如 DURATION 180d，表示该数据库中的数据达到180天即过期自动删除。创建一个名为 test_tsdb1 的数据库，该数据库的数据永久保留：`CREATE DATABASE test_tsdb1`。创建一个名为 test_tsdb2 的数据库，该数据库启用数据过期，设置数据被保留30天：`CREATE DATABASE test_tsdb2 WITH DURATION 30d` 。
DROP DATABASE	删除数据库	✅	执行语义如下所示： `DROP DATABASE <database_name>`
DROP SERIES	删除数据库时间序列数据	❌	-
DROP MEASUREMENT	删除测量值	✅	执行语义： `DROP MEASUREMENT <measurement_name>`
DROP SHARD	删除数据分片	❌	-
DELETE	删除数据点，可以根据时间范围和查询条件来删除一个或多个数据点	✅	执行语义： `DELETE FROM <measurement_name> WHERE [<tag_key>='<tag_value>'] \| [<time interval>]` 如下以删除名为 cpu_load 的测量类型中时间戳在某个时间范围内的所有数据点为例，演示其执行方式。 `DELETE FROM cpu_load WHERE time >= '2023-05-20T00:00:00Z' AND time < '2023-05-21T00:00:00Z'`
CREATE RETENTION POLICY	创建数据保留策略的命令	❌	-
ALTER RETENTION POLICY	修改保留策略	❌	-
DROP RETENTION POLICY	删除保留策略	❌	-

协议	协议说明	是否兼容	格式
InfluxDB Line Protocol	InfluxDB Line Protocol 是一种基于文本的数据格式，用于将数据点写入 InfluxDB 数据库。每个数据点都由一个单独的行表示，行中包含时间戳和测量值名称、标签集和字段集的值。	✅	每个数据点都由一个单独的行表示，行中包含时间戳和测量值名称、标签集和字段集的值。 <measurement>[,<tag_key>=<tag_value>[,<tag_key>=<tag_value>]] <field_key>=<field_value>[,<field_key>=<field_value>] [<timestamp>] 更多信息，请参见官网 InfluxDB line protocol reference。
Prometheus	Prometheus 是一种开源的监控系统和时间序列数据库，用于收集、存储和查询各种类型的指标数据。 InfluxDB 提供了一个兼容 Prometheus 的 HTTP API 端点，使得 Prometheus 可以将其数据写入InfluxDB 中。	✅	启用 Prometheus 远程读写 API 与 InfluxDB： 1. 创建目标数据库在 InfluxDB 实例中，通过库管理或参照数据库管理，创建一个数据库来存储从 Prometheus 发送的数据。在下面提供的示例中以 prometheus_test 举例，用作数据库名称`CREATE DATABASE "prometheus_test"`。 2. 请将 URL 值添加到 Prometheus 配置文件中的以下设置： username、password：分别为实例的访问账号与密码。 influxdb_ip：指实例内网 IP 地址。 db：指数据库库名，举例如 prometheus_test。 remote_write: - url: "http://influxdb_ip:8086/api/v1/prom/write?db=prometheus_test&u=username&p=password" remote_read: - url: "http://influxdb_ip:8086/api/v1/prom/read?db=prometheus_test&u=username&p=password" 具体如何配置文件以及如何解析 Prometheus 指标，请参见 Prometheus endpoints support in InfluxDB。

tencent cloud

时序数据库 CTSDB

数据库管理

数据库管理

写入协议

下载并写入数据

帮助和支持