示例数据

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

创建数据库

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

$ influx -precision rfc3339
Connected to http://localhost:8086 version 1.12.0
InfluxDB shell 1.12.0
>

注释

• 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 http://localhost:8086 version 1.12.0
InfluxDB shell 1.12.0
>

查看所有五个测量值

> 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 包含虚构数据。 这些测量值用于阐明 模式探索 中的查询功能。

h2o_feet 测量值是唯一包含 NOAA 数据的测量值。 请注意，level description 字段不是原始 NOAA 数据的一部分 - 我们将其偷偷加入其中，以便拥有一个带有特殊字符和字符串 字段值 的字段键。