本章节以Linux系统为例，介绍从购买到内网连接GeminiDB Influx实例的操作步骤和基础语法。

购买GeminiDB Influx实例

购买ECS

连接GeminiDB Influx实例

基础语法

购买GeminiDB Influx实例

1. 登录管理控制台。
2. 在服务列表中选择“数据库 > 云数据库 GeminiDB”。
3. 在“实例管理”页面，单击“购买数据库实例”，进入“服务选型”页面。
4. 在“购买数据库实例”页面，选择计费模式，填写并选择实例相关信息后，单击“立即购买”。

图1 基本信息

图2 选择规格

图3 设置密码

5. 查看购买成功的GeminiDB Influx实例。

图4 购买成功

购买ECS

1. 登录管理控制台。
2. 在服务列表中选择“计算 > 弹性云主机 ECS”，进入云服务器控制台，单击“购买弹性云主机”。

图5 登录弹性云主机控制台

3. 配置基础信息后，单击“下一步：网络配置”。ECS与待连接的GeminiDB Influx实例的区域及可用区一致。ECS与待连接的GeminiDB Influx实例的区域、可用区、VPC和安全组一致。

图6 基础配置

图7 选择规格

图8 选择镜像

4. 配置网络信息后，单击“下一步：高级配置”。ECS与待连接的GeminiDB Influx实例的VPC和安全组一致。

• 如果安全组规则允许弹性云主机云主机访问，即可连接实例。
• 如果安全组规则不允许弹性云主机云主机访问，需要在实例安全组添加一条“入”的访问规则。

图9 网络配置

图10 选择弹性公网IP

5. 配置密码等信息后，单击“下一步：确认配置”。

图11 高级配置

6. 确认配置信息后，单击“立即购买”。

图12 确认配置

7. 查看购买成功的ECS。

连接GeminiDB Influx实例

1. 在ECS上，使用控制台提供的VNC方式登录。

图13 远程登录

2. 输入用户名和创建ECS时设置的密码。

图14 输入用户名和密码

3. 获取InfluxDB客户端。

方法一：

wget https://dl.influxdata.com/influxdb/releases/influxdb-1.7.9-static_linux_amd64.tar.gz

方法二：

下载InfluxDB客户端，并将InfluxDB客户端安装包上传到弹性云主机。

4. 解压客户端工具包。

tar -xzf influxdb-1.7.9-static_linux_amd64.tar.gz

5. 在“influx”工具所在目录下，连接数据库实例。
   1. 使用如下命令，进入InfluxDB目录。

      cd influxdb-1.7.9-1
      

   2. 连接GeminiDB Influx实例。

      ./influx -ssl -unsafeSsl -username ' < DB_USER > ' -password ' < DB_PWD > ' -host  < DB_HOST >  -port  < DB_PORT >
      示例：./influx -ssl -unsafeSsl -username 'rwuser' -password '<DB_PWD>' -host 192.xx.xx.xx -port 8635
      

表1 参数说明

参数	说明
<DB_USER>	管理员账户名，默认为rwuser。您可以在“实例管理”页面单击实例名称，进入“基本信息”页面，在“数据库信息”模块的“管理员账户名”处获取。
<DB_PWD>	管理员密码。
<DB_HOST>	待连接实例的负载均衡地址。 负载均衡地址目前处于公测阶段，如需使用，请您联系客服申请开通。 场景一：在创建实例之前，如果您已经申请开通了负载均衡地址，您可以在创建实例页面查看到系统默认勾选负载均衡地址。待实例创建成功后，您可以单击实例名称，进入“基本信息”页面，在网络信息区域获取到“负载均衡地址”。 场景二：如果实例已创建成功，此时如果需要使用负载均衡地址，则需要联系客服帮您开通。开通成功后，您可以单击实例名称，进入“基本信息”页面，刷新页面，在网络信息区域获取到“负载均衡地址”。
<DB_PORT>	实例的端口。您可以在“实例管理”页面单击实例名称，进入“基本信息”页面，在“网络信息 > 负载均衡地址”处获取端口信息。

6. 出现如下信息，说明连接成功。

Connected to https://host:port version 1.7.4 
InfluxDB shell version：1.7.9 
>

基础语法

库语法

• 创建数据库。

  create_database_stmt = "CREATE DATABASE" db_name
  [ WITH
  [ retention_policy_duration ]
  [ retention_policy_replication ]
  [ retention_policy_shard_group_duration ]
  [ retention_policy_name ]
  ] .
  

说明
上述命令中，[]表示可选选项。

示例：

• 创建名称为“mydb”的数据库。

CREATE DATABASE "mydb"

• 创建名称为“mydb”的数据库，使用指定的保留策略，名称为“myrp”，保留时间为1天，副本数量为1，shardGroup的存储时间为30分钟。

CREATE DATABASE "mydb" WITH DURATION 1d REPLICATION 1 SHARD DURATION 30m NAME "myrp"

• 创建名称为“mydb”的数据库，使用默认的保留策略，保留策略名称为“myrp”。

CREATE DATABASE "mydb" WITH NAME "myrp"

查询数据库

SHOW DATABASES

切换数据库

USE db_name

删除数据库

DROP DATABASE "db_name"

图15 创建数据库

RETENTION POLICY语法

• 创建RETENTION POLICY，当前RETENTION POLICY命名中不能包含逗号、冒号、分号和点号。

  create_retention_policy_stmt = "CREATE RETENTION POLICY" policy_name on_clause
  retention_policy_duration
  retention_policy_replication
  [ retention_policy_shard_group_duration ]
  [ "DEFAULT" ] .
  

说明
上述命令中，[]表示可选选项。

示例：

• 创建数据保留策略。

CREATE RETENTION POLICY "10m_events" ON "somedb" DURATION 60m REPLICATION 2

• 创建数据保留策略，并将其设置为默认。

CREATE RETENTION POLICY "10m_events" ON "somedb" DURATION 60m REPLICATION 2 DEFAULT

• 创建数据保留策略，并指定shardGroup的存储时长。

CREATE RETENTION POLICY "10m_events" ON "somedb" DURATION 60m REPLICATION 2 SHARD DURATION 30m

查看RETENTION POLICY

show retention policies on <database name>

图16 创建并查看RETENTION POLICY

说明
同时使用retention_policy_duration与retention_policy_shard_group_duration时，retention_policy_duration需大于retention_policy_shard_group_duration。

• 删除RETENTION POLICY

DROP RETENTION POLICY policy_name ON db_name

• 修改RETENTION POLICY

Alter_retention_policy_stmt  = "ALTER RETENTION POLICY" policy_name on_clause

retention_policy_option

[ retention_policy_option ]

[ retention_policy_option ]

[ retention_policy_option ] .

说明
上述命令中，[]表示可选选项。

示例：

• 修改默认保留策略。

ALTER RETENTION POLICY "1h_cpu" ON "mydb" DEFAULT

• 修改保留时间和副本数量。

ALTER RETENTION POLICY "policy1" ON "somedb" DURATION 1h REPLICATION 4

新增数据

insert into <retention policy> measurement,tagKey=tagValue fieldKey=fieldValue timestamp

说明
插入数据时，系统会根据需要创建measurement。

• 使用默认的retention policy。

insert demo,name=LiSi math=99,english=90,language=95

新增数据，measurement为demo，tag为name，field为math、english和language

• 使用指定的retention policy。

insert into rp_1_hours demo,name=ZhangSan math=99,english=90,language=95

查询数据

• 在默认RETENTION POLICY中查询

select * from demo where time < xxx and time > xxx

• 在指定RETENTION POLICY中查询

select * from rp_1_hours.demo where time < xxx and time > xxx

说明
查询语句需要指定查询的时间范围，包括上界和下界。

修改数据

使用insert来修改数据，当所有tag和timestamp完全相同时，insert会覆盖原有内容。

图17 修改数据

删除数据

delete from measurement where time …

图18 删除数据

删除series

drop series from "measurement" where "tag_name" = 'tag_value'

图19 查看demo

图20 删除series

说明
drop series的where不支持time、fields，且会删除所有RETENTION POLICY中符合条件的series。

HELP命令

• HELP ，查看所有支持的命令。

图21 查看支持的全部命令

• HELP ，查询某一命令的使用方法。

示例：HELP DESC