示例数据
为了进一步探索查询语言,这些指令帮助您创建一个数据库,下载并在您的InfluxDB安装中写入数据。示例数据随后在 数据探索、模式探索 和 函数中使用和引用。
创建数据库
如果您在本地安装了 InfluxDB,influx 命令应该可以通过命令行使用。 执行 influx 将启动 CLI,并自动连接到本地 InfluxDB 实例(假设您已经使用 service influxdb start 启动了服务器或直接运行 influxd)。 输出应该如下所示:
$ influx -precision rfc3339
Connected to http://localhost:8086 version 1.11.8
InfluxDB shell 1.11.8
>
注意:
- InfluxDB API 默认运行在端口
8086。 因此,influx默认会连接到端口8086和localhost。 如果您需要更改这些默认值,请运行influx --help。 -precision参数 指定任何返回时间戳的格式/精度。在上面的示例中,rfc3339告诉 InfluxDB 以 RFC3339 格式 返回时间戳 (YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ)。
命令行现在准备好以 Influx 查询语言(即 InfluxQL)语句的形式接收输入。
要退出 InfluxQL shell,请输入 exit 并按回车。
新安装的InfluxDB没有数据库(除了系统 _internal),所以创建一个是我们的第一项任务。您可以使用 CREATE DATABASE <db-name> InfluxQL语句创建一个数据库,其中 <db-name> 是您希望创建的数据库名称。数据库名称可以包含任何unicode字符,只要字符串是双引号括起来的。如果名称仅包含ASCII字母、数字或下划线并且不以数字开头,也可以不加引号。
在查询语言探索中,我们将使用数据库名称 NOAA_water_database:
> CREATE DATABASE NOAA_water_database
> exit
下载并将数据写入InfluxDB
从你的终端,下载包含数据的文本文件,格式为 line protocol:
curl https://s3.amazonaws.com/noaa.water-database/NOAA_data.txt -o NOAA_data.txt
通过influx CLI将数据写入InfluxDB:
influx -import -path=NOAA_data.txt -precision=s -database=NOAA_water_database
测试查询
$ influx -precision rfc3339 -database NOAA_water_database
Connected to http://localhost:8086 version 1.11.8
InfluxDB shell 1.11.8
>
查看所有五个测量:
> SHOW measurements
name: measurements
------------------
name
average_temperature
h2o_feet
h2o_pH
h2o_quality
h2o_temperature
计算h2o_feet中非空值的数量water_level:
> SELECT COUNT("water_level") FROM h2o_feet
name: h2o_feet
--------------
time count
1970-01-01T00:00:00Z 15258
选择测量 h2o_feet 中的前五个观察值:
> SELECT * FROM h2o_feet LIMIT 5
name: h2o_feet
--------------
time level description location water_level
2015-08-18T00:00:00Z below 3 feet santa_monica 2.064
2015-08-18T00:00:00Z between 6 and 9 feet coyote_creek 8.12
2015-08-18T00:06:00Z between 6 and 9 feet coyote_creek 8.005
2015-08-18T00:06:00Z below 3 feet santa_monica 2.116
2015-08-18T00:12:00Z between 6 and 9 feet coyote_creek 7.887
数据源和需要注意的事项
样本数据来自国家海洋和大气管理局(NOAA)运营海洋产品和服务中心的公开数据。数据包括在2015年8月18日至2015年9月18日期间,每六分钟在两个站点(加利福尼亚州圣塔莫尼卡(ID 9410840)和加利福尼亚州科约特溪(ID 9414575))收集的15,258个水位(英尺)观测值。
请注意,测量值 average_temperature、h2o_pH、h2o_quality 和 h2o_temperature 包含虚构的数据。
这些测量用于照亮Schema Exploration中的查询功能。
h2o_feet 测量是唯一包含NOAA数据的测量。请注意,level description 字段并不是原始NOAA数据的一部分 - 我们把它加进去是为了拥有一个带有特殊字符和字符串的字段键 field values。