购买并连接GeminiDB Influx实例

步骤一：购买GeminiDB Influx实例

1. 登录管理控制台。
2. 在服务列表中选择“数据库 > 云数据库 GeminiDB Influx 接口”。
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"

    

• 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>

    

    

    同时使用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会覆盖原有内容。

  

• 删除数据

  建议根据需求设置合理的RETENTION POLICY，通过RETENTION POLICY自动删除数据。

• HELP命令
  • HELP，查看所有支持的命令。
    图15 查看支持的全部命令
    
  • HELP <COMMAND>，查询某一命令的使用方法。

    示例：HELP DESC