示例数据

为了进一步探索查询语言，以下说明将帮助您创建一个数据库，下载数据并将其写入到您的 InfluxDB 安装中。示例数据随后将在 数据探索、模式探索 和 函数 中使用和引用。

创建数据库

如果您已在本地安装 InfluxDB，则 influx 命令应可通过命令行使用。执行 influx 将启动 CLI 并自动连接到本地 InfluxDB 实例（假设您已使用 service influxdb start 或直接运行 influxd 启动服务器）。输出应如下所示

$ influx -precision rfc3339
Connected to https://127.0.0.1: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

从您的终端，下载包含 行协议 格式数据 的文本文件

curl https://s3.amazonaws.com/noaa.water-database/NOAA_data.txt -o NOAA_data.txt

通过 CLI 将数据写入 InfluxDB

influx -import -path=NOAA_data.txt -precision=s -database=NOAA_water_database

测试查询

$ influx -precision rfc3339 -database NOAA_water_database
Connected to https://127.0.0.1:8086 version 1.11.8
InfluxDB shell 1.11.8
>

查看所有五个 measurement

> 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

选择 measurement 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 个水位 (英尺) 观测值。

请注意，measurement average_temperature、h2o_pH、h2o_quality 和 h2o_temperature 包含虚构数据。这些 measurement 用于阐明 模式探索 中的查询功能。

h2o_feet measurement 是唯一包含 NOAA 数据的 measurement。请注意，level description 字段不是原始 NOAA 数据的一部分 - 我们为了拥有一个带有特殊字符和字符串 字段值 的字段键而偷偷加入了它。