示例数据

为了进一步探索查询语言，这些指令帮助您创建一个数据库，下载并在您的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 InfluxQL语句创建一个数据库，其中 是您希望创建的数据库名称。数据库名称可以包含任何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

通过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。