0x00 基础操作介绍
在本文中将介绍InfluxDB常用的基础操作,帮助读者建立对InfluxDB的感性认识,快速的动手玩起来,持续查询(Continuous Queies)、Group by、Series、行协议(Line Protocol)、InfluxQL等高级特性和细节,将会在后续文章中逐步介绍。
InfluxDB支持类SQL的操作接口,尽管因为时序数据的特点,InfluxDB是非CRUD的,不支持更新数据、删除单条数据操作,但考虑到大多数的读者对应CRUD的关系型数据库比较熟悉,在本文中,还是按照CRUD原则,介绍数据库(Database)、保留策略(Retention Policy)、表(Measurement)、数据写入、数据查询、数据更新、数据删除等内容。
InfluxDB支持influx命令行和InfluxDB API 2种操作接口,在本文中,将以influx命令行的操作为例,介绍上述内容。本文的操作示例,基于InfluxDB最新的稳定版本,InfluxDB-v1.7.8。
0x01 数据库(Database)
1. 创建数据库
通过CREATE语句,创建名为telegraf的数据库。
$ influx Connected to http://localhost:8086 version 1.7.8 InfluxDB shell version: 1.7.8 > create database telegraf >
2. 查看数据库
通过SHOW语句,查看当前所有的数据库。
> show databases; name: databases name ---- _internal monito telegraf >
3. 删除数据库
通过DROP语句,删除名为telegraf的数据库。
> drop database telegraf
>
4. 使用数据库
通过USE语句,使用名为telegraf的数据库。
> use telegraf Using database telegraf >
0x02 保留策略(Retention Policy)
1. 查看数据库对应的保留策略
通过SHOW语句,查看数据库telegraf对应的保留策略。
> show retention policies on telegraf name duration shardGroupDuration replicaN default ---- -------- ------------------ -------- ------- autogen 0s 168h0m0s 1 true >
2. 创建保留策略
通过CREATE语句,创建名为rp-one-year的保留策略。
> create retention policy "rp-one-year" on "telegraf" duration 365d replication 1 > > show retention policies on telegraf name duration shardGroupDuration replicaN default ---- -------- ------------------ -------- ------- autogen 0s 168h0m0s 1 true rp-one-year 8760h0m0s 168h0m0s 1 false >
3. 更改保留策略
通过ALTER语句,更改保留策略rp-one-year为数据库telegraf的默认保留策略。
> alter retention policy "rp-one-year" on "telegraf" duration 365d replication 1 default > > show retention policies on telegraf name duration shardGroupDuration replicaN default ---- -------- ------------------ -------- ------- autogen 0s 168h0m0s 1 false rp-one-year 8760h0m0s 168h0m0s 1 true >
4. 删除保留策略
通过DROP语句,删除数据库telegraf的保留策略rp-one-year。
> drop retention policy "rp-one-year" on "telegraf" > > show retention policies on telegraf name duration shardGroupDuration replicaN default ---- -------- ------------------ -------- ------- autogen 0s 168h0m0s 1 false >
0x03 表(Measurement)
1. 创建表
与MySQL等关系型数据不同,在InfluxDB中,无需显式创建表,在写入时序数据时,InfluxDB服务器会根据行协议,按需自动创建对应的表。
在数据库telegraf中,插入数据时,自动创建了表devops-idc-sz。
> use telegraf Using database telegraf > > show measurements > > insert devops-idc-sz,host=server01 cpu=23.1,mem=0.63 > > show measurements name: measurements name ---- devops-idc-sz >
2. 查看measurements
通过SHOW语句,,查看数据库telegraf中的所有的表。
> show measurements name: measurements name ---- devops-idc-sz >
3. 删除表
通过DROP语句,删除表devops-idc-sz和对应的所有数据。
> drop measurement devops-idc-sz > > show measurements >